External Content Properties

With the External Content presentation object you can show content from some other website or web portal. The External Content presentation object uses html's iframe element to embed the websites. Using the External Content presentation object enables integrating multiple Web applications into a single UI.

Properties Tab

The following properties can be set on the Properties tab:

• Name: Name of the External Content presentation object.
• Description: Description for the External Content presentation object.
• External Content URL: The URL of the external page you want to embed in QPR MobileDashboard. You can also use a relative path (e.g. "/examples/test.html"), if the page you want to embed is accessible by the same protocol, host, and port as QPR MobileDashboard.

Accessing context variables in external content webpages

Context variables in the session context can be get and set in the external content webpage using the getSessionVariable(variableName) and setSessionVariable(variableName, variableValue) javascript function. Following code example demonstrates how the context variables can be set and get though window.parent:

window.parent.setSessionVariable("variable1", "value1");
var variable1 = window.parent.getSessionVariable("variable1");

Context variable values must be strings.

There is also a text page available in QPR MobileDashboard installation where the functioning of the variables can be tested: http(s)://SERVERNAME:8080/mobiledash/examples/test.html

Note that these functions read only the session context - not the external presentation object's effective context. To access the effective context, you can pass context variable names in the iFrame url. If the variables are after the hashtag (#) sign, the whole external web page is not updated. Url changes can be monitored through onhashchange event in the window object. Example

window.parent.setSessionVariable("variable1", "value1");
var variable1 = window.parent.getSessionVariable("variable1");

window.onhashchange = function() {

 var iFrameUrl = window.location.href;
 var listOfParameters = iFrameUrl.substr(iFrameUrl.indexOf("#") + 1));

}

Web browser security considerations

Some websites prevent themselves to be embedded into other websites using iFrame. In those cases, the external content presentation object will be left blank (in Chrome and Firefox) or there may be an error message "This content cannot be displayed in a frame" (in Internet Explorer). The way to workaround the issue is to have X-Frame-Options HTTP response header changed in the embedded website (more information: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options).

Usage Example

1. Click the External Content presentation object icon.
2. Click the Properties button on the presentation object to open its properties.
   
3. Define the Name, Description, and the External content URL. In the Name and URL fields, you can use context variables by typing in the context variable name in the format "{#contextvariablename}".
4. After defining these properties, click Close. The web page should now be visible: