Adding Custom Topics

This procedure describes how to use data collected by third-party applications for display in Live View. An SDK document and sample source code package is available from SOTI .

About this task

To add custom topics:

Procedure

  1. From the Configure View or Edit View panel, select Edit Topics. The Edit Topics panel displays.
    Edits Topics panel
  2. Select Add Custom Topic. The Add Custom Topic Wizard start page displays.
    Add Custom Topic Wizard start screen
  3. Select Next then choose one of the following value types:
    Value Description
    Integer (arbitrary values) Numerical value
    Integer (suitable for mapping to colors on icons) Numerical value for display on the Map
    String (arbitrary value) Sequence of characters
    String (suitable for mapping to colors on icons) Sequence of characters for display on the Map
  4. Select Next then choose a collection frequency and significant change value.
    Custom Topic Wizard collection frequency screen
    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.
  5. Select Next then choose one of the following data source options:
    Data Source Option Description
    Retrieve data from SOTI Snap App (Android only) Specify parameters to retrieve data using the SOTI XT socket for SOTI Snap.

    Custom Topic Wizard SOTI Snap app integration screen

    See the SOTI Snap online help: XSight Topics

    • Display Prompt Text: Enter the topic name to display in Live View.
    • Topic Identifier: Enter a topic exported by SOTI Snap.
    Use XT Socket Interface Specify the parameters to retrieve data using the SOTI XT socket interface, a mechanism developed by SOTI to talk directly to business apps.

    Custom Topic Wizard XT Socket screen
    • Display Prompt Text: Enter the topic name to display in Live View.
    • Package/Prog Id: The application you want to get data from.
    • XTSocket Field Key: Enter the name of the field you want to extract data from.
    Retrieve data from JSON file Specify the parameters to retrieve data from a JSON file on the device.

    Custom Topic Wizard JSON file integration screen
    • Display Prompt Text: Enter the topic name to display in Live View.
    • File Path: Enter the location of the JSON file on the device.
    • JSONPath: Enter the specific subsection of the JSON document you want to extract. Use the format: $.store.book[0].title
    Note: There are two styles of notation:
    • Dot Notation: Uses a dot (.) to separate nodes. For example: $.tool.jsonpath.creator.location[2].
    • The dollar sign ($) represents the root member object.
    • Operators like @ (current node) and * (wildcard) are used in expressions.
    • Functions like min(), max(), and length() can be applied at the end of a path.