Skip to content

51-Multi-Tenancy-Features-Tenant-Key-User-Flexibility.md

Latest commit

 

History

History
52 lines (38 loc) · 3.97 KB

51-Multi-Tenancy-Features-Tenant-Key-User-Flexibility.md

File metadata and controls

52 lines (38 loc) · 3.97 KB

Enable Key User Flexibility Using SAP Build Work Zone

Imagine you're a key user, also known as citizen user, for a customer using the poetry slam manager. You want to customize the user interface of the poetry slam manager application for all users in your company. This could be adding, hiding or rearranging fields, or renaming labels.

In SAP Build Work Zone, the SAP BTP service UI5 flexibility for key users comes included out of the box. You can enable it in a SAP Build Work Zone site to support key user adaptations for applications built with SAP Fiori elements.

Make sure you've completed the steps described in chapter Provision Your Multi-Tenant Application to Consumer Subaccounts, including the SAP Build Work Zone setup.

Configure the SAP Build Work Zone Site

Ensure that the key user adaptation is enabled in the SAP Build Work Zone site by following these steps:

  1. Open the SAP BTP cockpit of the consumer.
  2. Navigate to the Instances and Subscriptions view.
  3. Open the SAP Build Work Zone, standard edition application.
  4. In the Site Manager, open the Site Directory.
  5. Choose the gear icon of the Partner Reference Application site to access the Site Settings.
  6. Edit the Site Settings.
  7. In section Services, set the Key User Adaptation to Yes.
  8. Save your changes.

Configure Authorization Roles

To assign authorization roles to different users, use user groups from the Identity Authentication Service (IAS). For more details and setup steps, see Configure Authentication and Authorization.

To set up authorization roles for your application, follow these steps:

  1. In the Identity Authentication service, create a new user group named PoetrySlamManagerKeyUser and assign the key users to it.

    Note: An overview of the supported roles of the UI5 flexibility service for key users can be found in the SAP Help document Defining and Bundling Roles.

  2. In the SAP BTP consumer subaccount, create a new role collection named PoetrySlamKeyUserRoleCollection and add the FlexKeyUser role. The role grants key users the authorizations needed to adapt the user interface for all users of the Poetry Slam Manager.

  3. Assign the created user group PoetrySlamManagerKeyUser from the identity provider to the role collection PoetrySlamKeyUserRoleCollection.

Adapting the User Interface for all Users

After completing the steps below, the Price is shown in the Poetry Slams table of the Poetry Slam Manager for all users:

  1. Open the application Poetry Slam Manager.
  2. Open the User Action Menu by clicking on your profile.
  3. Choose Adapt UI to start the UI Adaptation.
  4. Right-click a colum of the Poetry Slams table.
  5. Choose View Settings.
  6. Select the Price column.
  7. Close the popup.
  8. Activate the new version on the top left.
  9. Enter a version title, for example Add Price to Poetry Slams List.
  10. Activate the version with title AddPrice.
  11. Publish the version.
  12. Exit the adaptation mode.
  13. In case the Price column is not visible, switch the display of the list to show all columns by selecting the Show More per Row icon.

Further examples of possible adaptations include moving and renaming UI elements and embedding external content. You can find more examples in Key User Adaptation on SAP Help Portal.

You can also find a description on how to adapt the user interface in Adapting SAP Fiori UIs at Runtime - Key User Adaptation on SAP Help Portal.