Migrate

This guide explains how to migrate Designer's configuration and diagrams with metadata from one ServiceNow instance to another using XML export and import.

How to Migrate Designer's Configuration and Diagrams Between Instances

Designer is built on several ServiceNow tables. If you have made any changes to their configuration, you must migrate these changes via XML export.

Designer Configuration Tables

The following tables must be migrated:

  • Class Definitions (x_inpgh_des_class_definitions)

  • Class Fields (x_inpgh_des_class_fields)

  • Diagrams (x_inpgh_des_diagrams)

  • Filters (x_inpgh_des_filters)

  • Global Settings (x_inpgh_des_global_settings)

  • Indicators (x_inpgh_des_indicators)

  • Indicator Breakdown (x_inpgh_des_indicator_breakdown)

  • Relationship Definitions (x_inpgh_des_relationship_definitions)

  • Relationship Fields (x_inpgh_des_relationship_fields)

  • Shapes (x_inpgh_des_shapes)

  • Shape Libraries (x_inpgh_des_shape_libraries)

  • Templates (x_inpgh_des_templates)

  • Cross-scope privileges (sys_scope_privilege)

Additional ServiceNow Tables to Consider

Designer is built on the following ServiceNow tables. Migrate these if you have made any changes to their configuration:

  • Images (db_image)

  • Relationship Types (cmdb_rel_type)

  • Suggested Relationships (cmdb_rel_type_suggest)

Field Extensions, Dashboards, and Workflows

If you have changed Designer's configuration, migrate these via UpdateSet:

  • Field extensions (captured via UpdateSet)

  • Dashboards

  • Reports

  • Workflows

Migrate Diagrams Between Instances

Export Configuration from the Source Instance

To export diagrams plus metadata from an existing instance:

  1. In the ServiceNow navigator, type 'x_inpgh_des_diagrams.list' and press Enter

  2. Select the diagrams you wish to export, or select the all checkbox to export all diagrams

  3. Right-click on any column heading and scroll down to select Export > XML

  4. ServiceNow will prepare an XML file containing all your diagrams and their metadata. Once ready, select Download

Import Configuration to the Target Instance

To import the XML file to a new instance:

  1. In the ServiceNow navigator, type 'x_inpgh_des_diagrams.list' and press Enter

  2. Right-click any column header and select Import XML from the dropdown menu

  3. On the Import XML page, select Browse, locate your XML file, and select Upload

  4. Once the upload is complete, your diagrams will be available in the new instance

Last updated