From ICIHelp8.2
Jump to: navigation, search
Line 16: Line 16:
 
To create a Masterdata Contract Type: 
 
To create a Masterdata Contract Type: 
  
−
1. '''Click '''''Create Contract Type'' sub menu from the ''Configuration ''tile. The ''Select Contract Type'' page opens.
+
1. '''Click '''Create Contract Type sub menu from the Configuration tile. The Select Contract Type page opens.
 
<div class="image-green-border">[[File:GIF1.png|500px|GIF1.png]]</div>  
 
<div class="image-green-border">[[File:GIF1.png|500px|GIF1.png]]</div>  
−
2.'''Select''' ''Masterdata''.
+
2.'''Select''' Masterdata.
−
<div class="image-green-border">[[File:GIF 2.png|500px|GIF 2.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;'''Click '''the ''Next ''button. The ''Create Contract Type Wizard'' page opens.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:GIF 3.png|500px|GIF 3.png]]</div>  
+
<div class="image-green-border">[[File:GIF 2.png|500px|GIF 2.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;'''Click '''the Next button. The Create Contract Type Wizard page opens.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:GIF 3.png|500px|GIF 3.png]]</div>  
−
The&nbsp;''Create Contract Type&nbsp;''page has the following sections:&nbsp;
+
The&nbsp;Create Contract Type&nbsp;page has the following sections:&nbsp;
  
 
*Details:&nbsp;'''Enter&nbsp;'''the contract type name.&nbsp;  
 
*Details:&nbsp;'''Enter&nbsp;'''the contract type name.&nbsp;  
Line 26: Line 26:
 
*Display Preference: '''Select''' Attributes to be displayed in the Agreement Tile View.  
 
*Display Preference: '''Select''' Attributes to be displayed in the Agreement Tile View.  
 
*Team:&nbsp;'''Select&nbsp;'''the team.  
 
*Team:&nbsp;'''Select&nbsp;'''the team.  
−
*Verify: Verify the details in preview mode and&nbsp;'''click&nbsp;'''''Create.''
+
*Verify: Verify the details in preview mode and&nbsp;'''click&nbsp;'''Create.  
  
 
&nbsp;
 
&nbsp;
Line 34: Line 34:
 
The Client App Cross Reference mapping maps ICI entities (for example, ICI attributes) to client app entities.
 
The Client App Cross Reference mapping maps ICI entities (for example, ICI attributes) to client app entities.
  
−
1.&nbsp;Navigate to the&nbsp;''Create Masterdata'' page in ICI. This page contains the following tabs:
+
1.&nbsp;Navigate to the&nbsp;Create Masterdata page in ICI. This page contains the following tabs:
 
<div class="image-green-border">[[File:GIF 4.png|600px|GIF 4.png]]</div>  
 
<div class="image-green-border">[[File:GIF 4.png|600px|GIF 4.png]]</div>  
 
'''Masterdata Details&nbsp;'''
 
'''Masterdata Details&nbsp;'''
  
−
1.&nbsp;'''Select&nbsp;'''the ''Category'' from the drop-down. For example, ''Default''.
+
1.&nbsp;'''Select&nbsp;'''the Category from the drop-down. For example, Default.
  
 
2.&nbsp;'''Select'''&nbsp;the Masterdata Contract Type.
 
2.&nbsp;'''Select'''&nbsp;the Masterdata Contract Type.
−
<div class="note-box">'''Note: '''In order to map ICI entities with entities in the file uploaded through SFTP''', '''you must select&nbsp;''Client App Cross Reference ''from the drop-down.</div>  
+
<div class="note-box">'''Note: '''In order to map ICI entities with entities in the file uploaded through SFTP''', '''you must select&nbsp;Client App Cross Reference from the drop-down.</div>  
−
3.&nbsp;'''Click&nbsp;'''''Next. ''The ''Attributes''&nbsp;page opens.
+
3.&nbsp;'''Click&nbsp;'''Next. The Attributes&nbsp;page opens.
  
 
'''Attributes&nbsp;'''
 
'''Attributes&nbsp;'''
  
