Transport Your Spaces and Pages Configurations in the SAP S/4HANA Cloud 3-System Landscape Systems
In my previous blog on How to Use Spaces and Pages in SAP S/4HANA Cloud, Public Edition, I explained the details on creating spaces and pages in a Development System – Customizing Tenant. In this blog, I will explain how you are going to deliver (it is called transports in the SAP universe) this same configuration to other systems in the 3-System Landscape, namely the Test System and the Production System.
First things first, we need to do a quick highlight on the transport mechanism, as it is a vehicle to deliver all contents (development, customizing and extensibility) in the 3-System Landscape.
Transport Mechanism in the SAP S/4HANA Cloud 3-System Landscape Systems
From Release 2208, the SAP S/4HANA Cloud solution has a 3-System Landscape, involving Development, Test and Production Systems, on top of a temporary Starter System (for customers to conduct a fit-to-standard workshop). A sophisticated content transport management mechanism is available, and documented in 3-System Landscape and Transport Management on the SAP Help Portal.
The content movement starts from the SAP Central Business Configuration (CBC) and ends at the Production System. In the CBC, business users configure their business processes, and deploy them to the Development System. With its own development and configuration activities, the Development System generates a rich content including business processes, ABAP development objects, configurations, and key user extensibilities and deposit in a repository. Users can pick and choose which content to be added on to a specific Software Collection to be exported to the Test and Production Systems.
The vehicle to transmit these contents is called transport (as a noun), from the Development System, to the Test System and the Production System.
Corresponding to the Development System, the Test System imports the transport contents. Subsequently, it forwards the content to the Production System to be imported from. The content in the transports can be edited and re-exported and re-imported to reflect the changes of the business.
The SAP Fiori Launchpad Spaces and Pages topic belongs to the Key User Extensibility category. Therefore, we use the Customizing Tenant of the Development System to create/edit Spaces and Pages along with the Business User Roles. The changes made during this creation and editing are handled by the Extensibility transports, and managed with Export Software Collection Fiori App.
Create a New Transport to Deliver the New Space and Pages Configuration
First, let’s go to Maintain Business User Roles Fiori App, and create an Accounts Receivable Manager user role Z_BR_AR_MANAGER by copying it from a SAP standard template BR_AR _MANAGER.
Since this is a copy from a SAP template, there is already one space ZBR_AR_MANAGER assigned to it. Let’s take this default setting.
By taking a closer look at this space, we notice there are three pages assigned to it, and take a note for our later usage.
Now let’s go to Export Software Collection Fiori App. Currently there are only two Software Collections. None of them is associated with the Accounts Receivable Manager role. So, we need to manually create a new Software Collection.
To create a new Software Collection, you click on the “+” icon. The new Software Collection can be called “Z_SP_AR_MGR”, standing for “spaces and pages for accounts receivable manager” for easy reorganization purpose.
To add the right content into this Software Collection, click on the Add Items icon. In the filter Type, select 3 types to filter out all irrelevant items: Business Role, SAP Fiori Launchpad Pages and SAP Fiori Launchpad Spaces. Then hit the Go button.
By first glance, we immediately noticed two items to select:
- Accounts Receivable Manager, Business Role
- Accounts Receivable Manager, SAP Fiori Launchpad Spaces
However, don’t forget about the three pages assigned to this space. This time, we set the filter type to “SAP Fiori Launchpad Pages” only, and make sure all three pages are selected. By adding another filter type “Last Changed On”, I can easily find three pages I am looking for.
Now we completed adding five items to my Software Collection Z_SP_AR_MGR.
Before exporting this Software Collection, clicking on the Check –> All Items button to make sure everything is right. The Check result is displayed in the Log tab.
Finally, clicking on Export -> All Items button to release this Software Collection to the Test System for importing. At this moment, you will get another confirmation window before hitting the final Export button.
The Software Collection Export takes some time, depending on the content size. It took 10 sec for this simple software collection. After the export is done, an export log becomes available.
Import a Transport with the New Spaces and Pages Configuration
After a successful export of the Software Collection, we can expect it to be available for importing on the Test System.
Open the Import Collection Fiori App. Enter “Z_SP*” in the Search area, then click the Go button. The Software Collection Z_SP_AR_MGR is shown. Since this software collection falls into the Key User Extensibility category, it has a Low Risk.
After clicking on the “>” icon on the righthand side, the content of this Software Collection is displayed.
By clicking on the Import button, it validates the content. Now we are entering the final import step.
After the Import started, its status is displayed, from Importing to Imported.
The importing process keeps a good log for tracking purpose. For example, by clicking on Notes (1) tab, we can see who and when this Software Collection was imported.
Use the Newly Imported User Role and Its Space and Pages in the Test System
After the above user role and its associated space and pages are imported into the Test System, we can assign the users to this role.
Opening Maintain Business Roles Fiori App, clicking on Assigned Business Users (0) tab. A popup message shows up to remind the administrator that this user role was imported. If new version of the role is imported later, the changes to this role within the Test System will be overwritten by the originator system, i.e., the Development System. Clicking the OK button to acknowledge it.
Assigning business user George to this newly imported business role. Hit the Save button.
Now logon to the Test System as George, we can clearly see the Space Accounts Receivable and its subsequent three pages available.
After verifying this Software Collection’s accuracy, don’t forget to Forward it to the Production System.
Note: About naming conventions for spaces and pages, please refer to my blog Naming and Tracking Your Business Roles, Spaces and Pages in the SAP S/4HANA Cloud 3-System Landscape Systems.
(Updated on February 6, 2023)