URL form control

Label

Function:

Specifies the text label that shows on your form for the control.

Accepted Values:

One line of text that can have spaces.

Default Value:

Different for different controls.

Example:

This is a common configuration field that is used in many examples. Refer to:

• Examples - Step-by-step use case examples, information about what types of examples are provided in the AgilePoint NX Product Documentation, and other resources where you can find more examples.

Internal Name

Function:

Specifies a unique, technical name for your control.

Accepted Values:

One line of text (a string) with no spaces.

Default Value:

Different for different controls.

Example:

This is a common configuration field that is used in many examples. Refer to:

• Examples - Step-by-step use case examples, information about what types of examples are provided in the AgilePoint NX Product Documentation, and other resources where you can find more examples.

Default Value

Function:

Specifies the default value in the field.

Accepted Values:

An integer.

Default Value:

Different for different controls.

Help Text

Function:

Specifies the text to shows when a runtime app user hovers their cursor over the form control.

Accepted Values:

More than one line of text.

Default Value:

None

Example:

Refer to:

• The videos on this page

Help Text Display

Function:

Specifies if the field shows the text in Help Text field when the form user puts the mouse on the label or field.

Accepted Values:

• None - Does not show the help text.
• Hover On Label - Shows the help text when you put your mouse on the label.
• Hover On Field - Shows the help text when you put your mouse on the field.
• Hover On Both - Shows the help text when you put your mouse on the label and Field.

Default Value:

None

Example:

Refer to:

• The videos on this page

Required

Function:

Specifies if the field is mandatory.

Accepted Values:

• Deselected - The field is not mandatory.
• Selected - The field is mandatory.

Default Value:

Deselected

Example:

Refer to:

• The videos on this page
• (Example) How Can I Map a Repeating Schema Element to Data Population?
• (Example) Create an eForm to Start the Process (Create Absence Request)
• (Example) Create an eForm (Set Available Leave Hours)

Validation Message for Required Field

Function:

Specifies the message to show if the form user does not enter data in a mandatory form control.

Accepted Values:

More than one line of text that can have letters, numbers, spaces, and special characters.

Default Value:

Enter the ${L}

${L} is a process data variable that shows the label for a form control.

Example:

Refer to:

• The videos on this page

URL Validation Message

Function:

Specifies the message the form user sees if he enters an invalid URL.

Accepted Values:

One line of text that can have spaces.

Default Value:

Enter the valid ${L}

${L} is a process data variable that shows the label for a form control.

Font Family

Function:

Specifies the font family of the input text and label.

Accepted Values:

A font name from the list.

Default Value:

• Modern theme - Roboto
• Classic theme - Arial

Example:

Refer to:

• The videos on this page

Font Size (px)

Function:

Specifies the size of the input text and label for your form control.

Accepted Values:

A positive integer.

Default Value:

• Classic theme - 12
• Modern theme - 14

Example:

Refer to:

• The videos on this page

Font Style

Function:

Specifies the style of the font for the input text and label.

Accepted Values:

• Bold - Shows the input text and label in bold.
• Underline - Shows the label underlined.
• Italic - Shows the label in italic.

Default Value:

None

Example:

Refer to:

• The videos on this page

Background Color

Function:

Specifies the background color for your control.

Accepted Values:

A color value using a hex code, RGB code, or RGBA code.

You can enter a color code, or select a color from the palette.

Default Value:

#ff0000

Example:

Refer to:

• The videos on this page

Border Color

Function:

Specifies the border color for your control.

Accepted Values:

A color value using a hex code, RGB code, or RGBA code.

You can enter a color code, or select a color from the palette.

Default Value:

#ff0000

Example:

Refer to:

• The videos on this page

Foreground Color

Function:

Specifies the foreground color for your control.

Accepted Values:

A color value using a hex code, RGB code, or RGBA code.

You can enter a color code, or select a color from the palette.

Default Value:

#ff0000

Example:

Refer to:

• The videos on this page

Apply Font Properties To Control

Function:

Specifies if the control gets the font properties from the properties set in the form settings.

Accepted Values:

• Selected - The control gets the font properties from the properties set in the form settings.
• Deselected - The control does not get the font properties from the properties set in the form settings.

Default Value:

Deselected

Example:

Refer to:

• The videos on this page

Label CSS Class

Function:

Specifies a CSS class for the label of your control.

Accepted Values:

A valid CSS class.

