---
schema_version: "1"
id: 1d0ac4d0748144867c2d7b7b8ec27b3424304a29c916e9be7c61823f99752c61
title: Configuring a PushTopic Data Source (Managed Package)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_configuring_a_pushtopic_data_source.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_configuring_a_pushtopic_data_source.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c5dcdccdf14e5159d636776104d1e180c16a2f5794517fc7aca430b2cfb8ac0e
description: 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.
products:
  - Omnistudio
release: "264"
---
# 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.

![Managed Package app icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/resources-global/_corporate/images/managedpackageicon.png) This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see [Omnistudio Help](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_standard.htm&language=en_US).

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)](https://help.salesforce.com/s/articleView?id=xcloud.os_pushtopic_data_source_1.htm&release=264.0.0&type=5 "For the managed package runtime, the Streaming Channel API type uses the Streaming API to send notifications of general events that are not tied to Salesforce data changes. Use the Streaming Channel API when you want to send and receive notifications based on custom events that you specify. You can use Streaming Channel API for any application that sends custom notifications, such as a Chat application. Streaming API is known as Generic Streaming in Salesforce.").

To configure a PushTopic data source:

1. In the Cards Designer, in the Layout or Cards pane, from the **Data Source** picklist, select **Streaming API**.
2. From the **Type** picklist, select **PushTopic**.
    
    ![image](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/pushtopicdemo.png)
3. In the **Channel** field, select the URL of the PushTopic that you created.
    
    This field is auto-populated for Streaming Channel and PushTopic.
4. 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.
5. (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 `results` array 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.
        
        ![image](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/orderbyreverseorder.png)
    - 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.
6. 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)](https://help.salesforce.com/s/articleView?id=xcloud.os_testing_data_source_settings.htm&release=264.0.0&type=5 "For the managed package runtime, add runtime variables to fetch and test your data source.").
    
    ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/images/icon_important.png)
    
    Important
    
    After 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)](https://help.salesforce.com/s/articleView?id=xcloud.os_creating_an_lwc_card_layout.htm&release=264.0.0&type=5 "For the managed package runtime, create an LWC card layout to enable Vlocity Lightning web components."). For more information on adding an LWC card to a page, see [Adding an LWC Card to a Lightning or Community Page (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_adding_an_lwc_card_to_a_lightning_or_community_page.htm&release=264.0.0&type=5 "For the managed package runtime, beginning with the Vlocity Insurance and Health Summer '19 and Vlocity Communications, Media, and Energy Fall '19 releases, Vlocity supports the Salesforce Lightning Web Component programming model.").