External Content Properties - Revision history

Ollvihe at 14:23, 17 April 2019

2019-04-17T14:23:42Z

2018-12-07T15:25:25Z

Web browser security considerations

2018-12-07T15:24:37Z

2018-12-07T15:24:21Z

Passing Context Variables in url

2018-12-07T15:24:11Z

2018-04-26T19:20:57Z

Accessing Context Variables in the External Webpage

2018-04-26T19:18:12Z

Accessing Context Variables in the External Webpage

2018-02-09T22:01:40Z

Passing effective context in the url

2018-02-09T22:00:40Z

Accessing Context Variables in the External Webpage

2018-02-09T22:00:29Z

Accessing Context Variables in the External Webpage

← Older revision		Revision as of 14:23, 17 April 2019
Line 1:		Line 1:
−	External Content presentation object can be used to show content from other ~~websites~~ in QPR UI~~. The External Content presentation object uses html's ''iframe'' element to embed the~~ content. One usecase for the External Content presentation object is that it enables integrating multiple web applications into a single UI.	+	External Content presentation object can be used to show content from other webpages in QPR UI, such as from Microsoft Sharepoint or other content management systems. One usecase for the External Content presentation object is that it enables integrating multiple web applications into a single UI.
		+
		+	The External Content presentation object uses html ''iframe'' element to embed the content.

	== Properties Tab ==		== Properties Tab ==

@@ Line 25: / Line 25: @@
 There is a test page available in the QPR UI where the functioning of changing variables can be tested: '''/ui/examples/test.html'''.
-== Web browser security considerations ==
+== 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).
 {{MDBTutorialExternalContent}}
 [[Category: QPR UI]]

@@ Line 6: / Line 6: @@
 * '''Description''': Description for the External Content presentation object.
 * '''External Content URL''': The URL of the external page you want to embed in QPR UI. 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 UI.
 == Passing Context Variables in Url==
@@ Line 24: / Line 19: @@
+}
 </pre>
 == Web browser security considerations ==

@@ Line 12: / Line 12: @@
 There is a test page available in the QPR UI where the functioning of changing variables can be tested: '''/ui/examples/test.html'''.
-== Passing Context Variables in url==
+== Passing Context Variables in Url==
 You can pass context variable values in the iframe url using the [[Variable_Tag_in_QPR_UI|variable tags]]. Example:

@@ Line 1: / Line 1: @@
-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.
+External Content presentation object can be used to show content from other websites in QPR UI. The External Content presentation object uses html's ''iframe'' element to embed the content. One usecase for the External Content presentation object is that it enables integrating multiple web applications into a single UI.
 == Properties Tab ==
@@ Line 12: / Line 12: @@
 There is a test page available in the QPR UI where the functioning of changing variables can be tested: '''/ui/examples/test.html'''.
-== Passing effective context in the url==
+== Passing Context Variables in url==
-To access the external presentation object's effective context, you can pass context variable values in the iFrame url using the '''<#variableName>''' syntax. Example:
+You can pass context variable values in the iframe url using the [[Variable_Tag_in_QPR_UI|variable tags]]. Example:
 '''<nowiki>http(s)://SERVERNAME/ExternalPresentationObjects/ExternalPresentationObject1#variable1=<#variable1>&variable2=<#variable2></nowiki>'''

@@ Line 8: / Line 8: @@
 == Accessing Context Variables in the External Webpage ==
-See [[HTML Properties#Setting Context Variables in JavaScript|Using setSessionVariable function in HTML code]].
+See the [[HTML Properties#Setting Context Variables in JavaScript|setSessionVariable function]] that can be called to change context variables in the external webpage. Note that the external webpage must be linked using the same server name and port as QPR UI, so that these JavaScript functions can be called. This is because of web browsers security features ([https://en.wikipedia.org/wiki/Same-origin_policy same origin policy]).
-The external webpage must be referenced using the same server name and port as QPR UI, so that these javascript functions can be called. This is because of web browsers security features ([https://en.wikipedia.org/wiki/Same-origin_policy same origin policy]).
+There is a test page available in the QPR UI where the functioning of changing variables can be tested: '''/ui/examples/test.html'''.
 == Passing effective context in the url==

@@ Line 17: / Line 17: @@
 == Passing effective context in the url==
-To access the external presentation object's effective context, you can pass context variable values in the iFrame url using the '''{#variableName}''' syntax. Example:
+To access the external presentation object's effective context, you can pass context variable values in the iFrame url using the '''<#variableName>''' syntax. Example:
-'''<nowiki>http(s)://SERVERNAME/ExternalPresentationObjects/ExternalPresentationObject1#variable1={#variable1}&variable2={#variable2}</nowiki>'''
+'''<nowiki>http(s)://SERVERNAME/ExternalPresentationObjects/ExternalPresentationObject1#variable1=<#variable1>&variable2=<#variable2></nowiki>'''
 If the variable references appear after the hash mark (#), the external web page is not refreshed when the context variables values change. In the external web page, url changes can be monitored through '''onhashchange''' javascript event of the '''window''' object. The following example registers a function that is called when the url changes: