Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Mobile configuration and navigation
Table of Contents
Choose your release version
    Home New York Mobile Configuration and Navigation Mobile configuration and navigation ServiceNow mobile app configuration Create a data item for a mobile application

    Create a data item for a mobile application

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Create a data item for a mobile application

    Data items are data sets that represent a table from the platform. Data items determine the information that appears on a screen. Associate data items with specific applets to determine the purpose of each applet.

    Before you begin

    Role required: admin

    Procedure

    1. In Studio, navigate to Mobile Studio > Data Items, and click the popout icon (The popout icon.).
    2. In the Data Items tab, click Create a new data item.
    3. Complete the following fields as needed.
      Table 1. Data item fields
      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.
      Condition type Determine whether the condition for the data item is declarative or scripted. Use a declarative condition to create conditions for the data item using the condition builder. Use a scripted conditions to create a scripted data item.
      Add sort Adds fields to the form that allow you to configure how to sort the list. In the Add Sort window, select the field you want the list to be sorted by. For example, Caller. Then select a to z or z to a to determine which order the list goes in.
      Query Condition Set of conditions for the data item to conform to. You can create conditions using the condition builder.
      Sorted by This field only appears if you click Add sort. It is automatically populated with the information you added in the Add Sort window.
      Direction This field only appears if you click Add sort. It is automatically populated with the information you added in the Add Sort window.
    4. (Optional) If you want the application to query the database for more information before loading the data, add parameters to the data item.
    5. (Optional) To configure a data item for a Grouped By applet, in the Group Function section, from the Group By list, select the field you want to group items by. The available fields are based on the table you selected.
    6. (Optional) 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 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.

    7. Click Save.

    What to do next

    Associate a data item with an applet.
    • Configure a data item with parameters

      Data items are data sets from a table in the platform. Configure a parameterized data item to filter and view just the relevant data according to the selected parameters.

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Create a data item for a mobile application

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Create a data item for a mobile application

      Data items are data sets that represent a table from the platform. Data items determine the information that appears on a screen. Associate data items with specific applets to determine the purpose of each applet.

      Before you begin

      Role required: admin

      Procedure

      1. In Studio, navigate to Mobile Studio > Data Items, and click the popout icon (The popout icon.).
      2. In the Data Items tab, click Create a new data item.
      3. Complete the following fields as needed.
        Table 1. Data item fields
        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.
        Condition type Determine whether the condition for the data item is declarative or scripted. Use a declarative condition to create conditions for the data item using the condition builder. Use a scripted conditions to create a scripted data item.
        Add sort Adds fields to the form that allow you to configure how to sort the list. In the Add Sort window, select the field you want the list to be sorted by. For example, Caller. Then select a to z or z to a to determine which order the list goes in.
        Query Condition Set of conditions for the data item to conform to. You can create conditions using the condition builder.
        Sorted by This field only appears if you click Add sort. It is automatically populated with the information you added in the Add Sort window.
        Direction This field only appears if you click Add sort. It is automatically populated with the information you added in the Add Sort window.
      4. (Optional) If you want the application to query the database for more information before loading the data, add parameters to the data item.
      5. (Optional) To configure a data item for a Grouped By applet, in the Group Function section, from the Group By list, select the field you want to group items by. The available fields are based on the table you selected.
      6. (Optional) 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 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.

      7. Click Save.

      What to do next

      Associate a data item with an applet.
      • Configure a data item with parameters

        Data items are data sets from a table in the platform. Configure a parameterized data item to filter and view just the relevant data according to the selected parameters.

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login