How to configure the SAP Fiori Apps for SAP Application Interface Framework
With SAP S/4HANA 2021, we have shipped another two message monitors in SAP Fiori UX technology that you can access from your SAP Fiori launchpad. Besides the Message Monitoring that we have supported since SAP S/4HANA 2020, we now also provide the Message Monitoring for Integration Experts and the Message Monitoring for Administrators. Latter two contain more technical information compared to the former monitor which is more suited for the line of business users.
For a complete list of all monitors in SAP Fiori, check out the SAP Fiori Apps for Message Monitoring documentation.
This blog is not intended to describe the new monitors in detail, I most likely do this in a separate blog, here I rather like to show you how to configure the SAP Application Interface Framework (AIF) monitors in the SAP Fiori launchpad.
SAP Fiori Apps Reference Library
As a starting point, go to the SAP Fiori Apps Reference Library. Here, you actually find all relevant information about important SAP notes, installation, configuration, and support.
In the SAP Fiori Apps Reference Library, simply search for Application Interface Framework. This will show you the required information for the above mentioned monitoring apps.
- The Overview Message Monitoring app refers to the overview page of the Message Monitoring for business users which shows you the status of all your interfaces in a tile layout.
- The Message Monitoring app is the one that you navigate to from the Overview Message Monitor, see the blog SAP Fiori UX monitor with SAP S/4HANA 2020 shipment.
- The Message Monitoring for Integration Experts app actually covers both the one for Integration Experts and the one for Administrators. The monitors as such are the same anyway, they only differ in their respective overview pages.
Activate ICF services
As described in the SAP Fiori Apps Reference Library, you need to ensure that the ICF services for the following SAPUI5 applications are activated on the front-end server:
Run transaction code SICF (Define Services), navigate to the respective nodes, and activate the above mentioned services if not already active.
Publish OData service groups
Run transaction code /IWFND/V4_ADMIN (SAP Gateway Service Administration), and publish the following OData V4 service groups on the front-end server:
Maintain authorization role
You need an authorization role to run the SAP Fiori launchpad as an end user. The configuration steps are described in Configuring Roles with Launchpad Start Authorizations. I followed a bit different approach which actually worked for me, see also Setup of Roles.
So, copy the role SAP_FLP_USER to your own custom role.
On the Authorization tab, generated an authorization profile. Then, below Edit Authorization Data and Generate Profiles section, click the Change Authorization Data button.
In the Change Role: Authorizations screen, select menu Edit –> Insert authorization(s) –> From template…
Select template /IWFND/RT_GW_USER, and click OK. This is required for accessing the Gateway.
For the nodes with missing values (yellow status) set authorization fields to full authorization. Then, generate the profile.
Finally, save the role and assign the role to your user.
Maintain role menu
Next, you need to create a new role and maintain its role menu.
Run transaction code PFCG (Role Maintenance), and create a new single role.
First, let’s select the launchpad group. In the new role, switch to the Menu tab, open the drop down menu of the Transaction button, and select the menu item SAP Fiori Launchpad –> Launchpad Group.
In the upcoming dialog, enter Group ID SAP_CA_BCG_COM_MM (Message Monitoring), and click OK.
Next, you need to add the following business catalogs:
Select the menu item SAP Fiori Launchpad –> Launchpad Catalog.
In the upcoming dialog, enter the Catalog ID, here SAP_CA_BC_COM_ERR, and click OK.
Do the same for the rest of the catalogs listed above. When done, your menu should look as follows:
Note: Usually you wouldn’t assign all catalogs to the same role. You would rather create different roles for the different personas, i.e., the business user, the integration expert, and the administrator. In my blog however, I just keep it simple, and assign all catalogs to the same role.
The following Catalog/App assignment should actually help you to create the proper roles:
- Message Monitoring and Error Handling (SAP_CA_BC_COM_ERR)
- Message Monitoring Overview
- Message Monitoring
- Message Monitoring for Integration Experts
- Message Monitoring and Error Handling for Operation (SAP_CA_BC_COM_OP_ERR)
- Message Monitoring for Administrators
- Message Monitoring Configuration (SAP_CA_BC_COM_CONF)
- Assign Recipients to Users
- Message Monitoring and Extended Error Handling (SAP_CA_BC_COM_EXT_ERR)
- Configure Value Mapping
- Message Dashboard
Once done with maintaining the role menu, switch to tab User, and assign your user(s) to the role.
Adjust SAP Fiori Launchpad home page
Open the SAP Fiori Launchpad, your home page should now look as follows. You should see the business group Message Monitoring and a couple of apps that are assigned to the business group by default. Some apps can be removed from here, the two new monitors are actually missing and need to be added. As mentioned above, I will simply add all the Fiori message monitors to the user’s home page. If you have created different roles for the different personas, you would only be able to add the monitor that corresponds to your role.
From the drop down menu of your profile, select the Edit Home Page entry to switch to the edit mode.
First, we will remove the apps that are not required. We actually remove the Message Monitoring app and the Message Dashboard for the following reasons.
Usually, you navigate to the Message Monitoring from the Message Monitoring Overview by selecting a particular interface. The Message Monitoring cannot show messages for more than one interface and so it doesn’t make sense to directly call the Message Monitoring without having selected an interface before. For this reason, it will be redirected to the Message Monitoring Overview anyway.
The Message Dashboard is not a Fiori app, it’s actually a Web Dynpro UI of the interface monitor. For sure, if you prefer this monitor, you can keep it in. Since I focus here on the new Fiori apps only, I just remove it.
For the apps that should be removed, click on the Remove sign in the upper right corner of the respective app tile.
Once done, let’s add the two new apps. Click on the Plus sign as shown in the screenshot below.
Select the Message Monitoring and Error Handling catalog, and select the pin of the Message Monitoring for Integration Experts app to add the monitor to the Message Monitoring group.
Select the Message Monitoring and Error Handling for Operation catalog, and select the pin of the Message Monitoring for Administrators app to add the monitor to the Message Monitoring group.
Finally, let’s rearrange the apps via drag & drop.
Close the editor by clicking on the Close button on the bottom right.
Your home page should now look as follows.
I hope this blog helps you to setup the monitors in your system. Stay tuned, as said I plan to publish a blog describing the two new monitors in detail. Furthermore, I am currently preparing a couple of AIF example scenarios in the upcoming new SAP S/4HANA Fully-Activated Appliance on Cloud Appliance Library, see details about the CAL solution in this blog. In the new planned solution, I also have setup the Fiori apps. I will let you know once the new CAL solution has been published.