This section of the documentation describes the details of the ASM connector, including:
The name of the file used
Connection methodology
Use case scenario
Architectural and functional details that ensure the running of the use case through the Inbound and Outbound action functionality of the Integration Platform
For compatibility and version support details, refer to the ASM Connector Matrix.
You should familiarize yourself with the information in Installing Connectors before installing any connectors, and read the Integration topics for more information on how to configure them.
The ASM to ASM interoperability concept basically allows for the creation of calls and requests on one ASM System (the Receiver) triggered by actions sent from another ASM System (the Creator).
The type of actions that are implemented and whether calls or requests are logged in the Receiver system is part of the Integration Platform settings in both systems, while creating adequate transactions, ensuring proper communication and maintaining reconciled information between the two systems are amongst the ASM to ASM connector duties.
The connector operation is symmetrical. This means that in some instances one of the systems acts as the Creator, creating calls or requests in the other system, and in other instances the same system acts as the Receiver, calls or requests being created internally based on instructions sent by the other system.
The interoperability concept can be broken down into several use cases that are listed in the table below.
The table below provides a description of the ASM to ASM Connector.
The connector operation makes use of Windows Communication Foundation (WCF). WCF allows for the following:
Services to be defined abstractly and published physically over a wide variety of channels.
Permits extensive tailoring of this behavior by updating the appropriate .NET configuration files.
Connector parameter values possess default values that are defined in these configuration files and can be modified. However, possessing a strong knowledge of WCF is a prerequisite before attempting to modify the default parameters.
Endpoint Configuration references a client endpoint configuration by name.
The configuration files also define server endpoints.
Note the following:
If no name is provided, BasicHttpBinding_ISM2XService is used. This is the name of the default binding defined in the configuration files shipped in the kit.
It defines how the local ASM instance (client) must communicate with the remote ASM instance (server), as:
A basic HTTP binding
References the Infra.Connector.Ionix.SM.ISM2XService service contract
Any changes to the configuration must be applied to the following two files:
<System>/web.config
<Root>/Infra.Services.exe.config
When setting up a ASM source, the parameters listed below have to be defined.
In order to successfully connect a system installed on Windows Server 2003 to a system installed on Windows Server 2008, the following steps must be executed on the Windows Server 2008 server:
Run the following in the command prompt:
"%windir%\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe -r -y"
Enable anonymous authentication for the virtual directory in Internet Information Services (IIS).
ASM interoperability between two ASM Systems relies on a specific connector and specific Web Services. Furthermore, the running of the use case scenario requires a specific architecture to be adhered to by the two ASM Systems, as depicted below.
The connector ensures:
A proper connection with the Outbound and Inbound actions APIs of the system it is installed on
A proper connection with the ASM Services Web of the system it is installed on
Transfer of communications between the Inbound actions and the Outbound actions APIs of the connected systems
From a functional standpoint, the connector ensures that the message types described in Action and Communication Protocol are properly handled and transferred.
The Web Service, although not part of the connector itself, is developed especially to support the communication between the two ASM Systems through the connector.
This connector does not include any Federated CMDB population functionality.
The connector has the facility to trace information. The data can be obtained through Polling tracing or Application tracing.
This section describes Inbound/Outbound actions and communication protocol handled by the ASM to ASM connector.
ASM Interoperability allows calls or requests to be created on one ASM System based on information sent by another. The creation of calls and requests relies on actions being implemented between the two systems. These actions are supported by a particular communication protocol composed of a set of specific transactions, as illustrated below.
The Creator sends a Create message to initiate an action for the Receiver to perform.
Both the Creator and Receiver can send Update messages to each other when required.
Both the Creator and Receiver can send Notify messages to each other when required.
The Creator can also send a Cancel message to stop any further processing of the Action by the Receiver.
A Complete message is sent by the receiver when the action is successfully performed.
A Not Complete message is sent by the Receiver when the action has not been successfully performed. This does not include failures to establish communication connection with the Receiver.
When two ASM Systems are connected through the ASM to ASM connector, either system can act as the Creator or the Receiver.
To make the ASM to ASM connector available for use, you must:
Verify the connector service is accessible from each server
Configure the system(s) for outbound actions
Configure the system(s) for inbound actions
Follow the steps in both systems to configure ASM System interoperability. For demonstration purposes, we will refer to the systems as System 1 and System 2. If there are specific instructions for systems which are held on different servers, System 1 will be held on Server A and System 2 on Server B.
For demonstration purposes, we will refer to the systems as System 1 and System 2. System 1 will be held on Server A and System 2 on Server B.
For each system, place the endpoint address URL of the other system into a browser and make sure a valid page appears as follows. The endpoint address format is http://Server B/System 2/SM2XService.svc (from Server A) and http://Server A/System 1/SM2XService.svc (from Server B).
In the example below "localhost" indicates that both systems are on the same server.
If this page is not returned there may be a blocked port on the firewall. Contact your Network Administration team to resolve.
The ASM to ASM connector requires the configured port to be open on the firewalls between servers, including SOAP/XML messages. The default ports are 80 for http and 443 for https.
For demonstration purposes, we will refer to the outbound system as System 1.
The version of the ASM System must be identical on both servers.
There must be an identical Person record on both servers, with Analyst and User permissions. The two records must have the same login ID, and have IPK Analyst selected in the Options tab of their IPK Management security role.
Log in to ASM System 1.
Select ≡ > Admin > Integration.
In the Explorer pane, under Integration, select Integration Platform Settings to view the window.
Under Inbound Actions, select the Enabled checkbox, then save the details.
In the Explorer pane, under Integration, select Connectors.
On the Integration Connectors window, locate the ASM to ASM connector, and ensure that the Actions and Visible checkboxes are selected.
You can adjust the column widths if required.
Save the changes.
The connector is visible in the list of available connectors of the Integration Platform.
In the Explorer pane, under Integration, select Sources.
Select the button on the toolbar. In the pop up window, select ASM to ASM Connector from the drop-down list.
In the Integration Source Details window, complete the details.
Further fields are displayed on this window, but you do not need to complete them at this stage.
If you have already configured the receiving system (System 2), select the button on the toolbar to test the connection.
Save the details.
Next, you need to configure the receiving system (if you have not already done so), the outbound actions and the inbound actions.
The settings of the Inbound actions of one system influences the possible settings of the Outbound actions of the other system. The possible actions listed in the Outbound actions page of the system for a particular source reflects which Inbound actions have been defined in the specific source system.
If you want to enable global connector attachments, you must enable them in the registry, using the IntegrationAttachmentsEnabled setting.
For demonstration purposes, we will refer to the receiving system as System 2.
Ensure that the web configuration file has been configured.
Log in to ASM System 2.
Select ≡ and then Admin. From the submenu, select Integration .
In the Main Explorer pane under Integration, select Integration Platform Settings to view the settings.
In the Outbound Actions section, select the Enabled checkbox, then save the details.
In the Main Explorer pane, select Connectors to view the integration connectors.
Locate the ASM to ASM connector, then ensure that the Actions and Visible checkboxes are selected.
Select alongside the connector if you need to edit the options. After you have updated the option, select to commit the changes to the connector.
You can adjust the column widths if required.
Select to save the changes.
In the Main Explorer pane, select Sources.
Select the button on the toolbar to create a new source.
In the pop up dialog box, select ASM to ASM Connector from the drop-down list, then select OK.
In the Integration Source Details window, complete the details.
If you have already configured the outbound system (System 1), select the button on the toolbar to test the connection.
Save the integration source configuration.
After IIS reset on both servers, check the source connection on System 1.
Next, you need to configure the inbound actions and the outbound actions.
If you want to enable global connector attachments, you must enable them in the registry, using the IntegrationAttachmentsEnabled setting.
You must configure the inbound actions for the connector. The settings of the Inbound actions of one system influences the possible settings of the Outbound actions of the other system. The possible actions listed in the Outbound actions page of the system for a particular source reflects which Inbound actions have been defined in the specific source system.
For demonstration purposes, we will refer to the receiving system as System 2.
Log in to ASM System 2.
Select ≡ > Admin > Integration.
In the Explorer pane under Integration, select Inbound Actions to view the Integration Inbound Actions window.
Select the Action button on the toolbar.
On the Inbound Action Type Details window, complete the details.
On the Fields tab, select Add located at the bottom of the window.
In the Inbound Action Fields pop-up window, scroll down the list of fields in the left hand table and select Call ref and then Add. Then select OK to close the window. The details appear in the table.
Select the Save icon to close the window. Your new inbound action appears in the Integration Inbound Actions window.
Next, you need to configure the outbound actions on the sending system (System 1).
For demonstration purposes, we will refer to the receiving system as System 1.
Log in to ASM System 1.
Select ≡ > Admin > Integration.
In the Explorer pane, under Integration, select Outbound Actions.
In the Filter by Source field, select the connector source name from the drop-down list, for example System 1.
All available outbound actions are listed in the browse table. Select the one you want to work with and then select .
The Outbound Action Type [action name] window appears. Select the button on the toolbar.
In the Mapping window, complete the details.
If you change the screen set after defining outgoing or incoming field mappings, a warning appears indicating that some field mappings may become invalid.
To associate an external supplier and contract with the Outbound Action mapping, select the Suppliers & Contracts tab.
Select Add to add the supplier and/or contract to the browse table. Whenever a call or External Supplier task is forwarded to that external supplier and/or contract, this Outbound Action mapping will be applied.
You cannot specify the same supplier and contract (per screen set) for more than one Outbound Action mapping. However, you can link an external supplier to one mapping and the same supplier plus a contract to another mapping. In this case, the most specific mapping will be applied: if the call or task is forwarded to a supplier and contract matching the supplier and contract specified on the second mapping, this mapping will be applied. If not, it will use the default mapping for that supplier.
Select the Action tab and ensure that the rules for Incoming and Outgoing Transactions using this mapping are as wanted.
Select the Fields - Outgoing tab and select Add. Complete the details.
Your Fields - Outgoing tab should look like this -
Select the Fields – Incoming tab and select Add. Complete the details.
Your Fields - Incoming tab should look like this
Save the mapping and the outbound action.
The following examples illustrate some of the more commonly used outbound action field mappings.
Add IntegrationAttachmentsEnabled=1 registry value in ASM Core/System level for both systems.
Enable attachments in the Outbound Action mapping screen in System 1.
When user attaches an object to a Call in System 1 this should be transferred to the call logged in System 2.
Max Object size should be considered in System Settings (Admin).
Expose the drop down field in System 2 – Inbound Action mapping screen.
Save the Inbound Action.
In System 1, open up the Outbound Action mapping page and map in the drop down selected in System 2.
Select Profile Mapping from Internal Field option.
Set up the Profile mapping.
Save the Profile mapping
Expose a single field in System 1’s Outbound Action mapping page/Fields – Incoming tab.
Set up a Resolution rule. The rule should create an entity (e.g. User) in System 2 when a call is logged and transferred from System 1.
Transforms are used to modify data and populate a field with the modified/converted data, e..g concatenate two field values and populate a field with the results. See transforms.
Once the interoperability has been set up, there are two main ways to use this functionality.
Follow these steps to transfer a call from the Creator system to the Receiver system:
Open the call that is intended to be transferred.
Click External to forward the call externally.
Specify the External Supplier and the Contract as defined in the Receiver system settings. See Configuring the System for Outbound Actions.
Click Forward to Supplier to transfer the call to the Receiver system.
Once the call has been transferred, a button labeled Take Back is visible on the Call Details page. This button allows for the cancellation of the transfer of the call and disables the reconciliation of call information between the two systems.
What happens to the call created on the Receiver system depends on the settings of the Receiver system.
The connector allows for objects attached to calls on the Creator system to be copied over to their related calls created in the Receiver system.
Two workflow tasks can be used to trigger actions in the Receiver system:
You may discover that when you forward the call externally and select the External Supplier and contract that no analysts are available to forward the call or task. To resolve this:
Create an external contact.
Link the contract to the external contact.
Link the contract to all analysts who will be externally forwarding the call.
Name | Type the name of the integration source |
---|---|
Name | Type the name of the integration source. |
---|---|
Name | Type a name for the inbound action |
---|---|
Name | Type a name for the mapping. This name appears in the Mappings table. |
---|---|
External Supplier | Select a supplier |
---|---|