Upgrading Netenrich Connect App

  • Updated
Table of Contents:

This article covers the prerequisites to upgrade the Netenrich Connect app and the steps to upgrade in detail.

Roles Required

For a successful configuration, the Customer ServiceNow Developer must have the following role:

  • Global Admin role

Domain Specifications

  • Domain should be in Global and Application should be Netenrich Connect.

servicenow_new.png

Prerequisites

Before proceeding with the upgrade, ensure the following prerequisites are met:

  • You must have a previous version of Netenrich Connect app installed in your ServiceNow account.
  • Ensure that you are using one of the following versions: Tokyo, San Diego, Rome, Utah, Washington DC, or Xanadu, as the Netenrich application supports only these.  

Upgrading from Customer application UI

To upgrade Netenrich Connect app:

  1. Log in to your application with valid credentials
  2. Search for "Plugins" in the application navigator

Picture28.png

3. Click Plugins obtained from search result

4. Search "Netenrich Connect" in the top search bar. The Netenrich Connect app will appear on your screen.

mceclip1.png

5. Select the latest version say for example- 1.2.11 that you want to install from the drop-down. 

6. Select the latest version 1.2.XX  Click "Install" next to the app.

Once the latest version is installed, a popup message appears as, "You have installed version 1.2.XX successfully."

Verifying your Netenrich Connect App version

  After installing the required version, follow these steps to verify the installed version:

  1. Check if the version number 1.2.XXX is displayed next to the Netenrich Connect app.
  2. Go to the ServiceNow store and check if version number 1.2.XX is displayed next to the Netenrich Connect app tile.

mceclip1.png

3. Compare both the versions shown on the above screenshots and you would know the latest version of Netenrich Connect app installed in your account.

mceclip0.png

After Upgrading Application - Next Steps:

  • Search in filter navigator for update history under system diagnostics.

afterupgradingapp.png

  • Open Upgrade history and open recent upgraded file.

afterupgradingapp_1.png

Open recent upgraded file click on skipped changes to review.

afterupgradingapp_2.png

afterupgradingapp_3.png

  • Select all files and revert base to system.

   Validation after Upgrade

  • As Customer activated Modules(Incident, Case Etc) all the rules must be in latest Netenrich Connect Upgraded Version.

afterupgradingapp_4.png

  • These are the modules need be verified as per above screenshot, like
Module name URL
Business rules https://yourinstancename.service-now.com/sys_script_list.do?sysparm_query=collection%3Dsn_customerservice_case%5EORcollection%3Dincident%5Esys_scope%3D6565f2a51b15f010c76beac5624bcb1c%5Eactive%3Dtrue&sysparm_view=
Script includes https:// yourinstancename.service-now.com/sys_script_include_list.do?sysparm_query=sys_scope.nameLIKENetenrich%5Ename!%3DNetenrichCreateorUpdateRITM%5EORname%3DNULL%5Ename!%3DNetenrichCreateorUpdateSR%5EORname%3DNULL%5Ename!%3DNetenrichCreateorUpdateProblem%5EORname%3DNULL%5Ename!%3DNetenrich_Github_Utils%5EORname%3DNULL%5Ename!%3DNetenrichCreateorUpdateCR%5EORname%3DNULL&sysparm_view=
Transform maps https:// yourinstancename.service-now.com/sys_transform_map_list.do?sysparm_query=name%3DNetEnrich%20Incident%20Import%20Map%5EORname%3DNetenrich%20Case%20Import&sysparm_view=
UI Pages https:// yourinstancename.service-now.com/sys_ui_page_list.do?sysparm_query=sys_scope.nameLIKEnetenrich&sysparm_view=

We will share the wrapper Table XML and Script include Update Set In case the changes are moved through the Upgrade.

Note: Before Upgrade take Backup of Wrapper table XML.

Authentication Process

The Customer should share the Netenrichuser password with the RI team during the call.

Note: The Customer should import the Update Set for changing API endpoints in the Staging environment. As we upgrade the app, the endpoints will point to Production, so we need to change them to Staging. This can be done either manually or through the Update Set, depending on the Customers preference.

Inbound:

Inbound key and secret will be providing by RI Team, which need to be updated in Netenrich Connect Inbound Provider(https:/yourinstancename.service-now.com/nav_to.do?uri=oauth_entity.do?sys_id=325aabbd1b953410c76beac5624bcbb2%26sysparm_view=default )

authenticationprocess.png

Above Client id and client secret will share by RI Team Update in Customers ServiceNow.

Outbound:

RI Team will provide Client id and Client Secret , Which need to be updated in Netenrich Connect Outbound Provider (https://yourinstancename.service-now.com/nav_to.do?uri=oauth_entity.do?sys_id=2f8a6fbd1b953410c76beac5624bcb9e%26sysparm_view=oauth_provider )
authenticationprocess_1.png

Client ID and Client ID will share by RI Team and change the Re-direct URL to Your instance name

Rest Message: Validate “Netenrich Rest Message” authentication records.
Check all endpoints in the REST Message and verify if the HTTP request authorization value is correct. Use Base64 encoding for the client ID and client secret to generate the value. If the value is incorrect, update it and share it with the Customer ServiceNow’s team for verification.

authenticationprocess_2.png

By following these steps, you can successfully upgrade the Netenrich Connect app in your ServiceNow account.

Note: once Testing is successful from both ServiceNow/RI with attached Approved Signoff will move the same update set to higher instances.

 

Related articles

Comments

0 comments

Please sign in to leave a comment.