From ICIHelp8.2
Jump to: navigation, search
(Created page with " = Self-Serve Tools =")
 
Line 1: Line 1:
  
 
= Self-Serve Tools =
 
= Self-Serve Tools =
 +
 +
Self-Serve tools include tools and features of ICM that can be used out-of-the-box by authorized users. Besides serving ICM users with specific feature and performance goals, being self-sufficient is the primary goal of these tools. These tools are user-friendly and time-saving, enabling users to perform tasks by themselves instead of reaching out to Icertis Solutions Engineering, Database or Support teams based on the requirement. Sometimes, these changes were minor and of low complexity, but the turnaround time was substantial.
 +
 +
The ICM Self-Serve tools include:
 +
 +
*Search Sync Tool
 +
*Translations Editor Tool
 +
*Improved ICM Health Check Tool
 +
*Configurations Key Editor Tool
 +
*Promote to Production (P2P) Tool
 +
<div class="image-caption">'''<span style="color:#008000;">Prerequisites</span>'''</div>
 +
*The ICM application, version 7.11 and above
 +
*The user must have valid credentials to access ICM and the ''User Administration'' tile.
 +
 +
&nbsp;
 +
 +
== Search Sync Tool ==
 +
 +
The Search Sync tool gets data from Elastic Search (ES) for a given instance’s&nbsp;''Sys Id ''and synchronizes it if required.&nbsp;Using the fetched ES value, the tool validates if the Sys Id is the latest for the respective instance or if a sync is required. This tool can be accessed by the Administrator from the ''Admin Task'' on ''User Administration'' tile.
 +
 +
If the key exists, the latest value from ES will be displayed. If the key does not exist, the system displays an error message indicating that the value could not be fetched for the provided Sys Id. The Sys Id can be provided as input CSV file or as comma separated. Either comma separated Sys Ids can be entered or a CSV file can be uploaded.
 +
 +
This helps to make the entity search more streamlined and efficient. Users can quickly refer to related agreements at the time of deals or audits.
 +
 +
'''Note''': Data can be fetched from only one instance at a time. A dedicated key must exist for ES sync to work with ''Sys ID''.
 +
 +
You can search the documents that an Agreement is linked to.
 +
 +
To use the Search Sync Tool:
 +
 +
1. '''Click'''&nbsp;Home > User Administration >&nbsp;''Admin Task''.&nbsp;The ''Admin Task'' page opens.
 +
<div class="image-green-border">[[File:Search Sync 1.png|720px|Search Sync 1]]</div>
 +
2. '''Click'''&nbsp;the&nbsp;''Search Sync ''task from the left pane.
 +
<div class="image-green-border">[[File:Search Sync 2.png|720px|Search Sync 2]]</div>
 +
4.&nbsp;'''Select'''&nbsp;the&nbsp;''Entity Type&nbsp;''from the drop-down to sync data to the Elastic Search. For example, Agreement.
 +
 +
5.&nbsp;'''Select'''&nbsp;the&nbsp;''Contract Type&nbsp;''from the drop-down''.''
 +
 +
5. '''Toggle '''''Skip Agreement Document Indexing ''to ''Yes/No'' as required.
 +
 +
6. To get the ''Sys Ids,''&nbsp;'''click'''&nbsp;the&nbsp;''Upload CSV&nbsp;button'' to upload the .CSV Agreement or&nbsp;enter&nbsp;the Sys Id using comma separated value in the box.
 +
 +
7. '''Click''' the&nbsp;''Upload CSV''&nbsp;button to upload the CSV document. The&nbsp;''Upload Document''&nbsp;window opens.
 +
<div class="image-green-border">[[File:Search Sync 3.png|720px|Search Sync3]]</div>
 +
8.&nbsp;'''Click''' ''SelectFile'' to upload a CSV file and add a note if required.
 +
<div class="image-green-border">[[File:Search Sync 4.png|720px|Search Sync 4]]</div>
 +
9.&nbsp;'''Click''' ''Upload File''. The file is uploaded to the ''File Path ''displayed.If the uploaded file format is incorrect, an alert message is displayed. The supported file formats will be also be displayed.
 +
 +
If the uploaded file format is incorrect, an alert message is displayed. The supported file formats will be also be displayed.
 +
<div class="image-green-border">[[File:Search Sync 6.png|720px|Search Sync 6]]</div>
 +
10. '''Click'''&nbsp;''Sync''. The&nbsp;''Sync Request Accepted''&nbsp;message is displayed.&nbsp;
 +
<div class="image-green-border">[[File:Search Sync 7.png|720px|Search Sync7]]</div>
 +
11. '''Click'''&nbsp;''Ok''. Users can now get data from ES for a given instance’s&nbsp;SysId&nbsp;and can check if it has the latest value or if a sync is needed.
 +
 +
12. '''Select''' ''Get ES Value''.
 +
 +
13. Enter the SysId and '''click''' ''Go''. If the key exists, the latest value from ES will be displayed. If the key does not exist, the error message ''Please enter valid SysId'' is displayed.
 +
<div class="note-box">'''Note''': Data can be fetched from only one instance at a time.</div> <div class="image-green-border">[[File:Search Sync 8.png|720px|Search Sync 8]]</div> <div class="image-caption">&nbsp;</div> <div class="image-caption">&nbsp;</div> <div class="image-caption"><span style="color:#008000;">'''''Elastic Search Sync'''''</span></div>
 +
