Download Migration Assistant to migrate Unified Service Desk configurations from the legacy web client to Unified Interface

This topic describes the prerequisites and tools you require to migrate the configurations from the legacy web client to Unified Interface.

Prerequisites

• Upgrade to Unified Service Desk 4.1. To learn more, see Download Unified Service Desk.

• Ensure your environment has an model-driven app such the Customer Service Hub app built of Microsoft Dataverse. To learn more, see What are model-driven apps?

Download Web Client - Unified Interface Migration Assistant

The Web Client - Unified Interface Migration Assistant is an executable file that you can download and save on your machine. After downloading, you can run the executable file to start the migration process.

Download the Web Client – Unified Interface Migration Assistant.

Download Configuration Migration Tool

The migration of Unified Service Desk configurations from the legacy web client to Unified Interface app is a three-step process:

• Fetch and migrate the configuration elements to a USD_UI_Configurations folder using the Web Client - Unified Interface Migration Assistant.
• Import the USDWebResources folder, which is in the USD_UI_Configurations folder, using the Solutions option in Dataverse.
• Import the Data zip folder from the USD_UI_Configurations folder to the Unified Interface app using the Configuration Migration Tool (DataMigrationUtility.exe).

You must download the Configuration Migration Tool (DataMigrationUtility.exe), which is available as a NuGet package.

To download the tool, see Download the tools from NuGet. Follow the steps on this page to extract the Configuration Migration Tool (DataMigrationUtility.exe).

How to migrate the configurations

See also

Migration of Unified Service Desk configurations from Web Client to Unified Interface apps

Migration steps of the configurations from Web Client to Unified Interface App