There are two types of property, form and page. These are configuration settings that can be changed in the forms designer and determine the global and page level attributes of a form.
Different property types range from simple strings to complex JSON encoded JavaScript objects. Many of these properties are required by the site templates.
Pre-defined Properties used by iCM
| Property | Description |
|---|---|
| Boolean | This allows a true or false value to be selected as the property value |
| Date | This allows a fixed date to be selected as the property value. A calendar dialogue can be used to select the date |
| Integer | This allows an integer to be entered as the property value |
| String | This allows a single string to be entered as the property value |
| String (Multiline) | This allows a multi-line string to be entered as the property value. A multi-line dialogue can be used to enter the value |
| Regular Expression | This allows a JavaScript regular expression to be entered as the property value. A dialogue is available to assist with the entry of the regular expression. This can also be used for testing the expression |
| List | This allows the selection of a single value for the property from a list. The value displayed in the list can be different from value set for the property |
| Combo Box | This allows the selection of a single value for the property from a list or the entering of a different value |
| Data | This allows the property value to contain a list of values. Each value can consist of the actual value and a display value. A dialogue is used in the form designer to allow these values to be entered directly or read from a database |
| Grouped Data | This allows the property value to contain a list of values. Each value can consist of the actual value and a display value. An additional value can be specified that allows the list content to be grouped. A dialogue is used in the form designer to allow these values to be entered directly or read from a database |
Copy a Property
The copy a property option is used to create a duplicate property. Right-click on the property you would like to copy and click "Copy this property".
Create or Edit a Property
To create a new property right-click on "Form Properties" or "Page Properties" and choose "Create a property". To edit an existing property, double-click on it.
For each property you can define:
| Property | Description |
|---|---|
| Name | A unique identifier for the property |
| Type | One of the pre-defined types described above |
| Options | The list items a user can select in this property (if applicable) |
| Label | The label that will be displayed in the forms designer |
| Description | A short description of the property |
| Default for existing fields | An optional default value for the property where this field has already been added to a form. This default value will be preserved even if the form is imported, exported and republished |
| Default for new fields | An optional default value that will be used when the field is added to a form |
| Validation | Not currently used |
| Display Order | The property's ordering in the settings panel in the forms designer |
| Allow Edit | True if the property can be edited in the designer, false if not |
| Help Text | The help text visible in the forms designer |
Two Default Values?
There may be times when a new version of a field is released as part of an iCM patch or fix and the previous behaviour needs to be retained in forms that are already in use.
Field properties can supply two default values. In the majority of cases the two default values will be the same. The value that gets used depends on when the field is added to a form.
For example, an existing form is using a field with a property that has a default value of
The existing forms can be republished, exported, imported, republished somewhere else, and the default value for existing fields in our example will stay as
Delete a Property
To delete a property, right-click on it and select "Delete this property". Be very careful when deleting any items in a form family as it could cause some forms to stop working when they are next published.
Share this page
