Skip to Content

Integrate Your SAP Fiori Elements App into SAP Build Work Zone, standard edition

Add an SAP Fiori elements app to a site in SAP Build Work Zone, standard edition.
You will learn
  • How to create a new site in SAP Build Work Zone, standard edition
  • How to add a deployed SAP Fiori elements app to the site
nicoschoenteichNico SchoenteichFebruary 6, 2023
Created by
IObert
June 8, 2021
Contributors
maximilianone
IObert
nicoschoenteich

Prerequisites

  • You’ve deployed your SAP Fiori elements app (including the navigation properties) to SAP BTP, Cloud Foundry environment.

Once you’ve deployed your SAPUI5 app to SAP BTP, it becomes available to add to your site in SAP Build Work Zone, standard edition.

  • Step 1
    1. Open the SAP BTP Cockpit.

    2. In the side navigation panel of your subaccount, click Instances and Subscriptions, and then from the Subscriptions tab, click SAP Build Work Zone, standard edition and the Go to Application icon.

      The Site Manager opens with the Site Directory in focus. From here, you’ll create your new site.

      Note: In the side panel of the SAP Build Work Zone, standard edition, you’ll see four tools. You can see all existing sites in the Site Directory. This is also where you can create new sites. The Content Manager is where you’ll manage cross-site content such as business apps. And the Provider Manager helps you to manage content providers. Content providers expose business content that you can integrate into your sites. The fourth icon opens Settings to configure various settings related to the SAP Build Work Zone, standard edition.

    3. Click Create Site.

      Create site
    4. Enter hana-cloud-apps as the site name and click Create.

      Name site
    Log in to complete tutorial
  • Step 2

    When you create a site, you are directed to the Site Settings screen, where you can edit the site settings and assign a site to a specific user role.

    Navigate back to the Site Directory to view the site tile.

    Navigate to site directory

    Your site is empty for now. In the following steps, you’re going to add business apps to your site.

    Log in to complete tutorial
  • Step 3
    1. Click the Provider Manager icon to view any available content providers. In there, click the Fetch updated content icon the HTML5 Apps content provider.

      The HTML5 Apps content provider is created automatically. Any app that you deploy to SAP BTP is automatically added as content to this provider.

      Select the HTML5 Provider
    2. Note that you’ll see a “Content is being updated” message. Wait until this message disappears again before you continue with the next step.

      Fetch updated content

    The HTML5 Apps content provider should now expose any newly deployed app for integration.

    Log in to complete tutorial
  • Step 4
    1. Click the Content Manager icon in the side panel to open the Content Manager. Click the Content Explorer tab to explore content from the available content providers and select the HTML5 Apps provider.

      The Content Manager has two tabs: You can manually configure content items and view any other available content items in My Content. And the Content Explorer is where you can explore exposed content from available content providers, select the content, and add it to your own content.

      Select the HTML5 tile
    2. You’ll see that your List Report app that you’ve just created in SAP Business Application Studio already exists in this provider. Select it and click + Add to My Content.

      Add app to My Content
    3. Click the My Content tab.

      Click My Content

      Note that your List Report app is in the list of content items.

    Log in to complete tutorial
  • Step 5

    In this step, you’ll create a new group and assign the List Report app to it.

    A group is a set of one or more apps displayed together on a launchpad site. Assigning apps to groups makes them visible to the user.

    1. Click + New in the Content Manager and select Group to create a new group.

      Add new group
    2. Enter Default as the Title and in the Assignments panel on the right, click in the search box to see a list of apps.

      If you have many apps, you can type some letters of your app name in the search field (for example, List) to search for the app.

    3. Next to the List Report app, click the + icon to assign your app to this group.

      You’ll see that the icon changes.

    4. Click Save.

      Save
    5. You now see that the app has been added to the group. Go back to the start page of the content manager.

      Done
    Log in to complete tutorial
  • Step 6

    In this step, you’ll assign the List Report app to the Everyone role. This is a default role - content assigned to the Everyone role is visible to all users.

    1. Click the Everyone role to open the role editor.

      Everyone role
    2. Click Edit.

    3. Click the search box in the Assignments panel on the right. Any available apps are shown in the list below. Click the + icon next to the List Report app, and confirm with Save.

      Edit role
    4. Similar to in the last step, you should see that the app has been added to the role.

    Log in to complete tutorial
  • Step 7
    1. Click the Site Directory icon to open the Site Directory and click Go to site on the site tile.

      Open site

      You’ll see all the apps that you have added to your site. In the Default group, you’ll see the Show Items app that we’ve just created. This looks similar to what you’ve seen in the previous tutorial, but this time the app runs in a production-ready site of SAP Build Work Zone, standard edition. You can see the difference when you look at the top-right corner; you can find the initials of your user there.

      See all apps
    2. Click the app to launch it and to display all columns.

      View app
    Log in to complete tutorial
  • Step 8
    1. Display all available data items.

      See all apps

      Note that your might see no records if you didn’t explicitly fill the HDI container that is used for this deployment.

    2. Apply a new filter to display only items with the German language code DE

      applied-filter
    3. Click on the ˅ button and click Save As to save the current filter settings.

      applied-filter
    4. You can use any name (for example, GermanItem) for this view. Make sure to check both boxes before you confirm with Save.

      named view
    5. Open the page in an incognito tab and log in with the same user. You’ll notice that you see the same view, which means that it has been successfully persisted in the backend.

      saved-view

    Congratulations! You have successfully embedded and tested the SAP Fiori elements in your SAP Build Work Zone, standard edition site. On top of that, you’ve used a SAPUI5 Flexibility feature to persist custom filter views in the backend.

    Copy the URL of the newly created site from the site settings and paste it below.

    Log in to complete tutorial
Back to top