Generic Integration Framework to Support ASB Interface[edit]


= Generic Integration Framework to Support ASB Interface =

Azure Service Bus (ASB) is a fully managed enterprise integration message broker. Data is transferred between different applications and services using messages. The ICM-ASB adapter considers the approach based on REST and OData principles that exposes a uniform, stateless interface which communicates using HTTP(S) and JSON payloads.

== Configuring ASB adapter to load Masterdata&nbsp; ==

The ICM support for generic integration provides the ability to synchronize ICM Masterdata tables using the input from ASB. Through a technical configuration, you can specify the attributes to be used for this generic integration.

=== Create Masterdata Contract Type ===

To enable synchronization between ICM and ASB, a Masterdata Contract Type should first be configured in ICM, with specific attributes for the integration. To create a Masterdata Contract Type:

#'''Click '''''Create Contract Type'' sub menu from the ''Configuration ''tile. The ''Select Contract Type'' page opens. 
<div class="image-green-border">[[File:Generic Integration Framework ASB 01.png|620px|Generic Integration Framework ASB 01.png]]</div> <ol start="2">
<li>'''Select''' ''Masterdata''.</li>
</ol>
<div class="image-green-border">[[File:Generic Integration Framework ASB 02.png|420px|Generic Integration Framework ASB 02.png]]</div> <ol start="3">
<li>'''Click '''the ''Next ''button. The ''Create Contract Type Wizard'' page opens.</li>
</ol>
<div class="image-green-border">[[File:Generic Integration Framework SFTP 03.png|520px|Generic Integration Framework SFTP 03.png]]</div> <ol start="3">
<li>The ''Create Contract Type ''page has the following sections:</li>
</ol>

*Details: Enter the ''Contract Type Name'' 
*Attributes: Select the Attributes for the Masterdata Contract Type 
*Display Preference: Select Attributes to be displayed in the Agreement Tile View 
*Team: Select the Team 
*Verify: Verify the details in preview mode and '''click&nbsp;'''''Create.'' 

=== Client App Cross Reference ===

The Client App Cross Reference mapping maps ICM entities (for example, ICM attributes) to client app entities.

#Navigate to the ''Create Masterdata'' page in ICM. This page contains the following tabs: 
<div class="image-green-border">[[File:Generic Integration Framework ASB 04.png|520px|Generic Integration Framework ASB 04.png]]</div> 
==== Masterdata Details ====

1.&nbsp;&nbsp; &nbsp;Select the ''Category ''from the drop-down. For example, ''Default''.<br/> 2.&nbsp;&nbsp; &nbsp;Select the Masterdata Contract Type.
<div class="note-box">'''Note''': In order to map ICM entities with entities in the file uploaded through ASB, you must select ''Client App Cross Reference'' from the drop-down.</div> 
3.&nbsp;&nbsp; &nbsp;Click ''Next''. The ''Attributes ''page opens.

==== Attributes ====

#Enter the relevant attribute values. For example, enter ''ICM Entity Name'' as ''ICMSupplierMaster'' and ''Client Entity Name'' as ''SupplierMaster''. The ''Payload Type'' can be selected as ''JSON''. 
<div class="note-box">'''Note''': The ''Client Name'' ''GenericIntegration'' must be selected. To create mapping using ASB, select ''Messaging'' in the ''Integration Mode'' drop-down. You need to select a ''Task Category for Messaging'', either ''Scheduled'' or ''EventBased'' as required.</div> <ol start="2">
<li>'''Click '''''Save'' to save the entity mapping.</li>
</ol>
<div class="image-green-border">[[File:Generic Integration Framework ASB 05.png|520px|Generic Integration Framework ASB 05.png]]</div> 
=== Client App Entity Mapping ===

The Client App Entity Mapping maps ICM attributes (for example, attribute names used in Supplier Master) to attributes in the file uploaded through ASB.

#Navigate to the''Create Masterdata'' page in ICM. This page contains the following tabs: 
<div class="image-green-border">[[File:Generic Integration Framework ASB 06.png|520px|Generic Integration Framework ASB 06.png]]</div> 
==== Masterdata Details ====

#Select the ''Category ''from the drop-down. For example, ''Default''. 
#Select the Masterdata Contract Type. 
<div class="note-box">'''Note''': In order to map ICM attributes with attributes uploaded through ASB, ''Client App Entity Mapping'' must be selected from the drop-down.</div> <ol start="3">
<li>Click ''Next''. The ''Attributes'' page opens.</li>
</ol>

==== Attributes ====

#'''Enter''' the relevant attribute values. For example, enter ''ICM Entity Name'' as ''ICMSupplierMaster'' and ''Client Entity Name'' as ''SupplierMaster''.&nbsp; 

To create mapping using ASB, select ''Messaging'' in the ''Integration Mode'' drop-down. The ''Client Name'' selected must be ''GenericIntegration''.

In case of lookup and non-lookup attributes: The ICM Relationship Key should be set for lookup attributes and kept blank for non-lookup attributes. The Relationship Key framing should be <''Master Contract Type Name''> Double Underscore<''ICM Attribute Name''>. For example, in case of Supplier Master the ICM attribute name will be ''ICMSupplierCountry'' and the Masterdata Contract Type for this attribute will be ''ICMCountryMaster''. Hence, relationship key will be ''ICMCountryMaster__ICMSupplierCountry.''
<ol start="2">
<li>'''Click '''''Save'' to save the entity mapping.</li>
</ol>
<div class="image-green-border">[[File:Generic Integration Framework ASB 07.png|720px|Generic Integration Framework ASB 07.png]]</div> 
== Using ASB Adapter to load/publish Masterdata ==

=== Download Payload ===

#Navigate to the Masterdata page in ICM. 
#'''Click''' the ''View Record'' icon next to the ''Client App Cross Reference'' entity you have created. The ''Masterdata Details'' page opens. 
<div class="image-green-border">[[File:Generic Integration Framework ASB 08.png|720px|Generic Integration Framework ASB 08.png]]</div> <ol start="3">
<li>Click the ''Download Payload'' button to download a template for the Masterdata.</li>
</ol>

'''Note''': The file format of the template will be according to the ''Payload Type'' selected in the attributes of the ''Client App Cross Reference'' entity.
<div class="image-green-border">[[File:Generic Integration Framework ASB 09.png|720px|Generic Integration Framework ASB 09.png]]</div> <ol start="4">
<li>Open the downloaded JSON file. This file will be used by third-party systems to push data to the ASB adapter.</li>
</ol>

For Scheduled updation:
<div class="image-green-border">[[File:Generic Integration Framework ASB 10.png|520px|Generic Integration Framework ASB 10.png]]</div> 
<br/> For EventBased updation:
<div class="image-green-border">[[File:Generic Integration Framework ASB 11.png|520px|Generic Integration Framework ASB 11.png]]</div> 
=== Publish Payload ===
<ol start="5">
<li>'''Click''' ''Publish Payload.'' The file will be published.</li>
</ol>
<div class="note-box">'''Note''': For any subsequent ''Masterdata'' changes, the user needs to click ''Publish Payload'' button again to update the empty payload.</div> 
A notification is displayed once the Payload is published successfully.
<div class="image-green-border">[[File:Generic Integration Framework ASB 12.png|720px|Generic Integration Framework ASB 12.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''': The user can create a subscription to the job status updates by using the standard in ''Notification Setting'' in the ''User Administration'' menu.</div>