Chains and fields configuration
Basic configuration
Within the EPM Manager connector, you will find a Chains tag that contains a number of Chain children, which each represent a topology view visible in DataMiner.
For example:
<Chains>
<Chain name="Customer Topology">
<Field name="Customer" options="displayInFilter;showCPEChilds;ignoreEmptyFilterValues;tabs:3500-KPI;details:3500;ShowBubbleupAndInstanceAlarmLevel" pid="3502"/>
<Field name="Device" options="displayInFilter;ignoreEmptyFilterValues;tabs:2500-KPI;details:2500;ShowBubbleupAndInstanceAlarmLevel" pid="2501"/>
</Chain>
</Chains>
Within a <Chain>
, you can define multiple fields. Each field represents a level from the respective topology.
For example:
<Field name="Customer" options="displayInFilter;showCPEChilds;ignoreEmptyFilterValues;tabs:3500-KPI;details:3500;ShowBubbleupAndInstanceAlarmLevel" pid="3502"/>
The Field tag has the following attributes:
Attribute | Description |
---|---|
name |
Specifies the name of the field representing the level. |
options |
Used to define the topology options. |
pid |
Specifies the ID of the parameter to which the level is linked. The view table column should be used. |
Several options can be used. These are the options used in the example:
Option | Description |
---|---|
displayInFilter |
Displays the field in the filter column on the left side of the EPM UI. |
ignoreEmptyFilterValues |
Excludes empty values from the filter drop-down lists of the topology levels. |
tab |
Displays one or more links in the block and next to the filter corresponding to the field. |
details |
Allows you to specify the tables that will be displayed in the details pane with a filter on the selection. |
ShowBubbleupAndInstanceAlarmLevel |
Allows two alarm indications on every object: the alarm state of the object and the alarm state of all the objects below. |
Note
For more info about the options, see options attribute.
Visibility of chains and fields
Within the EPM Manager protocol, it is possible to configure the visibility of a chain or a field.
To enable this functionality:
- Add a
<Display>
tag within the corresponding chain or field. - Create a read-write parameter for each chain or field. This parameter will make it possible to configure the visibility of these items when necessary.
Example parameter
<Param id="301" trending="false" save="true">
<Name>chainVisibilityCustomer</Name>
<Description>Customer Topology</Description>
<Type>read</Type>
<Information>...</Information>
<Interprete>...</Interprete>
<Display>...</Display>
<Measurement>
<Type>discreet</Type>
<Discreets>
<Discreet>
<Display>Disabled</Display>
<Value>1</Value>
</Discreet>
<Discreet>
<Display>Enabled</Display>
<Value>2</Value>
</Discreet>
</Discreets>
</Measurement>
</Param>
<Param id="351" setter="true">
<Name>chainVisibilityCustomer</Name>
<Description>Customer Topology</Description>
<Type>write</Type>
<Interprete>...</Interprete>
<Display>...</Display>
<Measurement>
<Type>togglebutton</Type>
<Discreets>
<Discreet>
<Display>Disabled</Display>
<Value>1</Value>
</Discreet>
<Discreet>
<Display>Enabled</Display>
<Value>2</Value>
</Discreet>
</Discreets>
</Measurement>
</Param>
Example chain
<Chain name="Customer Topology">
<Display>
<Visibility default="true">
<Standalone pid="301">
<Value>1</Value>
</Standalone>
</Visibility>
</Display>
<Field name="Customer" options="displayInFilter;showCPEChilds;ignoreEmptyFilterValues;tabs:3500-KPI;details:3500;ShowBubbleupAndInstanceAlarmLevel" pid="3502">
<Display>
<Selection>
<Visibility default="true">
<Standalone pid="308">
<Value>1</Value>
</Standalone>
</Visibility>
</Selection>
</Display>
</Field>
<Field name="Device" options="displayInFilter;ignoreEmptyFilterValues;tabs:2500-KPI;details:2500;ShowBubbleupAndInstanceAlarmLevel" pid="2501">
<Display>
<Selection>
<Visibility default="true">
<Standalone pid="310">
<Value>1</Value>
</Standalone>
</Visibility>
</Selection>
</Display>
</Field>
</Chain>
Chain configuration
Tag | Attribute | Description |
---|---|---|
<Visibility> |
default |
Specifies if the chain or field should be displayed by default (true or false ). |
<Standalone> |
pid |
Specifies the ID of the configurable parameter linked to toggle visibility. |
<Value> |
Defines the parameter value that will set the visibility to be the opposite of what is defined by default. |
Renaming chains and fields
You can change the names of topology chains and fields without making changes to the connector. This change will also apply to alarms, so any new alarms will be created with the new system types to make sure that alarm linking works.
You can do so by specifying overrides in the EPMConfig.xml in the C:\Skyline DataMiner
root directory, and then restarting DataMiner so that the changes take effect. For detailed information, refer to EPMConfig.xml.
Example:
<Protocol>
<Topologies>
<Topology>
<Cell name="Vendor" override="Manufacturer"/>
<Cell name="Station" override="Node"/>
</Topology>
</Topologies>
<Chains>
<Chain name="Vendor Topology" override="Manufacturer Topology">
<Field name="Vendor" override="Manufacturer"/>
</Chain>
<Chain name="Location Topology">
<Field name="Station" override="Node"/>
</Chain>
</Chains>
</Protocol>
Note
You can also do this with any collectors using the exposer logic by putting a similar file in the C:\Skyline DataMiner\Elements\<ElementName>\
directory.