Date 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!
Create or open a previously created form and navigate to the Builder section of the form builder. You will find the date element in the Elements menu on the right hand side. Click to add the date element to the canvas.
Select the newly created date element in order to access its Properties menu under the Elements menu.
Builder | |
|---|---|
Text | Write the text/question you want the user to read in the published form in the textbox under Text. The new question 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 options. Your choices are Left, Right, Top 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 field, Text area, Date or a Password. |
Validation | Choose from default and custom-built validations for the input options. For date elements, the validation is Date by default. For more info about validations, see the Validation Builder documentation. |
Override Width | Choose how wide the date 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). |
Read-only | Toggle this check box in order to make the element read-only. |
Date Options | Click Date Options, and customize the date settings in the Date Options menu (more info in the section below). The date options are demonstrated in the Calendar - Date element user guide. |
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 script, Call CNG service and Call Generic Service, and there can be multiple actions triggered per question. See the Events Menu documentation for more information. |
Date Options Menu | |
|---|---|
Display year | Check Display year to display a calendar including years in respondent view. Decide how many years prior and after the date currently selected by the respondent user will be shown in the list of years, in the fields becoming visible after you check Display year. |
Display month | Check Display month to display a calendar including a list of the months of the year. |
Display week | Check Display week to display a calendar including the weeks of the year. |
Display dates of other months | Check Display dates of other months to display a calendar including dates from other months included in the weeks shown in the calendar. |
Number of months to show | Select the number of months you would like to display at the same time. You may show up to 5 months. |
Restrict date range | When Restrict date range is checked you are able to restrict the time frame in the date field. |
Fixed | The restricting can be set to a fixed/static time frame. |
Start | The first date possible to select in the fixed date range. The date can be selected from a date picker available for the input field. |
End | The last date possible to select in the fixed date range. The date can be selected from a date picker available for the input field. |
Relative to current date | The restricted time can be set as relative. The dates available will be relative the present when the end-user is filling out the form. |
Start | Enter the first possible day the end-user can select in the calendar. This could be prior or after the day the end-user is filling out the form. Select if it should be before (-) the current day or after (+) the current day the user is filling out the form. Enter year and/or month and/or days. |
End | Enter the last possible day for the end-user can select in the calendar. This could be prior or after the day the end-user is filling out the form. Select if it should be before (-) the current day or after (+) the current day the end-user is filling out the form. Enter year and/or month and/or days. |
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 settings 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 | N/A at current time. |