Users can now get data from Elastic search for a given instance’s ''SysId'' so that they can look up the value and identify whether it is the latest or if a sync is needed. If the key exists, the latest value from ES will be displayed. If the key does not exist, the system will display the error message “Could not fetch value for provided SysId”.
 +
<div class="note-box">'''Note''': Data can be fetched from only one instance at a time.</div> <div class="image-green-border">[[File:Search Sync ES.png|720px|Search Sync ES.png]]</div> <div class="image-green-border">&nbsp;</div>
 +
== Translations Editor Tool ==
 +
 +
The ICM platform is available in different languages and different languages label text are available&nbsp;for&nbsp;localization. However, to make any changes to the localization values, users had to reach out to the Solutions Engineering or Database teams. Sometimes, these changes were minor and of low complexity, but the turnaround time was substantial.
 +
 +
Hence, a self-service ''Translations Editor'' tool has been introduced that contains all strings that are localized.
 +
 +
Users can now download all keys and their localization values as an Excel file, modify multiple values, and upload the modified changes to ICM. Once the values are updated in ICM, the caches are updated automatically to avoid the cache flush and server restart. This has significantly enhanced productivity as the turnaround time to update the Resource Key values has been eradicated.
 +
 +
Using this tool, users can now:
 +
 +
*Search for a specific string using the search bar and update the Resource Key value for Language and Locale.
 +
*Update multiple language strings by selecting and saving the Resource Key value.
 +
*Download and upload the localization key values using Microsoft Excel.
 +
*View the modified values in the ICM instance immediately.
 +
 +
To use the Translations Editor Tool:
 +
 +
1. '''Click'''&nbsp;the&nbsp;''User Administration'' tile on the ''Home'' page.
 +
 +
2. '''Select '''''Admin Task''&nbsp;from the drop-down. The ''Admin Task'' page opens.
 +
<div class="image-green-border">[[File:User Administration.PNG|720px|User Administration]]</div>
 +
3.&nbsp;'''Select'''&nbsp;the&nbsp;''Translation Editor ''task from the left pane.
 +
<div class="image-green-border">[[File:Translation Editor 1.png|720px|Translation Editor 1]]</div>
 +
Users can update translations in the following ways:
 +
 +
1. For selective editing, select a language and a resource key to update the translations.
 +
 +
2. For bulk editing and updation of multiple languages and resource keys, use the Download / Upload option to download an MS Excel sheet.
 +
 +
&nbsp;
 +
 +
'''<span style="color:#008000;">Selective Editing to Update Translations</span>'''
 +
 +
For editing Resource Key values selectively:
 +
 +
1. From the ''Select Language'' drop-down, select a language in which you want to edit the labels.&nbsp; For example, français (French).
 +
<div class="image-green-border">[[File:Translation Editor 2.png|720px|Translation Editor 2]]</div>
 +
The Resource Key and respective values of the selected language are displayed.
 +
<div class="image-green-border">[[File:Translation Editor 3.png|720px|Translation Editor 3]]</div>
 +
2. '''Ente'''r a ''ResourceKey ''value in the''Search'' field to edit. For example, default. All ResourceKey(s) with the ''Par défaut (default)'' values from the French language are displayed.
 +
 +
'''Note:''' ResourceKey is a unique key by which the application gets its label text for different languages.
 +
<div class="image-green-border">[[File:Translation Editor 4.png|720px|Translation Editor 4]]</div>
 +
3.&nbsp;'''Click '''the ''Edit this Resource Key for Multiple Languages&nbsp;'''''icon '''in the ''Actions'' column.
 +
 +
You can change the key for a single language or for multiple languages as required. For example, change ''Par défaut'' to ''défaut'' in French or ''Predeterminado'' in Español (Spanish) to&nbsp;''Defecto''.
 +
<div class="image-green-border">[[File:Translation Editor 5.png|720px|Translation Editor 5]]</div>
 +
4.&nbsp;'''Click''' ''Update''. The ResourceKey value for ''default ''is updated to ''défaut ''for French and to ''Defecto'' in Spanish.
 +
 +
5. The ''Resources Updated Successfully'' message is displayed. '''Click''' ''Ok''.
 +
<div class="image-green-border">[[File:Translation Editor 6.png|720px|Translation Editor 6]]</div>
 +
You can select the respective languages (French or Spanish) to verify that the resources have been successfully updated.
 +
<div class="image-green-border">[[File:Translation Editor 7.png|720px|Translation Editor 7]]</div> <div class="image-caption">&nbsp;</div> <div class="image-caption">&nbsp;</div> <div class="image-caption"><span style="color:#008000;">Bulk Editing in Multiple Languages</span></div>
 +
&nbsp;For editing Resource Key values of multiple languages in bulk:
 +
 +
1.&nbsp;'''Click''' ''Download File''. A Microsoft Excel file (named BulkActionWorkBookStringResource) that contains all the Resource keys and values for all supported languages in ICM is downloaded.
 +
<div class="image-green-border">[[File:Translation Editor 9.png|720px|Translation Editor 9]]</div>
 +
2.&nbsp;'''Open''' the downloaded Microsoft Excel file.
 +
 +