−
#'''Enter''' the relevant attribute values. For example, enter ''ICI Entity Name'' as ''ICISupplierMaster'' and ''Client Entity Name'' as ''SupplierMaster''. The ''Payload Type ''can be selected as&nbsp;''CSV or Json''.  
+
#'''Enter''' the relevant attribute values. For example, enter ICI Entity Name as ICISupplierMaster and Client Entity Name as SupplierMaster. The Payload Type can be selected as&nbsp;CSV or Json.  
−
#'''Select '''the ''Text Delimiter''. Supported options are ''pipe'', ''colon'' and ''comma''.  
+
#'''Select '''the Text Delimiter. Supported options are pipe, colon and comma.  
−
#'''Select''' the ''Text Qualifier''. Supported options are ''Single Quote'', ''Double Quote'', ''No Quote''.  
+
#'''Select''' the Text Qualifier. Supported options are Single Quote, Double Quote, No Quote.  
−
<div class="note-box">'''Note''': The ''Client Name'' ''GenericIntegration'' must be selected. To create mapping using SFTP, select ''FileBased'' in the ''Integration Mode'' drop-down. The ''Transport Protocol'' can be ''FTP'', ''SFTP'',&nbsp;''SSH&nbsp;''or Blob.</div>  
+
<div class="note-box">'''Note''': The Client Name GenericIntegration must be selected. To create mapping using SFTP, select FileBased in the Integration Mode drop-down. The Transport Protocol can be FTP, SFTP,&nbsp;SSH&nbsp;or Blob.</div>  
−
4.&nbsp;'''Click&nbsp;'''''Crate&nbsp;''to crate&nbsp; the entity mapping. Or Click UPDATE to update existing entity mapping.&nbsp;
+
4.&nbsp;'''Click&nbsp;'''Crate&nbsp;to crate&nbsp; the entity mapping. Or Click UPDATE to update existing entity mapping.&nbsp;
 
<div class="image-green-border">[[File:SFTP 1.png|600px|SFTP 1.png]]</div>  
 
<div class="image-green-border">[[File:SFTP 1.png|600px|SFTP 1.png]]</div>  
 
=== Client App Entity Mapping&nbsp; ===
 
=== Client App Entity Mapping&nbsp; ===
Line 56: Line 56:
 
The Client App Entity Mapping maps ICI attributes (for example, attribute names used in Supplier Master) to attributes in the file uploaded through SFTP.
 
The Client App Entity Mapping maps ICI attributes (for example, attribute names used in Supplier Master) to attributes in the file uploaded through SFTP.
  
−
1.&nbsp;Navigate to the''Create Masterdata'' page in ICI.&nbsp;This page contains the following tabs:
+
1.&nbsp;Navigate to theCreate Masterdata page in ICI.&nbsp;This page contains the following tabs:
 
