Перемещение данных конфигурации между средами и организациями с помощью средства миграции конфигурации
Средство миграции конфигурации позволяет перемещать данные конфигурации между средами и организациями. Данные конфигурации используются для определения настраиваемых функций в приложениях 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 используется для переноса данных конфигурации.
Определите схему исходных данных для экспорта: Файл схемы (.xml) содержит информацию о данных, которые вы хотите экспортировать, например, сущности, атрибуты, Отношения, определение уникальности данных и необходимость отключения подключаемых модулей перед экспортом данных. Дополнительные сведения: Создание схемы для экспорта данных конфигурации
Используйте схему для экспорта данных: используйте файл схемы для экспорта данных в файл .zip, содержащий данные и схему экспортированных данных. Дополнительные сведения: Создание схемы для экспорта данных конфигурации
Импортируйте экспортированные данные: используйте экспортированные данные (файл .zip) для импорта в целевую среду. Импорт данных осуществляется в несколько проходов. Сначала импортируются основные данные, в то время как зависимые данные поступают в очередь. В последующих проходах выполняется импорт зависимых данных, что позволяет обрабатывать зависимости и связи данных. Это гарантирует чистый импорт данных. Дополнительные сведения: Импорт данных конфигурации
Устранение проблем переноса данных с помощью файлов журнала
Средство миграции конфигурации поддерживает ведение журнала для получения подробных сведений об ошибках, которые могут возникать при входе в среду с помощью средства, действиях, выполняемых средством во время определения схемы и экспорте или импорте данных конфигурации, а также сведения о данных, которые были импортированы с помощью средства. Инструмент создает три файла журнала, которые доступны в следующем расположении на компьютере, где он запущен: c:\Users\<Имя пользователя>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Версия>.
Login_ErrorLog.log: предоставляет информацию о проблемах, возникших при использовании инструмента для входа в среду. Если при входе возникла какая-либо проблема, на экране входа средства появляется сообщение со ссылкой на этот файл журнала. Сообщение заявляет, что при обработке запроса на вход произошла ошибка и пользователь может просмотреть журнал ошибок. Можно щелкнуть ссылку в сообщении, чтобы просмотреть этот файл журнала. Этот файл журнала создается при первом возникновении ошибки в средстве при входе в систему. В дальнейшем этот файл журнала используется для записи информации обо всех возникающих проблемах единого входа.
DataMigrationUtility.log: предоставляет подробную информацию о каждой задаче, выполненной в инструменте во время последнего запуска. Чтобы просмотреть файл журнала из средства, щелкните меню Журналы на главном экране и выберите Ведущийся журнал.
ImportDataDetail.log: предоставляет подробную информацию о данных, импортированных в последнем задании импорта с помощью инструмента. При каждом выполнении импорта с помощью этого средства существующие данные из файла журнала переносятся в файл ImportDataDetail._old.log в том же каталоге, а в файл ImportDataDetail.log помещается информация о последнем импорте, выполненном с помощью средства. Чтобы просмотреть этот файл журнала из средства, щелкните меню Журналы на главном экране и выберите Журнал последнего импорта.
Рекомендации по переносу данных конфигурации с помощью средства
При использовании этого средства для переноса данных конфигурации рекомендуется иметь в виду следующее.
При создании схемы экспортируемых данных необходимо определять соответствующие правила уникальности для каждой сущности во избежание непреднамеренного обновления данных в целевой системе.
Импортируйте данные в подготовительную среду (желательно зеркальный образ рабочей среды), чтобы убедиться, что результаты импорта соответствуют вашим ожиданиям.
Создайте резервную копию рабочей среды, прежде чем импортировать данные.
Ограничения
- Перенос сущности календаря не поддерживается.
- Перенос столбца «Изображение» не поддерживается.
См. также
Загрузите инструменты с сайта NuGet
Создать схему для экспорта данных конфигурации
Изменить схему данных конфигурации
Импорт данных конфигурации
Управление конфигурацией каталога продукции