From ICIHelp8.1
Jump to: navigation, search
Line 25: Line 25:
 
8. The Association gets added under the ''Association ''section with an incremented association number.
 
8. The Association gets added under the ''Association ''section with an incremented association number.
 
<div class="note-box">'''Note:'''&nbsp;In ICM you can auto attach supporting documents to an agreement at a pre-defined state, if proper Masterdata and Rules are created for the specific Contract Type.<br/> Two types of Masterdata must be created:,<br/> *&nbsp;for Mapping:&nbsp;it will consist of Contract type, Associations, Event&nbsp;which is the state when you want the supporting document to get attach with the Agreement and the Smart Link&nbsp;saved search name.<br/> *&nbsp;for Document Repository:&nbsp;it will consist of information such as&nbsp;Document Name, Effective date and&nbsp;Validity.<br/> The Rule needs to be created for the Agreement to get the ''Supporting Documents'' auto attached at the predefined state.</div>  
 
<div class="note-box">'''Note:'''&nbsp;In ICM you can auto attach supporting documents to an agreement at a pre-defined state, if proper Masterdata and Rules are created for the specific Contract Type.<br/> Two types of Masterdata must be created:,<br/> *&nbsp;for Mapping:&nbsp;it will consist of Contract type, Associations, Event&nbsp;which is the state when you want the supporting document to get attach with the Agreement and the Smart Link&nbsp;saved search name.<br/> *&nbsp;for Document Repository:&nbsp;it will consist of information such as&nbsp;Document Name, Effective date and&nbsp;Validity.<br/> The Rule needs to be created for the Agreement to get the ''Supporting Documents'' auto attached at the predefined state.</div>  
 +
=== &nbsp; ===
 +
 +
== Ability to define parent-child relationship for peer associations ==
 +
 +
ICM provides the functionality to attach associations to agreement entities. This functionality has now been enhanced with the ability to define the type of relationship (association) as Parent, Child or Peer.&nbsp;<br/> With this release, agreements can have only one association as a parent and all existing related agreements will be tagged as peer associations.
 +
 +
=== Configuring Contract Type to enable parent-child relationship for peer associations ===
 +
 +
Users need to configure the contract type and define default associations to enable the parent child linkage for peer associations.
 +
 +
<br/> To set the associations in Contract Type:
 +
 +
&nbsp;
 +
 +
#Click Configuration > Create Contract Type > Agreement > Next on the Dashboard. The Create Contract Type page opens.
 +
#Enter the Contract Type name. For example, PK_SOW.
 +
#Enter remaining details on Details tab.
 +
#Click Next. The Attribute tab opens.
 +
#Enter the details on Attributes tab.
 +
#Click Next. The Association tab opens.
 +
#Click Add Association icon. The Add Association section is displayed.
 +
#Add Association Name. For example, ICMPK_MSA.
 +
#Select the Contract Type. For example, PK_MSA.
 +
#Toggle the Multiple instances to Yes.
 +
#Toggle the Allow two-way linkage to Yes.
 +
#Click Save. The association is added to the contract type.
 +
#Enter the details in the remaining Display Preference and Team tabs.
 +
#Verify and click Create. The agreement contract type is created.&nbsp;
 +
 +
Screenshot
 +
 +
You can also edit and configure the associations in the existing agreement contract type.
 +
 +
&nbsp;
 +
 +
=== Creating the single-linked associations for agreements ===
 +
 +
User can link the masterdata instance as an association to the agreement. In such case, the Linkage Type drop-down will not be displayed on the Lookup window and the association will be added as peer.
 +
 +
<br/> Note: The self-reference linkage is enabled through technical configuration.
 +
 +
<br/> To create the self-linked masterdata association for the agreement:
 +
 +
#Click Agreement Management > Agreement on the Dashboard. The agreement index page opens.
 +
#Click View Record icon next to the contract type for which you want to create associations. For example, Icertis Statement of work (agreement created with PK_SOW contract type). The agreement details page opens.
 +
 +
All the configured associations for the contract type will be visible by default on the left panel configuration under Association tab on the agreement Details page.
 +
<ol start="3">
 +
<li>Click Create Associations icon next to the masterdata contract type for which you want to create the single-link association. For example, Product Masterdata. The Lookup Search window opens. All the masterdata instances for the selected masterdata contract type are displayed.</li>
 +
<li>Select the masterdata instance. For example, Ads Data Hub.</li>
 +
</ol>
 +
 +
Screenshot
 +
 +
The linkage type field on the Lookup Search window is not visible while creating associations for masterdata and the associations are linked as Peer by default.
 +
<ol start="5">
 +
<li>Click Select. The masterdata will be linked to the agreement with the linkage type as Peer.</li>
 +
