Skip to Content

Integrate Your UI Integration Card from the Content Package Into Your Site

Integrate a card from your content package into your SAP Build Work Zone, standard edition site.
You will learn
  • How to integrate the UI integration card that you created
LindsayBertLindsay BertAugust 21, 2024
Created by
LindsayBert
July 7, 2024
Contributors
LindsayBert

Prerequisites

  • You’ve created a content pakage that includes a UI integration card with its associated role
  • You’ve successfully deployed the card into a ZIP file and downloaded it on to your computer
  • You have a subscription to SAP Build Work Zone, standard edition

In this tutorial, you’ll learn how to integrate the card and role from the content package that you created in SAP Business Application Studio.

  • Step 1

    From the SAP BTP cockpit, go to Instances and Subscriptions and click SAP Build Work Zone, standard edition to open the service.

    Access Work Zone

    The Site Directory opens.

    Open Site Directory
  • Step 2
    1. Click the Channel Manager icon in the side navigation panel to open it.

      Open Channel Manager
    2. Click + New and select Content Package.

      New content package
    3. In the New Content Package dialog box, browse for and select the ZIP file that you downloaded in the previous tutorial. You’ll find the ZIP file in your Downloads folder on your computer.

      Browse for ZIP file
    4. In the Runtime Destination field, select ES5, and leave the default values in the other fields. Click Save.

      Save content package

      Once you’ve saved the content package properties, the ZIP file is created in the Channel Manager.

    5. Click Report to check the content of the package. It should look like this showing that your content package includes a role and an app:

      Create report
    6. Ensure that the app is assigned to the ContentPackageRole by opening the Content Manager and searching for this role. In the role editor, under the Apps tab, you’ll see the Products by Category Card.

      View card in the role editor
  • Step 3

    In this step, you’ll add a header to your page for the card that you will add.

    1. Go back to the Content Manager by using the breadcrumbs above.

      Back to Site Manager
    2. Click the Overview page to open the page editor.

      Open Overview page
    3. Click Edit.

    4. Click + to add a new secion.

      Name section
    5. In the Section Title field, type My Cards

      Name section
    6. Click Add Widget

      Add widget
    7. Select Cards.

      Select card
    8. Select the Products by Category Card to add it to your Overview page and then click Save.

      Select card

      Your screen will look like this. Don’t worry the content will appear on the card once you do the necessary role assignments.

      !– border –>

      Design time view

  • Step 4

    The ContentPackageRole is part of the content in the content package ZIP file. You now have to assign the ContentPackageRole to your site and you will also need to assign your user to this role in the next step.

    1. Open the Site Directory.

      Open Site Directory
    2. Open the Site Settings screen.

      Open Site Settings
    3. Click Edit.

    4. In the Assignments panel, click inside the search box to open a list of available roles. You’ll see the ContentPackageRole. Assign it to the site by clicking the + next to the role name and then click Save.

      Assign role to site
  • Step 5
    1. Go back to the SAP BTP Cockpit using the Instances and Subscriptions tab in your browser.

      Go to BTP Cockpit
    2. From the side menu, go to Security –> Role Collections and search for the ContentPackageRole role.

      ContentPackage role
    3. Click the arrow at the far right of the row displaying the ContentPackageRole.

      Open role collection details
    4. In the screen that opens, click Edit.

      Edit role collection
    5. In the Users section of the screen, add your ID (your email), and then your email again and add it to the list of users by clicking the + button. Save your changes.

      Add User

      Note that assignment to the role can take time. If you don’t want to wait, you can log out and log in again in order for the role assignment to take effect.

  • Step 6
    1. Still in the SAP BTP cockpit, click Instances and Subscriptions and go to SAP Build Work Zone, standard addition. The Site Directory is in focus.

    2. Click the Go to site icon.

      Go to site
    3. You’ll see that your card has been added to the Overview page:

      Final view
Back to top