SAP Fiori Client Guide

Online Application Plugin

(Android, iOS) Allows you to run an online web application within a Kapsel application. You can pass a remote web application URL to the plugin and it loads the content from the web server in the application's web view.

The plugin is supported for use with applications on the Android and iOS platforms.

Loading the Content from a Web Server

Another way to implement this feature is to have the Cordova webview (browser) load the content from the web server instead of including the HTML5 files as part of the app. The app detects that it is being loaded in a Cordova container and then dynamically includes cordova.js and utils.js.

User Agent Prefix

To include a prefix to the web view's user agent string, include the following text in config-xml in the application project:

<preference name="UserAgentPrefix" value=""/>

Assign the value you want to prefix in the value field.

Plugin List in HTTP Header

On iOS, the online application plugin adds a session cookie named X-CORDOVA-PLUGINS that includes a comma-separated list of the Cordova plugins. When the page starts to load, it sets a cookie for the target server that makes the header appear in each request. This can be used for feature detection by the server or the client. The values can be accessed in JavaScript via a document.cookie and can be seen when debugging using Web Inspector.

Busy Indicator Support

You can display a busy indicator when a page starts loading from the server, and hide it when the page finishes loading. This features uses the native busy indicator for the device, and centers it on the page.

To control the display on the busy indicator, include the following in config.xml:

<preference name="useBusyIndicator" value="true"/>

You can also show and hide the busy indicator from JavaScript. To show the busy indicator use:

sap.Online.showBusyIndicator();

To hide the busy indicator use:

sap.Online.hideBusyIndicator();