3. '''Click''' ''Enable Editing''. All ICM supported language Resource keys and their respective values are displayed.
 +
 +
4.&nbsp;'''Edit''' the ResouceKey of multiple languages as required.
 +
 +
5. '''Save''' the Excel file.
 +
 +
6.&nbsp;'''Click''' ''Upload File''. The ''Upload Translations'' window opens.
 +
 +
7. '''Click''' ''SelectFile''. The ''Open ''window opens.
 +
 +
8. '''Select''' the updated Excel file.
 +
 +
9.&nbsp;'''Click''' ''Open''. A warning window opens indicating that this is a heavy operation and can potentially affect overall application performance.
 +
 +
10.&nbsp;'''Click''' ''Ok''. The ''Upload Summary'' displays the number ''of Records Uploaded, Records Processed, ''and''Records Updated Successfully ''values.
 +
 +
11.&nbsp;'''Click''' ''Close''. The label translations have been achieved for multiple languages in bulk.
 +
 +
&nbsp;
 +
 +
== ICM Health Check Tool ==
 +
 +
The ICM platform hosted on Azure Cloud uses services such as Elastic Search, Redis along with internal components such as APIs and Task services. However, no services were used to provide an insight on the application health except for the ICM Health Check page that provided regular application health checks and application monitoring to be able to detect issues before they became full-fledged outages.
 +
 +
The ICM Health Check page has been further extended to cover additional parameters to help identify potential outages and diagnose issues. The health insights will provide information on how well the ICM Instance and its service is performing, its overall health, as well as its usefulness to users. Users will now be able to access a dashboard (without logging into ICM) that tracks application health alongside usage metrics and application crash data.
 +
 +
The health statuses are classified into three categories:
 +
 +
*''Warning ''- This is indicated with a yellow warning icon
 +
*''Healthy ''- This is indicated with a green check mark icon
 +
*''Unhealthy ''- This is indicated with a red warning icon
 +
 +
The following details are displayed in the Health Check:
 +
 +
*'''Elastic Search Health''': This displays the Status (yellow/green/red), the Elastic Search version and the Uptime, and so on.
 +
 +
*'''Redis Cache Health''': This displays the Redis version, Uptime In Days, CPU usage, Connections Received and Commands Processed, and so on.
 +
 +
*'''API Health''': This displays the API Response Time, Status and Issues and so on.
 +
 +
*'''Database Server Metrics''': This displays the CPU usage percentage, User Connections, Total Server Memory, Disk Read/Write IO/Sec and so on.
 +
 +
*'''IIS Server Metrics''': This displays&nbsp;% 404 HTTP Response Sent,&nbsp;% 500&nbsp; HTTP Response Sent, percentage of CPU utilization per process, Requests/sec, and so on.
 +
<div class="image-green-border">To view the Health Check, add "Health/ViewHealth"&nbsp;(without quotes) to your ICM URL.&nbsp;</div>
 +