<div class="image-green-border">[[File:GIF 7.png|600px|GIF 7.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div>  
 
<div class="image-green-border">[[File:GIF 7.png|600px|GIF 7.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div>  
 
'''Masterdata Details&nbsp;'''
 
'''Masterdata Details&nbsp;'''
  
−
1.&nbsp;'''Select&nbsp;'''the ''Category'' from the drop-down. For example, ''Default''.
+
1.&nbsp;'''Select&nbsp;'''the Category from the drop-down. For example, Default.
  
 
2.'''Select'''&nbsp;the Masterdata Contract Type.
 
2.'''Select'''&nbsp;the Masterdata Contract Type.
−
<div class="note-box">'''Note: '''In order to map ICI attributes with attributes uploaded through SFTP''', '''''Client App Entity Mapping ''must be selected from the drop-down.</div>  
+
<div class="note-box">'''Note: '''In order to map ICI attributes with attributes uploaded through SFTP''', '''Client App Entity Mapping must be selected from the drop-down.</div>  
−
3.&nbsp;'''Click&nbsp;'''''Next. ''The ''Attributes''&nbsp;page opens.
+
3.&nbsp;'''Click&nbsp;'''Next. The Attributes&nbsp;page opens.
  
 
'''Attributes'''
 
'''Attributes'''
  
−
1.&nbsp;'''Enter''' the relevant attribute values. For example, enter ''ICI Entity Name'' as ''ICISupplierMaster'' and ''Client Entity Name'' as ''SupplierMaster''.
+
1.&nbsp;'''Enter''' the relevant attribute values. For example, enter ICI Entity Name as ICISupplierMaster and Client Entity Name as SupplierMaster.
  
−
To create mapping using SFTP, select ''FileBased'' in the ''Integration Mode'' drop-down. The ''Client Name'' selected must be ''GenericIntegration''.
+
To create mapping using SFTP, select FileBased in the Integration Mode drop-down. The Client Name selected must be GenericIntegration.
  
−
In case of lookup and non-lookup attributes: The ICI 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<''ICI Attribute Name''>. For example, in case of Supplier Master the ICI attribute name will be ''ICISupplierCountry'' and the Masterdata Contract Type for this attribute will be ''ICICountryMaster''. Hence, relationship key will be ''ICICountryMaster__ICISupplierCountry.&nbsp;''
+
In case of lookup and non-lookup attributes: The ICI Relationship Key should be set for lookup attributes and kept blank for non-lookup attributes.
  
−
2.&nbsp;'''Click&nbsp;'''''Save&nbsp;''to save the entity mapping.&nbsp;
+
The Relationship Key framing should be <Master Contract Type Name> Double Underscore<ICI Attribute Name>. For example, in case of Supplier Master the ICI attribute name will be ICISupplierCountry and the Masterdata Contract Type for this attribute will be ICICountryMaster. Hence, relationship key will be ICICountryMaster__ICISupplierCountry.&nbsp;
 +
 
 +
2.&nbsp;'''Click&nbsp;'''Save&nbsp;to save the entity mapping.&nbsp;
 
<div class="image-green-border">&nbsp;</div>  
 
<div class="image-green-border">&nbsp;</div>  
 
== Using SFTP Adapter to load/publish Masterdata ==
 
== Using SFTP Adapter to load/publish Masterdata ==
Line 80: Line 82:
 
=== Download Payload ===
 
=== Download Payload ===
  
−
#Navigate to the ''Masterdata'' page in ICI.  
+
#Navigate to the Masterdata page in ICI.  
−
#'''Click''' the ''View Record'' icon next to the ''Client App Cross Reference'' entity you have created. The ''Masterdata Details'' page opens.  
+
#'''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:GIF 9A.png|600px|GIF 9A.png]]</div> <ol start="3">
 
<div class="image-green-border">[[File:GIF 9A.png|600px|GIF 9A.png]]</div> <ol start="3">
−
<li>'''Click''' the ''Download Payload'' button. The template for the Masterdata will be downloaded to your local drive.</li>
+
<li>'''Click''' the Download Payload button. The template for the Masterdata will be downloaded to your local drive.</li>
 
</ol>
 
</ol>
−
<div class="note-box">'''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> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:GIF 10.png|600px|GIF 10.png]]</div> <ol start="4">
+
<div class="note-box">'''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> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:GIF 10.png|600px|GIF 10.png]]</div> <ol start="4">
 
<li>Open the downloaded CSV or Json file. This file will be used by third-party systems to push data to the SFTP adapter.</li>
 
<li>Open the downloaded CSV or Json file. This file will be used by third-party systems to push data to the SFTP adapter.</li>
 
</ol>
 
</ol>
Line 91: Line 93:
 
=== Publish Payload ===
 
=== Publish Payload ===
  
−
'''Click''' ''Publish Payload.'' The empty payload will be published.
+
'''Click''' Publish Payload. The empty payload will be published.
−
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:GIF 11.png|600px|GIF 11.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <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>  
+
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:GIF 11.png|600px|GIF 11.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <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>  
 
== Using SFTP adapter to load/publish Transaction Data&nbsp; ==
 
== Using SFTP adapter to load/publish Transaction Data&nbsp; ==
  
 
=== Download Payload&nbsp; ===
 
=== Download Payload&nbsp; ===
  
−
1. Navigate to the ''Masterdata'' page in ICI.
+
1. Navigate to the Masterdata page in ICI.
  
−
2. '''Click'''&nbsp;the ''View Record'' icon next to the ''Client App Cross Reference'' entity you have created. The ''Masterdata Details'' page opens.
+
2. '''Click'''&nbsp;the View Record icon next to the Client App Cross Reference entity you have created. The Masterdata Details page opens.
  
−
3.&nbsp;'''Click''' the ''Download Payload'' button. The template for the Masterdata will be downloaded to your local drive.
+
3.&nbsp;'''Click''' the Download Payload button. The template for the Masterdata will be downloaded to your local drive.
−
<div class="note-box">'''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>  
+
<div class="note-box">'''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>  
 
4.&nbsp;Open the downloaded CSV file. This file will be used by third-party systems to push data to the SFTP adapter.
 
4.&nbsp;Open the downloaded CSV file. This file will be used by third-party systems to push data to the SFTP adapter.
  
Line 109: Line 111:
 
=== Publish Payload&nbsp; ===
 
=== Publish Payload&nbsp; ===
  
−
'''Click''' ''Publish Payload.'' The empty payload will be published.
+
'''Click''' Publish Payload. The empty payload will be published.
−
<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>  
+
<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.
 
A notification is displayed once the Payload is published successfully.
−
<div class="note-box">'''Note''':&nbsp;The user can create a subscription to the job status updates by using the standard in ''Notification Setting'' in the ''User Administration'' menu.</div>  
+
<div class="note-box">'''Note''':&nbsp;The user can create a subscription to the job status updates by using the standard in Notification Setting in the User Administration menu.</div>  
 
== Support for pre/post processing ==
 
== Support for pre/post processing ==
  
Line 148: Line 150:
 
To create a customized folder structure using GIF:
 
To create a customized folder structure using GIF:
  
−
1. '''Click '''''Home > Configure&nbsp;> Masterdata > Create Masterdata''. The ''Masterdata Details'' page opens.
+
1. '''Click '''Home > Configure&nbsp;> Masterdata > Create Masterdata. The Masterdata Details page opens.
 
<div class="image-green-border"><br/> 2. Enter the relevant details:</div>  
 
<div class="image-green-border"><br/> 2. Enter the relevant details:</div>  
−
*Category: '''Select '''''Default''
+
*Category: '''Select '''Default  
−
*Masterdata: '''Select '''''Client App Cross Reference''&nbsp;  
+
*Masterdata: '''Select '''Client App Cross Reference&nbsp;  
 
<div class="image-green-border">[[File:GIF 4.png|600px|GIF 4.png]]</div> <div class="image-green-border">&nbsp;</div>  
 
<div class="image-green-border">[[File:GIF 4.png|600px|GIF 4.png]]</div> <div class="image-green-border">&nbsp;</div>  
−
3. '''Click '''''Next''. The ''Attributes ''page opens.
+
3. '''Click '''Next. The Attributes page opens.
  
 
4. '''Enter '''the relevant attribute values in the respective fields.&nbsp;
 
4. '''Enter '''the relevant attribute values in the respective fields.&nbsp;
−
<div class="image-green-border">5. '''Copy '''the Json format from the tool-tip of the ''Folder Structure Json'' attribute.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.14 GIF Folder Structure Management 04.png|720px|7.14 GIF Folder Structure Management 04.png]]</div> <div class="image-green-border"><br/> 6. '''Edit '''the Json format text to customize the folder structure. &nbsp;</div> <div class="image-green-border">[[File:SFTP 14.png|600px|SFTP 14.png]]</div> <div class="image-green-border"><br/> '''Note''':&nbsp;</div>  
+
<div class="image-green-border">5. '''Copy '''the Json format from the tool-tip of the Folder Structure Json attribute.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.14 GIF Folder Structure Management 04.png|720px|7.14 GIF Folder Structure Management 04.png]]</div> <div class="image-green-border"><br/> 6. '''Edit '''the Json format text to customize the folder structure. &nbsp;</div> <div class="image-green-border">[[File:SFTP 14.png|600px|SFTP 14.png]]</div> <div class="image-green-border"><br/> '''Note''':&nbsp;</div>  
−
*The folders ''Inbox ''and ''Processing ''are mandatory whereas ''Archive, Error'' and ''Passed ''are not mandatory and can be removed. For example, if the ''Passed ''folder is removed, no Pass file will be created after the files are processed. However, if the ''Inbox ''or ''Processing ''folder(s) is/are removed, then the GIF will use the default folder structure.  
+
*The folders Inbox and Processing are mandatory whereas Archive, Error and Passed are not mandatory and can be removed. For example, if the Passed folder is removed, no Pass file will be created after the files are processed. However, if the Inbox or Processing folder(s) is/are removed, then the GIF will use the default folder structure.  
 
