Custom equipment parameters

You can add custom parameters to the platform objects. For example, item numbers, extended warranty information, additional specifications, etc.

Custom parameters can be used in global search and filtering of information in tables.

In the current version, it is possible to add parameters to the following objects:

servers;
chassis;
switches;
PDUs;
UPS;
warehouse equipment;
racks.

Fields for custom parameters can be of the following types:

String — single-line text;
Multiline text;
Select — selection field with the possibility of entering a custom value;
Date;
Number;
Checkbox — logical parameter (yes/no);
Link.

Parameter management via interface

To manage the parameters, go to the Equipment section → Additional parameters tab.

To add a parameter:

Select the equipment type → click Create parameter button.
Specify the parameter settings:
1. Choose the Field type:
  - String;
  - Multiline text;
  - Select — selection field with the possibility of entering a custom value;
  - Date;
  - Number;
  - Checkbox;
  - Link.
2. Specify the Internal name for API — name to be used in API requests. Must be unique within the selected object type.
3. Specify the RU field name –- the name to be displayed in the Russian interface.
4. Specify the EN field name –- the name to be displayed in the English interface.
5. If this field should be mandatory when creating and modifying the object, enable the Mandatory parameter option.
Click Create button.

The higher a parameter appears in the list, the higher it will be on the create and configure equipment forms. To change the position of a parameter, click the icon and drag the row to the desired location.

To change parameter, click the icon.

To delete parameter, click the icon.

Adding an object

When adding an object to the platform, fields for entering custom parameters are displayed on the form under Additional parameters.

Editing an object

Open the object card and enter Additional parameters to change the value of the object's custom parameters.

Displaying parameters in tables

Press the icon in the upper right corner and select the required parameters from the list to enable the display of custom parameters in the table.

Parameter management via API

Creating parameters

To create custom parameters for a certain type of equipment, run a POST request:

POST https://domain.com/dci/v3/custom_field/entity_name

Comments

In the body of the request, specify a description of the parameters:

Example of description

{
	"fields": [{
			"field_name": "param1",
			"is_required": true,
			"priority": 1,
			"readable_name": "Parameter 1",
			"readable_name_ru": "Параметр 1",
			"type": "string"
		},
		{
			"field_name": "param2",
			"is_required": false,
			"priority": 2,
			"readable_name": "Parameter 2",
			"readable_name_ru": "Параметр 2",
			"type": "text"
		},
		{
			"field_name": "param3",
			"is_required": false,
			"priority": 3,
			"readable_name": "Parameter 3",
			"readable_name_ru": "Параметр 3",
			"type": "select"
		}
	]
}

Comments

This POST request does not add new parameters, but recreates all parameters for the selected equipment type. All previously created parameters for this type of equipment will be deleted.

Deleting parameters

To delete custom parameters for a certain type of equipment, run a DELETE request:

DELETE https://domain.com/dci/v3/custom_field/entity_name

Comments