From ICIHelp7.15
Jump to: navigation, search
 
(23 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
 +
 
  
 
= Outlook Add-in =
 
= Outlook Add-in =
  
With this release, a new .JS version of the ICM Outlook Plugin has been introduced. The overall turnaround time for the author is reduced as he no longer needs to download the documents to the local machine, then switch applications and log in to ICM, search the Agreement and then upload the documents.<br/> The provisioned user can now:
+
A&nbsp;.JS version of the ICI Outlook Plugin is available in ICI. The overall turnaround time for the author is reduced as he no longer needs to download the documents received over email to the local machine, then switch applications and log in to ICI, search the Agreement and then upload the documents.<br/> The provisioned user can now:
  
 
*Upload the next version of the Agreement document received over an Email to the Agreement  
 
*Upload the next version of the Agreement document received over an Email to the Agreement  
Line 8: Line 10:
 
*Create a new Association instance and then upload the Associated Document received over an Email to the Agreement  
 
*Create a new Association instance and then upload the Associated Document received over an Email to the Agreement  
  
The configuration of the Outlook Add-in is driven by the Masterdata, whereas the list of Agreements and their details are configured by the Saved Searches. You can configure multiple saved searches. This is available for MS Outlook online as well as the Desktop client for <span style="background-color:#FFD700;">version … & above. &nbsp;</span><br/> &nbsp;
+
The configuration of the Outlook Add-in is driven by the Masterdata, whereas the list of Agreements and their details are configured by the Saved Searches. You can configure multiple saved searches.
 +
 
 +
The Outlook Add-in (.JS version) is supported on 2 different platforms:
 +
 
 +
*For MAC OS (Mojave): it is tested and verified on Microsoft Office 365 (2016 and above).
 +
*For Windows 10: it is tested and verified on Microsoft Office Professional Plus 2013 (15.0.5007.1000) and 2016 (16.0.4849.1000) 64-bit and above.  
 +
 
 +
&nbsp;
  
 
== Uploading the next version of an Agreement received over MS Outlook Email ==
 
== Uploading the next version of an Agreement received over MS Outlook Email ==
  
<br/> To add the Associated Documents to an Agreement:<br/> 1. '''Open''' the Email with the next version of the Agreement.<br/> 2. '''Open''' the ICM Outlook Add-in.<br/> 3. On the ''Details ''tab, '''click '''Select ICM Agreement / Association to look for the Agreement that you&nbsp;want to upload agreement or association.&nbsp;<br/> &nbsp;
+
To add the the next version of the Agreement received over Outlook Email:<br/> 1. '''Open''' the Email with the next version of the Agreement.<br/> 2. '''Open''' the ICI Outlook Add-in.<br/> 3. On the ''Details ''tab, '''click '''''Select ICI Agreement / Association'' to look for the Agreement that you&nbsp;want to upload as the next version.
 +
<div class="image-green-border">[[File:Email Outlook Plugin 1.png|820px|Email Outlook Plugin 1]]</div>
 +
4. '''Click''' ''Select Email Attachment'' that you want to upload from the drop-down.<br/> 5. '''Click''' ''Upload''.&nbsp;The ''File(s) uploaded successfully ''message is displayed. If the Agreement fails to be attached, then a message will be displayed indicating that you can retry sending the Attachment.
 +
<div class="image-green-border">[[File:Email Outlook Plugin 2.png|820px|Email Outlook Plugin 2]]</div>
 +
You can&nbsp;''Preview'' the Agreement in the ICI application&nbsp;on the Agreement ''Details ''page.
 +
<div class="image-green-border">[[File:Email Outlook Plugin 03.png|720px|Email Outlook Plugin 03.png]]</div>  
 +
&nbsp;
  
4. '''Click''' ''Select Email Attachment'' that you want to upload from the drop-down.<br/> 5. '''Click''' ''Upload''.&nbsp;
+
== Adding the next version of the Associated Document received over MS Outlook Email to the Agreement ==
  
The ''File(s) uploaded successfully ''message is displayed. If the Agreement fails to be attached, then a message will be displayed indicating that you can retry sending the attachment.
+
<br/> To add the next version of the&nbsp;Associated Document received over Outlook Email to the Agreement&nbsp;:<br/> 1. '''Open '''the Email with the Associated Documents.<br/> 2. '''Open '''the ICI Outlook Add-in.
  
You can&nbsp;''Preview'' the Agreement in the ICM application&nbsp;on the Agreement ''Details ''page.
+
3. On the ''Details'' tab,'''click''' ''Select ICI Agreement / Association'' to add the next version of the Association.&nbsp;For example, ''Payment Details''.
 +
<div class="image-green-border">[[File:Email Outlook Plugin 4.png|820px|Email Outlook Plugin 4]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4. '''Click''' ''Select Email Attachment'' that you want to upload from the drop-down.<br/> 5. '''Click''' ''Upload''.&nbsp;The ''File(s) uploaded successfully ''message is displayed.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Email Outlook Plugin 5 gr actions.png|820px|Email Outlook Plugin 5]]</div>
 +
