From ICIHelp8.2
Jump to: navigation, search
(Created page with " = Collaboration in Contracts = Previously, stakeholders involved in the contracting/sourcing process used to communicate via external tools such as Email, Skype, etc. Managi...")
 
 
(94 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
= Collaboration in Contracts =
 
= Collaboration in Contracts =
  
Previously, stakeholders involved in the contracting/sourcing process used to communicate via external tools such as Email, Skype, etc. Managing these conversations that involved multiple stakeholders and multiple discussions was a cumbersome task. With this release, ICM has eliminated the need to use external tools and created a dedicated space available within the Agreement itself.&nbsp;<br/> To collaborate, multiple stakeholders involved in the contracting/sourcing process can:<br/> •&nbsp;&nbsp; &nbsp;Use the Collaboration tab available inside the Agreement<br/> •&nbsp;&nbsp; &nbsp;Provision an internal/external Team member to communicate with other internal or external team member(s) by creating Topics and posting messages in it<br/> •&nbsp;&nbsp; &nbsp;Provision users to send and receive attachments along with the message<br/> •&nbsp;&nbsp; &nbsp;Provision users to mark the Topic as closed once the discussion is concluded<br/> •&nbsp;&nbsp; &nbsp;Send Email notification to participants when messages are posted in the topic<br/> This can be achieved by setting the Enable Collaboration flag to Yes on the Agreement Contract Type, which displays a Collaboration tab on the Agreement Details page. To prevent data loss, once Collaboration is enabled for a Contract Type, it cannot be disabled.<br/> &nbsp;
+
Previously, stakeholders involved in the contracting/sourcing process used to communicate via external tools such as Email, Skype, etc. Managing these conversations that involved multiple stakeholders and multiple discussions was a cumbersome task. With this release, ICM has eliminated the need to use external tools and created a dedicated space available within the Agreement itself.&nbsp;<br/> To collaborate, multiple stakeholders involved in the contracting/sourcing process can:
  
 +
*Use the Collaboration tab available inside the Agreement Details
 +
*Provision an internal/external Team member to communicate with other internal or external team member(s) by creating Topics and posting messages in it
 +
*Provision users to send and receive attachments along with the message
 +
*Provision users can send messages to all members at the same time or to specific team members
 +
*Provision users to mark the Topic as closed once the discussion is concluded
 +
*Send Email notification to participants when messages are posted on the topic
 +
 +
This can be achieved by setting the "Enable Collaboration" flag to "Yes" on the Agreement Contract Type, which displays a Collaboration tab on the Agreement Details page in the collapsible left navigation pane.
 +
<div class="note-box">'''Note:''' To prevent data loss, once Collaboration is enabled for a Contract Type, it cannot be disabled.</div>
 
== Configuring Collaboration for Contract Types ==
 
== Configuring Collaboration for Contract Types ==
  
To enable Collaboration for Contract Types:<br/> 1.&nbsp;&nbsp; &nbsp;Click the Configuration tile on the Dashboard. The Configuration page opens.<br/> &nbsp;<br/> 2.&nbsp;&nbsp; &nbsp;Click the Create Contract Type tile. The Create Contract Type page opens.<br/> &nbsp;<br/> 3.&nbsp;&nbsp; &nbsp;Select the Agreement Contract Type you want to create.&nbsp;<br/> &nbsp;<br/> 4.&nbsp;&nbsp; &nbsp;Click Next. The Create Contract Type page opens.<br/> 5.&nbsp;&nbsp; &nbsp;Enter a name in the Contract Type Name field. For example, Collaboration Contract Type.<br/> 6.&nbsp;&nbsp; &nbsp;Enter all the details on the Details tab.&nbsp;<br/> 7.&nbsp;&nbsp; &nbsp;Toggle the Enable Collaboration flag to Yes to enable Collaboration at Agreement level.<br/> Note: The Enable Collaboration flag is only available for Agreement Contract Type.
+
To enable Collaboration&nbsp;for Contract Types:
 +
 
 +
You have to set the "Enable Collaboration" flag to "Yes" while
 +
 
 +
*Creating a Contract Type OR
 +
*Updating&nbsp;an already existing Contract Type.  
 +
 
 +
=== Configuring&nbsp;on Creating Agreement Contract Type&nbsp; ===
 +
 
 +
1.&nbsp;'''Click '''the "Configure"&nbsp;tile or menu on the navigation bar at the top.<br/> 2.&nbsp;'''Click '''the&nbsp;"Contract Type" sub-menu. The "Contract Types" index page opens listing all the Contract Types in grid view.
 +
<div class="image-green-border">[[File:8.0-Collaboration-Contract-Type-Index.png|920px|8.0-Collaboration-Contract-Type-Index.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3. '''Click '''"Create" on top right&nbsp;in the&nbsp;title bar. The "Create Contract Type" page opens with four options.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:8.0-Collaboration-Contract-Type0.png|720px|8.0-Collaboration-Contract-Type0.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4.&nbsp;'''Select '''the "Agreement" Contract Type.&nbsp;The "Create Contract Type" for Agreement page opens.</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note:''' The "Enable Collaboration" flag is only available for Agreement Contract Type.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">5.&nbsp;'''Enter '''a name in the "Contract Type Name" field. For example, Collaboration Contract Type.<br/> 6.&nbsp;'''Enter '''all the details on the "Details" tab.&nbsp;<br/> 7.&nbsp;'''Toggle '''the "Enable Collaboration" flag to "Yes" to enable Collaboration at the Agreement level.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:8.0-Collaboration-Contract-Type.png|620px|8.0-Collaboration-Contract-Type.png]]</div>
 +
8.&nbsp;'''Click "'''Next". The "Attributes" tab opens.<br/> 9.&nbsp;'''Enter '''the details in the remaining Attributes, Association, Display Preference, Team, and Verify tabs to send the Collaboration Contract Type to Approved state.
 +
 
 +
=== Configuring&nbsp;on Editing Agreement Contract Type ===
 +
 
 +
Alternatively, you can edit an already Existing Contract Type to enable the Collaboration tab:
 +
 
 +
1. Navigate to "Contract Types" index page from "Configure" > "Contract Types".
 +
 
 +
2. On the "Contract Types" index page, '''click '''the eye icon [[File:Eye-icon.PNG|20px|Eye-icon.PNG]]on the last column. The "Contract Types" details page opens.
 +
<div class="image-green-border">[[File:8.0-Collboration-Contract Type-Edit.png|820px|8.0-Collboration-Contract Type-Edit.png]]</div>
 +
2.&nbsp;'''Click '''"Edit" on the top in the far-right of the title bar.
 +
 
 +
3.&nbsp;'''Set '''the "Enable Collaboration" flag to "Yes".
 +
<div class="image-green-border">[[File:8.0-Collboration-Contract Type-Edit-flag.png|620px|8.0-Collboration-Contract Type-Edit-flag.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Once set to "Yes" you can not disable the flag again.</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note:''' To prevent data loss, once the "Enable Collaboration" flag&nbsp;is toggled to "Yes", it cannot be turned back to "No". </div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:8.0-Collaboration-Enable-Contract Type-Edit-flag1.png|320px|8.0-Collaboration-Enable-Contract Type-Edit-flag1.png]]</div> <div class="image-green-border">&nbsp;</div>
 +
=== Viewing Contract Types with Collaboration Enabled ===
 +
 
 +
You can view all the Contract Types having the "Enable Collaboration" flag set to true by using "Refine View" as shown in the screenshot below:
 +
<div class="image-green-border">[[File:8.0-Collaboration-Contract-Type-Enable-flag.png|920px|8.0-Collaboration-Contract-Type-Enable-flag.png]]</div>
 +
&nbsp;
 +
 
 +
== Creating a New Topic and Sending Messages &nbsp; ==
 +
 
 +
=== Creating a Topic by Internal User and Sending Messages to another Internal User ===
 +
 
 +
1. '''Create '''an Agreement from the "Agreements" navigation menu on the top with the "Contract Type Name" selected among the Contract Types whose "Enable Collaboration" flag is true (Refer to the screenshot in the section "Viewing Contract Types with Collaboration Enabled" on this page for such Contract Types). The user is redirected to the newly created Agreement's Details page.
 +
 
 +
See the "Creating an Agreement" section&nbsp;under [[Agreements|Agreements]]&nbsp;for more details on creating Agreements.
 +
 
 +
2'''. Click '''the "Collaboration" tab on the collapsible left navigation pane of the Agreement’s Details page. The Collaboration page opens in the right pane indicating that there is no topic for you to collaborate and a “Start A New Topic” button.
 +
<div class="image-green-border">[[File:8.0-Collaboration-New-Topic.png|920px|8.0-Collaboration-New-Topic.png]]<br/> &nbsp;<br/> 3.&nbsp;'''Click '''the "Start A New Topic"&nbsp;button if no topics exist or click the "New Topic" plus icon on the top-left&nbsp;if topics already exist. The "Create a New Topic" drawer opens.<br/> You can now select participants who will collaborate and be able to send and receive messages for a topic related to the agreement. For example, let’s collaborate with an Internal user, CLM Admin.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:8.0-Collaboration-New-Topic-drawer1.png|920px|8.0-Collaboration-New-Topic-drawer1.png]]<br/> &nbsp;<br/> 4. By default "Select Team Members" option is selected for&nbsp;the "Participants" field to collaborate. If you want to collaborate with&nbsp;all team members at the same time, you can select the broadcast option of "All Team Members".</div> <div class="image-green-border">To select team members&nbsp;for the Topic, '''click''' the "Select Participants"&nbsp;icon[[File:Select-user-icon.PNG|20px|Select-user-icon.PNG]].&nbsp;The Select Participant(s) drawer opens. For example, let’s collaborate with an Internal user CLM Admin.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Inter-to-Internal.png|920px|Inter-to-Internal.png]]</div> <div class="image-green-border"><br/> 5.&nbsp;You can '''choose '''to keep the topic confidential from other users by toggling the "Do you want to mark this topic as Confidential" flag to Yes. In that case, Internal users that are part of the Topic conversation will not be able to view and reply to the Topic.<br/> 6.&nbsp;'''Enter '''the "Subject" and "Message" for the Topic.&nbsp;</div> <div class="image-green-border">7. '''Select '''files if required.</div> <div class="image-green-border">8. '''Click '''"Create". The Topic is created.</div> <div class="image-green-border"><div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Note:''' A notification email will be sent to the participants in the "To" section of the topic. In this example, it will go to the Participant - CLM Admin.&nbsp;</div> </div> <div class="image-green-border">Based on confidentiality, participants or other team members can view the created topic, in the Topics pane on the left of the "Collaboration" page.</div> <div class="image-green-border"><br/> The Topic is listed&nbsp;with the following details:</div>
 +
*Count of participants
 +
*Who initiated the conversation,
 +
*Who took the last action on the&nbsp;Topic,
 +
*Date
 +
 
 +
On the right pane, you can view the details of the topic's&nbsp;message and the replies. If the Topic is broadcasted to all team members a broadcast icon is displayed and the "Reply All" button appears beside "Reply".&nbsp; You can&nbsp;close a Topic&nbsp;if no further communication is required using the “Close Topic” button.
 +
<div class="image-green-border">[[File:8.0-Collaboration-Topic.png|920px|8.0-Collaboration-Topic.png]]&nbsp;<br/>  </div>
 +
=== Creating a Topic by the Internal User and Sending Message to the External User ===
 +
 
 +
Let’s create a Topic and add Lee Yen Po as an External user.<br/> 1.&nbsp;'''Click&nbsp;'''on more action 3 dots on the right-top of the Agreement Details page.<br/> 2.&nbsp;'''Click '''"Collaborate". The "Select User" drawer opens. Let’s select the external user Lee Yen Po.<br/> 3. '''Click '''"Add". The Agreement collaborated successfully message is displayed, and the External user is added to the Team.<br/> 4.&nbsp;'''Click '''the "Collaboration" tab on the left collapsible navigation pane on the&nbsp;Agreement’s Details page.<br/> 5.&nbsp;'''Click '''"New Topic" on the top-right corner. The "Create a New Topic" drawer opens.<br/> 6. '''Follow '''the&nbsp;same steps as for adding an internal user.<br/> 7.&nbsp;'''Click '''"Create". The Topic is created. The participants can view this topic in the Topics window of the Collaboration page and the body of the message at the right.<br/> &nbsp;
 +
<div class="note-box">'''Note:''' A notification email will be sent to the External Participant – Lee Yen Po of this Topic.&nbsp;</div>
 +
== Replying Messages with Reply and Reply All ==
 +
 
 +
Now let’s see how the provisioned external user Lee Yen Po can respond to the message.
 +
 
 +
1.&nbsp;'''Click "'''Reply" to respond to the selected message for one or more participants and "Reply All"&nbsp;to broadcast the message to all participants.&nbsp;
 +
 
 +
Based on confidentiality, a message posted by an external user will be visible to participants or other team members, but not external users.
 +
<div class="image-green-border">[[File:8.0-Broadcast-Reply-drawer.PNG|920px|8.0-Broadcast-Reply-drawer.PNG]]</div> <div class="image-green-border"><br/> 2. '''Click '''"Send". A notification email will be sent to all the recipients of this Topic. The authorized ICM user can see the external user response in the Topics window of the Collaboration tab.</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note:''' Internal and external users are identified in a Topic with two different colors. &nbsp;</div>
 +
If the topic message is sent to an external team member or members, a dropdown "All User View" for selecting the user view appears beside the topic name on the top-left. Collaboration details with the specific external users can be displayed by selecting the external user from the dropdown.
  
&nbsp; &nbsp;<br/> &nbsp;<br/> 8.&nbsp;&nbsp; &nbsp;Click Next. The Attributes tab opens.<br/> 9.&nbsp;&nbsp; &nbsp;Enter the details in the remaining Attributes, Association, Display Preference, Team, and Verify tabs to send the Collaboration Contract Type to Approved state. Alternatively, you can edit an already existing Contract Type to enable the Collaboration tab.<br/> Note: To prevent data loss, once the Enable Collaboration field is toggled to Yes, it cannot be turned back to No. <br/> Creating a new Topic and sending Messages by Internal user<br/> Section 1.1&nbsp;&nbsp; &nbsp;Sending Messages<br/> (a)&nbsp;&nbsp; &nbsp;Creating a Topic by Internal user and Sending Messages to another Internal user<br/> 1.&nbsp;&nbsp; &nbsp;Click the Agreement Management tile on the Dashboard. The Agreement Management page opens.&nbsp;<br/> &nbsp;<br/> 2.&nbsp;&nbsp; &nbsp;Click the Create Agreement tab. The Create Agreement page opens.<br/> &nbsp;&nbsp;<br/> 3.&nbsp;&nbsp; &nbsp;Enter all the details in the Create Agreement page.<br/> 4.&nbsp;&nbsp; &nbsp;Click the Collaboration tab on the Agreement’s Details page. The Collaboration page opens in the right pane indicating that there is no topic for you to collaborate.&nbsp;<br/> &nbsp;<br/> 5.&nbsp;&nbsp; &nbsp;Click the New Topic icon. The Create a New Topic window opens.<br/> •&nbsp;&nbsp; &nbsp;You can now select participants who will collaborate and able to send and receive messages for a topic related to the agreement. For example, let’s collaborate with an Internal user, CLM Admin.<br/> &nbsp;<br/> 6. &nbsp; &nbsp;To select Participants for the Topic, click the Add Team Members icon or you can select all Team members. The Select Participant(s) window opens. For example, let’s collaborate with an Internal user, CLM Admin.<br/> &nbsp;<br/> 7. &nbsp; Click Add. The Create a New Topic window opens displaying the Participant.<br/> 8.&nbsp;&nbsp; &nbsp;You can choose to keep the topic confidential from other users by toggling the Do you want to mark this topic as Confidential flag to Yes. In that case, Internal users that are part of the Topic conversation will not be able to view and reply the Topic.<br/> 9.&nbsp;&nbsp; &nbsp;Enter the Subject for the Topic.&nbsp;<br/> 10.&nbsp;&nbsp; &nbsp;Enter the message in the Message field.&nbsp;<br/> &nbsp;<br/> 11.&nbsp;&nbsp; &nbsp;Click Create. The Topic is created. Based on the confidentiality, participants or other team members can view the created topic, in the Topics window of the Collaboration page.<br/> Note: A notification email will be sent to the participants in the To section of the topic. In this example, it will go to the Participant - CLM Admin.&nbsp;<br/> &nbsp;<br/>  <br/> (b)&nbsp;&nbsp; &nbsp;Sending Message to External user<br/> Let’s create a Topic and add Lee Yen Po as an External user.<br/> 1. &nbsp; &nbsp;Click Show more option at the bottom right corner of the Agreement Details page.<br/> 2. &nbsp; &nbsp;Click Collaborate. The Select User window opens. Let’s select the external user Lee Yen Po.<br/> &nbsp;<br/> 3. &nbsp; Click Add. The Agreement collaborated successfully message is displayed, and the External user is added to the Team.<br/> &nbsp;<br/> &nbsp;<br/> 4.&nbsp;&nbsp; &nbsp;Click the Collaboration tab on the Agreement’s Details page.&nbsp;<br/> 5.&nbsp;&nbsp; &nbsp;Click the New Topic icon. The Create a New Topic window opens.<br/> 6.&nbsp;&nbsp; &nbsp;To select Participants for the Topic, click the Add Team Members icon or you can select all Team members. For example, let’s collaborate with an External user, Lee Yen Po.<br/> &nbsp;<br/> 7. &nbsp; &nbsp;Click Add. The Create a New Topic window opens displaying the Participant.&nbsp;<br/> 8. &nbsp; &nbsp;You can choose to keep the topic confidential from other users by toggling the Do you want to mark &nbsp; this topic as Confidential flag to Yes.<br/> 9.&nbsp;&nbsp; &nbsp;Enter the Subject for the Topic.&nbsp;<br/> 10.&nbsp;&nbsp; &nbsp;Enter the message in the Message field.&nbsp;<br/> &nbsp;<br/> 11.&nbsp;&nbsp; &nbsp;Click Create. The Topic is created. The participants can view this topic in the Topics window of the Collaboration page and the body of the message at the right.<br/> Note: A notification email will be sent to the External Participant – Lee Yen Po of this Topic.&nbsp;<br/> &nbsp;<br/> Details such as who initiated the conversation, who took the last action on a Topic, along with the Date, are displayed in the window.<br/>  <br/> Section 1.2&nbsp;&nbsp; &nbsp;Replying Messages<br/> (a)&nbsp;&nbsp; &nbsp;Replying Message from External to Internal user<br/> Now let’s see how the provisioned external user Lee Yen Po can respond to the message.<br/> 1.&nbsp;&nbsp; &nbsp;Click the Collaboration tab of the Agreement Details page.&nbsp;<br/> &nbsp;<br/> 2.&nbsp;&nbsp; &nbsp;Click Reply to respond to the selected message.&nbsp;<br/> Based on the confidentiality, a message posted by an external user will be visible to participants or other team members, but not external users.<br/> 3. &nbsp; &nbsp;Click Send. A notification email will be sent to all the recipients of this Topic. The authorized ICM user can see the external user response in the Topics window of the Collaboration tab.
+
== Searching Messages in Topics ==
  
&nbsp;<br/> &nbsp;<br/> Note: Internal and external users are identified in a Topic with two different colors. &nbsp;
+
A user can search messages across topics using the Search tab available in the Collaboration window. &nbsp;<br/> To search messages in a topic:<br/> '''Enter '''the keyword in the Search for Messages field. For example, let’s search the word - Can. All the topics where the message contains the searched criteria are rendered in the search result along the search word is highlighted.
  
<br/> Let’s see how the Internal user view the External user’s response.<br/> &nbsp;<br/> Note: Broadcast icon only be available when the internal users reply to all the participants.<br/> &nbsp;<br/> Note: Reply/Reply All to reply to a single participant or broadcast the message to all participants respectively.&nbsp;<br/>  <br/> Creating a new Topic and sending Messages by External user<br/> Section 1.3&nbsp;&nbsp; &nbsp;Sending Messages by External user<br/> (a)&nbsp;&nbsp; &nbsp;Creating a Topic by External user and Sending Messages to Internal user<br/> 1.&nbsp;&nbsp; &nbsp;Click the Agreement Management tile on the Dashboard. The Agreement Management page opens.&nbsp;<br/> &nbsp;<br/> 2.&nbsp;&nbsp; &nbsp;Select the Agreement where you want to Collaborate. For example, SaaS Agreement.<br/> &nbsp;<br/> 3.&nbsp;&nbsp; &nbsp;Click the Collaboration tab on the Agreement’s Details page. The Collaboration page opens in the right pane.&nbsp;<br/> &nbsp;<br/> 4.&nbsp;&nbsp; &nbsp;Click the New Topic icon. The Create a New Topic window opens.<br/> &nbsp;<br/>  <br/> 5.&nbsp;&nbsp; &nbsp;Enter the Subject for the Topic.&nbsp;<br/> 6.&nbsp;&nbsp; &nbsp;Enter the message in the Message field.&nbsp;<br/> 7.&nbsp;&nbsp; &nbsp;Click Create. The Topic is created. The participants can view this topic in the Topics window of the Collaboration page and the body of the message at the right.<br/> A notification email will be sent to the Internal user of this Agreement as shown below.&nbsp;<br/> &nbsp;<br/>  <br/> Section 1.4&nbsp;&nbsp; &nbsp;Searching Messages<br/> A user can search messages across topics using the Search tab available in the Collaboration window. &nbsp;<br/> To search messages in a topic:<br/> 1.&nbsp;&nbsp; &nbsp;Enter the keyword in the Search for Messages field. For example, let’s search the word - Can. All the topics where the message contains the searched criteria are rendered in the search result along with the search word is highlighted.<br/> &nbsp;
+
== Closing the Topics ==
  
<br/>  <br/> Section 1.5&nbsp;&nbsp; &nbsp;Closing the Topics<br/> An Internal user can close the topic when the discussion/conversation is concluded. Once closed, the user cannot reply to a conversation or reopen the topic.&nbsp;<br/> To close a topic:<br/> 1.&nbsp;&nbsp; &nbsp;Click Close Topic to end any Topic conversation. A message is displayed indicating that once you closed the topic, you can no longer post any new messages in this topic.<br/> &nbsp;<br/> 2.&nbsp;&nbsp; &nbsp;Click Yes. The Topic is now closed.<br/> &nbsp;<br/> The message is displayed in the message window indicating the name of the user who closed the topic along with the date and time.
+
An Internal user can close the topic when the discussion/conversation is concluded. Once closed, the user cannot reply to a conversation or reopen the topic.&nbsp;<br/> To close a topic:<br/> 1.&nbsp;'''Click '''"Close Topic" on the far-right to end any Topic conversation. A message is displayed indicating that once you closed the topic, you can no longer post any new messages on this topic.<br/> 2.&nbsp;'''Click '''"Yes". The Topic is now closed.<br/> &nbsp;<br/> The message is displayed in the message window indicating the name of the user who closed the topic along with the date and time.
 +
<div class="image-green-border">[[File:8.0-Collaboration-Topic-closed.png|920px|8.0-Collaboration-Topic-closed.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Related Topics:&nbsp;'''[[Agreement_Management|Agreement Management]]&nbsp;| [[Contract_Type|Contract Type]] |&nbsp;[[Application_Settings|Application_Settings]]&nbsp;|&nbsp;[[Notification_Settings|Notification Settings]]&nbsp;| [[Notifications_Dashboard|Notifications Dashboard]]</div>

Latest revision as of 06:50, 3 January 2022

Collaboration in Contracts

Previously, stakeholders involved in the contracting/sourcing process used to communicate via external tools such as Email, Skype, etc. Managing these conversations that involved multiple stakeholders and multiple discussions was a cumbersome task. With this release, ICM has eliminated the need to use external tools and created a dedicated space available within the Agreement itself. 
To collaborate, multiple stakeholders involved in the contracting/sourcing process can:

  • Use the Collaboration tab available inside the Agreement Details
  • Provision an internal/external Team member to communicate with other internal or external team member(s) by creating Topics and posting messages in it
  • Provision users to send and receive attachments along with the message
  • Provision users can send messages to all members at the same time or to specific team members
  • Provision users to mark the Topic as closed once the discussion is concluded
  • Send Email notification to participants when messages are posted on the topic

This can be achieved by setting the "Enable Collaboration" flag to "Yes" on the Agreement Contract Type, which displays a Collaboration tab on the Agreement Details page in the collapsible left navigation pane.

Note: To prevent data loss, once Collaboration is enabled for a Contract Type, it cannot be disabled.

Configuring Collaboration for Contract Types

To enable Collaboration for Contract Types:

You have to set the "Enable Collaboration" flag to "Yes" while

  • Creating a Contract Type OR
  • Updating an already existing Contract Type.

Configuring on Creating Agreement Contract Type 

1. Click the "Configure" tile or menu on the navigation bar at the top.
2. Click the "Contract Type" sub-menu. The "Contract Types" index page opens listing all the Contract Types in grid view.

8.0-Collaboration-Contract-Type-Index.png
 
3. Click "Create" on top right in the title bar. The "Create Contract Type" page opens with four options.
 
8.0-Collaboration-Contract-Type0.png
 
4. Select the "Agreement" Contract Type. The "Create Contract Type" for Agreement page opens.
 
Note: The "Enable Collaboration" flag is only available for Agreement Contract Type.
 
5. Enter a name in the "Contract Type Name" field. For example, Collaboration Contract Type.
6. Enter all the details on the "Details" tab. 
7. Toggle the "Enable Collaboration" flag to "Yes" to enable Collaboration at the Agreement level.
 
8.0-Collaboration-Contract-Type.png

8. Click "Next". The "Attributes" tab opens.
9. Enter the details in the remaining Attributes, Association, Display Preference, Team, and Verify tabs to send the Collaboration Contract Type to Approved state.

Configuring on Editing Agreement Contract Type

Alternatively, you can edit an already Existing Contract Type to enable the Collaboration tab:

1. Navigate to "Contract Types" index page from "Configure" > "Contract Types".

2. On the "Contract Types" index page, click the eye icon Eye-icon.PNGon the last column. The "Contract Types" details page opens.

8.0-Collboration-Contract Type-Edit.png

2. Click "Edit" on the top in the far-right of the title bar.

3. Set the "Enable Collaboration" flag to "Yes".

8.0-Collboration-Contract Type-Edit-flag.png
 
Once set to "Yes" you can not disable the flag again.
 
Note: To prevent data loss, once the "Enable Collaboration" flag is toggled to "Yes", it cannot be turned back to "No". 
 
8.0-Collaboration-Enable-Contract Type-Edit-flag1.png
 

Viewing Contract Types with Collaboration Enabled

You can view all the Contract Types having the "Enable Collaboration" flag set to true by using "Refine View" as shown in the screenshot below:

8.0-Collaboration-Contract-Type-Enable-flag.png

 

Creating a New Topic and Sending Messages  

Creating a Topic by Internal User and Sending Messages to another Internal User

1. Create an Agreement from the "Agreements" navigation menu on the top with the "Contract Type Name" selected among the Contract Types whose "Enable Collaboration" flag is true (Refer to the screenshot in the section "Viewing Contract Types with Collaboration Enabled" on this page for such Contract Types). The user is redirected to the newly created Agreement's Details page.

See the "Creating an Agreement" section under Agreements for more details on creating Agreements.

2. Click the "Collaboration" tab on the collapsible left navigation pane of the Agreement’s Details page. The Collaboration page opens in the right pane indicating that there is no topic for you to collaborate and a “Start A New Topic” button.

8.0-Collaboration-New-Topic.png
 
3. Click the "Start A New Topic" button if no topics exist or click the "New Topic" plus icon on the top-left if topics already exist. The "Create a New Topic" drawer opens.
You can now select participants who will collaborate and be able to send and receive messages for a topic related to the agreement. For example, let’s collaborate with an Internal user, CLM Admin.
 
8.0-Collaboration-New-Topic-drawer1.png
 
4. By default "Select Team Members" option is selected for the "Participants" field to collaborate. If you want to collaborate with all team members at the same time, you can select the broadcast option of "All Team Members".
To select team members for the Topic, click the "Select Participants" iconSelect-user-icon.PNG. The Select Participant(s) drawer opens. For example, let’s collaborate with an Internal user CLM Admin.
 
Inter-to-Internal.png

5. You can choose to keep the topic confidential from other users by toggling the "Do you want to mark this topic as Confidential" flag to Yes. In that case, Internal users that are part of the Topic conversation will not be able to view and reply to the Topic.
6. Enter the "Subject" and "Message" for the Topic. 
7. Select files if required.
8. Click "Create". The Topic is created.
 
Note: A notification email will be sent to the participants in the "To" section of the topic. In this example, it will go to the Participant - CLM Admin. 
Based on confidentiality, participants or other team members can view the created topic, in the Topics pane on the left of the "Collaboration" page.

The Topic is listed with the following details:
  • Count of participants
  • Who initiated the conversation,
  • Who took the last action on the Topic,
  • Date

On the right pane, you can view the details of the topic's message and the replies. If the Topic is broadcasted to all team members a broadcast icon is displayed and the "Reply All" button appears beside "Reply".  You can close a Topic if no further communication is required using the “Close Topic” button.

8.0-Collaboration-Topic.png 

Creating a Topic by the Internal User and Sending Message to the External User

Let’s create a Topic and add Lee Yen Po as an External user.
1. Click on more action 3 dots on the right-top of the Agreement Details page.
2. Click "Collaborate". The "Select User" drawer opens. Let’s select the external user Lee Yen Po.
3. Click "Add". The Agreement collaborated successfully message is displayed, and the External user is added to the Team.
4. Click the "Collaboration" tab on the left collapsible navigation pane on the Agreement’s Details page.
5. Click "New Topic" on the top-right corner. The "Create a New Topic" drawer opens.
6. Follow the same steps as for adding an internal user.
7. Click "Create". The Topic is created. The participants can view this topic in the Topics window of the Collaboration page and the body of the message at the right.
 

Note: A notification email will be sent to the External Participant – Lee Yen Po of this Topic. 

Replying Messages with Reply and Reply All

Now let’s see how the provisioned external user Lee Yen Po can respond to the message.

1. Click "Reply" to respond to the selected message for one or more participants and "Reply All" to broadcast the message to all participants. 

Based on confidentiality, a message posted by an external user will be visible to participants or other team members, but not external users.

8.0-Broadcast-Reply-drawer.PNG

2. Click "Send". A notification email will be sent to all the recipients of this Topic. The authorized ICM user can see the external user response in the Topics window of the Collaboration tab.
 
Note: Internal and external users are identified in a Topic with two different colors.  

If the topic message is sent to an external team member or members, a dropdown "All User View" for selecting the user view appears beside the topic name on the top-left. Collaboration details with the specific external users can be displayed by selecting the external user from the dropdown.

Searching Messages in Topics

A user can search messages across topics using the Search tab available in the Collaboration window.  
To search messages in a topic:
Enter the keyword in the Search for Messages field. For example, let’s search the word - Can. All the topics where the message contains the searched criteria are rendered in the search result along the search word is highlighted.

Closing the Topics

An Internal user can close the topic when the discussion/conversation is concluded. Once closed, the user cannot reply to a conversation or reopen the topic. 
To close a topic:
1. Click "Close Topic" on the far-right to end any Topic conversation. A message is displayed indicating that once you closed the topic, you can no longer post any new messages on this topic.
2. Click "Yes". The Topic is now closed.
 
The message is displayed in the message window indicating the name of the user who closed the topic along with the date and time.

8.0-Collaboration-Topic-closed.png