ServiceNow Integration - Map Device Name to Short Description

Products

• Network Observability

Issue/Introduction

We have a need to have the device name populated in the 'Short Description' field of the SNOW Incident.

Resolution

A custom mapping can be created to accomplish this.

Customize DX NetOps Spectrum to CA NIM Field Mapping
https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/spectrum/24-3/integrating/ca-spectrum-and-service-desk-integrations/alarm-fields-rest-examples-and-attribute-mapping.html#concept.dita_c2d131a5f263865b82692a09b5a41913ae57a18d_CustomizeSpectrumtoCANIMFieldMapping

 

 

Copy the nim-mappings-config.xml file
   From: <SPECROOT>\WEB-INF\svdsk\config\ directory
   To:     <SPECROOT>\custom\svdsk\config\ directory



Prerequisites:

• Ensure that you maintain a unique mapping; that is, one DX NetOps Spectrum attribute to one NIM Field.
  
  
• Avoid duplicate entries in either DX NetOps Spectrum attribute or NIM Field.
  
  
• A maximum of five custom mappings are supported, which is a limitation in NIM.
  
  
• Ensure that the NIM custom fields are mapped to the corresponding Service Desk fields in the NIM Customization page to populate the DX NetOps Spectrum attributes to the ticketing system.
  
  The following are the custom fields in CA NIM:
  • customField1
  • customField2
  • customField3
  • customField4
  • customField5
     

In the nim-mappings-config.xml file (the one under the custom folder) add the attribute mapping for the Model_Name/0x1006e to customField1

Note: If you already have a mapping configured for customFieldx please use the next available field 2-5.

<attribute-mappings>                      <Mapping>                           <model-attribute>0x1006e</model-attribute>                          <NIMField>customField1</NIMField>            </Mapping>      </attribute-mappings>

ex. $SPECROOT\custom\svdsk\config\nim-mappings-config.xml

OneClick tomcat needs to be restarted

   cd $SPECROOT/tomcat/bin
   ./stopTomcat.sh
   <wait ~ 60secs for process to stop and port to free>
   ./startTomcat.sh

 

Once this is done you can then map customField1 to 'short description'

 1. Access the NIM UI on your OneClick Server performing the Integration

         https://<oneClickServerName>:8443/ca-nim-sm/ui/login.jsp

  2. Login using:
 
         nimadmin / nimadmin

  

 

 

 

 3. Click on 'Customizations'

 

 

4. On the mappings screen

       - name is mapped to 'short description' by default, change 'name' to 

 

5. Click the 'Save' button on the top of the screen


The changes should take effect for new incidents raised after the changes.