Configure an input form screen

  • Release version: Xanadu
  • Updated August 1, 2024
  • 4 minutes to read

    • Configure an input parameter so that your users can see a list of records from their mobile app. To access a record from the list, a user just has to tap the record name.

    Before you begin

    Role required: admin

    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 Screens category, and then select New.
    4. Select the Input form option in the Create a screen page, and then select Continue.
    5. Complete the following fields as needed.
      Table 1. Input form screen form
      Field Value
      Properties
      Name The name of your screen. This name appears as a tile in the mobile application.
      Description Additional information about the screen.
      Active Option to set the input form screen as active. Inactive screens do not appear in your mobile apps.
      Settings
      Available offline Option to make the input form screen is available in offline mode. For details on offline mode, see Offline mode.
      Resume on Cancel Option to enable the resume on cancel option. When enabled, data entered on the screen is saved in memory when a user clicks Cancel. The data is loaded when the user returns to the screen later.
      Fetch Type Fetch type settings determine when data is loaded in screens. Change your fetch type to optimize load time performance for your screens. Select from Background, Dynamic prefetch, On-demand, or Prefetch as required for your setup. For more information about these options, see Mobile fetch types.
      Header Only on First Page Option to make the header visible only on the first page of the input form screen.
      Reset after Submit

      Option to reset the input form screen to its default state after an action is submitted. The Reset after Submit setting enables users to submit multiple actions that must be saved to the ServiceNow instance without having to reopen the input form screen.

      To configure this setting, do the following:

      1. Select Save to save the input form screen.
      2. Select the options menu icon (Option menu icon.) in the upper right corner of the form in Mobile App Builder and select Open in platform.
      3. Select the Settings tab.
      4. Select the Reset after Submit check box.
      5. Select Update to save the setting.
      6. Navigate back to Mobile App Builder by selecting that browser tab.
      Header Card An optional mobile view to display at the top of your input form screen. There can only be one header card for each input form screen. Select Choose to add an existing header card, or select New to configure one. For more information on view configuration, see Understanding mobile cards and legacy cards.
      Note:
      The header card supports buttons for navigation purposes only. Buttons can be used to navigate to another screen. Any other button functionality is not supported within the header card.
      Buttons
      Cancel label Label for the button used to cancel the input form screen.
      Next label Label for the button used to advance to the next page of the input form screen.
      Previous label Label for the button used to return to the previous page of the input form screen.
      Submit label Label for the button used to submit the input form screen.
      Input form page display The way that information is displayed on your input form screen. Select one of the following options, as required for your setup:
      • Individual page for each input: Choose this option to place each input field on its own page in your mobile app. Select this option for complex input types.
      • Custom page and section setup: Choose this option when you have multiple input fields that must appear on the same page in your mobile app. If you choose this option, more configuration options appear at the bottom of the form where you can configure Pages and Section mappings.
      Inputs Input fields that you want to appear on your input form screen. Select New to add a new input field. For more information about configuring input fields, see Configure input form screen inputs.
      Variables Variables that are to be used in your input form screen. Variables define what information is collected from the user automatically or the default information for an input. Select New to add a new variable. For more information about configuring variables, see Configure input form screen variables and attributes.
      Actions Actions that you want to appear on an Input field to trigger a UI rule. Created actions will be shown on the keyboard when the user selects the specified input. For more information about configuring actions, see Configure input form screen actions.
      Pages The sections or inputs that appear on your input form screen when there are multiple pages. Select New to define a new page. For more information about configuring pages, see Configure input form pages.
      Section mappings The way that sections are displayed on your input form screen. You can configure how each section displays and the order of sections. Select New to define a new section mapping. For more information about configuring section mappings, see Configure input form sections.
    6. Select Save.