Configure a parameterized record screen
Configure a record screen to query a user for a parameter. The screen then uses this parameter to determine the record that appears on the screen.
Before you begin
Role required: admin
Procedure
Navigate to All > System Mobile > Mobile App Builder.
The Mobile App Builder
Search for the application scope you are working in and then select the name of the application scope.
The Mobile App Builder
Select the Screens category, and then select New.
Select the Record option in the Create a screen page, and then select Continue.
Complete the following fields as needed.
| Field | Description |
|---|---|
| Name | The name of your screen. This name appears as a tile in the mobile application. |
| Description | Additional information about your screen. |
| Fetch type | Settings that determine when data is loaded in your screen. Select from the following fetch types:
|
| Dynamic prefetch count | You can change the number of rows loaded with prefetch by changing the value of the Dynamic prefetch count field. |
| Hide screen name | Option to hide the record's screen name. |
| View using \(Legacy Card/Card\) | A Card used for the header section of the record screen. Use the Mobile Card Builder to change the appearance of your mobile card or the fields displayed on the card. For more detail on using the Mobile Card Builder, see Customize a screen using Mobile Card Builder. The best practice is using Card. |
| Card | This is an element that visually displays information from different records. You can style this information by setting specific conditions for each information type. |
| Icon | Icon that appears in the header of the launcher screen. |
| Alert | This is a mobile alert overlay for a record screen. Use it to inform users of an important message and to redirect them to a specific screen. Only one mobile alert is available per instance. |
| Data item | This defines what table you want data from and what conditions must be met for the data to be displayed. |
| Record screen segments | This is a UI element for switching between different lists on a single record screen. Use it to divide content into different areas on the screen. |
| Dynamic segments height | Sets the height for dynamically sized segments. |
| Dynamic segments minimum width | Sets the minimum width for dynamically sized segments. |
| Top menu function instances | Functions placed in the top menu of the record screen. |
| UI parameters | This is a variable that affects how a field or UI element behaves. Use it to determine how a value can be entered or if it will be autopopulated for a UI element based on what the user has done. |
| Dynamic screen title | This is how you can create an element and map it to a UI parameter. Use it to pass a value from one screen to another and include it in the title of the destination screen. |
| Role access | Option to limit user access to the screen by role. |
- On the Record screen form, select an existing data item or create a new one.
| Field | Description |
|---|---|
| Name | Name of the data item. |
| Description | Additional information about your data item. |
| Table | Table where the data item gets its data from. |
| Group by | Determine what values the table will be grouped by. |
| Condition Type | Whether the conditions for the data item are declarative, scripted, or use an encoded query. Leave this field at its default setting. |
| Offline condition | Conditions to apply when the user sets the app to offline mode. |
| Parameters | Data Parameter used for filtering the data item. Use parameters to accept values passed from screens or other sources. |
In the Data item screen, create a new data parameter by selecting the New button in the Parameters field.
In the New Data Parameter screen, enter a name for your parameter in the Name field, and select the parameter Type.
The available types are Integer, String, Decimal, Boolean, Datetime, or Date. For more detail on available options when creating parametrized data items, see Configure a parametrized data item.
Use the left panel hierarchy tree to return to the data item you just created a data parameter for.
In the Condition field, create a query that uses your parameter to filter your records.
Use the left panel hierarchy tree to return to the Record Screen and select New in the UI Parameters field to create a new parameter.
In the Properties section, enter a name for the UI parameter.
In the Setting section, fill in the following fields.
| Field | Description |
|---|---|
| Input type | How your users enter a value for this parameter. Select from the following options: - Text - Choice List - Search List - QR/Barcode |
| Table name | Table used for the choice list where users select a parameter value.Note: This field is visible only when Input type is set to Choice list or Search list. |
| Field name | The field used for the choice list where users select a parameter value.Note: This field is visible only when Input type is set to Choice list or Search list. |
| Default value | Default value for your parameter.Note: This field is only visible when Default value type is set to Manual. |
| Input style | Input style for your parameter. Select from Inline or Popup. |
| Default value type | Whether the parameter has a default value. Select None to have no default value, or Manual to enter a manual value in the Default value field. |
| Mandatory | Determines whether user input for the parameter is mandatory. |
| Placeholder text | Text that appears in the parameter entry field before the users enters a value. |
| Multi-select | Whether the user can select multiple values from the choice list.Note: This field is visible only when Input type is set to Choice list. |
| Search type | The type of search used when finding a parameter value.Note: This field is visible only when Input type is set to Search list. |
| Carried | Whether this parameter a carried parameter. Use carried parameters to move information between different screens and actions. |
In the Data Parameter Mapping section, select the Choose button to create a new parameter mapping.
Select the data parameter you created for the data item.
Select Apply.
Select Save.
Result
The UI parameter in your form is associated with the data parameter in your data item. When a user accesses this form, the screen prompts the user for a value for the parameter. The data item uses that value to filter the record displayed in the form.