To check the health of your system:<br/> 1. Enter '''''/health/viewhealth''''' at the end of the URL of your ICM instance. For example, [https://apexorg.icertis.com/health/viewhealth https://apexorg.icertis.com/health/viewhealth]. The various tools and their health are displayed.
 +
<div class="image-green-border">[[File:Health Check 1.png|720px|Health Check 1]]</div> <div class="image-green-border"><br/> 2. '''Click''' the + icon next to the tool to view details regarding its health. The details for each of the tools are displayed in 2 columns with the Keys and their respective values as shown below.</div>
 +
'''Elastic Search Health'''<br/> The details for the Elastic Search Health include the status, node total, primary and relocating shards, version, heap percent, uptime, and so on. For example, the Status is green.
 +
<div class="image-green-border">[[File:Health Check 2.png|720px|Health Check 2]]</div>
 +
'''Redis Cache Health'''<br/> The details for the Redis Cache Health include the uptime in days. Connected or blocked clients, rejected connections, CPU usage, and so on. For example, the Uptime in Days is 28.
 +
<div class="image-green-border">[[File:Health Check 3.png|720px|Health Check 3]]</div>
 +
'''API Health'''<br/> The API Health provides the response time. For example, 94 ms.
 +
<div class="image-green-border">[[File:Health Check 4.png|720px|Health Check 4]]</div>
 +
'''Task Service Health&nbsp;&nbsp; &nbsp;'''<br/> The Task Service Health provides the failed count for keys and when it was last successful.&nbsp;
 +
<div class="image-green-border">[[File:Health Check 5.png|720px|Health Check 5]]</div>
 +
'''Database Server Metrics'''<br/> The details for the Database Server Metrics Health include the edition, SQL server resource pool stats, and so on.
 +
<div class="image-green-border">[[File:Health Check 6.png|720px|Health Check 6]]</div>
 +
'''IIS Server Metrics'''<br/> The details for the IIS Server Metrics Health include the total method requests/sec, number of seconds an IIS Worker process has been running, the percentage of CPU utilization per process, and so on.
 +
<div class="image-green-border">[[File:Health Check 7.png|720px|Health Check 7]]</div>
 +
&nbsp;
 +
 +
&nbsp;
 +
 +
== Promote Configurations (P2P) Tool ==
 +
 +
The Promote to Production (P2P) process of the ICM platform helps to move ICM Configuration from source (Config/UAT) environment to target (production) environment. P2P process enables to selectively move ICM configuration. The Promote Configuration Tool or P2P is designed to accomplish just that.
 +
 +
With the 7.11 release, the Promote to Production (P2P) tool to enable users with the following enhancements:
 +
 +
*Vulnerability and Penetration Testing (VAPT) fixes
 +
*Testing open bugs in P2P engine
 +
*Some new validations in the P2P engine
 +
*Better user interface to provide support to P2P and DevOps teams
 +
 +
With the 7.12 release, changes have been made in ICM to support the P2P engine. This functionality, provided to Administrators, can promote ICM configurations/modifications that are made to ICM configurations in pre-production environments to production environments. This tool provides support for contract types, contract type attributes, clauses and templates (along with the documents), notification templates, rules, masterdata, users, user groups and security groups. The elastic search sync is also supported by the tool.
 +
<div class="note-box">'''Note:''' UI changes on contract type, rule set, notification template are not included. Customers using ICM version before 7.12 need to upgrade for this capability.</div>
 +
Here is an overview of the P2P process:
 +
<div class="image-green-border">[[File:P2P 1.png|720px|P2P 1]]</div> <div class="image-caption"><span style="background-color:#008000;">Accessing P2P tool</span></div>
 +
To access the P2P tool:&nbsp;
 +
 +
1.&nbsp;'''Click '''''Home >&nbsp;''''Configuration'''''<b>tile. The ''Configuration'' page opens.</b>
 +
 +
2.&nbsp;'''Click '''the ''Promote'' ''Configurations'' tile. The ''Promote Configuration'' page opens.&nbsp;The ''Promote Configurations ''displays the current status of PToP requests and their status.
 +
 +
'''Note: '''Users cannot edit a request that is in ''Completed'' state.
 +
<div class="image-green-border">[[File:P2P 2.png|720px|P2P 2]]</div> <div class="image-caption">&nbsp;</div> <div class="image-caption">&nbsp;</div> <div class="image-caption"><span style="color:#008000;">'''''Creating a P2P Request'''''</span></div>
 +
To create a P2P Request:
 +
 +
1.&nbsp;'''Click'''&nbsp;''Configurations > Promote Configurations > Create Request''. The&nbsp;''Create P2P Request''&nbsp;page opens.
 +
<div class="image-green-border">[[File:P2P 3.png|720px|P2P 3]]</div>
 +
2.&nbsp;'''Enter'''&nbsp;a&nbsp;''Request Name''. For example,&nbsp;''Procurement''.
 +
 +
3. '''Select'''&nbsp;a ''Target'' from the drop-down. For example,&nbsp;''Acme Dev''.
 +
 +
4.&nbsp;'''Select'''&nbsp;the&nbsp;''P2P Request Start Date Time''.
 +
 +
5.&nbsp;'''Select&nbsp;'''the time to trigger an email to the recipient from the&nbsp;''Intimation Email minutes before P2P Starts&nbsp;''drop-down list. For example,&nbsp;''15 Min''.
 +
 +
6.&nbsp;'''Enter'''&nbsp;the intimation recipient Email Id in the&nbsp;''Notification Email – Intimation&nbsp;''field.
 +
 +
7.&nbsp;'''Enter'''&nbsp;the notification recipient Email Id in the&nbsp;''Notification Email – Success&nbsp;''field.
 +
 +
8.&nbsp;'''Enter'''&nbsp;the notification recipient email Id in the&nbsp;''Notification Email – Failure&nbsp;''field.
 +
 +
9.&nbsp;'''Enter'''&nbsp;the notification recipient email Id in the&nbsp;''Notification Email – Cancel&nbsp;''field.
 +
 +
10.&nbsp;'''Click'''&nbsp;''Next.&nbsp;''The&nbsp;''Contract Type''&nbsp;tab opens.
 +
 +
11.&nbsp;'''Select'''&nbsp;the&nbsp;''Contract Type&nbsp;''from the&nbsp;''Available Contract Types''. For example,&nbsp;''Fiscal Year Master''. The selected Contract Type attributes are available in the&nbsp;''Attributes Of Selected Contract Type''&nbsp;columns.
 +
 +
12.&nbsp;'''Select '''the attributes for the selected contract type'''. '''For example, ''Created By''.
 +
 +
13.&nbsp;'''Click '''the right arrow to move the selected contract type and attribute to ''the Selected Contract Types'' and ''Attributes Of Selected Contract Type'' columns respectively.
 +
<div class="image-green-border">[[File:P2P 4.png|720px|P2P 4]]</div>
 +
14.&nbsp;'''Click'''&nbsp;''Next''. The&nbsp;''Templates and Clauses&nbsp;tab'' opens.
 +
 +
15.&nbsp;'''Select'''&nbsp;a template from the&nbsp;''Available Templates''&nbsp;columns. For example,&nbsp;''Demo Template''.
 +
 +
16.&nbsp;'''Click '''the arrow key to move the selected template to the S''elected Templates'' column.
 +
 +
17.&nbsp;'''Select'''&nbsp;a clause from the''&nbsp;Available Clauses''&nbsp;columns. For example,&nbsp;''Clause 1_Demo''.
 +
 +
18.&nbsp;'''Click '''the arrow key to move the selected clause to the S''elected Clauses'' column.
 +
<div class="image-green-border">[[File:P2P 5.png|720px|P2P 5]]</div>
 +
19.&nbsp;'''Click '''''Next. ''The&nbsp;''Rules'' tab opens.
 +
 +
20.&nbsp;'''Select'''&nbsp;a Rule from the&nbsp;''Available Rule Set Information''&nbsp;column. For example, ''ICM_Master I Master_Exec Summary on Agr Add Association''.
 +
 +
21.&nbsp;'''Click '''the arrow key to move the selected rule to the S''elected Rule Set Information'' column.
 +
<div class="image-green-border">[[File:P2P 6.png|720px|P2P 6]]</div>
 +
22.&nbsp;'''Click '''''Next''. The&nbsp;''Notifications ''tab opens.
 +
 +
23.&nbsp;'''Select&nbsp;'''the notification template from the&nbsp;''Available Notification Template''&nbsp;columns. For example, ''UserInformation I User Information Expired I UserInformationExpired I User Notifications''.
 +
 +
24.&nbsp;'''Click '''the arrow key to move the selected template to the S''elected Notification Templates'' column.
 +
<div class="image-green-border">[[File:P2P 7.png|720px|P2P 7]]</div>
 +
25.&nbsp;'''Click'''&nbsp;''Next''.&nbsp;The&nbsp;''Master Data & Core Seed Data''&nbsp;tab opens.
 +
<div class="note-box">'''''Note''''':&nbsp;Users can use the ''P2P tool&nbsp;Master Data''&nbsp;tab for the faster transition of Master Data to production than the Bulk utility tool option.</div>
 +
&nbsp;
 +
 +
27.&nbsp;'''Click '''the arrow key to move the selected rule to the S''elected Master Data'' column.
 +
 +
28.&nbsp;'''Select&nbsp;'''the seed data from the&nbsp;''Available Core Seed Data''&nbsp;column.
 +
 +
29.&nbsp;'''Click '''the arrow key to move the selected master data to the S''elected Core Seed Data ''column.
 +
<div class="image-green-border">[[File:P2P 8.png|720px|P2P 8]]</div>
 +
30.&nbsp;'''Click '''''Next. ''The&nbsp;''Users & User groups''&nbsp;tab opens.
 +
 +
31.&nbsp;'''Select'''&nbsp;the users from the&nbsp;''Available Users''&nbsp;column.
 +
 +
32.'''Click '''the arrow key to move the selected user to the S''elected Users'' column.
 +
 +
33. '''Select&nbsp;'''the user group from the&nbsp;''Available User Groups''&nbsp;column.&nbsp;
 +
 +
34. '''Click '''the arrow key to move the selected user to the S''elected User Groups'' column.
 +
<div class="image-green-border">[[File:P2P 9.png|720px|P2P 9]]</div>
 +
35. '''Click'''''&nbsp;Next'' if any or no user or user group is selected.&nbsp;The&nbsp;''Security Groups''&nbsp;tab opens.
 +
 +
36. '''Select&nbsp;'''the security group from the&nbsp;''Available Security Groups''&nbsp;columns.
 +
 +
37. '''Click '''the arrow key to move the selected security group to the S''elected Security Groups'' column.
 +
 +
38.'''Select&nbsp;'''the KPI from the&nbsp;''Available KPI’s''&nbsp;columns.
 +
 +
39.'''Click '''the arrow key to move the selected KPI to the S''elected SaveSearchKPIs'' column. For example, ''Product Authorization''.
 +
<div class="image-green-border">[[File:P2P 10.png|720px|P2P 10]]</div>
 +
40. '''Click'''&nbsp;''Next''. The''&nbsp;Verify''&nbsp;tab opens.
 +
 +
41. '''Verify''' details of the contract types, attributes, templates, clauses, rule set information, notification templates, master data, core seed data, user and user groups, save search KPI and security groups that you have selected.
 +
<div class="image-green-border">[[File:P2P 11.png|720px|P2P 11]]</div>
 +
42. '''Click&nbsp;'''''Create''.&nbsp;The&nbsp;''Please Confirm''&nbsp;window opens indicating that downtime is required for this request.
 +
<div class="note-box">'''''Note''''':&nbsp;The P2P tool verifies all the information entered by the user before creating a P2P request.</div>
 +
43.'''Click&nbsp;'''''Yes ''if you wish to proceed.&nbsp;The&nbsp;''Information&nbsp;''window opens indicating that the P2P request created successfully.
 +
 +
44.'''Click'''&nbsp;''Ok''.&nbsp;The P2P request&nbsp;status&nbsp;changes to&nbsp;''ADDED''.
 +
 +
45. On completion of the P2P request, the&nbsp;status&nbsp;changes to&nbsp;''Completed''.
 +
<div class="note-box">'''Note''':&nbsp;Users cannot edit a request that is in&nbsp;''Completed''&nbsp;state.</div> <div class="image-green-border">[[File:P2P 12.png|720px|P2P 12]]</div>
 +
&nbsp;
 +
 +
&nbsp;
 +
 +
&nbsp;
 +
 +
'''Related Topics:&nbsp;'''[[Agreement_Management|Agreement Management]] |&nbsp;[http://int-wiki.cloudapp.net:8085/ICMHelp7.12/index.php?title=Association_Management Association Management]&nbsp;|&nbsp;[http://int-wiki.cloudapp.net:8085/ICMHelp7.12/index.php?title=Compliance_Management Compliance Management]&nbsp;|&nbsp;[http://int-wiki.cloudapp.net:8085/ICMHelp7.12/index.php?title=Template_Management Template Management]&nbsp;|&nbsp;[http://int-wiki.cloudapp.net:8085/ICMHelp7.12/index.php?title=Clause_Management Clause Management]&nbsp;|&nbsp;[http://int-wiki.cloudapp.net:8085/ICMHelp7.12/index.php?title=Configuration Configuration]&nbsp;|&nbsp;[http://int-wiki.cloudapp.net:8085/ICMHelp7.12/index.php?title=Reports Reports]&nbsp;|&nbsp;[http://int-wiki.cloudapp.net:8085/ICMHelp7.12/index.php?title=Localizing_ICM Localizing ICM]

Revision as of 06:54, 4 August 2020

Self-Serve Tools

Self-Serve tools include tools and features of ICM that can be used out-of-the-box by authorized users. Besides serving ICM users with specific feature and performance goals, being self-sufficient is the primary goal of these tools. These tools are user-friendly and time-saving, enabling users to perform tasks by themselves instead of reaching out to Icertis Solutions Engineering, Database or Support teams based on the requirement. Sometimes, these changes were minor and of low complexity, but the turnaround time was substantial.

The ICM Self-Serve tools include:

  • Search Sync Tool
  • Translations Editor Tool
  • Improved ICM Health Check Tool
  • Configurations Key Editor Tool
  • Promote to Production (P2P) Tool
Prerequisites
  • The ICM application, version 7.11 and above
  • The user must have valid credentials to access ICM and the User Administration tile.

 

Search Sync Tool

The Search Sync tool gets data from Elastic Search (ES) for a given instance’s Sys Id and synchronizes it if required. Using the fetched ES value, the tool validates if the Sys Id is the latest for the respective instance or if a sync is required. This tool can be accessed by the Administrator from the Admin Task on User Administration tile.

If the key exists, the latest value from ES will be displayed. If the key does not exist, the system displays an error message indicating that the value could not be fetched for the provided Sys Id. The Sys Id can be provided as input CSV file or as comma separated. Either comma separated Sys Ids can be entered or a CSV file can be uploaded.

This helps to make the entity search more streamlined and efficient. Users can quickly refer to related agreements at the time of deals or audits.

Note: Data can be fetched from only one instance at a time. A dedicated key must exist for ES sync to work with Sys ID.

You can search the documents that an Agreement is linked to.

To use the Search Sync Tool:

1. Click Home > User Administration > Admin Task. The Admin Task page opens.

Search Sync 1

2. Click the Search Sync task from the left pane.

Search Sync 2

4. Select the Entity Type from the drop-down to sync data to the Elastic Search. For example, Agreement.

5. Select the Contract Type from the drop-down.

5. Toggle Skip Agreement Document Indexing to Yes/No as required.

6. To get the Sys Ids, click the Upload CSV button to upload the .CSV Agreement or enter the Sys Id using comma separated value in the box.

7. Click the Upload CSV button to upload the CSV document. The Upload Document window opens.

Search Sync3

8. Click SelectFile to upload a CSV file and add a note if required.

Search Sync 4

9. Click Upload File. The file is uploaded to the File Path displayed.If the uploaded file format is incorrect, an alert message is displayed. The supported file formats will be also be displayed.

If the uploaded file format is incorrect, an alert message is displayed. The supported file formats will be also be displayed.

Search Sync 6

10. Click Sync. The Sync Request Accepted message is displayed. 

Search Sync7

11. Click Ok. Users can now get data from ES for a given instance’s SysId and can check if it has the latest value or if a sync is needed.

12. Select Get ES Value.

13. Enter the SysId and click Go. If the key exists, the latest value from ES will be displayed. If the key does not exist, the error message Please enter valid SysId is displayed.

Note: Data can be fetched from only one instance at a time.
Search Sync 8
 
 
Elastic Search Sync

Users can now get data from Elastic search for a given instance’s SysId so that they can look up the value and identify whether it is the latest or if a sync is needed. If the key exists, the latest value from ES will be displayed. If the key does not exist, the system will display the error message “Could not fetch value for provided SysId”.

Note: Data can be fetched from only one instance at a time.
Search Sync ES.png
 

Translations Editor Tool

The ICM platform is available in different languages and different languages label text are available for localization. However, to make any changes to the localization values, users had to reach out to the Solutions Engineering or Database teams. Sometimes, these changes were minor and of low complexity, but the turnaround time was substantial.

Hence, a self-service Translations Editor tool has been introduced that contains all strings that are localized.

Users can now download all keys and their localization values as an Excel file, modify multiple values, and upload the modified changes to ICM. Once the values are updated in ICM, the caches are updated automatically to avoid the cache flush and server restart. This has significantly enhanced productivity as the turnaround time to update the Resource Key values has been eradicated.

Using this tool, users can now:

  • Search for a specific string using the search bar and update the Resource Key value for Language and Locale.
  • Update multiple language strings by selecting and saving the Resource Key value.
  • Download and upload the localization key values using Microsoft Excel.
  • View the modified values in the ICM instance immediately.

To use the Translations Editor Tool:

1. Click the User Administration tile on the Home page.

2. Select Admin Task from the drop-down. The Admin Task page opens.

User Administration

3. Select the Translation Editor task from the left pane.

Translation Editor 1

Users can update translations in the following ways:

1. For selective editing, select a language and a resource key to update the translations.

2. For bulk editing and updation of multiple languages and resource keys, use the Download / Upload option to download an MS Excel sheet.

 

Selective Editing to Update Translations

For editing Resource Key values selectively:

1. From the Select Language drop-down, select a language in which you want to edit the labels.  For example, français (French).

Translation Editor 2

The Resource Key and respective values of the selected language are displayed.

Translation Editor 3

2. Enter a ResourceKey value in theSearch field to edit. For example, default. All ResourceKey(s) with the Par défaut (default) values from the French language are displayed.

Note: ResourceKey is a unique key by which the application gets its label text for different languages.

Translation Editor 4

3. Click the Edit this Resource Key for Multiple Languages icon in the Actions column.

You can change the key for a single language or for multiple languages as required. For example, change Par défaut to défaut in French or Predeterminado in Español (Spanish) to Defecto.

Translation Editor 5

4. Click Update. The ResourceKey value for default is updated to défaut for French and to Defecto in Spanish.

5. The Resources Updated Successfully message is displayed. Click Ok.

Translation Editor 6

You can select the respective languages (French or Spanish) to verify that the resources have been successfully updated.

Translation Editor 7
 
 
Bulk Editing in Multiple Languages

 For editing Resource Key values of multiple languages in bulk:

1. Click Download File. A Microsoft Excel file (named BulkActionWorkBookStringResource) that contains all the Resource keys and values for all supported languages in ICM is downloaded.

Translation Editor 9

2. Open the downloaded Microsoft Excel file.

3. Click Enable Editing. All ICM supported language Resource keys and their respective values are displayed.

4. Edit the ResouceKey of multiple languages as required.

5. Save the Excel file.

6. Click Upload File. The Upload Translations window opens.

7. Click SelectFile. The Open window opens.

8. Select the updated Excel file.

9. Click Open. A warning window opens indicating that this is a heavy operation and can potentially affect overall application performance.

10. Click Ok. The Upload Summary displays the number of Records Uploaded, Records Processed, andRecords Updated Successfully values.

11. Click Close. The label translations have been achieved for multiple languages in bulk.

 

ICM Health Check Tool

The ICM platform hosted on Azure Cloud uses services such as Elastic Search, Redis along with internal components such as APIs and Task services. However, no services were used to provide an insight on the application health except for the ICM Health Check page that provided regular application health checks and application monitoring to be able to detect issues before they became full-fledged outages.

The ICM Health Check page has been further extended to cover additional parameters to help identify potential outages and diagnose issues. The health insights will provide information on how well the ICM Instance and its service is performing, its overall health, as well as its usefulness to users. Users will now be able to access a dashboard (without logging into ICM) that tracks application health alongside usage metrics and application crash data.

The health statuses are classified into three categories:

  • Warning - This is indicated with a yellow warning icon
  • Healthy - This is indicated with a green check mark icon
  • Unhealthy - This is indicated with a red warning icon

The following details are displayed in the Health Check:

  • Elastic Search Health: This displays the Status (yellow/green/red), the Elastic Search version and the Uptime, and so on.
  • Redis Cache Health: This displays the Redis version, Uptime In Days, CPU usage, Connections Received and Commands Processed, and so on.
  • API Health: This displays the API Response Time, Status and Issues and so on.
  • Database Server Metrics: This displays the CPU usage percentage, User Connections, Total Server Memory, Disk Read/Write IO/Sec and so on.
  • IIS Server Metrics: This displays % 404 HTTP Response Sent, % 500  HTTP Response Sent, percentage of CPU utilization per process, Requests/sec, and so on.
To view the Health Check, add "Health/ViewHealth" (without quotes) to your ICM URL. 

To check the health of your system:
1. Enter /health/viewhealth at the end of the URL of your ICM instance. For example, https://apexorg.icertis.com/health/viewhealth. The various tools and their health are displayed.

Health Check 1

2. Click the + icon next to the tool to view details regarding its health. The details for each of the tools are displayed in 2 columns with the Keys and their respective values as shown below.

Elastic Search Health
The details for the Elastic Search Health include the status, node total, primary and relocating shards, version, heap percent, uptime, and so on. For example, the Status is green.

Health Check 2

Redis Cache Health
The details for the Redis Cache Health include the uptime in days. Connected or blocked clients, rejected connections, CPU usage, and so on. For example, the Uptime in Days is 28.

Health Check 3

API Health
The API Health provides the response time. For example, 94 ms.

Health Check 4

Task Service Health    
The Task Service Health provides the failed count for keys and when it was last successful. 

Health Check 5

Database Server Metrics
The details for the Database Server Metrics Health include the edition, SQL server resource pool stats, and so on.

Health Check 6

IIS Server Metrics
The details for the IIS Server Metrics Health include the total method requests/sec, number of seconds an IIS Worker process has been running, the percentage of CPU utilization per process, and so on.

Health Check 7

 

 

Promote Configurations (P2P) Tool

The Promote to Production (P2P) process of the ICM platform helps to move ICM Configuration from source (Config/UAT) environment to target (production) environment. P2P process enables to selectively move ICM configuration. The Promote Configuration Tool or P2P is designed to accomplish just that.

With the 7.11 release, the Promote to Production (P2P) tool to enable users with the following enhancements:

  • Vulnerability and Penetration Testing (VAPT) fixes
  • Testing open bugs in P2P engine
  • Some new validations in the P2P engine
  • Better user interface to provide support to P2P and DevOps teams

With the 7.12 release, changes have been made in ICM to support the P2P engine. This functionality, provided to Administrators, can promote ICM configurations/modifications that are made to ICM configurations in pre-production environments to production environments. This tool provides support for contract types, contract type attributes, clauses and templates (along with the documents), notification templates, rules, masterdata, users, user groups and security groups. The elastic search sync is also supported by the tool.

Note: UI changes on contract type, rule set, notification template are not included. Customers using ICM version before 7.12 need to upgrade for this capability.

Here is an overview of the P2P process:

P2P 1
Accessing P2P tool

To access the P2P tool: 

1. Click Home > 'Configurationtile. The Configuration page opens.

2. Click the Promote Configurations tile. The Promote Configuration page opens. The Promote Configurations displays the current status of PToP requests and their status.

Note: Users cannot edit a request that is in Completed state.

P2P 2
 
 
Creating a P2P Request

To create a P2P Request:

1. Click Configurations > Promote Configurations > Create Request. The Create P2P Request page opens.

P2P 3

2. Enter a Request Name. For example, Procurement.

3. Select a Target from the drop-down. For example, Acme Dev.

4. Select the P2P Request Start Date Time.

5. Select the time to trigger an email to the recipient from the Intimation Email minutes before P2P Starts drop-down list. For example, 15 Min.

6. Enter the intimation recipient Email Id in the Notification Email – Intimation field.

7. Enter the notification recipient Email Id in the Notification Email – Success field.

8. Enter the notification recipient email Id in the Notification Email – Failure field.

9. Enter the notification recipient email Id in the Notification Email – Cancel field.

10. Click Next. The Contract Type tab opens.

11. Select the Contract Type from the Available Contract Types. For example, Fiscal Year Master. The selected Contract Type attributes are available in the Attributes Of Selected Contract Type columns.

12. Select the attributes for the selected contract type. For example, Created By.

13. Click the right arrow to move the selected contract type and attribute to the Selected Contract Types and Attributes Of Selected Contract Type columns respectively.

P2P 4

14. Click Next. The Templates and Clauses tab opens.

15. Select a template from the Available Templates columns. For example, Demo Template.

16. Click the arrow key to move the selected template to the Selected Templates column.

17. Select a clause from the Available Clauses columns. For example, Clause 1_Demo.

18. Click the arrow key to move the selected clause to the Selected Clauses column.

P2P 5

19. Click Next. The Rules tab opens.

20. Select a Rule from the Available Rule Set Information column. For example, ICM_Master I Master_Exec Summary on Agr Add Association.

21. Click the arrow key to move the selected rule to the Selected Rule Set Information column.

P2P 6

22. Click Next. The Notifications tab opens.

23. Select the notification template from the Available Notification Template columns. For example, UserInformation I User Information Expired I UserInformationExpired I User Notifications.

24. Click the arrow key to move the selected template to the Selected Notification Templates column.

P2P 7

25. Click Next. The Master Data & Core Seed Data tab opens.

Note: Users can use the P2P tool Master Data tab for the faster transition of Master Data to production than the Bulk utility tool option.

 

27. Click the arrow key to move the selected rule to the Selected Master Data column.

28. Select the seed data from the Available Core Seed Data column.

29. Click the arrow key to move the selected master data to the Selected Core Seed Data column.

P2P 8

30. Click Next. The Users & User groups tab opens.

31. Select the users from the Available Users column.

32.Click the arrow key to move the selected user to the Selected Users column.

33. Select the user group from the Available User Groups column. 

34. Click the arrow key to move the selected user to the Selected User Groups column.

P2P 9

35. Click Next if any or no user or user group is selected. The Security Groups tab opens.

36. Select the security group from the Available Security Groups columns.

37. Click the arrow key to move the selected security group to the Selected Security Groups column.

38.Select the KPI from the Available KPI’s columns.

39.Click the arrow key to move the selected KPI to the Selected SaveSearchKPIs column. For example, Product Authorization.

P2P 10

40. Click Next. The Verify tab opens.

41. Verify details of the contract types, attributes, templates, clauses, rule set information, notification templates, master data, core seed data, user and user groups, save search KPI and security groups that you have selected.

P2P 11

42. Click Create. The Please Confirm window opens indicating that downtime is required for this request.

Note: The P2P tool verifies all the information entered by the user before creating a P2P request.

43.Click Yes if you wish to proceed. The Information window opens indicating that the P2P request created successfully.

44.Click Ok. The P2P request status changes to ADDED.

45. On completion of the P2P request, the status changes to Completed.

Note: Users cannot edit a request that is in Completed state.
P2P 12

 

 

 

Related Topics: Agreement Management | Association Management | Compliance Management | Template Management | Clause Management | Configuration | Reports | Localizing ICM

Retrieved from "https://iciwikiapac.icertis.com:443/ICIHelp8.2/index.php?title=Self-Serve_Tools&oldid=14198"