Accessing Embedded Reports on Different Domains
When an embedded report is hosted on a server in a different domain, you
can't directly access a its DOM elements and JavaScript functions due to
iFrame cross-domain access policy restrictions. However, the
EmbeddedReporting object provides functionality to get around those
restrictions, using these methods:
execEmbeddedFunction(functionName, arg1, arg2, ...argN, callback)
Executes a JavaScript function in an embedded report and returns its
execution result.
Our example Logi app contains a report definition named
EmbeddedReports.Elements and it includes this JavaScript function:
- function SayHello(firstName, secondName) {
- var hello = "Hi " + firstName + " " + secondName + "!"
- return hello;
- }
We can use the execEmbeddedFunction method to remotely execute this
function and then we can display its results locally.
1. Embed the report using HTML markup:
- <div id="div7" class="divFrame" data-applicationUrl="https://sampleapps.logianalytics.com/logiapp" data-report="EmbeddedReports.Elements" data-autoSizing="height"></div>
and here's the report:
2. Enter values for arg1 and arg2 on the current HTML page to send to the
report's function, and click Execute:
Here's the supporting JavaScript included in the current HTML page and called when you click Execute:
- function runEmbeddedFunction() {
- var funcName = document.getElementById('inpExecuteThis').value;
- var args1 = document.getElementById('inpArg1').value;
- var args2 = document.getElementById('inpArg2').value;
- var callback = document.getElementById('inpCallbackTo').value;
- var report = EmbeddedReporting.get('div7');
- report.execEmbeddedFunction(funcName, args1, args2, callback);
- }
- function showResults(result) {
- alert(JSON.stringify(result, null, 2));
- }
getElementAttribute(selector, attributeName, callback)
Returns an object with two properties:
elements and
values. The elements property contains
a list of elements, which matched the search query. The values property
contains a list of attribute values. The
selector argument should represent a
valid CSS ID selector string.
1. Embed the report using HTML markup:
- <div id="div8" class="divFrame" data-applicationUrl="https://sampleapps.logianalytics.com/logiapp" data-report="EmbeddedReports.Elements" data-autoSizing="all" ></div>
and here's the report:
2. Enter a CSS selector (#elementID) to specify the element, and an
attribute name, and click Execute.
Here's the supporting JavaScript included in the current HTML page and called when you click Execute:
- function GetElementAttribute() {
- var elementSelector = document.getElementById('inpSelector').value;
- var attrName = document.getElementById('inpAttrName').value;
- var callback = document.getElementById('inpCallbackTo').value;
- var report = EmbeddedReporting.get('div8');
- report.getElementAttribute(elementSelector, attrName, callback);
- }
- function showResults(result) {
- alert(JSON.stringify(result, null, 2));
- }
Note that values for Input Text Area and
Input Select List elements cannot be retrieved using this
method; you must write a separate function to extract their values and
call it with execEmbeddedFunction() instead.
setElementAttribute(selector, attributeName, attributeValue,
callback)
Sets an attribute value of element inside an embedded report. Returns
"true" when the element was found and an attribute has been
updated successfully. The
selector
argument should
represent a valid CSS selector string.
1. We'll use the report we embedded in the previous example.
2. Enter a CSS selector (#elementID), an attribute name and value, and
click Execute. Scroll up to see the result.
Here's the supporting JavaScript included in the current HTML page and called when you click Execute:
- function SetElementAttribute() {
- var elementSelector = document.getElementById('inpSelector').value;
- var attrName = document.getElementById('inpAttrName').value;
- var attrValue = document.getElementById('inpAttrValue').value;
- var callback = document.getElementById('inpCallbackTo').value;
- var report = EmbeddedReporting.get('div8');
- report.setElementAttribute(elementSelector, attrName, attrValue, callback);
- }
- function showResults(result) {
- alert(JSON.stringify(result, null, 2));
- }
Note that, if the specified attribute does not exist, this method will create it and then set its value. Values for Input Text Area and Input Select List elements cannot be set using this method; you must write a separate function to set their values and call it with execEmbeddedFunction() instead.