Default Value:

None

If you specify your CSS on the top menu, the CSS is populated.

Example:

Refer to:

• The videos on this page

Field CSS Class

Function:

Specifies a CSS class for the field in your control.

Accepted Values:

A valid CSS class.

Default Value:

None

If you specify your CSS on the top menu, the CSS is populated.

Example:

Refer to:

• The videos on this page
• (Example) Use Custom CSS in a Form Control

Container CSS Class

Function:

Specifies a CSS class for the container of your control.

Accepted Values:

A valid CSS class.

Default Value:

None

If you specify your CSS on the top menu, the CSS is populated.

Example:

Refer to:

• The videos on this page
• (Example) Use Custom CSS in a Form Control
• (Example) Create an eForm to Start the Process (Create Absence Request)

Enabled

Function:

Specifies if the form user can change the value of a field.

Accepted Values:

• Selected - The form user can change the value.
• Deselected - The input cannot change the value.

Default Value:

Selected

Example:

Refer to:

• The videos on this page
• (Example) Create an eForm to Start the Process (Create Absence Request)

Read-Only

Function:

Specifies if the field accepts user input.

Accepted Values:

• Selected - A user cannot enter a value for the field. The field shows as read-only.
• Deselected - A user can enter a value for the field.

Default Value:

Selected

Right To Left

Function:

Specifies if the text for this control, including user input, shows from right to left.

Accepted Values:

• Deselected - The text shows from left to right.
• Selected - The text shows from right to left.

Default Value:

Deselected

Example:

Refer to:

• The videos on this page

Visible

Function:

Specifies if the form user sees the field.

Accepted Values:

• Selected - The form user sees the field.
• Deselected - The form user does not see the field.

Default Value:

Selected

Example:

Refer to:

• The videos on this page

Text Align

Function:

Specifies the horizontal alignment of user input for this control.

Accepted Values:

• Left - Aligns the text to the left.
• Center - Centers the text.
• Right - Aligns the text to the right.

Default Value:

Left

Example:

Refer to:

• The videos on this page

Label Position

Function:

Specifies the position of the text label that shows on your form for the control.

Accepted Values:

• Inherit - The position of the label is as specified in the form settings.
• Left - Specifies that the position of the label is to the left of the container.
• Top - Specifies that the position of the label is to the top of the container.

Default Value:

Inherit

Example:

Refer to:

• The videos on this page

Field ID

Function:

Shows an ID of the control.

Accepted Values:

Read only.

Default Value:

Different for different controls.

Example:

Refer to:

• The videos on this page

Character Case

Function:

Specifies the character case for your label.

Accepted Values:

• None - The characters show as you enter them.
• Upper Case - Changes all characters to capital letters.
• Lower Case - Changes all characters to small letters.

Default Value:

None

JavaScript Event

Function:

Specifies the JavaScript event that causes an effect.

Accepted Values:

• None - No action.
• Blur - When a form user leaves an input field.
• Change - When a form user changes the content of an input field or selects a value.
• Click - When the form user clicks a button.
• Double Click - When the form user double-clicks text.
• Focus - When an input field gets focus.
• Keydown - When a form user holds down a key.
• Keypress - When the form user presses a key.
• Keyup - When the form user releases a key.

Default Value:

None

Example:

Refer to:

• The videos on this page

JavaScript Function

Function:

Specifies the name of a JavaScript function to complete the activity.

Accepted Values:

The name of a Javascript function that exists in your app.

For more information, refer to (Example) Use Custom JavaScript in an eForm.

Default Value:

None

Example:

ConfirmSubmission where one of these is your function:

function ConfirmSubmission()
  {
    alert ('Are you sure to submit this form?');
    return true;
  }

function ConfirmSubmission(parameter1,parameter2)
  {
    window.alert ( parameter1 * parameter2);
    
  }

Also refer to:

• The videos on this page

Show On Tablet Devices

Function:

Specifies if the form field shows on a tablet.

Accepted Values:

• Selected - The form field shows on a tablet.
• Deselected - The form field does not show on a tablet.

Default Value:

Selected

Example:

Refer to:

• The videos on this page

Show On Mobile Phone Devices

Function:

Specifies if the form field shows on a mobile device.

Accepted Values:

• Selected - The form field shows on a mobile device.
• Deselected - The form field does not show on a mobile device.

Default Value:

Selected

Example:

Refer to:

• The videos on this page