User Lookup

Name

Name that identifies the control. This value is also used for the label of the control.

XML Node

XML node mapped to the control. Use this value to map a list to a form and a form to a workflow.

• Prefix with @ to use the value of the control as an attribute with the immediate parent node. For example, @FirstName.

• Use / for a parent-child node configuration to uniquely identify a control in a form with multiple containers. For example, Employee/FirstName.

  The default value is the value for the Name property without the spaces.

Note:
- If you use / to denote a parent which is not a container and the parent is at the same level as that of the child, then the XML node for the control is not generated
- If you edit this value later, then it might affect the mapping between forms, lists, and workflows.

Description

Description for the control.

Tooltip

Message that appears when the pointer hovers over the control.

Default Value

The default value for the control.

To add the default value for the control

1. Click the User Lookup button. The Default Value dialog box appears.

2. In the Provider box, click a provider.

3. In the Search For box, enter a search keyword.

4. In the In list, click a search criteria.

5. Click Search. The search results appears.

6. Click a user in the search results, and then click Save. The selected user is set as the default value, and the Default Value dialog box is closed.

To delete the default value for the control

• Click the Clear button. The selected user is deleted.

Show Default User

Show or hide the logged on user as the default user for the control.

• Select Yes to show the logged on user as the default user for the control.

• Select No to hide the logged on user as the default user for the control.

  The default value is Yes.

Enable

Enable or disable the control.

• Select Yes to enable the control.

• Select No to disable the control.

  The default value is Yes.

Visible

Show or hide the control.

• Select Yes to show the control.

• Select No to hide the control.

  The default value is Yes.

Label Position

Position of the label for the control.

• Select Default to allow the system to align the label. The system aligns the label to the left of the control or as specified by the container control.

• Select Left to align the label to the left of the control.

• Select Top to align the label to the top of the control.

• Select Right to align the label to the right of the control.

• Select Bottom to align the label to the bottom of the control.

• Select Suppress to hide the label for the control.

  The default value is Default.

Note:
- If the value is Default and the control is placed on a container control, then the value of the Label Position property of the container control determines the position of the label for the control.
- For example, if the value is Default and the control is placed on a Base Form with Label Position property set to Top, then the label is aligned to the top of the control.

Label-Control Area

Area occupied by the label and the control in percentage.

• Select Default to allow the system to set the label and the control areas.

• Select Custom to specify the label area. The control area is automatically set based on the label area.

  The default value is Default.

Note:
- If the value is Default and the control is placed on a container control, then the value of the Label-Control Area property of the container control determines the area of the label for the control.
- This is applicable only when the Label Position is set to Left or Right.

Watermark

Hint text that appears when no value is entered for the control.

Width

Width in pixels for the control.

The default value is 0.

Note: If the value is 0, then the width of the control is set as per the default values.

Height

Height in pixels for the control.

The default value is 0.

Note: If the value is 0, then the height of the control is set as per the default values.

Retain Space

Reserve or remove space when the control is hidden.

• Select Yes to keep space when the control is hidden.

• Select No to remove space when the control is hidden.

  The default value is No.

Mandatory

Enforce or bypass entering a value for the control.

• Select Yes to enforce entering a value for the control.

• Select No to bypass entering a value for the control.

  The default value is No.

On Data Change

Run a script when value of the control changes.

For more information, see scripting guidelines for On Data Change property.

ID

Reference identification code for the control. This value is automatically generated and cannot be changed.

Extended Information

Allow or deny a user to access the extended information (that is columns other than the display and value columns of the result set) based on the selection for the control.

• Select Yes to allow a user to access the extended information based on the selection for the control.

• Select No to deny a user to access the extended information based on the selection for the control.

  The default value is No.

Include in Summary

Allow or deny a user to view the value in the Summary of a Base Form.

• Select Yes to allow a user to view the value in the Summary of a Base Form.

• Select No to deny a user to view the value in the Summary of a Base Form.

  The default value is No.

Note:
- This property is applicable only when the control is used on a Base Form with Repeating property set to True, and the form is viewed on a small form factor mobile device.
- For information about Summary of a Base Form, see Base Form.