Form Builder

ID Description

ID	Description
ENG-70 ENG-96	Updated the functionality of the `<IsRequired>` tag so that employees who are completing your custom form need to select a checkbox before they can submit the form. For example, you could add an "Accept and Acknowledge" checkbox to a form that includes a policy the employee must read before they can continue. You can add this requirement for checkboxes in the following tags: `<EmployeeProperty>` `<EmployeePropertyGrid>` `<Field>` `<Grid Column>` If an employee fails to select a required checkbox in a form, an error displays and the form can't be submitted. The following is an example of an `<IsRequired>` tag used in an `<EmployeeProperty>` tag: Copy `<EmployeeProperty> <Style>IVTextBox</Style> <Block>1</Block> <Row>8</Row> <RowSpan>1</RowSpan> <Column>2</Column> <PropertyXRefCode>EmployeePropertyXrefCode28</PropertyXRefCode> <IsRequired>true</IsRequired> </EmployeeProperty>` See Appendix: Supported Tags in the XML Forms Guide.
ENG-89	Updated Workflow Administration > Form Builder so that a warning message displays when you attempt to delete a custom form that you selected as an associated form in a workflow decision node. The message asks you to confirm the deletion, and informs you that the Associated Form field is cleared from the workflow when you delete the form.
ENG-91	Added the ability to perform regular expression validation on a string field in an `<EPGridColumn>` tag before a form is submitted. The incorrect value is flagged directly on the field, with an error pop-up that you can customize. To support this functionality, two new tags are available: `<RegExp>`: Defines the regular expression that controls what you can enter in the field. For example, `^[0-9]$` restricts the field to numbers only. `^[A-Z]$` allows only uppercase letters. `<RegExpErrorMessage>`: Defines the error message that appears when you enter a value in the field that is outside of the regular expression definition. If you use a `<RegExp>` tag without a `<RegExpErrorMessage>` tag, a standard error message displays, "`[Field name]`: field value does not match given Regex". The following sample restricts a field to five lowercase letters, and outputs a custom message: Copy `<EPGridColumn> <BindingProperty>Value</BindingProperty> <XRefCode>EmployeePropertyXrefCode21</XRefCode> <IsRequired>True</IsRequired> <TextAlignment>Right</TextAlignment> <DefaultValue>az05</DefaultValue> <RegExp>^[a-z]{0,5}$</RegExp> <RegExpErrorMessage>Only up to 5 lowercase letters are allowed</RegExpErrorMessage> </EPGridColumn>` See Appendix: Supported Tags in the XML Forms Guide.

ENG-70

ENG-96

Updated the functionality of the <IsRequired> tag so that employees who are completing your custom form need to select a checkbox before they can submit the form. For example, you could add an "Accept and Acknowledge" checkbox to a form that includes a policy the employee must read before they can continue. You can add this requirement for checkboxes in the following tags:

<EmployeeProperty>
<EmployeePropertyGrid>
<Field>
<Grid Column>

If an employee fails to select a required checkbox in a form, an error displays and the form can't be submitted.

The following is an example of an <IsRequired> tag used in an <EmployeeProperty> tag:

Copy

    <EmployeeProperty>
      <Style>IVTextBox</Style>
      <Block>1</Block>
      <Row>8</Row>
      <RowSpan>1</RowSpan>
      <Column>2</Column>
      <PropertyXRefCode>EmployeePropertyXrefCode28</PropertyXRefCode>
      <IsRequired>true</IsRequired>
    </EmployeeProperty>

See Appendix: Supported Tags in the XML Forms Guide.

ENG-89

Updated Workflow Administration > Form Builder so that a warning message displays when you attempt to delete a custom form that you selected as an associated form in a workflow decision node. The message asks you to confirm the deletion, and informs you that the Associated Form field is cleared from the workflow when you delete the form.

ENG-91

Added the ability to perform regular expression validation on a string field in an <EPGridColumn> tag before a form is submitted. The incorrect value is flagged directly on the field, with an error pop-up that you can customize. To support this functionality, two new tags are available:

<RegExp>: Defines the regular expression that controls what you can enter in the field. For example, ^[0-9]*$ restricts the field to numbers only. ^[A-Z]*$ allows only uppercase letters.
<RegExpErrorMessage>: Defines the error message that appears when you enter a value in the field that is outside of the regular expression definition. If you use a <RegExp> tag without a <RegExpErrorMessage> tag, a standard error message displays, "[Field name]: field value does not match given Regex".

The following sample restricts a field to five lowercase letters, and outputs a custom message:

Copy

<EPGridColumn>
    <BindingProperty>Value</BindingProperty>
    <XRefCode>EmployeePropertyXrefCode21</XRefCode>
    <IsRequired>True</IsRequired>
    <TextAlignment>Right</TextAlignment>
    <DefaultValue>az05</DefaultValue>
    <RegExp>^[a-z]{0,5}$</RegExp>
    <RegExpErrorMessage>Only up to 5 lowercase letters are allowed</RegExpErrorMessage>
</EPGridColumn>

See Appendix: Supported Tags in the XML Forms Guide.