*Folder structures using only one folder will also have a separate folder for processing.  
 
*Folder structures using only one folder will also have a separate folder for processing.  
 
*Users can configure different folder structures per entity.  
 
*Users can configure different folder structures per entity.  
−
*If no customization is needed, then leave the ''Folder Structure Json'' attribute blank and ''Update ''the existing ''Client App Cross Reference''. In this case, the default folder structure will be created on the FTP folder structure.  
+
*If no customization is needed, then leave the Folder Structure Json attribute blank and Update the existing Client App Cross Reference. In this case, the default folder structure will be created on the FTP folder structure.  
 
<div class="image-green-border">[[File:SFTP 7.png|500px|SFTP 7.png]]</div>  
 
<div class="image-green-border">[[File:SFTP 7.png|500px|SFTP 7.png]]</div>  
−
7. '''Click '''''Save''. The cross reference mapping will be created.
+
7. '''Click '''Save. The cross reference mapping will be created.
−
<div class="image-green-border"><br/> 8. '''Click '''''Publish Payload ''on the ''Masterdata Summary ''page. The folder structure will be created in the FTP.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.14 GIF Folder Structure Management 08.png|650px|7.14 GIF Folder Structure Management 08.png]]</div> <div class="image-green-border">&nbsp;</div>  
+
<div class="image-green-border"><br/> 8. '''Click '''Publish Payload on the Masterdata Summary page. The folder structure will be created in the FTP.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.14 GIF Folder Structure Management 08.png|650px|7.14 GIF Folder Structure Management 08.png]]</div> <div class="image-green-border">&nbsp;</div>  
 
