Everything You Need to Know About Configuring the Fiori Launchpad

Your first step in configuring the Fiori Launchpad is to assign yourself the role required to work with the Portal Service. The Portal Service is simply the UI which allows you to configure the Fiori Launchpad to display your built UI5 applications. To assign your user the correct role:

• Navigate to us1.hana.ondemand.com (or the specified HANA server instance you’re using).
• Go into the “security” tab.
• Click “Authorizations.”
• Type in your user’s S-number (or P-Number if your system is configured with the Identity Provider).
• Select “Assign Role.”
• In the popovers you can select the “account”, the “application” and the “role.”

The Role is different for all configurations, but choose these values for the account and role fields.

Account = Portal

Application = nwx

Role = TENANT_ADMIN

Adding permissions to configure the Fiori launchpadWith those two entered and a value for the role selected, your user should now have the necessary permissions for configuring the Fiori Launchpad. 

To create your site entry:

• Go into your services tab and click “Portal.”
• Click the blue link “Go to Service.” You should be directed to your homepage which shows a couple of graphs and charts.
• Click “Site Directory” on the left side of the page to navigate to a list of your Launchpad sites (if you have created any).
• If your site list is empty, simply click the + mark, choose your site alias name, and select the default layout.

Next, you will need to add in a code snippet in the index.html file of your HTML5 applications so that Fiori can reference your app location. To find your HTML5 applications:

• Go to the root of the Hana Cloud Platform.
• Navigate to Applications > HTML5 Applications.
• Using the snippet below, replace the “your ID here” with the id field found in the first few lines of your manifest.json, and paste the whole thing into a section of your index.html.
• If your site list is empty, simply click the + mark, choose your site alias name, and select the default layout.

To deploy the app:

• Navigate back to the folder structure (still in Web IDE) and right click on the main folder.
• Click “Deploy.”
• Click “Deploy to SAP Cloud Platform.”

If you click “Register to Fiori Launchpad” instead, there can be issues where a separate app entry is created in the portal service, one which might not have the necessary metadata required to launch correctly from the Launchpad. Additionally, deploying the app in this way can lead to multiple versions appearing in the Fiori Launchpad, when you only intended on having one current version.