</ol>
 +
 +
Screenshot
 +
 +
&nbsp;
 +
 +
=== Creating the unidirectional associations for agreements ===
 +
 +
The Allow Two-Way Linkage field is set to No for the associations in the contract type to create the unidirectional associations.
 +
 +
To create the association for the agreement:
 +
 +
#Click Create Associations icon next to the contract type you want to link to the agreement. For example, Base CT (This association is configured with the two way linkage disabled at the contract type level).&nbsp;
 +
 +
The Lookup Search window opens. All the agreements for the selected contract type (Base CT) are displayed irrespective of their states.
 +
 +
Screenshot
 +
 +
Note: Amendments will not be displayed for associating with agreement on the Lookup window.
 +
<ol start="2">
 +
<li>Select the agreement instance. For example, ICMBaseCT_5.</li>
 +
</ol>
 +
 +
The association will not be allowed and the validation messages will be displayed if the user tries to:
 +
 +
*Relink the already associated agreement
 +
*Link the parent agreement with its child agreement as peer association&nbsp;
 +
*Link the same agreement to itself ( self-linking the agreement)
 +
*Link more than one agreement with the linkage type as Parent to the agreement
 +
*Link the agreement as child which already has a parent association
 +
 +
For example, validation message is displayed when the user associates the agreement as Child which already has Parent:
 +
 +
Screenshot
 +
<ol start="3">
 +
<li>Select the Linkage Type as:</li>
 +
</ol>
 +
 +
*Peer
 +
*Parent
 +
*Child
 +
 +
For example, Parent.
 +
 +
&nbsp;
 +
 
=== Auto-attachment of Associated documents ===
 
=== Auto-attachment of Associated documents ===
  

Revision as of 07:54, 9 July 2020

Adding Supporting Documents to an Agreement

You can add Associations and supporting documents to an Agreement after it is created. Supporting documents are not necessarily part of the agreement, but are used to capture miscellaneous details, like email threads, minutes of meetings, and so on. There are two types of associations:

  • Peer to Peer: when an agreement is associated with another agreement or Masterdata. The peer associations can be in Executed, Waiting for Review and Reviewed states. This works only for the configured state(s).
  • Parent to Child: when an agreement and its supporting documents are linked through associations that are defined in a contract type. Inheritance is possible only when the data type of attributes defined for Parent and child agreements are the same.

To add an Association:

1. Click the Agreement Management tile on My Dashboard. The Agreements Page opens.

2. Click the Details icon  to view the details of the selected Agreement. The Agreement Details Page opens.  

3. Click the Associations option in the left navigation to see a list of all associations that have been added to the agreement.

4. Click RTENOTITLE icon to add a peer to peer association. The Select Association page opens.

RTENOTITLE

5. Select an appropriate association and then click Select. The selected Association gets added under theAssociation section with an incremented association number.

6. Click RTENOTITLE to add a parent to child association. The Create Associated Document dialog box opens with the parent agreement name on the right side of the page.

7. Type the appropriate information in the respective fields and click Create to create a child association for that agreement.

8. The Association gets added under the Association section with an incremented association number.

Note: In ICM you can auto attach supporting documents to an agreement at a pre-defined state, if proper Masterdata and Rules are created for the specific Contract Type.
Two types of Masterdata must be created:,
* for Mapping: it will consist of Contract type, Associations, Event which is the state when you want the supporting document to get attach with the Agreement and the Smart Link saved search name.
* for Document Repository: it will consist of information such as Document Name, Effective date and Validity.
The Rule needs to be created for the Agreement to get the Supporting Documents auto attached at the predefined state.

 

Ability to define parent-child relationship for peer associations

ICM provides the functionality to attach associations to agreement entities. This functionality has now been enhanced with the ability to define the type of relationship (association) as Parent, Child or Peer. 
With this release, agreements can have only one association as a parent and all existing related agreements will be tagged as peer associations.

Configuring Contract Type to enable parent-child relationship for peer associations

Users need to configure the contract type and define default associations to enable the parent child linkage for peer associations.


To set the associations in Contract Type:

 

  1. Click Configuration > Create Contract Type > Agreement > Next on the Dashboard. The Create Contract Type page opens.
  2. Enter the Contract Type name. For example, PK_SOW.
  3. Enter remaining details on Details tab.
  4. Click Next. The Attribute tab opens.
  5. Enter the details on Attributes tab.
  6. Click Next. The Association tab opens.
  7. Click Add Association icon. The Add Association section is displayed.
  8. Add Association Name. For example, ICMPK_MSA.
  9. Select the Contract Type. For example, PK_MSA.
  10. Toggle the Multiple instances to Yes.
  11. Toggle the Allow two-way linkage to Yes.
  12. Click Save. The association is added to the contract type.
  13. Enter the details in the remaining Display Preference and Team tabs.
  14. Verify and click Create. The agreement contract type is created. 