== Support for user provisioning/deprovisioning from ASB/SFTP/BLOB ==
 
== Support for user provisioning/deprovisioning from ASB/SFTP/BLOB ==
 
<div class="image-green-border">Configurators can now provision, deprovision, reprovision and replace users in ICI through ASB and SFTP based integrations. For example, to provision a user using ASB:</div> <div class="image-green-border">&nbsp;</div>  
 
<div class="image-green-border">Configurators can now provision, deprovision, reprovision and replace users in ICI through ASB and SFTP based integrations. For example, to provision a user using ASB:</div> <div class="image-green-border">&nbsp;</div>  
 
=== Configuring Client App Cross Reference Mapping &nbsp; ===
 
=== Configuring Client App Cross Reference Mapping &nbsp; ===
−
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">1. Create the master data for user information, similar to other integration client app cross reference mapping.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:SFTP 8.png|500px|SFTP 8.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2. Edit the JSON structure for “UserInformation”.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 02.png|600px|7.16 GIF User provisioning 02.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3. In the “Default Groups” attribute on the Create Masterdata page, enter the JSON structure. The default security groups can be configured for each payload. The security groups will get added into that payload as a default.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:SFTP 20.12.21.png|500px]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4. In the “Default Entity Team” attribute, enter the JSON structure array of the team. You can add details such as user’s email Id here.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">5. Set the “Auto Detect User” flag to Yes. The user’s action will be auto-detected, even if the user does not pass any action from JSON structure/payload.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">6. Update details on ASB.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">7. Send the payload on the inbound topic. Payload can be captured from any third-party application. For example, SAP.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">8. '''Click '''''User Administration > Users > Users'' in ICI. The users index page opens. The provisioned user will be displayed in the list of users.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">If the entity team includes an approver, the user gets created with Status “Created”. If the team does not include an approver, the user gets created with status “Provisioned”.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Following is a list of all actions available that can be used in the same steps as described for the “Provision” above:</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 06.png|720px|7.16 GIF User provisioning 06.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''': All actions can be checked for success or failure through standard ICI notifications.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">The same actions are available when using SFTP based integrations. However, in case of CSV multiple data cannot be sent in one line item. The first file contains the main payload. For example, see screenshot below:</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 07.png|720px|7.16 GIF User provisioning 07.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">The line items (such as organization, extended user entity, etc.) can be sent in other files.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 08.png|720px|7.16 GIF User provisioning 08.png]]</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 09.png|720px|7.16 GIF User provisioning 09.png]]</div> <div class="image-green-border"><br/> When the files are uploaded and the job is triggered at the backend, the line items and main payload will be picked up for processing. The user will get added and the team will get updated in ICI.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Similar to ASB, users can also be provisioned, deprovisioned and replaced using SFTP by passing the respective actions via CSV.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Unlike CSV, when using JSON based integrations, all actions can be passed using one file.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 10.png|600px|7.16 GIF User provisioning 10.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''':&nbsp;&nbsp; &nbsp;<br/> The Folder Structure Json attribute has been updated to Version 2.0, however earlier versions continue to be supported.<br/> Notifications to individual users and mass notification to functional users are not supported.<br/> Creating a new security group or user group is not supported.</div>  
+
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">1. Create the master data for user information, similar to other integration client app cross reference mapping.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:SFTP 8.png|500px|SFTP 8.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2. Edit the JSON structure for “UserInformation”.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 02.png|600px|7.16 GIF User provisioning 02.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3. In the “Default Groups” attribute on the Create Masterdata page, enter the JSON structure. The default security groups can be configured for each payload. The security groups will get added into that payload as a default.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:SFTP 20.12.21.png|500px|SFTP 20.12.21.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4. In the “Default Entity Team” attribute, enter the JSON structure array of the team. You can add details such as user’s email Id here.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">5. Set the “Auto Detect User” flag to Yes. The user’s action will be auto-detected, even if the user does not pass any action from JSON structure/payload.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">6. Update details on ASB.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">7. Send the payload on the inbound topic. Payload can be captured from any third-party application. For example, SAP.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">8. '''Click '''User Administration > Users > Users in ICI. The users index page opens. The provisioned user will be displayed in the list of users.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">If the entity team includes an approver, the user gets created with Status “Created”. If the team does not include an approver, the user gets created with status “Provisioned”.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Following is a list of all actions available that can be used in the same steps as described for the “Provision” above:</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 06.png|720px|7.16 GIF User provisioning 06.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''': All actions can be checked for success or failure through standard ICI notifications.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">The same actions are available when using SFTP based integrations. However, in case of CSV multiple data cannot be sent in one line item. The first file contains the main payload. For example, see screenshot below:</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 07.png|720px|7.16 GIF User provisioning 07.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">The line items (such as organization, extended user entity, etc.) can be sent in other files.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 08.png|720px|7.16 GIF User provisioning 08.png]]</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 09.png|720px|7.16 GIF User provisioning 09.png]]</div> <div class="image-green-border"><br/> When the files are uploaded and the job is triggered at the backend, the line items and main payload will be picked up for processing. The user will get added and the team will get updated in ICI.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Similar to ASB, users can also be provisioned, deprovisioned and replaced using SFTP by passing the respective actions via CSV.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Unlike CSV, when using JSON based integrations, all actions can be passed using one file.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.16 GIF User provisioning 10.png|600px|7.16 GIF User provisioning 10.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''':&nbsp;&nbsp; &nbsp;<br/> The Folder Structure Json attribute has been updated to Version 2.0, however earlier versions continue to be supported.<br/> Notifications to individual users and mass notification to functional users are not supported.<br/> Creating a new security group or user group is not supported.</div>  
 
