Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
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).

...

Then in Abiquo, administrators can modify existing properties or add new properties when they create or edit the enterprise. 

Tip

The maximum length of enterprise property elements is:

  • key of 255 characters

  • value of 255 characters

...

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:.

Enterprise properties
Code Block
title
"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.

Code Block
languagejavascriptjs
titleInput property
{"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 valueattributes (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.Image Removed

...

Define a Combo selection property

To enable the 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
languagejavascripttitleCombo propertyjs
{"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  You can also add the required attribute set to true if you want to force this property to be added to enterprise properties.Image Removed

...

...

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 elements displayed in a multi-selection grid, use the Multi multi type.

Code Block
languagejavascriptjs
titleMulti property
{"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  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.Image Removed

...

...

Full example

Putting all the above examples together, the client property will have the following value.

Full example
Code Block
title
"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"}
 	]
}]