Custom Attributes

This chapter describes how to work with Custom Attributes. You can use Custom Attributes to add additional attributes to Systems. Those additional attributes can be populated in the System details dialog. They can be used in Selectors.

You also have the option to show Custom Attributes in System lists. By default, they are not shown in System lists, use the list configuration action to display the Custom Attributes in System lists.

Custom Attributes can also be used as interpolations in Notifications Output Channels.

Setup of Custom Attributes

Custom Attributes must be defined in an XML file. Please see below how to write such an XML file. Once you have the XML file, login to Avantra UI, select Administration  Settings, and navigate to the Custom Attributes tab. On the Custom Attributes tab, click on Upload Custom Attributes definition button. Find your XML file and upload it. After that, you will see the list of available Custom Attributes.

Custom Attributes XML File Definition

You have to be familiar with editing XML files to configure your own Custom Attributes.

You can find a solution document here with an example XML file. You can also find a XML XSD definition file describing the exact schema definition for the XML file. We recommend using this XSD in your preferred XML editor for validation checks.

Here your find the description of the XML nodes and attributes:

XML Node Name Purpose XML Attributes Purpose XML Subnodes


Root node


set the version attribute to 1



Attribute definition


the unique id of the custom attribute, it cannot be changed.

systemtype,name,defaultvalue, values


the datatype of the attribute, possible values are text and enum.


the length of the attribute, only for text attributes.


set to true or false to set whether the attribute is mandatory or not.


Limit to monitored system types


Attribute name


Attribute default value


Enumeration values (only for enum attributes)



Enumeration value