Validator Settings

Seed set of validators is created in the system when the plugin is installed. Confluence Administrators can backup existing validators by using the Export link in the bottom of the form: validators are saved to disk as a JSON file. Import link will add validators from a file to the system.

Import can only add new validators, existing validators are preserved. To modify a validator via export-import you need to delete the validator before import.

images/wiki/download/attachments/44696025/Screenshot-29.png

Confluence administrators define validators by setting validator properties detailed below.

Type

images/wiki/download/attachments/44696025/Screenshot-21.png

Validator type defines the basic validator behaviour. Currently there are seven validator types defined in the plugin:

Code

images/wiki/download/attachments/44696025/Screenshot-22.png

Validator code is a system identifier of the validator. To apply a validator to a table cell you will use the validator code with dsvalidate- prefix:

images/wiki/download/attachments/44696025/Screenshot-32.png

Please use only alphanumeric characters and dashes in validator code. Using other characters may cause validator to fail.

Name

images/wiki/download/attachments/44696025/Screenshot-28.png

A human-readable name of a validator. This is what is displayed in the validator list in the left-hand section of the form.

External Module

images/wiki/download/attachments/44696025/Screenshot-24.png

External validator modules are discussed in a separate section.

Prompt

images/wiki/download/attachments/44696025/Screenshot-25.png

A prompt is a text that will be displayed in a table cell if the cell is empty, for example:

images/wiki/download/attachments/44696025/Screenshot-33.png

Warning

images/wiki/download/attachments/44696025/Screenshot-26.png

A warning message is a text that will be displayed in a table cell when the value in the cell is invalid:

images/wiki/download/attachments/44696025/Screenshot-34.png

Validator text

images/wiki/download/attachments/44696025/Screenshot-27.png

Validator text has different meaning with different validator types. This can be a list of values, a CQL query, а regular expression etc. Please refer to validator types description in the previous sections.