Tell us what you think

We want to create the best possible experience for our learners. Your feedback helps us to improve the experience for everyone.

Configuring Transactional Apps

Objective

After completing this lesson, you will be able to configure transactional apps

Architecture and Configuration

Figure shows a graphical outline of SAP Fiori System Landscape – Transactional Apps

The configuration of transactional apps takes place in the front-end server (FES) and back-end server (BES). It consists of two parts:

Activation of the SAPUI5 service
Registration of the SAP Gateway service

Screenshot with labels shows the Transactional App – Configuration Information

The SAP Fiori app reference library offers for every app individual configuration information for the according SAPUI5 application and OData service. This is also valid for analytical and fact sheet apps, but for these additional configuration steps are needed.

Service Activation and Registration

Screenshot from system: Filter Details pane

The SAPUI5 application is available in ABAP using a Business Server Page (BSP) as a container. Two nodes in the Internet Communication Framework (ICF) are created but only the one under ui5_ui5 is used during runtime. The only mandatory configuration step is the activation of the ICF service using transaction SICF. In general, all other configuration options are handled by the SAP Fiori launchpad.

Hint

For activating multiple ICF nodes at once, you can use the task list SAP_BASIS_ACTIVATE_ICF_NODES in transaction STC01.

Screenshot from system: SAP Gateway Service Registration

The SAP Gateway services are shipped as part of the business solution and therefore reside in the BES. To register an SAP Gateway service, you can use transaction /IWFND/MAINT_SERVICE on the FES connecting to the BES, or you can use transaction SEGW on the BES connecting to the FES. The limitation of transaction SEGW is that only one service can be activated at a time. That is because the SEGW is focused on the development and not maintenance.

During registration, multiple repository elements are created. These can be put in the local objects area of the processing administrator or it can be put in a development package. The second option needs a transport request and makes it possible to transport the registration of the Gateway service in other systems.

Hint

For registering multiple Gateway services at once, you can use the task list SAP_GATEWAY_ACTIVATE_ODATA_SERV in transaction STC01.

App Reference

In SAP S/4HANA 1809 SPS03, the SAP Fiori launchpad content manager was introduced to ease the mass-administration of catalogs. You can show the catalogs and their content, the tiles and target mappings for all catalogs, or roles and their catalogs. There are easy ways to copy complete catalogs or reference certain tiles and target mappings in other catalogs. Similar to the SAP Fiori launchpad designer, you can use the SAP Fiori launchpad content manager for configuration (transaction /UI2/FLPCM_CONF) or customizing (transaction /UI2/FLPCM_CUST).

Configure a Transactional App

Business Example

In this exercise, you will configure the transactional app View Browser.

Note

In this exercise, when an object name or value contains ##, replace ## with the number your trainer assigned to you.

Task 1: Access Configuration Details in the SAP Fiori Apps Reference Library

Steps

In the SAP Fiori apps reference library, open the configuration details for the View Browser app.
1. On the WTS, start a web browser and open https://www.sap.com/fiori-apps-library.
2. Choose All apps for SAP S/4HANA (Private Cloud and On-Premise).
3. Choose All apps.
4. In the Search field (at the top left), enter view browser and press Enter.
5. Select the View Browser app.
6. In the App Details pane, choose Implementation Information.
7. Make sure to select the details for SAP S/4HANA 2023 FPS02 (On-Premise).
8. Expand Configuration.
9. Keep this browser window open for later reference (you may copy and paste some technical names from here).

Task 2: Activate the SAPUI5 ICF Service

Steps

In your SAP S/4HANA system, activate the ICF node relevant for the View Browser app.
1. From the SAP Fiori apps reference library, you know that the relevant SAPUI5 ICF path is /sap/bc/ui5_ui5/sap/CDSBROWSERS1.
2. Log on to your SAP system using the train-## user.
3. Enter transaction SICF.
4. In the Service Name field, enter cdsbrowsers1 and choose Execute (F8).
5. Expand the ICF path /sap/bc/ui5_ui5/sap.
6. If the service /sap/bc/ui5_ui5/sap/cdsbrowsers1 is not active (indicated by a gray or blue color), perform the following steps:
  1. Right-click the service cdsbrowsers1 and choose Activate Service.
  2. In the pop-up, choose the left Yes button.

Task 3: Register the SAP Gateway Service

Steps

In your SAP S/4HANA system, register the SAP Gateway service relevant for the View Browser app.
Note
For Package Assignment, choose Local Object.
1. From the SAP Fiori apps reference library, you know that the relevant SAP Gateway service is CDSALLVIEWS.
2. Continue working in your SAP system using the train-## user.
3. Enter transaction /IWFND/MAINT_SERVICE.
4. If the service CDSALLVIEWS (note the column External Service Name) is not registered, perform the following steps:
5. Choose Add Service.
6. Right of System Alias, select Co-Deployed. In the External Service Name field, enter CDSALLVIEWS. Choose Get Services (F8).
7. Select the search result and choose Add Selected Services.
8. In this training, we choose Local Object (instead of using a customer package).
9. Keep all other fields on their default values and choose Continue (Enter).
10. To confirm the message, choose Continue (Enter).
11. Go Back.
12. Verify that a technical service with the name, ZCDSALLVIEWS, and external service name CDSALLVIEWS is listed.

Task 4: Create References

Steps

Create a reference for the View Browser tile and its target mapping in your catalog Catalog ##.
Note
Use the client-specific version of the SAP Fiori launchpad content manager.
1. From the SAP Fiori apps reference library, you know the following:
  - The App ID is F2170.
  - The relevant semantic object is CDSView.
  - The relevant action is browse.
