Skip to main content
Version: 2.31.0

registerDataDrivenContent

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 url, reportUri, and objectName, see the Getting Started page.

Arguments​

options: Object​

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.
    • 'credentials' default uses 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.

Return value​

registerDataDrivenContent returns a DataDrivenContentHandle which can be used to dispatch messages to the data-driven content object.