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
- 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
- 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.
- 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.
- This is the label that displays next to the data field.
- This is the text that is displayed in the data field before the user clicks within.
- 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
- 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:
- This is the attribute to run the check against
- This is the type of condition to check the attribute against the below value. Eg Equals is an exact match
- This is the value to compare the attribute against using the condition above.