The 1E ITSM Connect V2 App is supported on the London, Madrid and New York versions of ServiceNow. The V1 App is supported on Kingston, London and Madrid versions only. 

As soon as you upgrade your Instance to New York, the V1 App exists as is. However, the "Run Instruction" button is not clickable any longer.

Before upgrading

Before you begin, ensure the following:

  1. All instructions have been approved, i.e. all Approvals are in the Approved state.
  2. All instructions have been executed, i.e. they are in Complete state.
  3. Ensure that the latest version of the 1E Core App is installed.
  4. As a best practice, please backup the following tables:
    • Instruction definitions
    • Instruction history
    • Tachyon approvals

Here are the details for each of the three tables that need to be backed up: 

  • x_1e_connect_instruction_definition (xml format) or Instruction Definitions
  • x_1e_connect_triggered_instruction (xlsx format) or Instruction History
  • The third table is a subset of the sysapproval_approver table. This table requires a custom query. For this, navigate to your address bar, append the query after your serviceNow instance name. 
    For example:  

    https://dev03448.service-now.com/nav_to.do?uri=%2Fsysapproval_approver_list.do%3Fsysparm_query%3D%26sysparm_first_row%3D1%26sysparm_view%3D%26sysparm_fixed_query%3Dsource_table%253Dx_1e_connect_triggered_instruction
    

Steps to backup each table :

  1. In the Application navigator, populate the table name and append .LIST at the end. For example: x_1e_connect_instruction_definition.LIST
  2. Right click on the table and select Export→XML from the right-click context menu, as shown in the picture opposite.

  1. For the x_1e_connect_triggered_instruction table, take a backup in xlsx format, as shown in the picture opposite.

Upgrading 1E ITSM Connect

Once the tables have been backed up, perform the following steps to upgrade:

  1. In ServiceNow, navigate to My Company Applications and click on the All Apps  tab.
  2. Click on the ITSM Connect V2 Application, Select the latest version (currently 2.0.0) from the drop down menu, as shown in the picture opposite, and click Update.

  1. Navigate to the "App Configuration" under 1E Core App and ensure all settings are available. If not, please populate the settings.
  2. Check to ensure that all three previously backed up tables are now populated. If they have not been populated, please follow these steps to restore them:

    1. If the Instruction definitions table is not populated, please click on the Retrieve Instructions button on the App configuration page, as shown highlighted in the picture opposite.
    2. If the Instruction History table is not populated, migrate data from the xlsx back up of the table (x_1e_connect_triggered_instruction) and restore it through a transform map.

Uninstalling ITSM Connect

You can use the following steps if you need to uninstall ITSM Connect:

  1. In ServiceNow, navigate to My Company Applications and click on the Installed tab, as shown in the picture opposite.
  2. Click on the App name you want to uninstall.
  3. On the App page click Uninstall. Acknowledge the confirmation message and wait for uninstallation to complete.