Managing Shared Topics

About this task

Shared topics can be added to views when creating a view and provides the following capabilities:
  • Create/Edit always monitored topics
  • Monitoring starts when a shared topic is configured
  • Monitoring restarts immediately when a device is rebooted
  • Shared topic values are cached in device RAM
  • Shared topics can be selected when creating a view
  • Historical data for shared topics is available in the Device Details dialog
Note: The Manage Shared Topics feature is available in SOTI XSight versions 2024.0.2 and later.

Accessing Managed Shared Topics

Procedure

  1. Login to the SOTI XSight web console as administrator.
  2. From the main menu, select Live View. The Live View map displays.
    Select Live View from the main menu
  3. In the Live View Map display, from the main menu, select Manage Shared Topics.
    From the main menu select Manage Shared Topics

Creating a Shared Topic

Procedure

  1. In the Manage Shared Topics window, select the Add Shared Topic icon.
    The Manage Shared Topics window
  2. In the Shared Topic Configuration panel, enter the following:
    • A Name for the configuration.
    • The MobiControl Instance.
    • The Platform for the device groups.
    • In the Group Filter section, select the device groups to add.
    Enter a name for your configuration
Add topics to monitor
  1. In the Topics to Monitor section, select the Add Shared Topic icon.
    Add topics to Monitor
  2. In the Add Shared Topic Wizard panel, select Next.
    The Add Shared Topic Wizard panel
  3. Choose the type of values to retrieve for this topic (see Adding Custom Topics for more information on value types).
    Select the type of values to retrieve
  4. Select Next.
  5. Select the Collection Frequency, Significant Change and Units for the custom topic you are creating. .
    Note: Collection Frequency sets how often the device sends topic data. Significant Change tells the device to send data when this condition is met, regardless of the collection frequency.
    Select collection frequency
  6. Select Next
  7. Choose how to retrieve values from a third part application and select Next.
    1. If you select Retrieve data from SOTI Snap App (Android only), you must specify the parameters needed to retrieve data using the XT socket interface for SOTI Snap.
      Note: See Adding Custom Topics for more information on the XT socket interface.
      Enter the following:
      • The Display Prompt Text.
      • The Topic Identifier used in SOTI Snap.
      • Select the Show error if app cannot be read from checkbox if you want an error to display if the application cannot be read from.

      Enter the XT socket parameters

    2. If you select Use XTSocket Interface, you must specify the parameters needed to retrieve data using the XT socket interface. Enter the following:
      • The Display Prompt Text.
      • The Package/Prog Id.
      • The application Signature.
      • The XT Socket Field Key.
      • Select the Show error if app cannot be read from checkbox if you want an error to display if the application cannot be read from.
      Enter the paremeters for Use XT Socket Interface
    3. If you select retrieve data from JSON file you need to specify the parameters needed to retrieve data from a JSON file on the device{color} . Enter the following:
      • The Display Prompt Text.
      • The File Path required to retrieve the JSON file.
      • The JSONPath needed to retrieve the data
      • Select the Show error if app cannot be read from checkbox if you want an error to display if the application cannot be read from.
      Enter the JSON file parameters
  8. Select Finish.
  9. When you have all the topics you want, select Save.
    Select save

Editing a Shared Topic

Procedure

  1. In the Manage Shared Topics window, hover over the shared topic to edit and select Edit.
    Editing a shared topic
  2. Edit the details of the shared topic in the Shared Topic Configuration panel.
    Edit the shared topic configuration
  3. Select Save.

Deleting a Shared Topic

Procedure

  1. In the Manage Shared Topics window, hover over the shared topic to delete and select Delete.
    Delete a shared topic
  2. Select Yes.
    Confirm deletion of a shared topic