== Extending file-based inbound integration for agreements and associations ==
 
== Extending file-based inbound integration for agreements and associations ==
  

Revision as of 08:06, 21 December 2021

 

Generic Integration Framework to Support SFTP Interface

The Secure File Transfer Protocol (SFTP) adapter will be built as an automated solution to load Masterdata once extracted from source of truth via SFTP. SFTP, a secure version of File Transfer Protocol (FTP), is a network protocol which facilitates file access, file transfer and file management over a Secure Shell (SSH) data stream. 

Configuring SFTP Adapter to load Masterdata

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

Create Masterdata Contract Type 

To enable synchronization between ICI and SFTP, a Masterdata Contract Type should first be configured in ICI, with specific attributes for the integration.

To create a Masterdata Contract Type: 

1. Click Create Contract Type sub menu from the Configuration tile. The Select Contract Type page opens.

GIF1.png

2.Select Masterdata.

GIF 2.png
 
3. Click the Next button. The Create Contract Type Wizard page opens.
 
GIF 3.png

The Create Contract Type page has the following sections: 

  • 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 Create.

 

Client App Cross Reference

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

1. Navigate to the Create Masterdata page in ICI. This page contains the following tabs:

GIF 4.png

Masterdata Details 

1. Select the Category from the drop-down. For example, Default.

2. Select the Masterdata Contract Type.

Note: In order to map ICI entities with entities in the file uploaded through SFTP, you must select Client App Cross Reference from the drop-down.

3. Click Next. The Attributes page opens.

Attributes 

  1. Enter the relevant attribute values. For example, enter ICI Entity Name as ICISupplierMaster and Client Entity Name as SupplierMaster. The Payload Type can be selected as CSV or Json.
  2. Select the Text Delimiter. Supported options are pipe, colon and comma.
  3. Select the Text Qualifier. Supported options are Single Quote, Double Quote, No Quote.
Note: The Client Name GenericIntegration must be selected. To create mapping using SFTP, select FileBased in the Integration Mode drop-down. The Transport Protocol can be FTP, SFTP, SSH or Blob.

4. Click Crate to crate  the entity mapping. Or Click UPDATE to update existing entity mapping. 

SFTP 1.png

Client App Entity Mapping 

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

1. Navigate to theCreate Masterdata page in ICI. This page contains the following tabs:

GIF 7.png
 
 

Masterdata Details 

1. Select the Category from the drop-down. For example, Default.

2.Select the Masterdata Contract Type.

Note: In order to map ICI attributes with attributes uploaded through SFTP, Client App Entity Mapping must be selected from the drop-down.

3. Click Next. The Attributes page opens.

Attributes

1. Enter the relevant attribute values. For example, enter ICI Entity Name as ICISupplierMaster and Client Entity Name as SupplierMaster.

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

In case of lookup and non-lookup attributes: The ICI 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<ICI Attribute Name>. For example, in case of Supplier Master the ICI attribute name will be ICISupplierCountry and the Masterdata Contract Type for this attribute will be ICICountryMaster. Hence, relationship key will be ICICountryMaster__ICISupplierCountry. 

