A link combines a source- and target application to interchange monitoring and ticket information. To start processing information between both applications, a link has to be configured. The link adds the needed information to connect, read and write data from and to the applications. In most scenarios a monitoring application is the source application while the ITSM application is the target application.
Link creation requires two steps:
Both steps will be explained using an example scenario.
In this scenario a link is created for SCOM as monitoring application and TOPdesk as ITSM application. The goal of the example is to create a TOPdesk ticket based on a SCOM alert.
The table below shows the application specific information needed to define the link:
For the mapping file the table below describes the values added to the TOPdesk ticket fields using static and dynamic data:
In this example the urgency is dependent on the SCOM alert property Severity. If the Severity is Critcal the urgency get’s High and Medium if Severity is Warning.
The mapping file tells the Service Management Connector how information should be processed. Based on the example scenario, a mapping file needs to be added containing a mapping definition for each TOPdesk ticket field which needs to be filled.
More information about the mapping file is found at the Mapping File reference.
Create the file C:\Program Files\The Backbone\Service Management Connector\SCOM-mapping.xml and open this file in a text editor. The XML structure below corresponds to the example scenario and can be copied to the new mapping file.
Be aware that the first letter of the name field is a capital letter, like name="CallerLookup.Email"
TOPdesk allows the usage of specific HTML tags like <br> for a new line. The Service Management Connector requires those HTML tags to be encoded like in the example above using \<br\>
After a new installation the default Service Management Connector configuration file contains a link template. This template can be used to define the link by changing a few XML attribute values.
More information about the configuration file can be found at the Service configuration.
Open the file TheBackbone.SMConnector.exe.config in a text editor, this file can be found in the installation directory. After opening the file change the configuration file so it looks like the XML structure below.
Clear text passwords will be encrypted and replaced in the Service Management Connector configuration file after loading the configuration for the first time. A reload of the configuration is initiated by a restart of The Backbone Service Management Service Windows Service.
Refer to TOPdesk developers how to create an application password in TOPdesk.
After saving the configuration file the Service Management Connector will load the link, connect to both applications and starts processing information.