Перемещение данных конфигурации между средами и организациями с помощью средства миграции конфигурации

  • Статья

Средство миграции конфигурации позволяет перемещать данные конфигурации между средами и организациями. Данные конфигурации используются для определения настраиваемых функций в приложениях Customer Engagement (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing и Dynamics 365 Project Service Automation) и обычно хранятся в настраиваемых сущностях. Данные конфигурации отличаются от данных конечных пользователей (организация, контакты и т. д.). Типичный пример данных конфигурации — это параметры, которые определяются в Unified Service Desk для Dynamics 365 для настройки настраиваемого приложения агента центра обработки вызовов. Сущности Unified Service Desk, а также данные конфигурации, хранящиеся в сущностях, определяют приложение агента. Дополнительные сведения об Unified Service Desk см. в Руководстве по Unified Service Desk.

Средство Configuration Migration Tool позволяет выполнять следующие действия:

  • Выбрать сущности и поля, из которых требуется экспортировать данные конфигурации.

  • Избегать повторяющихся записей в целевой системе путем определения условия уникальности для каждой сущности на основе сочетания полей в сущности, которое используется для сравнения значений с целевой системой. При отсутствии совпадающих значений в целевой системе создается уникальная запись. Если совпадающая запись найдена, запись в целевой системе обновляется.

    Заметка

    Если условие поиска повторяющихся данных (уникальности) для экспортируемой сущности, не определено, средство использует для сравнения с существующими данными в целевой системе имя первичного поля сущности.

  • Отключить подключаемые модули перед экспортом данных, а затем сновавключить их в целевой системе после завершения импорта — для всех сущностей или выбранных сущностей.

  • Проверить схему для выбранных экспортируемых сущностей, чтобы убедиться, что все обязательные данные присутствуют.

  • Использовать существующую схему для экспорта данных из исходной системы.

  • Автоматически перемещать поля DateTime вперед при импорте для демонстрационных сред.

  • Внедрять экспортированные модули, созданные этим средством (файлы схем и данных) в другие программы. Например, можно использовать экспортированные данные в Package Deployer вместе с другими файлами решения и данные для создания и развертывания пакетов в среде. Дополнительная информация: Развертывание пакетов с помощью Package Deployer

Средство миграции конфигурации доступно в виде NuGet пакета, или вы можете скачать средство с помощью Power Platform CLI.

Как работает средство Configuration Migration?

На следующей схеме показано, как средство миграции конфигурации Configuration Migration Tool используется для переноса данных конфигурации.

Схема последовательности операций процесса миграции конфигурации.

Символ шага 1Определение схемы исходных данных, которые требуется экспортировать: файл схемы (XML) содержит сведения о данных, которые требуется экспортировать, таких как сущности, атрибуты, отношения, определение уникальности данных, а также о том, следует ли отключить перед экспортом данных подключаемые модули. Дополнительные сведения: Создание схемы для экспорта данных конфигурации

Символ шага 2Использование схемы для экспорта данных: используйте файл схемы, чтобы экспортировать данные в ZIP-файл, содержащий данные и схему экспортированных данных. Дополнительные сведения: Создание схемы для экспорта данных конфигурации

Символ шага 3Импорт экспортированных данных: используйте экспортированные данные (ZIP-файл) для импорта в целевую среду. Импорт данных осуществляется в несколько проходов. Сначала импортируются основные данные, в то время как зависимые данные поступают в очередь. В последующих проходах выполняется импорт зависимых данных, что позволяет обрабатывать зависимости и связи данных. Это гарантирует чистый импорт данных. Дополнительные сведения: Импорт данных конфигурации

Устранение проблем переноса данных с помощью файлов журнала

Средство миграции конфигурации поддерживает ведение журнала для получения подробных сведений об ошибках, которые могут возникать при входе в среду с помощью средства, действиях, выполняемых средством во время определения схемы и экспорте или импорте данных конфигурации, а также сведения о данных, которые были импортированы с помощью средства. Средство создает три файла журнала, которые доступны в следующем расположении на компьютере, где оно запущено: c:\Users\<имя_пользователя>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<версия>.

  • Login_ErrorLog.log: содержит информацию о проблемах, возникших при использовании инструмента для входа в среду. Если при входе возникла какая-либо проблема, на экране входа средства появляется сообщение со ссылкой на этот файл журнала. Сообщение заявляет, что при обработке запроса на вход произошла ошибка и пользователь может просмотреть журнал ошибок. Можно щелкнуть ссылку в сообщении, чтобы просмотреть этот файл журнала. Этот файл журнала создается при первом возникновении ошибки в средстве при входе в систему. В дальнейшем этот файл журнала используется для записи информации обо всех возникающих проблемах единого входа.

  • DataMigrationUtility.log: содержит подробную информацию о каждой задаче, выполненной при последнем запуске средства. Чтобы просмотреть файл журнала из средства, щелкните меню Журналы на главном экране и выберите Ведущийся журнал.

  • ImportDataDetail.log: содержит подробную информацию о данных, импортированных в ходе последнего импорта с помощью средства. При каждом выполнении импорта с помощью этого средства существующие данные из файла журнала переносятся в файл ImportDataDetail._old.log в том же каталоге, а в файл ImportDataDetail.log помещается информация о последнем импорте, выполненном с помощью средства. Чтобы просмотреть этот файл журнала из средства, щелкните меню Журналы на главном экране и выберите Журнал последнего импорта.

Рекомендации по переносу данных конфигурации с помощью средства

При использовании этого средства для переноса данных конфигурации рекомендуется иметь в виду следующее.

  • При создании схемы экспортируемых данных необходимо определять соответствующие правила уникальности для каждой сущности во избежание непреднамеренного обновления данных в целевой системе.

  • Импортируйте данные в подготовительную среду (желательно зеркальный образ рабочей среды), чтобы убедиться, что результаты импорта соответствуют вашим ожиданиям.

  • Создайте резервную копию рабочей среды, прежде чем импортировать данные.

Ограничения

  • Перенос сущности календаря не поддерживается.
  • Перенос столбца «Изображение» не поддерживается.

См. также

Загрузка средств из NuGet
Создание схемы для экспорта данных конфигурации
Изменение схемы данных конфигурации
Импорт данных конфигурации
Управление настройкой каталога продукции