You are here:
Configuring a PushTopic Data Source (Managed Package)
For the managed package runtime, configure a PushTopic data source to run an SOQL query that returns a result that notifies listeners of changes to records in a Salesforce organization.
This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.
The PushTopic defines a Streaming API channel. For instance, if you want to get notified when a case is created for a particular type or status or both, use a PushTopic. For more information on how a Streaming API PushTopic data source works, see PushTopic Data Source (Managed Package).
To configure a PushTopic data source:
- In the Cards Designer, in the Layout or Cards pane, from the Data Source picklist, select Streaming API.
-
From the Type picklist, select
PushTopic.
-
In the Channel field, select the URL of the PushTopic that
you created.
This field is auto-populated for Streaming Channel and PushTopic.
-
From the Operation picklist, select
Replace or Append.
-
Select Replace to overwrite the Card with new data.
-
Select Append to add new data to the Card.
From the Get All Messages picklist, select True or False.
-
Select True to get all data from the last 24 hours.
-
Select False to get the latest data update.
-
-
(Optional). Enter values for these properties:
-
To drill down to a specific dataset, in the Result JSON Path field, enter a path. For example, enter records.results, which drills down to the
resultsarray and passes the array to the card or card layout. -
To sort data by a specific data field, enter the field name in the Order By input field.
-
To reverse the order of the data returned, select True from the Reverse Order picklist.
-
Set a Timeout value in milliseconds.
The timeout value controls the time that the framework waits for the designated data source to return a response. Timeouts improve handling user interactions with long running processes. Setting an appropriate timeout value allows the application and users to react accordingly to long wait times.
-
Set an Interval value in milliseconds.
The card component's data source refreshes continuously at the given interval and checks for changes in data source records. If changes are found, the layout or card component reloads. Setting an interval enables recursive updates of records.
-
-
To preview a card using real data, add a test variable in the Test Data
Source Settings fields. See Testing Data Source Settings (Managed Package).
ImportantAfter configuring a Streaming API data source for an LWC card, you cannot preview the card in the Card Designer's Preview pane. To view the LWC card, you must deploy it, and then add the LWC card to a Lightning or Community page. For more information on deploying an LWC card, see Creating an LWC Card Layout (Managed Package). For more information on adding an LWC card to a page, see Adding an LWC Card to a Lightning or Community Page (Managed Package).
