Running an Application Standalone

Applications that support standalone mode can be run directly by specifying the SAPUI5 component of the application in the URL, without configuring a target mapping and catalog and assigning the catalog to relevant users on an ABAP-based front-end server. You can also configure the header bar of a standalone application to hide some of the UI elements provided by the shell, or not to display the header bar at all.

To run an application in standalone mode, use the intent Shell-runStandaloneApp with parameters specifying the SAPUI5 component and the URL of the application. Use the following parameters:

Parameter	Description
`sap-ushell-SAPUI5.Component`	The name of the SAPUI5 component, including its namespace. For example: `cus.crm.opportunity`
`sap-ushell-url`	A URL pointing to the location, on the server, of the application's resource file. For example: `/sap/bc/ui5_ui5/sap/crm_opprtnty`

Tip If you only have the location of the SAPUI5 component (typically a BSP) on the server, you can look up the component name in the Component.js file in that location. For more information, see Identifying the Component Name.

Optionally, you can append additional intent parameters for the application.

All parameters described above must be intent parameters of the Shell-runStandaloneApp intent (and not regular URL/query parameters). They must therefore be written after the hash sign.

http://<server>:<port>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html?sap-client=<client>#Shell-runStandaloneApp?sap-ushell-SAPUI5.Component=<ComponentName>&sap-ushell-url=<Encoded-URL>&<AdditionalApplicationParameterKey>=<AdditionalApplicationParameterValue>

To work correctly, this URL needs to be encoded as described below.

Encoding the URL

For the URL to work correctly, certain characters in the intent need to be encoded. To construct a URL for calling a standalone application, you need to double encode the intent part of the URL, as shown in the following JavaScript code example:

encodeURI("#Shell-runStandaloneApp"
        + "?" + "sap-ushell-SAPUI5.Component=" + encodeURIComponent("cus.crm.opportunity")
        + "&" + "sap-ushell-url=" + encodeURIComponent("/sap/bc/ui5_ui5/sap/crm_opprtnty")
        + "&" + "AccountId=" + encodeURIComponent("123")
        + "&" + "ContactId=" + encodeURIComponent("abc"))

Example

The following example shows a URL that calls an application in standalone mode:

http://<server>:<port>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html?sap-client=123#Shell-runStandaloneApp?sap-ushell-SAPUI5.Component=cus.crm.opportunity&sap-ushell-url=%252Fsap%252Fbc%252Fui5_ui5%252Fsap%252Fcrm_opprtnty&AccountId=123&ContactId=abc

Configuring the Header Bar

When running an application in standalone mode, you should also configure the header bar to hide some of the UI elements provided by the shell, or not to display at all. You do this in the URL, using the sap-ushell-config URL parameter with one of the following values:

Parameter Value	Description	Navigate to
`standalone`	Displays only the logo and the options area, including the user photo (or avatar) and user name. The Options menu contains only the following default menu items: Contact Support and About.	Application only
`embedded`	Displays only the avatar icon, which opens the Options menu. The Options menu contains only the following default menu items: Contact Support and About.	Application only
`headerless`	Does not display a header bar. When navigating to the launchpad, it is not possible to personalize the home page. This means that you cannot move or remove tiles.	Application or launchpad

Note When running an application in standalone mode, the Save as Tile option in the footer bar of an application is disabled.

You add the sap-ushell-config parameter before the hash sign.

This parameter is intended for hosting an app, for example, in SAP Enterprise Portal.

Example

The following example shows a URL that calls an application in standalone mode, with no header:

http://<server>:<port>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html?sap-client=123&sap-ushell-config=headerless#Shell-runStandaloneApp?sap-ushell-SAPUI5.Component=cus.crm.opportunity&sap-ushell-url=%252Fsap%252Fbc%252Fui5_ui5%252Fsap%252Fcrm_opprtnty&AccountId=123&ContactId=abc

Which Applications Support Standalone Mode?

For a list of standard SAP Fiori apps that support standalone mode, see SAP note 2103156 Information published on SAP site .

Limitations

When running an application standalone, navigation from this application to other applications is not supported.

If you would like to embed a standalone application into another user interface using an iFrame, consider the same-origin policy. For more information, see Security Aspects for Standalone Applications.