SAP Build Work Zone, standard edition with Multiple SaaS Applications

SAP Build Work Zone, standard edition provides a central entry point to apps from SAP Integrated Product Development and other platforms.

If you have subscribed to several SaaS applications from SAP Integrated Product Development, we recommend that you use SAP Build Work Zone, standard edition. This central service lets you tailor access to the apps from the different SaaS applications for different users. The general steps for setting up and administering SAP Build Work Zone, standard edition are explained in the SAP Build Work Zone, standard edition documentation: Initial Setup

This document provides additional guidance that is specific to setting up the service for use with SAP Integrated Product Development.

App Access

There are two scenarios for accessing the apps in SAP Integrated Product Development:
  • You use the default role collections that are provided by the Common Functions SaaS application for SAP Integrated Product Development.

  • You want to create your own role collections for accessing the apps in SAP Integrated Product Development.

Using the Default Role Collections for SAP Integrated Product Development

To make SAP Integrated Product Development apps visible on SAP Build Work Zone, standard edition and allow your users to navigate between them as needed, follow these steps:

  1. Assign the same apps that are included in the SAP Integrated Product Development default role collection to the new SAP Build Work Zone, standard edition role.

  2. Assign the SAP Build Work Zone, standard edition role to the users that need to see and use the apps. The role in SAP Build Work Zone, standard edition is the same as the SAP Integrated Product Development default role collection.

  3. Inform your users that they need to log off and on again to see the changes.

Creating Your Own Role Collections

If you want to build your own role collections, you can use them for the app access for both SAP Integrated Product Development and for SAP Build Work Zone, standard edition. Follow these steps:
  1. Create role collections in SAP Build Work Zone, standard edition. The detailed steps to follow are available here: Assign Content to a Role.

  2. Assign the roles for accessing apps in SAP Integrated Product Development. For more information, see Role Templates for SAP Integrated Product Development.

UI Integration Cards in SAP Build Work Zone, standard edition

Prerequisites

Procedure

  1. In the Channel Manager of the Site Manager of your instance of the SAP Build Work Zone, standard edition, you can find the content packages that you want to use.

    The following content packages are provided by the Insights SaaS application for SAP Integrated Product Development:
  2. Edit the content packages, activate the Automatically add all content items to subaccount toggle, and save it. This adds the roles delivered with the content package as role collections to your SAP BTP subaccount.

  3. For the packages you want to use, destinations must be mapped as described in Map Card Aliases to Destinations.

  4. Create a site. In the site settings, choose the Spaces and Pages - New Experience view mode, as explained in Site Settings. For more information, see Managing Sites.

  5. Configure your Spaces and Pages. For more information, see Manual Configuration of Spaces and Pages.

  6. Configure each card. For more information, see Business Configuration for Insights.

  7. In the table listing the available cards in Business Configuration for Insights, check which of the delivered roles with prefix ~sap.plm.ins is required for the cards you want to use. Open the site settings for your newly created site and assign the corresponding roles to the site.

  8. In the SAP BTP cockpit, go to your subaccount and open the Role Collections section within Security. Choose the matching role collections corresponding to the roles delivered with the cards, and assign your users to them.

  9. Inform your business users of the new site you have created.

Language Activation for Your Site (Optional)

If a business user wants to see texts translated in a language other than the source language that the site in the SAP Build Work Zone, standard edition was built with, you need to activate the language. This enables the user to select the language in their runtime site. For more information about how to activate languages in a site, see Translate Your Site.

Activation of In-App Help (Optional)

SAP Companion provides on-screen help to support your business users when they are using the apps for SAP Integrated Product Development.

To Activate SAP Integrated Product Development In-App Help, follow these steps:

  1. In the Site Directory, choose the site for which you want to activate the in-app help.

  2. On the Site Settings screen of the relevant site, select the SAP Companion setting.

  3. Enter the following parameters:

    Parameter

    Value

    product

    PLM_EPD

    version

    Cloud

    stateUACP

    PRODUCTION

    dataUrlUACP

    https://help.sap.com/webassistant/

    resourceUrl

    https://xray.hana.ondemand.com/xRayControls/resources/sap/dfa/help

  4. Save your settings.

Results

After activation, in the launchpad, business users can open the SAP Companion by choosing the Open Help .

In-App Help for Multiple Products

In-app help is also available at the launchpad level for SAP Build Work Zone, standard edition. If you want to use both types of help together, follow these steps to first activate the help for SAP Build Work Zone, standard edition:

  1. In the Site Directory, choose the site for which you want to activate the in-app help.

  2. On the Site Settings screen of the relevant site, select the SAP Companion setting.

  3. Enter the parameters for the SAP Build Work Zone, standard edition in-app help in the SAP Companion section. Those parameters are available here: Activating SAP Companion Content.

  4. Save your settings.

Each SaaS application for SAP Integrated Product Development that you have subscribed to has a content channel on your site. To see the in-app help for a SaaS application, you have to add the corresponding content channel as a destination in SAP BTP Cockpit. The name of the destination must match the ID of the content channel exactly as shown in your Channel Manager. For example, if you have subscribed to the Configuration Management SaaS application, you can create a destination in the following way:

Parameter

Value

Name

You enter the ID of the content channel for Configuration Management.

Type

HTTP

URL

https://help.sap.com

Proxy Type

Internet

Authentication

NoAuthentication

Additional Properties

  • Name: launchpad.wa.productId

  • Value: PLM_EPD

Additional Properties

  • Name: launchpad.wa.productVersion

  • Value: Cloud

Create a destination for each of the SaaS applications that you have subscribed to and for which you want to use the in-app help. If you also use other SAP products, create additional destinations for them. For more information, check the relevant product documentation on the SAP Help Portal.