# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ins-pi.com/designer/get-the-app/migrate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.