Переміщуйте дані конфігурації між різними середовищами та організаціями за допомогою засобу перенесення конфігурації

Засіб перенесення конфігурації дає змогу переміщувати дані конфігурації між середовищами та організаціями. Дані конфігурації використовуються для визначення настроюваних функцій у програмах для взаємодії з клієнтами (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 дозволяє вам:

• Вибирати сутності та поля, куди потрібно експортувати конфігураційні дані.

• Уникати повторюваних записів у цільовій системі, визначаючи умову унікальності для кожної сутності на основі поєднання полів у сутності, яка використовується для порівняння зі значеннями в цільовій системі. Якщо немає відповідних значень, у цільовій системі створюється унікальний запис. Якщо відповідний запис знайдено, у цільовій системі запис буде оновлено.

  Нотатка

  Якщо умову пошуку повторів (унікальності) не вказано для експортованої сутності, засіб використовує назву основного поля сутності для порівняння з наявними даними в цільовій системі.

• Вимкнути плагіни перед експортуванням даних, а потім знову ввімкнути їх у цільовій системі після завершення імпорту для всіх або вибраних сутностей.

• Перевірка схеми для вибраних сутностей, які будуть експортуватися, щоб переконатися, що є всі необхідні дані/відомості.

• Повторне використання наявної схеми для експортування даних із вихідної системи.

• Автоматично перемістіть поля "Дата й час" вперед під час імпорту для тестових середовищ.

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

Інструмент міграції конфігурації доступний у вигляді пакета NuGet або ви можете завантажити інструмент за допомогою Power Platform CLI.

Як працює інструмент Configuration Migration?

На схемі нижче показано, як інструменти Configuration Migration використовується для міграції даних конфігурації.

Визначте схему вихідних даних для експорту: Файл схеми (.xml) містить інформацію про дані, які потрібно експортувати, наприклад сутності, атрибути, зв’язки, визначення унікальності даних і те, чи слід вимкнути плагіни перед експортом даних. Додаткові відомості: Створення схеми експорту даних конфігурації

Використання схеми для експорту даних: використовуйте файл схеми, щоб експортувати дані в .zip файл, який містить дані та схему експортованих даних. Додаткові відомості: Створення схеми експорту даних конфігурації

Імпортуйте експортовані дані: використовуйте експортовані дані (файл .zip) для імпорту в цільове середовище. Імпорт даних здійснюється у декілька проходів. Спочатку імпортуються основні дані, а залежні від них ставляться в чергу. Потім імпортуються дані, залежні від основних, залежні від залежних і т.д., доки не буде опрацьовано всі залежності або зв'язки даних. Це гарантує чистий і узгоджений імпорт даних. Додаткові відомості: Імпортувати дані конфігурації

Виправлення помилок міграції даних конфігурації із використанням файлів журналів

Засіб перенесення конфігурації забезпечує підтримку журналювання, щоб отримати докладні відомості про можливі помилки під час входу в середовище за допомогою інструменту, дії, що виконуються інструментом під час визначення схеми та експортування/імпортування даних конфігурації, та інформацію про дані, які було імпортовано за допомогою інструмента. За допомогою засобу створено три файли журналу, які доступні в такому місці на комп’ютері, де ви використовуєте засіб: c:\Users\UserName<\AppData\Roaming\Microsoft\>\VersionMicrosoft Dataverse Configuration Migration Tool<.>

• Login_ErrorLog.log: надає інформацію про проблеми, які сталися під час використання інструмента для входу до середовища. Якщо проблеми виникають під час входу до системи, на екрані входу інструмента з'являється повідомлення з посиланням на цей файл журналу. Повідомлення інформує, що під час обробки запиту входу сталася помилка, і користувач може переглянути журнал помилок. Можна клацнути посилання в повідомленні, щоб переглянути цей файл журналу. Файл журналу створюється вперше, коли в інструменті виникають будь-які проблеми входу. Після цього файл журналу використовується для запису відомостей про проблему входу кожного разу, коли вона виникає.

• DataMigrationUtility.log: містить докладні відомості про кожне завдання, що виконувалося в засобі під час останнього запуску. Файл журналу з інструмента можна переглянути, вибравши меню Журнали на головному екрані й натиснувши Запуск журналу.

• ImportDataDetail.log: надає детальну інформацію про дані, які імпортуються в останнє завдання імпортування за допомогою інструмента. Під час кожного запуску завдання імпортування за допомогою цього інструмента наявні докладні відомості з файлу журналу переміщуються до файлу з назвою ImportDataDetail._old.log у тому ж каталозі, а файл ImportDataDetail.log відображає відомості про останнє завдання імпортування, яке було виконано за допомогою інструмента. Цей файл журналу можна переглянути з інструмента, вибравши меню Журнали на головному екрані й натиснувши Журнал останнього імпорту.

Найкращий спосіб перенесення даних конфігурації за допомогою інструмента

Нижче зазначено, що ви повинні розглянути під час використання цього інструмента для перенесення даних конфігурації:

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

• Імпортуйте експортовані дані у невиробниче середовище (бажано, щоб це був дзеркальний знімок виробничого середовища), щоб пересвідчитися в правильності результатів імпорту даних.

• Резервне копіювання виробничого середовища перед імпортуванням даних.

Обмеження

• Перенесення сутності «Календар» не підтримується.
• Перенесення стовпця «Зображення» не підтримується.

Див. також

Завантаження інструментів із NuGet
Створення схеми експорту даних конфігурації
Змінення схеми даних конфігурації
Імпорт даних конфігурації
Керування конфігурацією каталогу продуктів