{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":34847,"path":"mobile/input-form-screen-actions-config.md","title":"Configure input form screen actions","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure input form screen actions\n\nLearn how to configure actions that affect the whole input form screen. These actions can be accessed with an icon or within a more menu button, located in the top menu bar. For example, you can configure a writeback action to save your work progress on the input form.\n\n## Before you begin\n\nRole required: admin\n\nA loading mechanism is required to refresh the input form screen with updated data. The options available are autofill variables and data sources. For more information, see [Loading mechanisms for input form screens](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/loading-mechanisms.md).\n\nIf your input form only includes input values for loading, and you don’t need to load an input type of attachment, then the autofill variable option is sufficient. If your input form includes either attachments, comments, or descriptive elements, the data source option must be used. The data source option also handles input values.\n\n## About this task\n\nInput form screen actions are accessed in the top menu as either an icon \\(\\[Omitted image \"icon-ifs-save-progress.png\"\\] Alt text: More menu icon.\\) or within the more menu button options \\( \\[Omitted image \"IconAppMenuAndroid.png\"\\] Alt text: More menu button.\\). The configuration of the writeback action in this task explains how to create a function that enables users to save the progress of data entered in an input form screen before users submit the final version. This feature enables multiple users to collaborate on a single input form screen. Once a user saves the data, it becomes visible to all other users working on the form when they refresh their input form. Writeback actions use the action item function. For more information, see [Configure an action item](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/sg-studio-create-action-item.md).\n\n**Note:** Input form screens contain a submit button. For this configuration you have the option to configure a save-as-you-work option, the data of which is available to other users after it is saved.\n\n|Top navigation more menu \\(iOS\\)|Top menu icon for input form screen action|\n|--------------------------------|------------------------------------------|\n|\\[Omitted image \"ifs-top-nav-menu-iOS.png\"\\] Alt text: Top navigation more menu \\(iOS\\).|\\[Omitted image \"ifs-top-nav-icon.png\"\\] Alt text: Top menu button for input form screen action.|\n\n## Procedure\n\n1.  Navigate to **All** > **System Mobile** > **Mobile App Builder**.\n\n    The Mobile App Builder opens in a new browser tab and displays the application scope selection screen.\n\n2.  Search for the application scope you're working in and then select the name of the application scope.\n\n    The Mobile App Builder categories home screen displays.\n\n3.  Select the **Screens** category and then either select an existing input form screen or **New**.\n\n    If you select **New**, select the **Input form** option in the Create a screen page, and then select **Continue**.\n\n4.  In the Input form screen page, select **Screen** in the **Presentation style** field.\n\n5.  Complete the Input form screen form as required.\n\n    For information about the various fields, see [Configure an input form screen](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/parameter-screen-config.md).\n\n6.  Select one of the following options:\n\n    -   To add the input form screen action as a top menu icon, select **New** in the Top icon function instances area.\n    -   To add the input form screen action as a function in the top menu more \\(\\[Omitted image \"IconAppMenuAndroid.png\"\\] Alt text: Top menu more button.\\) button, select **New** in the Top menu function instances area.\n    **Note:** The subsequent instructions are the same for either top icon or top menu function instances.\n\n7.  In the Function instance form do the following:\n\n    1.  Enter a **Name** for the function instance.\n    2.  Enter a name in the **Display label** field.\n    3.  Select an icon from the **Icon** field.\n\n        **Note:** This field is required if you selected the **Top icon function instances** option.\n\n    4.  Select **New** in the Function area, to display the function form.\n8.  Enter a **Name** for the function.\n\n9.  Select **Action item** in the Type field.\n\n10. Select **Record** in the Context field.\n\n11. Either **Choose** or create a **New** action item.\n\n    For more information, see [Configure an action item](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/sg-studio-create-action-item.md).\n\n12. In the **Data** field, select the table relating to what the input form is representing.\n\n13. In the Button attributes area, do the following:\n\n    1.  Select **New**.\n    2.  From the **Name** field, select `retain_parent_parameter_screen`. This attribute verifies the parent input form \\(the input form that you're working on\\) opens when the user taps the button, as opposed to launching a new input form.\n    3.  Enter `true` in the **Value** field.\n    4.  Select **Save**.\n    5.  From the **Name** field, select `refresh_parameter_screen_after_action`. This attribute refreshes the input form with the latest data from the instance.\n\n        **Note:** To display the data in the input form after the save action, you must configure one of the following loading mechanisms:\n\n        -   Autofill variable: For more information, see [Configure input form screen inputs](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/param-screen-config-inputs.md).\n        -   Data source: For more information, see [Data sources](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/data-sources.md).\n    6.  Enter `true` in the **Value** field.\n    7.  Select **Save**.\n14. Select **Save**.\n\n\n## What to do next\n\n**Use timestamps to track users changes in the input form**. To monitor the changes made by different users on an input form screen, you must enable the track timestamps option and use a script. The **Track timestamps for input updates** field is on the main input form screen record. For more information, see [Configure an input form screen](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/parameter-screen-config.md). It tracks the time the input’s value changed. This information is accessible using the scripted writeback action. For a code example of this writeback action, see [Using timestamps to track user changes in an input form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/track-timestamp-script.md).\n\n"}}