2. Continue working in your SAP system using the train-## user.
3. Enter transaction /UI2/FLPCM_CUST.
4. Ensure that the Catalogs tab is selected.
5. Search for your catalog Z_##_BC_UX200, for example using the Search Catalogs field.
6. Select your catalog Z_##_BC_UX200.
7. Choose Show Catalog Content (in case this button active).
8. At the bottom (area Content in Catalog...), choose Add Tiles/Target Mappings → Add Tiles/TMs to Selected Catalog.
9. In the Add Tiles/Target Mappings as References to Catalog... screen, enter F2170 in the Search Tiles/Target Mappings field and choose Go.
10. Select the line for the CDSView semantic object and the browse action.
11. Choose Add Tile/TM Reference.

Task 5: Test the App

Steps

In your My Home, add the View Browser tile from your Catalog ## catalog to your favorite apps and test the app.
1. Start or reload the SAP Fiori launchpad of your SAP system in a client of your choice.
2. In your My Home, navigate to the Apps → Favorites section.
3. Choose Add Apps.
4. In the App Finder, select your catalog Catalog ## (at the left).
5. Click Add to Page "My Home" (the + sign) beneath the View Browser tile.
6. Choose Navigate to Home (the SAP logo in the upper left).
7. Use the app as you see fit.
From the View Browser app, access its App ID.
1. Continue working in the browser window with the View Browser app.
2. Choose the User Actions Menu (user icon in the upper-right corner).
3. Choose About.
4. Note the line below ID of the Application.
5. Choose OK to close the pop-up.

Configure Multiple Transactional Apps

Business Example

In this exercise, you will prepare multiple transactional apps of area Higher Education and Research (HER) using task lists for mass processing.

Prerequisites

Note

In this exercise, when an object name or value contains ##, replace ## with the number your trainer assigned to you.

Task 1: Activate the SAPUI5 ICF Services

Steps

In your SAP S/4HANA system, activate the ICF services using prepared at S:\Courses\UX200_24\Configure multiple Transactional Apps\ICF Nodes.csv using task list SAP_BASIS_ACTIVATE_ICF_NODES.
Note
The CSV file has been downloaded from the SAP Fiori apps reference library using the Aggregate feature.
Hint
In case you are missing the S: drive at the WTS level, execute the Connect Training Share script (offered as a Windows tile below Initialize Environment).
1. Log on to your SAP system using the train-## user.
2. Enter transaction STC01.
3. In the Task List field, select SAP_BASIS_ACTIVATE_ICF_NODES and choose Generate Task List Run (F8).
4. Select Execute (first column of the table) for the task the with the description Activate HTTP Services (SICF).
5. Select Fill Parameters for the task with the description Activate HTTP Services (SICF).
6. Ensure that Virtual Host is set to DEFAULT_HOST and that the Expand Flag is not selected.
7. Open the S:\Courses\UX200_24\Configure multiple Transactional Apps\ICF Nodes.csv file. Copy the content (the list of ICF services) to your clipboard.
8. Paste the content of your clipboard into the Service Path (URL) field.
9. To save your settings, choose Save and choose Back.
10. Choose Start/Resume Task List Run in Dialog (F8).

Task 2: Register the SAP Gateway Services

Steps

In your SAP S/4HANA system, register the SAP Gateway service prepared at S:\Courses\UX200_24\Configure multiple Transactional Apps\oData Services.csv using task list SAP_GATEWAY_ACTIVATE_ODATA_SERV.
Note
The CSV file has been downloaded from the SAP Fiori Apps Reference Library using the Aggregate feature.
1. Continue working in your SAP system using the train-## user.
2. Enter transaction STC01.
3. In the Task List field, select SAP_GATEWAY_ACTIVATE_ODATA_SERV and choose Generate Task List Run (F8).
4. Choose Set All Tasks in Scope (F6).
5. Select Fill Parameters for the task with the description Define OData Services for Activation.
6. In the Define OData Services popup, choose Load local file.
7. In the file select box, navigate to S:\Courses\UX200_24\Configure multiple Transactional Apps\oData Services.csv (in the file selection box, make sure to choose Files of type: All Files (*.*)) and choose Open. Choose Continue to close the Define OData Services popup.
8. Select Fill Parameters for the task with the description Select Processing Mode / System Alias for Activation.
9. In the Select Processing Mode field, select Co-deployed only. Choose Save and then Back.
10. Select Fill Parameters for the task with the description Confirm OData Services for Activation.
11. Ensure that for all OData services, the checkmark for the Activate flag is set. Choose Save and then Back.
12. Choose Start/Resume Task List Run in Dialog (F8).

Task 3: Assign the PFCG Role for the Business Catalog

Steps

In your SAP S/4HANA system, assign your train-## user to role SAP_BR_STUDENT.
1. Continue working in your SAP system using the train-## user.
2. Enter transaction PFCG.
3. Select the SAP_BR_STUDENT role using the F4 help.
4. Choose Change.
5. Select the User tab.
6. In the next free User ID field, enter train-##.
7. Choose Save.
8. Optional: Analyze the menu of role SAP_BR_STUDENT. To do so, select the Menu tab and note the assigned SAP Fiori catalog SAP_IPS_BC_HER_SSS.
9. Choose Back (F3).

Task 4: Test the Apps

Steps

Test the new tiles in the SAP Fiori launchpad of your SAP S/4HANA system.
1. Start or reload the SAP Fiori launchpad of your SAP system in a client of your choice.
2. Choose the Student Profile space.
3. Use the app as you see fit.
  Note
  You should be able to see and start all apps. However, because Higher Education and Research (HER) has not been configured, there is no meaningful data available in this training system.

Next lesson