Document Version: 1.0 2017-02-01 RELEASED Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise
Document History The following table provides an overview of the most important document changes Table 1 Version Date Description 1.0 February 14, 2017 Initial Version J. Javier Baltazar
Typographic Conventions Type Style Example Example EXAMPLE Example Example <Example> EXAMPLE Description Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options. Textual cross-references to other documents. Emphasized words or expressions. Technical names of system objects. These include report names, program names, transaction codes, table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE. Output on the screen. This includes file and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools. Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation. Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system. Keys on the keyboard, for example, F2 or ENTER.
Table of Contents 1 Introduction... 5 2 Important Considerations... 6 3 App Finder Basic Configuration... 8 4 Create Custom PFCG Role... 13 5 Open App Finder and add new Tiles to Fiori Launchpad... 14 6 Common Issues and Solutions... 21
1 Introduction Description This document is created as a step-by-step guide to demonstrate how to quickly configure App Finder in S/4HANA 1610 On-Premise. By reading this document you will be able to understand the main activities required to activate App Finder and some of the common errors and solutions. System prerequisites SAP S/4HANA 1610 On-Premise with Gateway Hub Installation Technical Activation of Fiori Launchpad has been concluded Fiori Administrator Roles have been assigned to your user Target group Target group requirements System Administrators Security Administrators. RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 5
2 Important Considerations Background SAP Fiori Launchpad for S/4HANA 1610 can integrate various UX application technologies. Amongst these technologies, we can find: SAP UI5 SAP Web Dynpro/FPM ABAP SAP GUI for HTML In the current S/4HANA releases not all SAP GUI standard transactions are available as a standard SAP Fiori Apps using any of the technologies listed above, this means you will find some cases where you will need to define an alternate approach to expose standard or custom backend functionality in Fiori Launchpad. This approach needs to be based on User Role definitions and Fiori Launchpad design provided by your UX Implementation Team. Prerequisites Required transaction exists as Web Dynpro/FPM or SAP GUI for HTML You have analyzed and identified the required subset of transactions required for a specific user role so the amount of applications exposed through this method is minimal. RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 6
General Recommendations The app finder displays the following tabs where you can find all the apps available for your role: Catalog - A repository of all the Fiori UI5 apps that are assigned by your administrator to your role User Menu - A customized menu that includes folders of those SAP GUI transactions and Web Dynpro ABAP apps assigned to your role in a specific backend system. SAP Menu - A standard menu delivered by SAP that includes folders of all SAP GUI transactions and Web Dynpro ABAP apps offered by a particular SAP system. This menu is not role-dependent and therefore displays the same content for all users this means you need to be aware of any security risks generated by exposing this functionality. You can hide the SAP Menu and User Menu in the App Finder using Launchpad Configuration Parameters You are aware of the Restrictions in SAP Fiori visual theme for classic applications in SAP Note 2348661 You are aware of the Restrictions for using SAP GUI for HTML and SAP Note 314568 You are aware of the display adjustments that may be needed to render an application using Belize Theme described in the Configuration Guidelines RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 7
3 App Finder Basic Configuration Step/Description Screenshot 1. Enter transaction /IWFND/MAINT_SERVICE and activate the following OData Services: /UI2/EASY_ACCESS_MENU /UI2/USER_MENU **NOTE: Make sure you assign your backend system alias to both OData services. In our scenario, the required system alias is S4QCLNT210 RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 8
2. Enter Fiori Launchpad Designer and create a new catalog in (remember to assign a transport order or define as local object). In this case our custom catalog name would be ZEASY_ACCESS (you can name your catalog as you wish) **NOTE: Access Fiori Launchpad Designer using the following url: http://<host>.<domain>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sapclient=<client>?scope=cust. You need Fiori Launchpad Administrator Roles to perform these modifications. RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 9
3. Define a new Target Mapping for WebGUI Transactions (make sure you define the system alias name assigned in Step 1) **NOTE Make sure you define the values exactly as indicated: Parameter Semantic Object Action Application Type Title Transaction Device Types Value Shell startgui Transaction <Any> <Any> Desktop Additional Parameters Name Mandatory Value Is Regular Expression sap-system Checked <System Alias defined in step 1> Not Checked sap-ui2-tcode Checked.* Checked Allow Additional Parameters Not Checked RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 10
4. Define a new Target Mapping for Webdynpro Apps (make sure you define the system alias name assigned in Step 1) **NOTE Make sure you define the values exactly as indicated: Parameter Semantic Object Action Application Type Title Transaction Device Types Value Shell startwda Web Dynpro <Any> <Any> Desktop Additional Parameters Name Mandatory Value Is Regular Expression sap-system Checked <System Alias defined in step 1> Not Checked sap-ui2-wd-appid Checked.* Checked Allow Additional Parameters Checked RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 11
5. In your Frontend Server create two additional RFC s in transaction SM59 following the next naming syntax: <System Alias Defined in Step 1> + _RFC <System Alias Defined in Step 1> + _HTTPS **NOTE In this case we are using suffix _HTTPS as the system is configured to use SSL, you may use suffix _HTTP in case your system is not configured for SSL. RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 12
4 Create Custom PFCG Role Step/Description Screenshot 1. In transaction PFCG create a new Role containing the Catalog ID PFCG Menu Object: SAP Fiori Tile Catalog Catalog ID: ZEASY_ACCESS Once the Role has been created assign it to your user(s). **Note In this scenario the Catalog ID and Role Name are the same: ZEASY_ACCESS RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 13
5 Open App Finder and add new Tiles to Fiori Launchpad Step/Description Screenshot 1. Once the PFCG Role has been assigned you can access the user personalization settings from your Fiori Launchpad by clicking on the User Icon located on the upper left corner RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 14
2. In the User Personalization options you will find the App Finder icon. RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 15
3. Once you open App Finder you will notice three tabs: Catalog: Displays assigned Fiori Launchpad Catalog Content (available Fiori apps per user) User Menu: Displays available content (transactions/webdynpro) from backend system User Menu SAP Menu: Displays available content (transactions/webdynpro) from backend system SAP Menu RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 16
4. Click on the User Menu tab. You will observe the available content in the backend system User Menu Fiori Launchpad: Backend Server: **NOTE Notice that Fiori Launchpad displays all content available in the backend server User Menu RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 17
5. Click on the SAP Menu tab. You will observe the available content in the backend system SAP Menu. Fiori Launchpad: Backend Server: **NOTE Notice that Fiori Launchpad displays all content available in the backend server SAP Menu RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 18
6. Add a new tile by selecting the + symbol and selecting the group where you wish to add the tile. In this case we will add a transaction from our User Menu 7. Once the tile has been added go back to the Fiori Launchpad main screen and navigate to the group where you added the tile. RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 19
ENJOY! 8. Click on the tile. The transaction will be displayed using Belize Theme RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 20
6 Common Issues and Solutions Error Description Screenshot / Solution 1. Application does not open. In Browser console you can find the following error message: Cannot select which system alias to pick between Http/Https make sure they are provided in the given system alias collection Solution RFC s with prefix _HTTP or _HTTPS have not been created RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 21
2. A pop-up is displayed when attempting to display a WebGUI App. Solution In FES, make sure the path /sap/public/bc/its and its sub-paths are active. 3. Not all WebGUI apps are opening. In browser console you can find an error related to the lightpseed.js libraries. Solution Update Kernel as described in note 2374840 - New Unified Rendering version. This errors is most common in Apple desktops. RIG Step-by-step guide to enable Easy Access Menu in S/4HANA 1610 On-Premise P a g e 22
www.sap.com/contactsap 2015 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. The information contained herein may be changed without prior notice. 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 or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP 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. 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. All other product and service names mentioned are the trademarks of their respective companies. Please see www.sap.com/corporateen/legal/copyright/index.epx for additional trademark information and notices. Material Number: