Button form control

Label

Description:

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

Allowed Values:

One line of text (a string).

Accepted:

• Letters
• Numbers
• 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

Description:

Specifies a unique, technical name for your control.

Allowed Values:

One line of text (a string).

Not Accepted:

• 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.

Help Text

Description:

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

Allowed Values:

More than one line of text.

Default Value:

None

Example:

Refer to:

• The videos on this page

Help Text Display

Description:

Specifies if the field shows the text in the Help Text field when the runtime app user hovers over the label or field.

Allowed 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

Action

Description:

Specifies what the form does.

Allowed Values:

• Click - Configure a custom action for the button with a Javascript function.
• Submit - Submits the form data.
• Cancel - Cancels the form data.
• Save - Saves the form data to be submitted later.

  This option only applies to process-based apps. You can not save an eForm in a form-based app.

• Reset - Resets the form fields to empty.
• Print - Prints the form.
• Save as PDF - Saves the form in PDF format.
• Navigate to Previous Section - Goes back to the last section of the form.
• Navigate to Next Section - Goes to the next section of the form.

Default Value:

Click

Example:

Refer to:

• The videos on this page

Show As Image Button

Description:

Specifies whether the form control shows as an image.

Allowed Values:

• Selected - Shows the form control as an image.
• Deselected - Does not show the form control as an image.

Default Value:

Deselected

Example:

Refer to:

• The videos on this page

Font Family

Description:

Specifies the font family of the input text and label.

Allowed Values:

A font name from the list.

Default Value:

• Modern theme - Roboto
• Classic theme - Arial

Example:

Refer to:

• The videos on this page

Font Style

Description:

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

Allowed 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

Description:

Specifies the background color for your control.

Allowed 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

Description:

Specifies the border color for your control.

Allowed 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

Description:

Specifies the foreground color for your control.

Allowed 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

Field CSS Class

Description:

Specifies a CSS class for the field in your control.

Allowed 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

Description:

Specifies a CSS class for the container of your control.

Allowed 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)

Font Size (px)

Description:

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

Allowed Values:

An integer.

Range:

• Greater than 0

Default Value:

• Classic theme - 12
• Modern theme - 14

Example:

Refer to:

• The videos on this page

Enabled

Description:

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

Allowed 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)

Right To Left

Description:

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

Allowed 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

Description:

Specifies if the runtime app user sees the field.

Allowed Values:

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

Default Value:

Selected

Example:

Refer to:

• The videos on this page

Button Alignment

Description:

Specifies the alignment of the button in the form control container.

Allowed Values:

• Top - Aligns the button to the top of the container.
• Middle - Aligns the button to the middle of the container.
• Bottom - Aligns the button to the bottom of the container.

Default Value:

Top

Limitations:

This field is available in these releases:

• AgilePoint NX OnDemand (public cloud)
• AgilePoint NX PrivateCloud or AgilePoint NX OnPremises v9.0 Software Update 1 or higher

Field ID

Description:

Shows an ID of the control.

Allowed Values:

Read only.

Default Value:

Different for different controls.

Example:

Refer to:

• The videos on this page

JavaScript Function

Description:

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

Allowed 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

Description:

Specifies if the form field shows on a tablet.

Allowed 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

Description:

Specifies if the form field shows on a mobile device.

Allowed 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