We are providing ways for customers to produce custom form schema which can be read by certain components in opCharts to show additional fields which can be configured to the users liking.
These files are stored in
conf/form_schemas and are json encoded schema which will tell our form system how to render.
Currently there is no way to get dynamic data for helping drive select lists for example but this could change in the future, let us know what you want to see.
Supported opCharts Components
The Filename must be prefixed with the application name, eg opCharts_
The filename must have .json at the end and only be a-Z 0-9 ascii characters.
Part of the filename will be saved to schema documents so changing the filename at a later date will break linkage.
|label||String||yes||Title of the form schema which will be shown in the gui|
|description||String||no||Give context to your users about what this form is for|
|component||array[string]||no||Allow the form schema to show for different components, is an array so a form could be shared over more than one component, if this is not defined then it will show over more than type of component.|
|tags||array[string]||no||We use this in element_inventory to then filter down form types for different inventory, its an array so you can share this form over multiple types of inventory.|
|schema||object||yes||Deep structure to represent the form|
|schema.<key>||nested key||yes||Defines what the value will be saved under|
|schema.<key>.type||string||no||Defines the type of field type to be rendered, if not defined it will default to Text|
|schema.<key>.title||string||no||Defines the text that appears in a form field's label|
|schema.<key>.help||string||no||Help text to add next to the editor.|
|schema.<key>.validators||array||no||A list of validators, see validation below|
Supported Field Types
|required||Checks the field has been filled in.|
|number||Checks it is a number, allowing a decimal point and negative values.|
|range||Checks it is a number in a range defined by |
|Checks it is a valid email address.|
|url||Checks it is a valid URL.|
|match||Checks that the field matches another. The other field name must be set in the |
|regexp||Runs a regular expression. Requires the |
See Backbone Form Validation for examples and further docs.