2. Click Save to save the entity mapping. 

 

Using SFTP Adapter to load/publish Masterdata

Download Payload

  1. Navigate to the Masterdata page in ICI.
  2. Click the View Record icon next to the Client App Cross Reference entity you have created. The Masterdata Details page opens.
GIF 9A.png
  1. Click the Download Payload button. The template for the Masterdata will be downloaded to your local drive.
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.
 
GIF 10.png
  1. Open the downloaded CSV or Json file. This file will be used by third-party systems to push data to the SFTP adapter.
Generic Integration Framework SFTP 10.png

Publish Payload

Click Publish Payload. The empty payload will be published.

 
GIF 11.png
 
 
Note: For any subsequent Masterdata changes, the user needs to click Publish Payload button again to update the empty payload.

Using SFTP adapter to load/publish Transaction Data 

Download Payload 

1. Navigate to the Masterdata page in ICI.

2. Click the View Record icon next to the Client App Cross Reference entity you have created. The Masterdata Details page opens.

3. Click the Download Payload button. The template for the Masterdata will be downloaded to your local drive.

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.

4. Open the downloaded CSV file. This file will be used by third-party systems to push data to the SFTP adapter.

 

Publish Payload 

Click Publish Payload. The empty payload will be published.

Note: For any subsequent Masterdata changes, the user needs to click Publish Payload button again to update the empty payload.

A notification is displayed once the Payload is published successfully.

Note: The user can create a subscription to the job status updates by using the standard in Notification Setting in the User Administration menu.

Support for pre/post processing

With this release, support is being provided for custom pre- and post-processing hooks to the Generic Integration Framework in order to considerably reduce implementation time. These hooks are now provided to:

  • Pre-process inbound data through file-based integrations.
  • Pre-process inbound and outbound data through ASB-based integrations.

ICI administrators will now be able to:

  • Enable or disable the hook as part of file-based integration.
  • Pass parameters to the hook for executing a custom logic.
  • Enable or disable the hook at file or record level. When hook is enabled at file level, the system will process all records in the file before handing off control to the hook. When hook is enabled at record level, system will wait for hook to complete processing at record level before processing the next record.
  • Execute any custom logic in the system for a file or record when hook is configured.
  • Complete GIF process even when custom logic encounters any error while processing a record or file.

 

Support for defining folder structure in Generic Integration Framework

Previously, the generic integration framework provided a fixed folder structure for file-based inbound master data integration. 
Now, support is being extended so that users will be able to define and configure the folder structure and file names depending on their business requirement. This helps in reducing effort during implementation while aiding better adoption of changes on the client's system.
With this release users have:

  • Support for single or multiple folders in the folder structure. 
  • A folder and file naming convention which is flexible, and configurable via masterdata (in JSON format).
  • Support for folder structure based on ICI entities, with separate folders for each ICI entity.
  • Folders which are easy to configure and flexible to modify via JSON structure, whenever business needs change.
  • A choice to use standard folders as per requirement. If JSON structure is not added, then the ICI default folder structure will automatically be used.

 

 

Creating a Customized Folder Structure

To create a customized folder structure using GIF:

1. Click Home > Configure > Masterdata > Create Masterdata. The Masterdata Details page opens.


2. Enter the relevant details:
  • Category: Select Default
  • Masterdata: Select Client App Cross Reference 
GIF 4.png
 

3. Click Next. The Attributes page opens.

4. Enter the relevant attribute values in the respective fields. 

5. Copy the Json format from the tool-tip of the Folder Structure Json attribute.
 
7.14 GIF Folder Structure Management 04.png

6. Edit the Json format text to customize the folder structure.  
SFTP 14.png

Note: 
  • The folders Inbox and Processing are mandatory whereas Archive, Error and Passed are not mandatory and can be removed. For example, if the Passed folder is removed, no Pass file will be created after the files are processed. However, if the Inbox or Processing folder(s) is/are removed, then the GIF will use the default folder structure.
  • Folder structures using only one folder will also have a separate folder for processing.
  • Users can configure different folder structures per entity.
  • If no customization is needed, then leave the Folder Structure Json attribute blank and Update the existing Client App Cross Reference. In this case, the default folder structure will be created on the FTP folder structure.
SFTP 7.png

7. Click Save. The cross reference mapping will be created.


8. Click Publish Payload on the Masterdata Summary page. The folder structure will be created in the FTP.
 
