Salesforce

Data Source Properties (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

Data Source Properties (Magic xpa 4.x)

Property

Description

Mobile Support

Items List

A comma-delimited string that defines the available options that can be selected.

If the Display List property is not defined, each string of each item is used both for the display and for the returned value. You may set a display list by using the Display List property to differentiate between the displayed string and the returned string.

To enter a blank entry, use an escape character, the backslash (\), followed by a space: \ . To display a backslash as the last character of the last item, use two backslash characters. For example: A combo box that has the items of A:\ and C:\ should have its Items list set with A:\\,C:\\.

This property supports the As Data mode. This mode instructs the control to use the Range property of the associated field as the Item List value.

When the Items List is a set list, such as for Gender, the list can be set during the creation of the column in the data source.

See also:

ControlItemsList function

Android and iOS

Display List

The values shown to the end user.

You can enter a set of comma-delimited options that will be displayed for the control but are not return values.

Note:

  • The number of entries in the Display List property must be zero or match the number of entries in the Items List property.

  • The Display List values must be entered in the same order as the return values entered for the Items List property.

For example, if you enter 1, 2, 3 in the Items List property field, where 1 is red, 2 is blue, and 3 is green, the red, blue, and green values must be entered in the order of 1, 2, 3.

To enter a blank entry, use an escape character, the backslash (\), followed by a space: \ . To display a backslash as the last character of the last item, use two backslash characters. For example: A combo box that has the items of A:\ and C:\ should have its Items list set with A:\\,C:\\.

When the Display List property is blank, the options entered in the Items List property field are both display and return strings. When there are Item List values and Source Table values (from the Data Source Number property), the Display List values must first represent the Items List values and then the Source Table values.

For Tab controls, you can insert an ampersand (&) in front of an entry to enable the use of an accelerator key for that tab. The underline indicator under the accelerator letter will be seen only when the Tab control's title color is set. (Since version: 3.2a)

Platform specific: For Tab controls on mobile devices, refer to:How Do I Use the Tab Control on Mobile Devices?

See also:

ControlDisplayList function

How Do I Display Different Text than the Stored Values in a Choice Control?

How Do I Display Special Characters in a Choice Control?

How Do I Set Accelerators to Choice Control Options?

Android and iOS

Data Source Number

The data source number as it appears in the Data Source repository. You can display the values of a table selected from the Data Source list. Table values can be combined with Items List values. When a source table is selected, you must add Display List values that represent the table values.

Android and iOS

Display Field

The field name from the selected table. You can select the field name for the selected Main source from the Variable list. Note that you must first select the Source table from the Data Source Number property.

Android and iOS

Linked Field

The field name from the selected table. You can select the field name for the selected linked table from the Variable list. Note that the variables from the Main source appear on the Variable list when a linked table is not defined.

Android and iOS

Index

An index name from the selected table. You can select an index that is defined for the Source table in the Data Source Number property.

Android and iOS

Field Ranges

A list of range values set for defined variables of the source table to limit the range of options.

Click the ellipsis button or zoom to open the Field Ranges screen. Press F4 to define a new range.

If the Source table does not have a range of values defined for a field, none will appear in the Field Range list.

In Rich Client tasks, expressions in this field are server-side only.

Android and iOS

Since version: .NET control support – 2.3

Related Topics

Reference
Attachment 
Attachment