Table of Contents |
---|
Author: Xavier Thevenot
Introduction to enterprise properties
Administrators can set enterprise properties in the UI when they create or modify an enterprise, and create or modify the properties of an existing enterprise through the API (see EnterprisesResource).
...
Tip |
---|
The maximum length of enterprise property elements is:
|
...
Create a list of preset enterprise properties
To define preset enterprise properties, enter a list of your custom property definitions in the client-config-custom.json
file.
Use the UI configuration property defined in the client-config-default.json
file. By default, the preset list will be empty and the property is the following:
...
.
Code Block |
---|
"config.enterprise.properties" : [] |
...
The preset property types you can define are described in the following sections and can be the following:
input
combo
multiple
...
Define an input property
To enable the user to edit a text value for a key, use the Input type.
Input property
Code Block | ||
---|---|---|
| ||
{"type": "input", "key":"property_input", "value":"value", "required":true} |
The object must have the type
value as 'input
'. Then you have to define key key
and value
attributes (these are mandatory, otherwise the property will fail in UI). You can also add the required
attribute, set to true
if you want to force this property value to be added to enterprise properties.
...
Define a Combo selection property
To enable the user to set a value by selecting one of the set of elements defined in the values
attributes, use the Combo combo
type.
...
Code Block | ||
---|---|---|
| ||
{"type": "combo", "key":"property_combo", "value": "first", "values":[ {"name":"First property", "value":"first"}, {"name":"Second property", "value":"second"}, {"name":"Third property", "value":"third"} ] } |
The object must have the Set the type
value as 'of the object to combo
'. Then you have to define key key
and value attributes (these value
attributes, which are mandatory , otherwise or the property will fail in UI), and a list of values
: each . Each object must have a name
(displayed in the combo-box) and a value
(will be used as value value
in the key/value property). You can also add the required
attribute set to true
if you want to force this property to be added to enterprise properties.
...
...
Define a multi-selection property
To enable the user to edit a list of values by selecting one or more values from the set of elements displayed in a multi-selection grid, use the Multi multi
type.
...
Code Block | ||
---|---|---|
| ||
{"type": "multi", "key":"property_multi", "value": "second", "values":[ {"name":"First property", "value":"first"}, {"name":"Second property", "value":"second"}, {"name":"Third property", "value":"third"} ] } |
The object must have Set the type
value as 'multi'of the object to multi
. Then you have to define key key
and value attributes (these value
attributes, which are mandatory , otherwise or the property will fail in UI), and a list of values
: each . Each object must have a name
and a value
(which will be used as the value in the key/value property). You can also add the required
attribute and set it to true
if you want to force this property to be added to enterprise properties.
...
...
Full example
Putting all the above examples together, the client property will have the following value.
...
Code Block |
---|
"config.enterprise.properties" : [ {"type": "input", "key":"property_input", "value":"value", "required":true}, {"type": "combo", "key":"property_combo", "value": "first", "values":[ {"name":"First property", "value":"first"}, {"name":"Second property", "value":"second"}, {"name":"Third property", "value":"third"} ] }, {"type": "multi", "key":"property_multi", "value": "second", "values":[ {"name":"First property", "value":"first"}, {"name":"Second property", "value":"second"}, {"name":"Third property", "value":"third"} ] }] |