Adding fields to a web form
In a Web form, fields enable users to enter information and select options. Web forms can offer input fields, selection fields, static and advanced content (captchas, subscriptions, etc.).
When you use the wizard to add fields, the field type is detected automatically based on the selected field or storage variable. You can edit it using the Type drop-down box in the General tab.
When using the buttons in the toolbar, select the type of field you want to add.
The following types of field are available:
- Text/number input. See Adding input fields .
- Drop-down list selection. See Adding drop-down lists .
- Multiple choice via checkboxes. See Adding checkboxes .
- Exclusive selection via radio buttons. See Adding radio buttons .
- Vote in an option grid. See Adding grids .
- Numbers and dates. See Adding dates and numbers .
- Subscription/unsubscription to an information service. See Subscription checkboxes .
- Captcha validation. See Inserting a captcha .
- Download button. Uploading a file .
- Hidden constant. See Inserting a hidden constant .
Please specify the response storage mode: update a field in the database (stores only the last value saved) or store in a variable (the answer is not stored). For more on this, refer to Response storage fields .
By default, the field is inserted at the bottom of the current tree. Use the arrows in the toolbar to move it up or down.
Field creation wizard
For each page of the form, you can add a field via the first button in the toolbar. To do this, go to the Add using the wizard menu.
Select the type of field you want to create: you can choose to add a field in the database, a variable or to import a group of fields created in another form and collected in a container.
Click Next and select the storage field or variable, or the container you want to import.
Click Finish to insert the selected field into the page.
Adding input fields
To add an input field, click the Input control button and choose the type of field you want to add.
Types of input fields
Five different types of text fields can be inserted into a form page:
- Text : lets the user enter a text on one line.
- Number : lets the user enter a number on one line. for more on this, refer to Adding numbers .When the page is approved, field content is checked to make sure the value entered is compatible with the field. For more on this, refer to Defining control settings .
- Password : lets the user enter text on a single line. During text entry, the characters are replaced by periods:Passwords are stored unencrypted in the database.
- Multi-line text : lets the user enter text on several lines.Multi-line text fields are specific fields that can contain carriage returns. Their storage space must be associated with a field mapped on an XML element, not an XML attribute. For more on the types of data in schemas, refer to the "Schema reference" chapter in this section .If you are using the Survey module, you can store this type of field in an archived field which will automatically adapt to the format. For more on this, refer to this section .
- Enriched multi-line text : lets the user enter text with a layout which will be stored in HTML format.You can select the type of editor offered to users. To do this, use the drop-down box of the HTML editor field in the Advanced tab.The number of icons displayed varies depending on the type of editor. For an Advanced editor, the rendering will be as follows:
Configure input fields
Input fields are all configured based on the same mode, using the following options:
The General tab lets you enter the name of the field and attribute a default value to it if necessary.
The answer storage mode can be altered via the Edit storage... link. Values can be stored in an existing field of the database; or you can choose not to save information in the database (use a local variable).
Storage modes are detailed in Response storage fields
The Advanced tab lets you define display parameters for the field (position of labels, alignment, etc.). See Defining web forms layout .
Adding drop-down lists
You can insert a drop-down list into a survey page. This lets the user select a value from those on offer in a drop-down menu.
To add a drop-down box to a form page, click the Selection controls > Drop-down list button in the toolbar of the page editor.
Select the answer storage mode and confirm your choice.
Define the labels and values of the list in the lower section of the General tab. If the information is stored in an existing field of the database and it is an enumeration field, you can fill in the values automatically by clicking Initialize the list of values from the database , as shown below:
Use the arrows to the right of the list of values to change their sequence.
If the data is stored in a linked table, you can select the field where the values to be suggested in the list are saved. For example, if you select the table of countries, click Initialize the list of values from the database... and select the desired field.
Next, click the Load link to retrieve the values:
Repeat this operation whenever the list is updated to refresh the values on offer.
In order for the user to select an option, you need to use a checkbox.
To add a checkbox to a form, click the Selection controls > Checkbox... icon in the toolbar of the page editor.
Select the answer storage mode and confirm your choice.
Enter the label of the box in the Label field of the General tab.
A checkbox lets you assign a value to the storage field (or value) depending on whether or not the box is checked. The Values section lets you enter the value to assign if the box is checked (in the Value field), and the value to assign if it is not checked (in the Empty value field). These values depend on the data storage format.
If the storage field (or variable) is boolean, the value to assign if the box is not checked will be deduced automatically. In this case, only the Value if checked field is offered, as shown below:
Example: Assign a value to a field if a box is checked
We want to insert a checkbox into a form to send a maintenance request, as shown below:
The information will be uploaded to the database and into an existing field (in this case, the Comment field):
If the "Maintenance required" box is checked, the Comment column will contain "Maintenance required". If the box isn't checked, the column will show "Maintenance not required". To obtain this result, apply the following configuration to the checkbox on the form page:
Grids are used to design voting pages in Web applications. This lets you offer lists of radio buttons for answering survey or assessment type Web forms, as shown below:
To use this type of element in a form, create a simple grid and add a line for each element to be assessed.
The number of radio buttons in each line of the grid matches the number of values defined in the simple grid.
Only one option can be selected per grid line.
In our example, the label of the grid is hidden. To do this, go to the Advanced tab, the Label position display is defined as Hidden . See Defining the position of labels .
Adding dates and numbers
The content of the form fields can be formatted to match the data stored in the database or to satisfy a particular requirement. You can create suitable fields for the entry of numbers and dates.
To allow the user to enter a date in a form page, select Add input field > Date... in the toolbar or page editor.
Enter a label for the field and configure the data storage mode.
The lower section of the window lets you select the date and time formats for the values stored in this field.
You can also choose not to display the date (or time).
Dates can be selected via a calendar or drop-down boxes. You can also enter them directly in the field, but they need to match the format specified in the screen above.
By default, dates used in forms are entered via a calendar. For multilingual forms, please check that calendars are available in all the languages used. See Translating a web form .
However in some cases, (for entering dates of birth, for instance) it may be easier to use drop-down lists.
To do this, click the Advanced tab and choose the input mode using Drop-down lists .
You can then set limits to the values offered in the list.
You can create suitable fields for the entry of numbers.
In a numeric field, the user can enter numbers only. Entry control is applied automatically when the page is approved.
Depending on the field in which data is stored in the database, special formatting or certain restrictions may be applied. You can also specify maximum and minimum values. This type of field is configured as follows:
The default value is the value displayed in the field when the form is published. It can be corrected by the user.
You can add a prefix and/or suffix to the numeric field via the Advanced tab, as shown below:
In the form, the rendering will be as follows:
You can add controls to allow users to subscribe to or unsubscribe from one or more information services (newsletters, warnings, real-time notifications, etc.). To subscribe, the user checks the corresponding service.
To create a subscription checkbox, click Advanced controls>Subscription .
Indicate the label for the checkbox and select the information service concerned using the Service drop-down box.
Information services are detailed in this page .
The user subscribes to the service by checking the relevant option.
If the user is already subscribed to an information service and the box linked to this service isn't checked when they approve the form, they will be unsubscribed.
Examples of subscriptions and referrals are available in this section .
Inserting a captcha
The purpose of captcha tests is to prevent fraudulent use of your Web forms.
If your form contains several pages, the Captcha must always be placed on the last page, just before the storage box, to prevent any circumvention of the security measures.
To insert a Captcha into a form, click the first button on the toolbar and Select Advanced controls>Captcha .
Enter the label of the field. This label will be displayed in front of the Captcha display area. You can change the position of this label in the Advanced tab.
For captcha type controls, there is no need to indicate a storage field or variable.
The Captcha is inserted into the page with an input field placed under the visual. These two elements are inseparable and are considered as a single item for the purpose of page layout (they occupy a single cell).
When the page is confirmed, the input field is displayed in red if the content of the Captcha was not entered correctly.
You can create an error message to display. To do that, use the Personalize the message link in the General tab.
Captchas are always 8 characters long. You cannot modify this value.
Uploading a file
You can add an upload field to a page. This functionality can be useful for intranet file sharing, for instance.
To insert an upload field to a form page, select the Advanced controls > File... menu in the toolbar of the page editor.
By default, the uploaded files are stored in resource files accessible via the Resources > Online > Public resources menu. You can use a script to change this behavior. This script can use the functions defined in Campaign JSAPI documentation , including those that concern file manipulation.
You can store the link to these files in a local variable or in a database field. For example, you can extend the recipient schema to add a link to file-based resources.
- This type of file must be reserved for forms with secure access (using credentials).
- Adobe Campaign does not control the size or the type of resource uploaded: we therefore highly recommend using upload fields for secure type intranet sites only.
- If several servers are linked to the instance (load balancing architecture), you need to make sure calls to the Web form arrive on the same server.
- These implementations require the assistance of the Adobe Campaign Consulting team.