7.14 GIF Folder Structure Management 08.png
 

Support for user provisioning/deprovisioning from ASB/SFTP/BLOB

Configurators can now provision, deprovision, reprovision and replace users in ICI through ASB and SFTP based integrations. For example, to provision a user using ASB:
 

Configuring Client App Cross Reference Mapping  

 
1. Create the master data for user information, similar to other integration client app cross reference mapping.
 
SFTP 8.png
 
2. Edit the JSON structure for “UserInformation”.
 
7.16 GIF User provisioning 02.png
 
3. In the “Default Groups” attribute on the Create Masterdata page, enter the JSON structure. The default security groups can be configured for each payload. The security groups will get added into that payload as a default.
 
SFTP 20.12.21.png
 
4. In the “Default Entity Team” attribute, enter the JSON structure array of the team. You can add details such as user’s email Id here.
 
5. Set the “Auto Detect User” flag to Yes. The user’s action will be auto-detected, even if the user does not pass any action from JSON structure/payload.
 
6. Update details on ASB.
 
7. Send the payload on the inbound topic. Payload can be captured from any third-party application. For example, SAP.
 
8. Click User Administration > Users > Users in ICI. The users index page opens. The provisioned user will be displayed in the list of users.
 
 
If the entity team includes an approver, the user gets created with Status “Created”. If the team does not include an approver, the user gets created with status “Provisioned”.
 
Following is a list of all actions available that can be used in the same steps as described for the “Provision” above:
 
7.16 GIF User provisioning 06.png
 
Note: All actions can be checked for success or failure through standard ICI notifications.
 
The same actions are available when using SFTP based integrations. However, in case of CSV multiple data cannot be sent in one line item. The first file contains the main payload. For example, see screenshot below:
7.16 GIF User provisioning 07.png
 
The line items (such as organization, extended user entity, etc.) can be sent in other files. 
 
7.16 GIF User provisioning 08.png
7.16 GIF User provisioning 09.png

When the files are uploaded and the job is triggered at the backend, the line items and main payload will be picked up for processing. The user will get added and the team will get updated in ICI.
 
Similar to ASB, users can also be provisioned, deprovisioned and replaced using SFTP by passing the respective actions via CSV.
 
Unlike CSV, when using JSON based integrations, all actions can be passed using one file.
 
7.16 GIF User provisioning 10.png
 
Note:    
The Folder Structure Json attribute has been updated to Version 2.0, however earlier versions continue to be supported.
Notifications to individual users and mass notification to functional users are not supported.
Creating a new security group or user group is not supported.

Extending file-based inbound integration for agreements and associations

To create an agreement along with associations and team using CSV file-based integration:
1. Update the Client App Cross Reference mapping as usual for file-based inbound integrations.

2. For CSV-based agreement creation:

  • Select “Integration Mode” as “FileBased”
  • Select “Payload Type” as “Csv”
  • Select “Transport Protocol” as “FTP”
  • Enter the folder structure in “Folder Structure Json”
7.16 GIF File based 01.png

3. Enter the “Default Entity Team”.

4. Enter the “Line Item Separator” as “#”.
 
The “Line Item Name Separator” entered here must be used in the Client App Entity Mapping. For example, it must be used while mapping, associations to agreements or roles to a distribution group.
 
SFTP 9.PNG
 
5. Upload the files to the FTP server.
 
Once the background task is triggered the files will be processed, the agreement gets created and it will be displayed on the agreement index page.
 
SFTP 11.png

The agreement gets created with all the uploaded details:
 
SFTP 13.png
 
 
 
To create an agreement along with associations and team using JSON file-based integration:

Update the JSON file with the agreement and team details.
 
7.16 GIF File based 06.png

Once the JSON is uploaded to the FTP server and the task is triggered, the files will be processed, the agreement gets created, and it will be displayed on the agreement index page.
 
SFTP 12.png

Follow the same process to create contract requests.
 

Note: 
To set a user other than service user or the user configured in cross reference mapping as the Primary Owner, the CSV payload must contain the details of the desired primary owner.

Adding the parent agreement code is mandatory in each association CSV file.

Inbound amendment management is currently not supported.

 

 

 

Related Topics: Agreement Management | Integrations | Salesforce | Using Adobe Sign | Using DocuSign | Using Namirial eSignAnyWhere | Generic Integration Framework to Support ASB Interface | Release_Notes |

Retrieved from "https://iciwikiapac.icertis.com:443/ICIHelp8.2/index.php?title=Generic_Integration_Framework_to_Support_SFTP_Interface&oldid=21045"