By clicking on "Add field" a new screen will open where we can create the new field:
Image 1: field configuration screen where you can see the "add field" button
In this screen, a series of data will have to be filled in that will depend on the type of field that you want to add. Below are explained all the types of fields available, with the options that each field has and examples of how they would look on the forms.
This type of field will allow the user to write a single line in a box. The options for this field are:
Image 1: field configuration screen. Detail type "text box"
- Internal name of the field : it is the name that will appear in the XML.
- Title : is the title that will be seen on the form and on the receipt. However, by clicking on the option below ("Do not show the title on the form"), we can hide this title from the form, but it will still appear on the receipt.
- Finally, we can choose if it will be mandatory for the user to enter a value in this field or not, and if we want to add a help text to guide the user in filling out the field.
Image 2: field configuration screen. Detail type "text box", where the user is allowed to enter a "short answer"
The number field is very similar to the text box, but will only allow the user to enter numbers. The options for this field are:
Image 1: field configuration screen. Detail type "number"
- Internal name of the field : it is the name that will appear in the XML.
- Title : is the title that will be seen on the form and on the receipt. However, by clicking on the option below ("Do not show the title on the form"), we can hide this title from the form, but it will still appear on the receipt.
- Minimum field length (optional): Number of digits that the entered number must have at least.
- Maximum length of the field (optional): Number of digits that the entered number must have at most.
- Minimum value of the field (optional): The minimum value that is allowed to be entered in the box.
- Maximum value of the field (optional): The maximum value that is allowed to be entered in the box.
- Finally, we can choose if it will be mandatory for the user to enter a value in this field or not, and if we want to add a help text to guide the user in filling out the field.
Visually, it is the same as the text box, but the user will only be able to enter numbers:
Image 2: field configuration screen. Detail type "number" with the possibility of entering numbers by the user
For cases where the user needs to enter more text, we have the "Text Box (Multiline)" which will show us a larger box where the user can write several lines of information. The options are the same as for the one-line text box:
Image 1: field configuration screen. Detail type "multiline text box"
- Internal name of the field : it is the name that will appear in the XML.
- Title : is the title that will be seen on the form and on the receipt. However, by clicking on the option below ('Do not show the title on the form (It will only be shown on the receipt)), we can hide this title on the form, but it will still appear on the receipt.
- Finally, we can choose if it will be mandatory for the user to enter a value in this field or not, and if we want to add a help text to guide the user in filling out the field.
Image 2: field configuration screen. Detail type "multiline text" with the possibility of entering a long answer by the user
A multiple check box will allow the user to select several or all of the options that are set. The screen to create one is as follows:
Image 1: field configuration screen. Detail type "multiple selection box"
- Title : is the title that will be seen on the form and on the receipt. However, by clicking on the option below (Do not show the title on the form), we can hide this title from the form, but it will still appear on the receipt.
- Options : we will have a section where you can add the options we need (it must be at least one). If we make a mistake, we can also rearrange and delete them. In addition, for each of the options, we will have to enter the internal name of the field, which is the name that will appear in the XML.
- Finally, we can choose if it will be mandatory for the user to enter a value in this field or not, and if we want to add a help text to guide the user in filling out the field.
Image 2: field configuration screen. "multiple selection box" type detail with an example of a selector
Single check boxes will allow the user to select one of all the options configured there. The options for this field are:
Image 1: field configuration screen. Detail type "single selection box" with an example of a selector.
- Internal name of the field : it is the name that will appear in the XML
- Title : is the title that will be seen on the form and on the receipt. However, by clicking on the option below ("Do not show the title on the form"), we can hide this title from the form, but it will still appear on the receipt.
- Options : we will have a section where you can add the options we need (in this case at least two because the user will have to choose only one of all the possible ones). If we make a mistake, we can also rearrange and delete them.
- Finally, we can choose if it will be mandatory for the user to enter a value in this field or not, and if we want to add a help text to guide the user in filling out the field.
Image 2: field configuration screen. Detail type "single selection box" with an example of a selector.
The drop-down list is another option that will allow the user to select one of all the options configured there. The display for this field is exactly the same as for the single check box:
Image 1: field configuration screen. "drop-down list" type detail with an example of a selector.
- Internal name of the field : it is the name that will appear in the XML.
- Title : is the title that will be seen on the form and on the receipt. However, by clicking on the option below ("Do not show the title on the form"), we can hide this title from the form, but it will still appear on the receipt.
- Options : We will have a section where you can add the options we need (in this case at least two because the user will have to choose only one of all the possible ones). If we make a mistake, we can also rearrange and delete them.
- Finally, we can choose if it will be mandatory for the user to enter a value in this field or not, and if we want to add a help text to guide the user in filling out the field.
The only difference between the single checkbox type and the drop-down list type is the way in which it will be displayed to the user, who in the case of the latter, would see it in the form of a drop-down:
Image 2: field configuration screen. "drop-down list" type detail with an example selector.
With the title field we can add a title that will allow us to separate the form into sections. The options for this field are simply a title for the field and the text we want the title to have:
Image 1: field configuration screen. "Title" type detail
Since the title is simply text that is displayed on the screen, it is not sent through the XML, nor does it allow you to hide it or add help text.
Image 2: screen showing how the "example title" field looks once configured
The description will allow us to add an information field within the form. The options for this field are simply a title for the field and the text we want the description to have:
Image 1: field configuration screen. "Description" type detail
Since the description is simply text that is displayed per screen, it is not sent through the XML, nor does it allow us to hide it or add help text.
Image 2: screen showing how the "example description" field looks once configured
The file field will allow the user to attach a file to the form. The options for this field are:
Image 1: field configuration screen. "File" type detail
- Internal name of the field : it is the name that will appear in the XML
- Title : is the title that will be seen on the form and on the receipt. However, by clicking on the option below ('Do not show the title on the form (It will only be shown on the receipt)'), we can hide this title from the form, but it will still appear on the receipt.
- Finally, we can choose if it will be mandatory for the user to enter a value in this field or not, and if we want to add a help text to guide the user in filling out the field.
Image 2: screen showing how the "File" field looks once configured