Choice Properties

Use the Choice control to display a collection of items as a drop-down list.

Choice control properties
Property Description
Mobile business object Click Search to find the mobile business object with which to associate the selected control.
Object query The object query to associate with the selected control. Leave empty for no filtering of the mobile business object.
Display name attribute This option is enabled when this control is associated with a mobile business object. It is populated with the selected mobile business object attributes. This provides content to the control during run time.
Value attribute This field is enabled when the Mobile Business Object field is not empty. It is populated with the mobile business object attributes. By default, the first attribute is selected. This attribute can be the same as the Display Name Attribute.
Linked value Enter a value for linking this choice to other choice elements on the screen. The value must be from the data available in the "display_name" attribute of the mobile business object.

The linked value is cleared and disabled if the mobile business object does not contain the necessary attributes with which to link parameters.

The device display shows the link decorator for any choice fields that are linked.

Items Click Add to add the items for the choice drop-down list.

Click Edit to edit the selected item.

Click Remove to remove the selected item.

Initial value Select the initial value for the choice drop-down menu. The choices in this drop-down list are set in the Items section.
Use variable Use a variable to determine the initial value of the choice. Click Browse to find available variables.
Read only Select if the choices displayed on the screen should be read-only.
Empty string means NULL When selected, if the user leaves the input field empty, a NULL value is passed to the server instead of an empty string. This is required by some back-end systems.
Note: This option is enabled only for the STRING data type.
Data type Select the data type from the drop-down list. Use this option on the device to give menu assistance to inputs, for example, selecting a calendar for date. The device retrieves the information and performs validation on the input, for example, INT must be a number. It is also used to map the control to the operation parameter correctly.
Logical type Sets the logical type for the choice. This is used on the device to give menu assistance to input fields, for example, task, calendar, e-mail, or phone.
Style Click Search to search available styles.

Click Restore to restore the default style.

Click Edit to edit the selected choice style.

Click Clear to clear the choice style.

Span Choose:
  • Horizontal – enter the number of columns the widget will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display.
  • Vertical – enter the number of rows the widget will occupy.