registerDataDrivenContent(options, onMessage): DataDrivenContentHandle
This function is used to receive and dispatch messages to a data-driven content object. If the report is not yet opened then this call will open it and initiate data processing for this data-driven content object.
To find the correct values for
objectName, see the Getting Started page.
Choose options for how to connect to the server. The following properties are supported:
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 name of the data-driven content object.
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.
defaultuses SAS Logon to establish an authenticated session.
onMessage: (receivedMessage: ReportObjectResultData) => void
Define a callback function to handle data changes for this data-driven content object. The
receivedMessage is a
ReportObjectResultData object and is passed to the
onMessage callback every time the data-driven content object is updated.
For more information about the properties of the
receivedMessage object as well as receiving data for data driven content, see the SAS Help Center.
registerDataDrivenContent returns a
DataDrivenContentHandle which can be used to dispatch
messages to the data-driven content object.