Screenshot

You can also edit and configure the associations in the existing agreement contract type.

 

Creating the single-linked associations for agreements

User can link the masterdata instance as an association to the agreement. In such case, the Linkage Type drop-down will not be displayed on the Lookup window and the association will be added as peer.


Note: The self-reference linkage is enabled through technical configuration.


To create the self-linked masterdata association for the agreement:

  1. Click Agreement Management > Agreement on the Dashboard. The agreement index page opens.
  2. Click View Record icon next to the contract type for which you want to create associations. For example, Icertis Statement of work (agreement created with PK_SOW contract type). The agreement details page opens.

All the configured associations for the contract type will be visible by default on the left panel configuration under Association tab on the agreement Details page.

  1. Click Create Associations icon next to the masterdata contract type for which you want to create the single-link association. For example, Product Masterdata. The Lookup Search window opens. All the masterdata instances for the selected masterdata contract type are displayed.
  2. Select the masterdata instance. For example, Ads Data Hub.

Screenshot

The linkage type field on the Lookup Search window is not visible while creating associations for masterdata and the associations are linked as Peer by default.

  1. Click Select. The masterdata will be linked to the agreement with the linkage type as Peer.

Screenshot

 

Creating the unidirectional associations for agreements

The Allow Two-Way Linkage field is set to No for the associations in the contract type to create the unidirectional associations.

To create the association for the agreement:

  1. Click Create Associations icon next to the contract type you want to link to the agreement. For example, Base CT (This association is configured with the two way linkage disabled at the contract type level). 

The Lookup Search window opens. All the agreements for the selected contract type (Base CT) are displayed irrespective of their states.

Screenshot

Note: Amendments will not be displayed for associating with agreement on the Lookup window.

  1. Select the agreement instance. For example, ICMBaseCT_5.

The association will not be allowed and the validation messages will be displayed if the user tries to:

  • Relink the already associated agreement
  • Link the parent agreement with its child agreement as peer association 
  • Link the same agreement to itself ( self-linking the agreement)
  • Link more than one agreement with the linkage type as Parent to the agreement
  • Link the agreement as child which already has a parent association

For example, validation message is displayed when the user associates the agreement as Child which already has Parent:

Screenshot

  1. Select the Linkage Type as:
  • Peer
  • Parent
  • Child

For example, Parent.

 

Auto-attachment of Associated documents

You can also create multiple Agreements that will have all the required supporting documents auto-attached to it. For this to work, the ICM Administrator must create two Masterdata Contract Types, one for the Supporting Documents and another to map the Agreement Contract Type to the specific Supporting Document. This feature will be useful when several Agreements need to be created with the same supporting documents. For example: Every sales order Agreement may be required to include a warranty documentation.

Tagging Saved Search of Associated documents in an Agreement

There are two ways to add an Associated document Saved search to an Agreement. 

  • Adding the Saved search tag to the Template
  • Adding the Saved search tag to the Agreement document

Note: A Saved Search needs to be created in ICM of the required association data. 

To tag Associated Document Saved Search:

You can add the rich text content control to tag the saved search in the Template or Agreement document using Word:

1. Select the Plain Text Content Control from the Developer menu.

2. Click Properties. TheContent Control Prpoerties winow opens

3. Enter the Title and tag as ICMAssociation|AssociatedSavedSearchName. For example, ICMAssociation|Country Master.

4. Click Ok. The Saved Search is now tagged in the Template/Agreement document in the form of a table.

RTENOTITLE

Note: This template is uploaded in ICM to be available while creating a document. The Saved Search is visible after assembling the contract.

Upon publishing the Agreement you can add more instances to the Associated document Saved Search in the Agreement document from the Agreement's Details page:

1. Click the Associations tab on the Agreement's Details page. 

2. Click the Create Association icon in the Associations tab. The Create Association page opens.  

RTENOTITLE

3. Enter the necessary details on the Meta Data tab. For example, Name, Contract Value.

RTENOTITLE

4. Click Next. The Templates tab opens.

4. Select the appropriate template. 

5. Click Create. The association instance is added. The Agreement's Details page opens. The number next to the association is updated in the Associations tab.Erlier there were 2 instances of the associations and now there are 3. 

RTENOTITLE

6. Click the Assemble Contract button on the Details page. The newly added instance get's updated in the Agreement document.

Note: The Associated document saved search instances can also be updated in the document by Edit and Update actions. 

 

 

Related Topics:  Agreement Details Page | Association Management | Saved Searches