Data field

The data field widget is used to create an input field that will populate a single attribute on an entity. When the form is submitted, an entity will be created in dynamics and its attributes will be populated with the values entered into the data fields.

Adding a data field widget to a form

Drag the "Data Field" widget from the toolbox onto the form

Click the 'Configure data field' icon or the edit link on the top left of the widget

A dialog will now display with various settings

Data tab:

Select a provider from the provider drop down. If the data field is placed in the same section as a Form Configurator this will be prepopulated

Select an entity from the entity drop down if the data field is placed in the same section as a Form Configurator this will be prepopulated

Select an attribute from the attribute drop down. When the form is submitted, the value entered in the field will populate the attribute selected here

Display tab:

Editor

Select an editor from the drop down. The editor will set the type of input which will be displayed to the user to enter a value for the selected attribute. Options available are Textbox, Numeric Texbox, Password Textbox, Date picker, Telephone and Text Area.

Style

Select the size of the data field that is to display. Options available include Small, Medium and Large.

CSS Class

Enter custom css classes which can be used with custom stylesheets to change the display of the field.

Label

This is the label that displays next to the data field.

Placeholder

This is the text that is displayed in the data field before the user clicks within.

Logic tab:

Hidden field:

This option will mark this as a hidden field. This will be no input displayed for this field

Is required:

This option marks the field as required. It must be completed in order to submit the form

Error message for required field: This option will only be available if “Is Required” is checked. The message entered here will display if the field is left empty and the form was submitted.

Validate input:

Validate as - Input will be validated against the selected option:

Custom expression. A custom regular expression can be used here to validate the field

Email

Webpage

Date

Min / Max length

Validation error message. This is the error message that displays when the field is invalid based off the above fields

Hide when:

You can use this to hide the field based on a condition. The field will not display when the following evaluates to true:

Attribute

This is the attribute to run the check against

Condition

This is the type of condition to check the attribute against the below value. Eg Equals is an exact match

Value

This is the value to compare the attribute against using the condition above.