Import and Setup Build Zone Configuration (Fiori Launchpad in BTP / Cloud)

On this page
  1. Problem
  2. Environment
  3. Solution
  4. Keywords

Problem

You want to import and set up an application in SAP Build Work Zone, Standard Edition so that it is accessible via a Launchpad tile.
You are unsure about the required trust setup, application creation steps, and how to correctly assign the app to groups, roles, and a site.

Environment

  • SAP Build Work Zone, Standard Edition
  • SAP Business Technology Platform (SAP BTP)
  • SAP Identity Authentication Service (IAS)
  • SAP Authorization and Trust Management (UAA)

Solution

1. Prerequisites: Trust and Federation Setup

Before configuring SAP Build Work Zone, trust between UAA and Identity Authentication Service (IAS) must be established.

Follow the official SAP guide:
Establish Trust and Federation Between SAP Authorization and Trust Management Service and SAP Cloud Identity Services

Key points:

  • IAS is used as the central identity provider.
  • UAA trusts IAS for authentication.
  • User groups must be available in IAS for later role and group assignment.

2. Initial Setup of SAP Build Work Zone

Complete the basic onboarding and initial setup as described in the SAP documentation:

Getting Started with SAP Build Work Zone, standard edition

This includes:

  • Subaccount configuration
  • Role assignments for administrators
  • Access to the Build Work Zone administration UI

3. Import Content via Transport ZIP (Apps, Groups, Roles, Catalog)

For easier setup, sophisTex provides an exported content transport ZIP for SAP Build Work Zone.

This ZIP already contains:

  • Applications
  • Groups
  • Demo Roles
  • Catalogs

Import Steps

  1. Open SAP Build Work Zone Administration
  2. Navigate to Content Manager
  3. Click Import
  4. Select the provided content transport ZIP file
  5. Start the import and wait until it completes successfully

After the import, the required apps, groups, roles, and catalogs are available in the system.

3.1 Configure Trusted Domains for Launchpad and Embedded App Access

SAP Build Work Zone allows applications to run embedded in the Launchpad by default,
This behavior is controlled per application via the Open App setting

The ready-to-use content transport ZIP provided by sophisTex imports applications with: Open App: In place

This means the applications are rendered embedded within the Launchpad.
To ensure embedded applications are not blocked by browser security restrictions, the Launchpad domain must be added to the Trusted Domains configuration in SAP Authorization and Trust Management (UAA).

The Launchpad domain can be derived directly from the SAP Build Work Zone URL, for example:

https://<subdomain>.launchpad.cfapps.<region>.hana.ondemand.com

Official SAP documentation:
Configure Trusted Domains for Multi-Environment Subaccounts

Add the following url:

https://*.launchpad.cfapps.<region>.hana.ondemand.com

The region (for example `eu10`) depends on where SAP Build Work Zone is deployed and may vary
(e.g. `eu10`, `us10`, `ap10`).

4. Adjust Application URL After Import

After importing the content, the application URL must be adjusted manually.

  1. Navigate to Content Manager > Select Apps and Plugins in the dropdown
  2. Open the imported applications
  3. For all applications: Replace the placeholders in the Application URL:

https://<your-cf-space>.hana.ondemand.com/<your-app-id>#/...

With:

  • <your-cf-space> is the Cloud Foundry space where the application is deployed
  • <your-app-id> is the application ID provided by sophisTex

Save the changes after updating the URL.

5. Review Demo Roles and Adjust for Your Needs

The imported content transport ZIP includes demo roles that grant access to the provided applications.

After the import, review and adapt these roles according to your requirements:

  1. Navigate to Content Manager >Select Roles in the dropdown

  2. Open the imported demo roles

  3. Review the assigned applications and catalogs

  4. Adjust the role by:

    1. Removing unused applications
    2. Adding additional applications if required
  5. Assign the adjusted role to the appropriate IAS user group

The demo roles are intended as a starting point and should be customized to match your authorization concept.

Keywords

SAP Build Work Zone, Build Work Zone Standard Edition, Content Transport, Application Import, Launchpad Configuration, SAP BTP, IAS, UAA