Input Field element

Input Field element

Compose Enterprise is going through a design update. The illustrations on this page might be of the old design, but the information is up to date. Thank you for your patience during this update!

Norsk

Create or open a previously created form and navigate to the Builder section of the Form Builder. You will find the input field element in the Elements menu on the right hand side. Click to add the input field element to the canvas.

Select the newly created input field element in order to access the Properties panel underneath the Elements menu.

Properties - Builder

Text

Write the text/question you want the user to read in the published form in the input field under Text. The entered label will appear in the canvas when you press enter or move to the next setting.

Position

Select where you want to place your label in regard to the input field. Your choices are LeftRightTop and No label.

Override Width

Choose how wide the label field should be. If you check off this check box a new field will appear and you can enter the desired number of characters (in measurement of em – 2em = 2 times the size of the current font).

Type

Choose whether the value input element is an Input fieldText areaDate or a Password.

Validation

Choose from default and custom-built validations for the input. Every question except file upload and date, has String as default validation. For more info about validations, see the Validation Builder documentation.

Max

Choose the limit for the maximum amount of characters allowed in the input field.

Override Width

Choose the width of the input field. Check the check box to display a new field where you can enter a desired number of characters (in measurement of em – 2em = 2 times the size of the current font).

Read-only

Toggle this check box in order to make the element read-only.

Alias

Question alias is a unique additional identifier that may be set on a question. It is non-mandatory and there are rules as to which names it can take. It can't e.g. start with a capital letter, contain white-space characters or letters outside the Latin alphabet, and must have a length of 1 to 40 characters. The question alias can be used to automatically map form questions with a PDF template in the Workflow Builder.

Events

Choose if you want to trigger actions with events for this question. There are three types of actions; Execute scriptCall CNG service and Call Generic Service, and there can be multiple actions triggered per question. See the Events Menu documentation for more information.

Autocomplete

Provides the end-user with a dropdown of options (“suggestions”) that autocomplete the input. Say, if the end-user writes “a”, all options with an “a” is left. The options are set either by an Option Source or a Service call. See the Auto-populate and Autocomplete - Option Source II and/or the Generic services (form and workflow population) documentation to learn how to connect option sources and/or generic services to form content.

Min

Define how many characters the end-user should write before the dropdown of autocomplete suggestions appear.

 

Properties - Help/Style

Help Text

Toggle Display Help and write a Help Text for guiding the end-user in writing the right answer for this question. The help text is available to the user next to the element by clicking the  icon.

Help icon placement

The Help icon placement controls where the help icon is placed. Your choices are: Next to label and Next to input.

Tooltip

Toggle Display Tooltip and write a Tooltip for guiding the end-user in writing the right answer for this question. The tooltip is available to the user by hovering over the element.

Style – Tag Names

Insert tags which will be translated into CSS class names for the implementation elements in the respondent-GUI. The feature comes in handy when you are customizing a skin.

Hint Text

Toggle Display Hint and write a Hint Text  for guiding the end-user in writing the right answer for this question. Choose the width and position of the hint text in the Width and Position fields. This only limits the visual width of the hint text. The hint text can be visible to the user to the right, at the bottom or inside the element.

For more guidance on shaping form content through guiding texts and styling, check out the user guides through the documentation page Help and Style - guide the end-user through the form.

 

Properties - Conditions

Display Condition

You can choose to hide and show elements depending on different conditions.

Enable Condition

You can enable and disable elements depending on different conditions.

Information about changing display and enable conditions can be found in the Display/Enable conditions and Condition scripting user guides.

 

Properties - Advanced

Use label from data model

The label saved in the data model will be shown in the respondent view.

Override label from data model

The label added to the currently opened view will be shown in the respondent view. The same question element (same Question ID) may therefore have different labels in different views. You might for instance want to shorten label text for question elements when used in a mobile view.

Validation Script runs when completing

In the Data Model is a validation script window, where you can customize a validation script. This is handy if your validation depends on other question elements (as you cannot reference question IDs in the Validation Builder). You can choose to have the validation script run when the end-user either completes the form, the page or the element.

The Question is

The end-user does not have to answer the question, is the question is optional or recommended (but a recommended question will launch a warning to the end-user recommending them to answer the question). It is mandatory for the end-user to answer the question, either by the completion of the form if it’s set to mandatory, or before entering the next page if it’s set to page mandatory.

Activate auto population

Based on the answer of another question in the form, the answer of this question can be automatically populated with pre-defined answers. Check the Activate auto population checkbox to reveal the auto-populate configuration settings below.

Trigger Auto Populate from Question

Choose the question that will trigger the auto-population by clicking Browse. The question ID of the selected question will be displayed here. Click Clear to remove the question as the trigger.

Enter

Click Options to launch a Options Menu. The answer values of the options are the triggering answers, while the text will be the answers automatically populated. Check out the Auto-populate and Autocomplete - Option Source II user guide to learn how to configure Auto-population properly.

Select

Toggle the radio button, browse and choose an option source to populate the options automatically. Learn more about option sources and how to connect them to forms in the Option Source user guide.

Option Source is also used by

Choose from your input variables in the Overridden by Input Variable dropdown menu to override the options. As of Compose 8.4.2, this function, although visible, is outdated.

Apply WebScriptlet

Provide the element with a Slider (for choosing integers with a slider) or a GeoLocationSelector.

Text Formatting

Select a Formatting mask in the drop down menu in order to format the input in the input field element. Choose between Credit card No.Telephone No.Org No.Bank account No., and Social Security No..