Преместване на конфигурационни данни между среди и организации с Configuration Migration Tool
Инструментът Мигриране на конфигурация ви позволява да премествате конфигурационни данни между среди и организации. Конфигурационните данни се използват за дефиниране на персонализирана функционалност в приложения за ангажиране на клиенти (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing и Dynamics 365 Project Service Automation) и обикновено се съхранява в потребителски обекти. Конфигурационните данни са различни от данните на крайния потребител (акаунт, контакти и т.н.). Типичен пример за конфигурационни данни е това, което дефинирате в Unified Service Desk for Dynamics 365 за конфигуриране на персонализирано приложение-агент за център за обаждания. Обектите на Unified Service Desk, както и конфигурационните данни, които се съхраняват в обектите, определят приложението-агент. За повече информация относно Unified Service Desk вижте Ръководство за Unified Service Desk.
Инструментът Мигриране на конфигурация ви дава възможност да:
Изберете обектите и полетата от мястото, където искате да експортирате конфигурационните данни.
Избягвайте дублиращи се записи в целевата система, като дефинирате условие за уникалност за всеки обект на базата на комбинация от полета в обекта, която се използва за сравнение със стойностите на целевата система. Ако няма съответстващи стойности, се създава уникален запис в целевата система. Ако се намери съвпадащ запис, записът се актуализира в целевата система.
Бележка
Ако не е указано условие за откриване на дублиращ се запис (уникалност) за обект, който се експортира, инструментът използва името на първичното поле на обекта за сравнение със съществуващите данни в целевата система.
Забранете добавките преди експортирането на данни и след това повторно ги разрешете в целевата система, след като импортирането завърши за всички обекти или избрани обекти.
Проверете схемата за избраните обекти, които ще експортирате, за да се уверите, че са налични всички необходими данни/информация.
Използвайте повторно съществуваща схема, за да експортирате данните от системата-източник.
Автоматично преместване на полета DateTime напред при импортиране за демонстрационни среди.
Вградете експортираните модули, създадени от този инструмент (схема и файлове с данни) в други програми. Можете например да използвате експортираните данни в Package Deployer заедно с други файлове с решения и данни, за да създадете и внедрите пакети в среда. Повече информация: Разполагане на пакети чрез Package Deployer
Инструментът за мигриране на конфигурацията е наличен като NuGet пакет или можете да изтеглите инструмента с помощта Power Platform на CLI.
Как работи на инструментът Мигриране на конфигурация?
Следващата диаграма илюстрира как инструментът Мигриране на конфигурация се използва за мигриране на конфигурационни данни.
Дефиниране на схемата на данните източник за експортиране: Файлът със схемата (.xml) съдържа информация за данните, които искате да експортирате, като например обектите, атрибутите, релациите, дефиницията на уникалността на данните и дали добавките трябва да бъдат забранени преди експортирането на данните. Още информация: Създаване на схема за експортиране на данни на конфигурация
Използване на схемата за експортиране на данни: Използвайте файла със схема, за да експортирате данните в .zip файл, който съдържа данните и схемата на експортираните данни. Още информация: Създаване на схема за експортиране на данни на конфигурация
Импортиране на експортираните данни: Използвайте експортираните данни (.zip файл), за да импортирате в целевата среда. Импортирането на данни се извършва на няколко етапа, за да се импортират първо основните данни, докато зависимите данни изчакват на опашка, след което се импортират зависимите данни в следващите етапи, за да се обработят всички зависимости или свързвания между данните. Това гарантира чисто импортиране на данни. Повече информация: Импортиране на данни за конфигурацията
Отстраняване на проблеми с мигрирането на конфигурационни данни с помощта на регистрационни файлове
Инструментът Мигриране на конфигурация осигурява поддръжка за регистриране, за да получите подробна информация за грешките, които могат да възникнат при влизане в средата с помощта на инструмента, дейностите, изпълнявани от инструмента по време на дефинирането на схемата и експортирането/импортирането на конфигурационните данни, и информация за данните, които са били импортирани с помощта на инструмента. Съществуват три регистрационни файла, генерирани от инструмента, които са достъпни на следното местоположение на компютъра, на който стартирате инструмента: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version>.
Login_ErrorLog.log: предоставя информация за проблемите, възникнали когато използвате инструмента, за да влезете в средата. Ако има някакви проблеми при влизане, ще се появи съобщение на входния екран на инструмента с връзка към този файл. Съобщението гласи, че е възникнала грешка при обработката на заявката за влизане и потребителят може да прегледа регистрационния файл с грешките. Можете да щракнете върху връзката в съобщението, за да видите този файл. Регистрационният файл се създава първия път, когато срещнете някакви проблеми с влизането в инструмента. След това в регистрационният файл се използва за регистриране на информация за проблеми при влизане при всеки такъв случай.
DataMigrationUtility.log: предоставя подробна информация за всяка задача, изпълнявана в инструмента по време на последното изпълнение. Можете да видите регистрационния файл от инструмента, като щракнете върху менюто Регистрационни файлове на главния екран и щракнете върху Стартиран регистрационен файл.
ImportDataDetail.log: предоставя подробна информация за данните, импортирани в последната задача за импортиране с помощта на инструмента. Всеки път, когато стартирате задача за импортиране с помощта на този инструмент, съществуващите данни от регистрационния файл се преместват във файл, наречен ImportDataDetail._old.log, в същата директория, а файлът ImportDataDetail.log показва информация за последната задача за импортиране, извършена с помощта на инструмента. Можете да видите регистрационния файл от инструмента, като щракнете върху менюто Регистрационни файлове на главния екран, след което щракнете върху Регистрационен файл на последното импортиране.
Най-добри практики за мигриране на конфигурационните данни с помощта на инструмента
По-долу са описани нещата, които трябва да обмислите при използването на този инструмент за мигриране на конфигурационните данни:
При създаване на схемата на данните за експортиране трябва да дефинирате правила за уникалност, подходящи за всеки обект, за да избегнете непреднамерените актуализации на данните в целевата система.
Импортирайте експортираните данни в предпроизводствена среда (за предпочитане огледален образ на производствената среда), за да се уверите, че резултатите за импортираните данни са каквито очаквате.
Архивирайте вашата производствена среда преди импортирането на данните.
Ограничения
- Мигрирането на обекта на календара не се поддържа.
- Мигрирането на колоната Изображение не се поддържа.
Вижте също
Изтегляне на инструменти от NuGet
Създаване на схема за експортиране на данни на конфигурация
Промяна на схема за конфигурационни данни
Импортиране на конфигурационни данни
Управление на конфигурацията на продуктов каталог