Create an action function with parameters
- UpdatedJan 30, 2025
- 4 minutes to read
- Yokohama
- Mobile Configuration and Navigation
Request additional information from your end users when they interact with an action. For example, you can allow your end users to provide a reason for rejecting an approval by adding a text input parameter to a Reject button. When you create an action item that has parameters, you must also configure the UI parameters for the action function.
Before you begin
Role required: admin
About this task
The UI parameter fields don’t appear on the action function unless you’ve associated an action item with parameters to the action function.
Procedure
-
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.
-
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.
-
Select Functions in the menu, and then select New.
Complete the action function fields as needed. For more information on completing the fields for the action function, see Configure an action function.
-
Scroll down to the UI Parameters section of the form, select New, and complete the fields as needed.
Table 1. UI Parameter fields Field Definition Properties Name Name for the UI parameter. You can have multiple UI parameters with the same name so make sure that you choose something you can easily discover later. If the parameter requires user input, use a user-friendly name. Display name UI label that displays on the app. This label is auto populated with the value from the Name field. Settings Parameter type Select Screen or Function. Screen/Function Depending on whether you select Screen or Function, select the screen or function you want to use. Input style How the user interacts in the UI. Choose from inline or pop-up. Mandatory Whether the user is required to enter information for that field. Placeholder text Text that appears below the field type. Order The order in which the UI parameters are rendered on the screen. Default value type The value that appears by default in the UI field. Select one of the following options. - None: There’s no default text. This option works well for a list input type.
- Manual: A Default value field appears for you to enter a default term. For example, Search for a field. The manual default type works well for search or text input types.
- Source field: Pulls in information from the field selected in the Field name section. If you select this option, a table name and field are required.
Input source The source for the parameter input. Choose User Input or Auto fill. Input type The UI used to complete the variable. The available options in this field depend on the choice entered in the Input source field. Choose from one of the following options. - User input options:
- Text
- Provides a simple text field. This option works best for fields that require text, such as work notes or resolution details.
- Choice list
- Opens a list for the user to select from. This option works well for reference fields that require specific information.Note: The Choice list input returns a maximum of 1000 results. For references that require more than 1000 results, use the Search list input type.
- Search list
- Provides a search bar so that users can search in a list. Select a reference field on a table for users to search on.
- QR/Barcode
- Provides the option to search by QRC or barcode. Learn more about this feature in Mobile barcode scanning.
- Auto fill options
- GPS Location
- Auto-fills with the mobile user's location when the action is used. For details on this feature, see Mobile location tracking configuration.
- Date
- Auto-fills with the date and timestamp of when the action is used.
- Constant
- Auto-fills with a constant value. The Constant value field appears on the form when this choice is selected.
- Source field
- Auto-fills from a specified field. TheButton parent table and Source field fields appear on the form when this choice is selected.
- User
- Auto-fills with the mobile user's user record.
- Append encoded query
- Used to connect a chart screen to a list or record screen.
Carried Whether this parameter is a carried parameter. Use carried parameters to move information between different screens and actions. Data Button parent table Table used when using Source field as the default value type.
This field is only visible when Default value type is set to Source field, Input source is set to Auto fill, and Input type is set to Source field.
Source field The field used from the source field table.
This field is only visible when Default value type is set to Source field, Input source is set to Auto fill, and Input type is set to Source field.
- In the Action data parameter mapping section, select Choose to select the data parameter that was created under the action item.
- Select Save.
What to do next
Associate the function with a specific screen. For more information on how to associate the action, see Associate a function with a location in the app.