Import Unified Service Desk configuration data

Unified Service Desk 2.0
 

Updated: November 29, 2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

You can import the Unified Service Desk configuration data to the target Microsoft Dynamics 365 Server by using either of the following ways:

  • Using the Configuration Migration tool

  • Creating a custom package for Unified Service Desk that contains the exported configuration data

Before you can import the configuration data to the target system, make sure you have exported the Unified Service Desk configuration data from your source system. More information:Export Unified Service Desk configuration data

  1. Make sure that the Dynamics 365 instance where you are migrating the configuration data has the required Unified Service Desk package deployed. If it doesn’t, deploy a sample Unified Service Desk package. More information:Deploy sample Unified Service Desk applications using Package Deployer

  2. Run the Configuration Migration tool, and click Import data in the main screen. For information about downloading the tool, see step 1 in Export Unified Service Desk configuration data.

  3. On the Login screen, provide authentication details to connect to your Dynamics 365 server from where you want to export data. If you have multiple organizations on the Dynamics 365 server, and want to select the organization from where to export the data, select the Always display list of available orgs check box. Click Login.

  4. If you have multiple organizations, and you selected the Always display list of available orgs check box, the next screen lets you choose the organization that you want to connect to. Select a Dynamics 365 organization to connect to.

  5. The next screen prompts you to provide the data file (.zip) to be imported. Browse to the data file, select it, and then click Import Data.

  6. The next screen displays the import status of your records. The data import is done in multiple passes to first import the foundation data while queuing up the dependent data, and then import the dependent data in the subsequent passes to handle any data dependencies or linkages. This ensures clean and consistent data import.

  7. Click Exit to close the tool.

You can build a custom package to include the configuration data that you exported from your existing instance of Unified Service Desk. To create a custom package for deploying the Unified Service Desk configuration data, you will use all the existing files in one of the default Unified Service Desk packages, and replace the standard configuration data with your Unified Service Desk configuration data that you exported. You can create a custom package for Unified Service Desk using the Microsoft Dynamics 365 SDK template for Visual Studio.

  • Download the Unified Service Desk package (self-extracting executable file), and double-click the file to extract the contents. You will use the files under one of the default packages to create a sample application. In this example, you’ll use the files under the Base package (<ExtractedFolder>\USDPackageDeployer\BasePackage).

  • Ensure that you know the prerequisites and how to create a custom package by using the Dynamics 365 SDK template for Microsoft Visual Studio. For detailed information about using template to create a package, see MSDN: Create packages for CRM Package Deployer.

  • Download the CRM SDK package (.exe file), and extract it to locate the PackageDeployer folder under the <ExtractedFolder>\SDK\Tools\ folder. This folder contains assemblies required for creating a custom project by using Visual Studio.

  • Install the template (CRMSDKTemplates.vsix) from the Dynamics 365 SDK package that you extracted in the previous step. The file is available under the SDK\Templates folder.

  1. Start Visual Studio, and create a new project by using the Dynamics 365 Package template.

    New project for creating a custom package
  2. In the Solution Explorer pane, expand PkgFolder, and delete the ImportConfig.xml file.

  3. Add all the existing solutions, import configuration, and other files except for the default configuration data file from one of the default Unified Service Desk packages to the Visual Studio project. In this example, we will use the Base package. Add the following files from the <ExtractedFolder>\USDPackageDeployer\BasePackage folder to PkgFolder in your Visual Studio solution:

    • DynamicsUnifiedServiceDesk_1_0_managed.zip

    • ImportConfig.xml

    • UII Option.csv

    • UiiforMicrosoftDynamicsCRM3_0_managed.zip

    • UIIOption.xml

    • UsdBaseCustomization_1_0_managed.zip

  4. Add the configuration data file (.zip) that you exported earlier from your existing instance of Unified Service Desk.

  5. For each file that you added under the PkgFolder folder, in the Properties pane, set the Copy to Output Directory value to Copy Always. This ensures that the files you added are available in the generated package.

    Copy to output directory field
  6. Double-click the ImportConfig.xml file under PkgFolder to edit it. Update the value of the crmmigdataimportfile parameter to match the name of the exported file (.zip) that you added in step 5.

  7. Double-click the PackageTemplate.cs file to update the package name and description. For detailed information about this, see MSDN: Create packages for CRM Package Deployer in the Dynamics 365 SDK help.

  8. Save your project, and then build it (Build > Build Solution) to create the package. All the contents in the <Project>\Bin\Debug folder are your package. Note that an assembly file (.dll) is created with the same name as your Visual Studio project name; this file contains the custom code that that you created in the previous step.

  9. Copy the entire contents from your Visual Studio project debug folder (<Project>\Bin\Debug) to the PackageDeployer folder, that is, at the same location as the PackageDeployer.exe file. You are prompted to replace some files; accept the confirmation to replace the files in the Package Deployer tool folder.

  10. After the files are copied, run the tool by double-clicking the PackageDeployer.exe file.

  11. You will be prompted to specify the credentials of the target Dynamics 365 server. Specify the details, and proceed.

  12. In the package selection screen, select your custom package to deploy, and follow the wizard screens to deploy the package.

    More information:Deploy sample Unified Service Desk applications using Package Deployer

Unified Service Desk 2.0

© 2016 Microsoft. All rights reserved. Copyright

Community Additions

ADD
Show: