Configure a standard data item

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Configure a standard data item to query data for your screens that do not require parameter input.

    Avant de commencer

    Role required: admin

    Procédure

    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. Select Data item and then select Continue.
    5. In the Data Items tab, click Create New.
    6. Complete the following fields as needed.
      Tableau 1. Data item fields
      Field Description
      Properties section:
      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.
      Data section:
      Table The table you want the data item to pull information from.
      Remarque :
      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.
      Group by Groups query results based on the selected field from the menu.
      Condition type Determines what type of condition your data item uses. Select from:
      Declarative
      Use a declarative condition to create conditions for the data item using the condition builder.
      Scripted
      Use a script to determine the conditions of your data item. A text window to enter a script appears below this field when you select this option.
      Append Encoded Query
      Use this option only when creating data items for your chart screens. For details on that data item type, see Configure an encoded query data item for chart screens.
      Condition Set of conditions for the data item to conform to. You can create conditions using the condition builder.
      Remarque :
      This field is only available when you select Declarative in the Condition type field.
      Sort by Lets you adds fields to the form that allow you to configure how to sort the list. In the condition builder, select the field you want the list to be sorted by. For example, select Caller. Then select ascending or descending to determine the order of the list.
      Remarque :
      This field is only available when you select Declarative in the Condition type field.
    7. Facultatif : If you have selected Scripted in the Condition type field, you must create a script in the Query Condition Script field.

      Your scripted condition must return a query string, which the instance uses to filter the data item. Use the input variable to access information from the current record.

      (function getQueryString(input) {
	var queryString = '';
	if(input.company) {
		  queryString += "company="+input.company;
	 }
	if(input.location) {
	  queryString += "^location="+input.location;
	 }
        queryString += "^EQ^ORDERBYDESCsys_updated_on";
	 return queryString; 
 })(input);

      This example uses the input variable and filters the data item for records matching the current records company and location. It then appends the text ^EQ^ORDERBYDESCsys_updated_on to the query, which sorts the data item records by the Updated on field.

    8. Select Save.

    Que faire ensuite

    Associate a data item with a screen. For more information, see Mobile screen types.