Table of Contents

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.