bb installation guidesapidp/... · web viewaccess the operating system of sap web dispatcher, edit...
TRANSCRIPT
BB Installation Guide
SAP Fiori rapid-deployment solution
October 2014
EnglishEnglish
SAP Generic Portal Integration for Fiori (MF5)
SAP SEDietmar-Hopp-Allee 1669190 WalldorfGermany
Building Block Configuration Guide
Copyright
2014 SAP SE or an SAP affiliate company. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company.
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. Please see http://global.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.
Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors.
National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP SE or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP SE or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.
In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop or release any functionality mentioned therein. This document, or any related presentation, and SAP SEs or its affiliated companies strategy and possible future developments, products, and/or platform directions and functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time for any reason without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or functionality. All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking statements, which speak only as of their dates, and they should not be relied upon in making purchasing decisions.
Icons
Icon
Meaning
Caution
Example
Note
Recommendation
Syntax
Typographic Conventions
Type Style
Description
Example text
Words or characters that appear on the screen. These include field names, screen titles, pushbuttons as well as menu names, paths and options.
Cross-references to other documentation.
Example text
Emphasized words or phrases in body text, titles of graphics and tables.
EXAMPLE TEXT
Names of elements in the system. These include report names, program names, transaction codes, table names, and individual key words of a programming language, when surrounded by body text, for example, SELECT and INCLUDE.
Example text
Screen output. This includes file and directory names and their paths, messages, source code, names of variables and parameters as well as names of installation, upgrade and database tools.
EXAMPLE TEXT
Keys on the keyboard, for example, function keys (such as F2) or the ENTER key.
Example text
Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation.
Variable user entry. Pointed brackets indicate that you replace these words and characters with appropriate entries.
Content
51Purpose
52Prerequisites
63Configuration (Manual)
63.1Configuration of SAP Webdispatcher
63.1.1Landscape Overview
63.1.2Configure SAP Webdispatcher
73.2Configuration in the Portal
73.1.2 Configure Portal Systems
83.2.2Set Trust between the Portal and the SAP NetWeaver Gateway System
83.2.3Create Role
93.2.4Create Fiori App specific iView
103.2.5Create Launchpad specific iView
113.2.6Assign Role/s to Users or Groups
114Business Process.
114.1Fiori App
SAP Generic Portal Integration for Fiori
1 Purpose
The purpose of this document is to describe the general configuration steps required to manually set up the configuration. The system landscape must have already been installed. Check the prerequisites carefully.
This guide enables the implementation of the SAP Fiori Launchpad or single Fiori Apps.
2 Prerequisites
Before starting the installation, complete the following activities:
Activity
SAP Notes
Refer to the following SAP Notes containing the most recent information on the installation as well as corrections to the installation documentation. You can access them on the SAP Service Marketplace at http://service.sap.com/notes.
SAP Note #
Description
2031108
SAP Fiori Integration with SAP Enterprise Portal - Central note
2017946
SAP Fiori application integration with NetWeaver Portal
2057847
Removing/Relaxing Click-Jacking Protection for the SAP Fiori Launchpad
1717945
Portal Logoff Does Not Logoff the Backend When Using HTTP Security Session Management
More information
For more information regarding SAP NetWeaver, SAP NetWeaver Portal, see http://help.sap.com/nw73 or http://help.sap.com/nw731 or http://help.sap.com//nw74.
For more information regarding SAP NetWeaver Portal, mobile edition, see http://help.sap.com/nwew.
3 Configuration (Manual)
3.1 Configuration of SAP Webdispatcher3.1.1 Landscape Overview
SAP Netweaver Gateway
SAP Netweaver Portal
Device
Device
SAP Webdispatcher
User
3.1.2 Configure SAP WebdispatcherUse
In this step, you configure the SAP Webdispatcher in order to forward requests to SAP NetWeaver Portal and SAP NetWeaver Gateway. This is mandatory in order to use FIORI within SAP NetWeaver Portal. In addition to the SAP Webdispatcher configuration described in the document Installation and configuration of common components of SAP Fiori (EE0) please add the following procedure.
Procedure
1. Access the Operating System of SAP Web Dispatcher, edit its Instance Profile.
Since Web Dispatcher uses a different System Number from SAP NetWeaver, so if you use Front-End Server underlying Web Dispatcher, the profile is not the one you can see in RZ10.
2. Add following profile parameters to enable forwarding:
wdisp/system_conflict_resolution = 1
3. Add following profile parameters for ICM ports:
icm/server_port_2 = PROT=HTTP,PORT=
4. Add following profile parameters for Web Dispatcher routes:
wdisp/system_21 = SID=, MSHOST= , MSPORT=, SRCSRV=*:, SRCURL=/sap/opu/;/sap/bc/;/sap/public/bc/, CLIENT=
wdisp/system_22 = SID=, EXTSRV=http://:, SRCSRV=*:, SRCURL=/irj/;/
5. Save the Instance Profile and restart the Web Dispatcher process.
6. Test the Web Dispatcher URLs using Web browser:
https://:/irj/portal
and
https://:/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html
3.2 Configuration in the Portal 3.1.2 Configure Portal SystemsUse
In this step, you configure the portal system that will be connected to the Gateway system.
Procedure
1. Logon to the portal with the user that has system administration authorization.Enter URL: http(s):// :/irj/portal Example: https://my.company.domain:50000/irj/portal
2. Go to System administration System Landscape.
3. Choose the New button.
4. Select SAP system using dedicated application server.
5. Choose Next.
6. Enter the system name and ID.
7. Choose Next.
8. Enter the alias name, for example, SAP_FIORI and choose Add.
9. Choose Finish.
10. Select properties under the Edit section.
11. Choose Modify Properties.
12. Enter the following parameters according to the Gateway system you use and choose Save:
Field Name
Entry Value Example
Application Host
As application host the properties of the Webdispatcher need to be maintained here.
Logical System Name
SAP Client
SAP System ID (SID)
SAP System Number
Server Port
Systemtype
SAP_R3
ITS Host Name
ITS Protocol
Logon Method
ICM Host Name
ICM Protocol
3.2.1 Set Trust between the Portal and the SAP NetWeaver Gateway System
Use
In this step, you set trust between the portal and the Gateway system.
Procedure
1. Logon to the portal with the user that has system administration authorization.Enter URL: http(s):// :/irj/portal Example: https://my.company.domain:50000/irj/portal
The user must exist with the same userID also in the SAP NetWeaver Gateway system and must have authorizations to maintain Single Sign On (SSO) settings like in transaction STRUSTSSO2.
2. Go to System administration System Landscape.
3. In the system landscape overview, select the new created Fiori system.
4. Choose Establish Trust.
5. Enter the user and password for the system that have authorization to edit the strustsso2 transaction and choose Apply.
6. Check that a message stating that the trust was established successfully is displayed.
3.2.2 Create Role
Use
In this step, you create portal role/roles.
Procedure
1. Logon to the portal with the user that has content administration authorization.
2. Go to Content Administration Portal Content Management.
3. Choose the Content tree and the folder where you store roles (for example: Portal Content -> ).
4. Right-click the folder and choose New Role Freestyle Role.
5. Enter the name, for example Fiori.
6. Enter the ID and choose Finish, for example rdsfiori.
7. Choose Content and structure under the Edit section.
8. Choose New Folder.
9. Enter the name Launchpad and choose OK.
10. Set the role as entry point.
11. Select the role.
12. Choose New Folder.
13. Enter the name Fiori Apps and choose OK.
14. Close the folder and role.
15. Repeat the steps above for all the different roles you must assign to users/groups.
3.2.3 Create Fiori App specific iView
Use
In this step, you create the iViews that launch the Fiori applications.
Procedure
1. Logon to the portal with the user that has content administration authorization.
2. Go to Content Administration Portal Content Management.
3. Choose the Content tree and the folder where you store the Roles, for example RDS -> Roles
4. Right-click the role Fiori you created and choose Open Role.
5. Choose the Fiori Apps folder.
6. Choose the new Button.
7. Select iView from Template.
8. Select SAP Fiori iView.
9. Choose next button.
10. Enter iView name (for example my opportunities).
11. Choose next.
12. Maintain the following values:
Field Name
Entry Value Example
Fiori Launch Pad Header State
No header
Parameters to Pass on the Location String in the URL
Shell-runStandaloneApp?sap-ushell-SAPUI5.Component=&sap-ushell-url=/sap/bc/ui5_ui5/sap/
Shell-runStandaloneApp?sap-ushell-SAPUI5.Component=cus.crm.opportunity&sap-ushell-url=/sap/bc/ui5_ui5/sap/crm_opprtnty
You can retrieve the parameter from Transaction LPD_CUST in the SAP Gateway System.Open the transaction LPD_CUST:Double-click the Role which, contains the FIORI App you want to add. (for example: UICRM001).Double-click the App name in the tree. (for example: My Opportunities)
Choose the Show advanced (optional) Parameters button.
Copy the string under Applications related Parameters -> Additional Information (for example:SAPUI5.Component=cus.crm.opportunity)
Copy the string under Applications Parameter -> UI Service of your SAP Fiori app (for example: /sap/bc/ui5_ui5/sap/crm_opprtnty)
Relative Path for SAP Fiori Application
sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html
System
Select the System Alias you have created in chapter Configure Portal Systems.
13. Choose Next.
14. Review your entries and Choose Finish.
15. Choose Close.
Within the SAP Note 2049423: SAP Fiori Apps rapid-deployment solutions V4.20 a list of example parameters is being provided.
3.2.4 Create Launchpad specific iView
Use
In this step, you create the iView that launches the Fiori launchpad.
Procedure
1. Logon to the portal with the user that has content administration authorization.
2. Go to Content Administration Portal Content Management.
3. Choose the Content tree and the folder where you store the Roles, for example RDS -> Roles
4. Right-click the role Fiori you created and choose Open Role.
5. Choose the Launchpad folder.
6. Choose the new Button.
7. Select iView from Template.
8. Select SAP Fiori iView.
9. Choose next button.
10. Enter iView name (for example my Fiori Launchpad).
11. Choose next.
12. Maintain the following values:
Field Name
Entry Value Example
Fiori Launch Pad Header State
No header
Parameters to Pass on the Location String in the URL
Relative Path for SAP Fiori Application
sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html
System
Select the System Alias you have created in chapter Configure Portal Systems.
13. Choose Next.
14. Review your entries and Choose Finish.
15. Choose Close.
3.2.5 Assign Role/s to Users or Groups
Use
In this step, you assign the configured roles to users or groups.
Procedure
1. Logon to the portal with the user that has user administration authorization.
2. Go to User Administration Identify management.
3. Search for the User/Group you would like to assign the roles to.
4. Select User/Group.
5. Choose Modify and choose the Assign Roles tab.
6. Search for the roles you would like to assign and choose Add.Example: Fiori
7. Choose Save.
4 Business Process.4.1 Fiori AppUse
In this step, you check call an SAP Fiori App in the portal using a desktop PC.
Procedure
Perform the following steps using the desktop browser:
1. Logon to the Portal through Webdispatcher URL as a user with a role containing the SAP Fiori Launchpad.for example: http://:/irj/portal
2. Choose a Fiori App in the navigation Fiori Apps, for example my Opportunities.The SAP Fiori app should be visible on the SAP NetWeaver Portal screen.
3. Choose Launchpad in the navigation.
4. The Fiori Launchpad should be visible on the SAP NetWeaver Portal screen
SAP SE
Page 2 of 9
_1471962352.vsd