Skip to main content
Version: 0.8.0

SASReportObjectElement

SASReportObjectElement is a custom HTML element that renders a report object. This could be a single object or a container of multiple objects. This element extends HTMLElement.

To find the correct values for url, reportUri, and objectName, see the Getting Started page.

Custom Element Tag​

<sas-report-object
  authenticationType="guest"
  url="http://my-viya-server.com"
  reportUri="/reports/reports/c3c6befb-3981-4c9e-b011-7dc11dec5e37"
  objectName="ve27"
></sas-report-object>

Attributes​

authenticationType: string​

Choose the method to authenticate requests to the SAS Viya server.

  • 'guest' automatically signs in to the SAS Viya server as the guest user.
  • 'credentials' uses SAS Logon to establish an authenticated session.

default value: 'credentials'

url: string​

Specify the URL of the SAS Viya server that hosts the report. This is the full context root, including the protocol, optional port, and host.

reportUri: string​

Specify the report URI.

objectName: string​

Specify the name of the object from the report to display.

Methods​

getReportHandle(): Promise<ReportHandle>​

Get a ReportHandle for controlling the state of the current report.

If called before the element is added to the DOM, the promise will resolve after the object begins to load.

The ReportHandle is invalidated when attributes on the SASReportObjectElement are changed and when the element is removed from the DOM. To obtain another ReportHandle, discard the previous result and call getReportHandle again.

ReportHandles from SASReportObjectElement are shared between objects from the same report.