Configure an encoded query data item for chart screens

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read
  • Configure an encoded query data item to query data for chart screens. An encoded query data item is a parametrized data item that is the basis for a chart screen to be passed to a list screen. When tapped it enables users to drill-down to a list of items that the chart is created from.

    Before you begin

    Role required: admin

    About this task

    Procedure

    1. Navigate to All > System Mobile > Mobile App Builder.
      The Mobile App Builder opens in a new browser tab and displays the application scope selection screen.
    2. Search for the application scope you are working in and then select the name of the application scope.
      The Mobile App Builder categories home screen displays.
    3. Select the Data category, and then select New.
    4. From the Create a data item dialog box, select the type of data item you want to create, and then select Continue.
      You can select either a standard Data item or a Relationship data item.
    5. Complete the following fields as needed.
      Table 1. New data item form
      Field Description
      Name A title for the data item. You can have multiple data items with the same name. Make sure that this name is unique so that you can find it easily.
      Description Optional additional details about the data item
      Table The name of the table you want the data item to pull information from.
      Note:
      Custom tables are not available by default. You can change this behavior by modifying the subscription.custom_table.enforce_entitlement system property. For details on making this change, see Allow or restrict access to custom tables in mobile data items.
      Condition type Determines what type of condition your data item uses. For an encoded query data item, select Append Encoded Query.
      Append Encoded Query This field only appears after you select Append Encoded Query in the Condition type field. Leave this field empty. You use this field in later steps.
    6. In the Parameters section, select New.
      The Data Parameter form appears.
    7. In the Name field, enter a name for your parameter. For example, URL.
    8. In the Type field, select String.
    9. Select the data item record in the configuration tree to navigate back to the data item record.
    10. In the Append Encoded Query field, select the parameter you created in the previous steps.
    11. Select Save.

    What to do next

    For more information on how parameters pass values between screens, see Parametrized list screens.