Managing element properties
Accessing element properties
To access the properties of an element:
Right-click the element in the Surveyor or on the Elements page of a view card.
Select Properties.
The Properties window will open, with a separate tab for general and for custom properties.
Note
To access properties of views and services, you can also use the Surveyor right-click menu.
Adding a custom property to an item
Tip
See also: DataMiner Cube – Adding properties to elements, views and services on DataMiner Dojo
To add a custom property to a DataMiner item, which can be an element, but also a service, a view, or an alarm:
Right-click the item and select Properties.
In the Properties dialog box, go to the Custom tab.
Click the cogwheel button in the lower left corner, and select Add.
Enter a name for the custom property.
Specify the following options:
Make this property available for alarm filtering: Select this checkbox if you want the property to be used in the Alarm Console, in filters and in Correlation rules.
Note
This option is not available for alarm properties, as these are always available for alarm filtering.
Display this property in the Surveyor: Select this checkbox if you want the property to be visible next to the DataMiner item in the Surveyor.
Note
By default, the property will be displayed next to the item in the Surveyor in the format [Property name]: [Property value]. However, it is possible to configure the DMA to display only the property value. See Customizing how properties are displayed in the Surveyor.
Update alarms on value changed: If you want alarms to be updated when the value of the property changes, make sure this option is selected; otherwise make sure this checkbox is cleared. This option is only available if Make this property available for alarm filtering is selected.
No format specified: If you do not want to restrict the allowed values, select this option.
Format (regular expression): If you want to restrict the allowed values by means of a regular expression, select this checkbox and enter a regular expression in the text box.
Possible values: If you want to specify a list of allowed values, select this checkbox and add all allowed values to the list. Optionally, assign a metric value to each value to determine in which order the values will be displayed to the user. The lowest number will be displayed at the top of the dropdown list.
In the Edit dialog box, click OK.
In the Properties dialog box, click OK.
Editing custom properties
Note
If an element has been created by another parent element, it is possible that some of its properties cannot be edited, except by an Administrator or via the parent element.
Right-click the item in the Surveyor and select Properties.
Alternatively, to view properties for several elements at a time, on the Elements page of a view card, select several elements by holding the Ctrl key while you click them, then right-click one of the elements and select Properties.
In the Properties dialog box, go to the Custom tab.
To change a property value, enter the property value you want and click OK.
Note
If you selected several elements, and these have different property values, the value field will display (Multiple Values).
To change a property’s configuration, select the property you want to edit, click the cogwheel button in the lower left corner, and select Edit.
The same options will be available as when adding a new property.
Note
To change a property name, you will need to delete the property with the old name and create a property with the new name. The value of the property will be lost.
Deleting a custom property
Right-click the item and select Properties.
In the Properties dialog box, go to the Custom tab.
Select the property you want to edit.
Click the cogwheel button in the lower left corner, and select Delete.
Click OK to confirm.
Note
If an element has been created by another parent element, it is possible that some of its properties cannot be deleted, except by an Administrator or via the parent element.