6. '''Click''' the ''View Record'' icon to view the Attachment details.&nbsp;
 +
<div class="image-green-border">[[File:Email Outlook Plugin 6.png|820px|Email Outlook Plugin 6]]</div>
 +
7. '''Click '''the&nbsp;''Preview'' icon to view the Attachment.&nbsp;
 +
<div class="image-green-border">[[File:Email Outlook Plugin 7.png|820px|Email Outlook Plugin 7]]</div>
 +
&nbsp;
  
 
&nbsp;
 
&nbsp;
 +
 +
== Creating a new instance of an Association and adding an Associated Document received over MS Outlook Email ==
 +
 +
To create a new instance of an Association and add the Associated Document received over Outlook Email to the Agreement:<br/> 1. On the ''Details'' tab,'''click''' ''Select ICI Agreement / Association ''to create a new instance of the&nbsp;Association. For example, adding an Association to the''Payment Details A''ssociation.<br/> 2. Enter a name for the new instance of the Association.<br/> 3. '''Click''' the ''Add Association'' button to add the new instance of the Association.
 +
<div class="image-green-border">[[File:Email Outlook Plugin 8.png|820px|Email Outlook Plugin 8]]</div> <div class="image-green-border"><br/> 4. '''Click '''the ''Select Email Attachment'' field to select the document that you want to attach to the newly created instance.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Email Outlook Plugin 9.png|820px|Email Outlook Plugin 9]]</div> <div class="image-green-border"><br/> 5.'''Click''' ''Upload''. The document is now attached to the newly created instance. The ''File(s) uploaded successfully'' message is displayed.</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note: '''The Association is only created with the name. The remaining mandatory fields need to be entered in the ICI application.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Email Outlook Plugin 10.png|820px|Email Outlook Plugin 10]]</div>
 +
6. The document is now available on the ''Associations'' tab in the ICI application as the next version.
  
 
&nbsp;
 
&nbsp;
  
== Adding the next version of the Associated Document received over MS Outlook Email to the Agreement ==
+
&nbsp;
  
<br/> To add the next version to the Association:<br/> 1. '''Open '''the Email with the Associated Documents.<br/> 2. '''Open '''the ICM Outlook Add-in.<br/> &nbsp;
 
  
3. On the ''Details'' tab,'''click''' ''Select ICM Agreement / Association'' to add the next version of the Association.<br/> 4. '''Select '''the document that you need to attach from the list. For example, Payment Details.&nbsp;
 
  
5. '''Click''' the ''View Record'' icon to view the attachment details.&nbsp;<br/> 6. '''Click '''''Preview'' icon to view the attachment.&nbsp;
 
  
== Creating a new instance of an Association ==
+
== Adding an email as an associated document to an existing association ==
  
<br/> To add Attachments to Associations:<br/> 1. On the ''Details'' tab,'''click''' ''Select ICM Agreement / Association ''to add an Association. For example, adding an Association to the Payment Details association.<br/> 2. Enter a name for the new instance of the Association.<br/> 3. '''Click''' the ''Add Association'' button.<br/> 4. '''Click '''the ''Select Email Attachment'' field to select the document that you want to attach to the newly created instance.<br/> 5.'''Click''' ''Upload''. The document is now attached to the newly created instance. The ''File(s) uploaded successfully'' message is displayed.
+
To upload an email conversation by creating a new instance of association in .docx and .msg formats:
<div class="note-box">Note: The Association is only created with the name. The remaining mandatory fields need to be entered in the ICM application.&nbsp;</div>  
+
 
6. The document is now available on the ''Associations'' tab in the ICM application as the next version.
+
1. On the Agreement Details page of the Outlook add-in, '''click '''on the association instance, for example Supplier Communication.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 01.png|720px|7.14 Outlook email as association 01.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2. '''Click '''''Add Association''. A text field is displayed.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.14 Outlook email as association 02.png|720px|7.14 Outlook email as association 02.png]]</div>  
 +
3. '''Enter '''a name for the new associated document, for example PriceList for August 2020.&nbsp;
 +
 
 +
4. '''Click '''the plus icon next to the text field. The association instance gets created and it appears as an option in the ''Select ICM Agreement/Association'' drop-down.
 +
 
 +
5. In the ''Select ICM Agreement/Association'' drop-down '''select '''the association created in Step 4.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 03.png|720px|7.14 Outlook email as association 03.png]]</div>  
 +
6. '''Click '''the ''Select Email Attachment'' drop down. The following options are displayed:
 +
 
 +
*''Email as Outlook format (.msg)'': Use this option to upload the email thread to the association as is.
 +
*''Email as document (.docx)'': Use this option to upload the email thread to the association as a Word document.  
 +
 
 +
7. '''Select''', for example, Email as document. The selected file name is displayed in the ''Mapping Result(s)'' section.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 04.png|720px|7.14 Outlook email as association 04.png]]</div>  
 +
8. '''Click '''''Upload''. The selected email gets uploaded and the ''File(s) uploaded successfully'' message is displayed.<br/> The uploaded email appears in .docx format on ICM Web and is displayed as an Association instance against the PriceList association.&nbsp;
 +
 
 +
9. On the agreement ''Details'' page, '''click''' the ''Association'' tab. In this example ''Supplier Communication'' is the association for the agreement. The associated document ''PriceList for August 2020'' uploaded using the Outlook add-in is displayed in the list of instances.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 05.png|720px|7.14 Outlook email as association 05.png]]</div>
 +
10. '''Click '''the ''View ''icon for the created associated document instance ''PriceList for August 2020''. The associated document ''Details ''page opens.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 06.png|720px|7.14 Outlook email as association 06.png]]</div>
 +
11. '''Click '''the ''Versions ''tab. The uploaded email thread is displayed and is available to download in PDF and in Word formats.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 07.png|720px|7.14 Outlook email as association 07.png]]</div>
 +
12. '''Click '''an icon below the ''Document ''column, for example Word icon. A .docx file will be downloaded.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 08.png|720px|7.14 Outlook email as association 08.png]]</div>
 +
'''Note''': If you have selected the option to upload ''Email as Outlook format'', the email thread is indicated with an Outlook Message icon in Step 11, clicking which downloads the email thread in .msg format in Step 12.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 09.png|720px|7.14 Outlook email as association 09.png]]</div>  
 +
13. Open the downloaded file. The uploaded email thread content will be displayed in the file contents. In this example, the .docx file displays the email uploaded as an association.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 10.png|720px|7.14 Outlook email as association 10.png]]</div>
 +
&nbsp;
 +
 
 +
 
 +
== Adding an email as a new version of an associated document using Outlook Add-in ==
 +
 
 +
1. '''Click '''''Select ICM Agreement / Association'' on the ''Details ''tab on the Outlook add-in. A drop down is displayed.
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 11.png|720px]]</div>
 +
2. '''Select''' the Association instance for which you want to add the current email as an association attachment (for example, ''PriceList for August 2020'').
 +
 
 +
3. '''Click '''''Upload''. The File(s) uploaded successfully message will be displayed.
 +
 
 +
The uploaded email (in .docx or in .msg format) gets uploaded on ICM Web as a version of the Association selected in Step 2, and is displayed as an Association instance against the ''PriceList'' association.&nbsp;
 +
<div class="image-green-border">[[File:7.14 Outlook email as association 12.png|720px]]</div>
 +
&nbsp;
 +
 
 +
&nbsp;
  
 
&nbsp;
 
&nbsp;
Line 42: Line 110:
 
&nbsp;
 
&nbsp;
  
'''Related Topics:'''&nbsp;ICM Word Add-in&nbsp;| ICM Excel Add-in |&nbsp;[http://int-wiki.cloudapp.net:90/ICMHelp7.9/index.php?title=Template_Management Template Management]&nbsp;|
+
'''Related Topics:'''&nbsp;'''Related Topics:''' [[Agreement_Management|Agreement Management]] | [[Association_Management|Association Management]] | [[Compliance_Management|Compliance Management]] | [[Template_Management|Template Management]] |&nbsp;[[Clause_Management|Clause Management]] | [[Configuration|Configuration]]&nbsp;|&nbsp;[[Reports|Reports]] |&nbsp;[[Power_BI_Integration_with_ICM|Advanced Analytics]]&nbsp;|&nbsp;[[User_Administration|User Administration]]&nbsp;| [[ICI_Add-ins|ICI Add-ins]]&nbsp;| &nbsp;[http://int-wiki.cloudapp.net:8085/ICMHelp7.12/index.php?title=Icertis_Experience_for_Word Icertis Experience for Word] |&nbsp;[[Release_Notes|Release Notes]]&nbsp;|

Latest revision as of 18:05, 30 September 2020

 

Outlook Add-in

A .JS version of the ICI Outlook Plugin is available in ICI. The overall turnaround time for the author is reduced as he no longer needs to download the documents received over email to the local machine, then switch applications and log in to ICI, search the Agreement and then upload the documents.
The provisioned user can now:

  • Upload the next version of the Agreement document received over an Email to the Agreement
  • Upload the next version of the Associated document (supporting Attachments) received over an Email to the Agreement
  • Create a new Association instance and then upload the Associated Document received over an Email to the Agreement

The configuration of the Outlook Add-in is driven by the Masterdata, whereas the list of Agreements and their details are configured by the Saved Searches. You can configure multiple saved searches.

The Outlook Add-in (.JS version) is supported on 2 different platforms:

  • For MAC OS (Mojave): it is tested and verified on Microsoft Office 365 (2016 and above).
  • For Windows 10: it is tested and verified on Microsoft Office Professional Plus 2013 (15.0.5007.1000) and 2016 (16.0.4849.1000) 64-bit and above.

 

Uploading the next version of an Agreement received over MS Outlook Email

To add the the next version of the Agreement received over Outlook Email:
1. Open the Email with the next version of the Agreement.
2. Open the ICI Outlook Add-in.
3. On the Details tab, click Select ICI Agreement / Association to look for the Agreement that you want to upload as the next version.

Email Outlook Plugin 1

4. Click Select Email Attachment that you want to upload from the drop-down.
5. Click Upload. The File(s) uploaded successfully message is displayed. If the Agreement fails to be attached, then a message will be displayed indicating that you can retry sending the Attachment.

Email Outlook Plugin 2

You can Preview the Agreement in the ICI application on the Agreement Details page.

Email Outlook Plugin 03.png

 

Adding the next version of the Associated Document received over MS Outlook Email to the Agreement


To add the next version of the Associated Document received over Outlook Email to the Agreement :
1. Open the Email with the Associated Documents.
2. Open the ICI Outlook Add-in.

3. On the Details tab,click Select ICI Agreement / Association to add the next version of the Association. For example, Payment Details.

Email Outlook Plugin 4
 
4. Click Select Email Attachment that you want to upload from the drop-down.
5. Click Upload. The File(s) uploaded successfully message is displayed.
 
Email Outlook Plugin 5

6. Click the View Record icon to view the Attachment details. 

Email Outlook Plugin 6

7. Click the Preview icon to view the Attachment. 

Email Outlook Plugin 7

 

 

Creating a new instance of an Association and adding an Associated Document received over MS Outlook Email

To create a new instance of an Association and add the Associated Document received over Outlook Email to the Agreement:
1. On the Details tab,click Select ICI Agreement / Association to create a new instance of the Association. For example, adding an Association to thePayment Details Association.
2. Enter a name for the new instance of the Association.
3. Click the Add Association button to add the new instance of the Association.

Email Outlook Plugin 8

4. Click the Select Email Attachment field to select the document that you want to attach to the newly created instance.
 
Email Outlook Plugin 9

5.Click Upload. The document is now attached to the newly created instance. The File(s) uploaded successfully message is displayed.
 
Note: The Association is only created with the name. The remaining mandatory fields need to be entered in the ICI application. 
 
 
Email Outlook Plugin 10

6. The document is now available on the Associations tab in the ICI application as the next version.

 

 



Adding an email as an associated document to an existing association

To upload an email conversation by creating a new instance of association in .docx and .msg formats:

1. On the Agreement Details page of the Outlook add-in, click on the association instance, for example Supplier Communication.

7.14 Outlook email as association 01.png
 
2. Click Add Association. A text field is displayed.
 
7.14 Outlook email as association 02.png

3. Enter a name for the new associated document, for example PriceList for August 2020. 

4. Click the plus icon next to the text field. The association instance gets created and it appears as an option in the Select ICM Agreement/Association drop-down.

5. In the Select ICM Agreement/Association drop-down select the association created in Step 4.

7.14 Outlook email as association 03.png

6. Click the Select Email Attachment drop down. The following options are displayed:

  • Email as Outlook format (.msg): Use this option to upload the email thread to the association as is.
  • Email as document (.docx): Use this option to upload the email thread to the association as a Word document.

7. Select, for example, Email as document. The selected file name is displayed in the Mapping Result(s) section.

7.14 Outlook email as association 04.png

8. Click Upload. The selected email gets uploaded and the File(s) uploaded successfully message is displayed.
The uploaded email appears in .docx format on ICM Web and is displayed as an Association instance against the PriceList association. 

9. On the agreement Details page, click the Association tab. In this example Supplier Communication is the association for the agreement. The associated document PriceList for August 2020 uploaded using the Outlook add-in is displayed in the list of instances.

7.14 Outlook email as association 05.png

10. Click the View icon for the created associated document instance PriceList for August 2020. The associated document Details page opens.

7.14 Outlook email as association 06.png

11. Click the Versions tab. The uploaded email thread is displayed and is available to download in PDF and in Word formats.

7.14 Outlook email as association 07.png

12. Click an icon below the Document column, for example Word icon. A .docx file will be downloaded.

7.14 Outlook email as association 08.png

Note: If you have selected the option to upload Email as Outlook format, the email thread is indicated with an Outlook Message icon in Step 11, clicking which downloads the email thread in .msg format in Step 12.

7.14 Outlook email as association 09.png

13. Open the downloaded file. The uploaded email thread content will be displayed in the file contents. In this example, the .docx file displays the email uploaded as an association.

7.14 Outlook email as association 10.png

 


Adding an email as a new version of an associated document using Outlook Add-in

1. Click Select ICM Agreement / Association on the Details tab on the Outlook add-in. A drop down is displayed.

7.14 Outlook email as association 11.png

2. Select the Association instance for which you want to add the current email as an association attachment (for example, PriceList for August 2020).

3. Click Upload. The File(s) uploaded successfully message will be displayed.

The uploaded email (in .docx or in .msg format) gets uploaded on ICM Web as a version of the Association selected in Step 2, and is displayed as an Association instance against the PriceList association. 

7.14 Outlook email as association 12.png

 

 

 

 

Related Topics: Related Topics: Agreement Management | Association Management | Compliance Management | Template ManagementClause Management | Configuration | ReportsAdvanced Analytics | User Administration | ICI Add-ins |  Icertis Experience for WordRelease Notes |