Міграція сайтів зі стандартними моделями даних на розширену модель даних (підготовча версія)

[Ця тема є передрелізною документацією та може бути змінена.]

З цієї статті ви дізнаєтеся, як перенести наявний сайт зі стандартною моделлю даних на розширену модель даних.

вимоги

• Щоб перенести сайти на розширену модель даних, потрібно встановити Microsoft Power Platform інтерфейс командного рядка з версією 1.31.6 або новішою. Більше інформації: Встановіть останній Power Platform CLI
• Dataverse Пакет базового порталу 9.3.2307.x або вище. 
• Power Pages Основний пакет 1.0.2309.63 або вище. Додаткові відомості: Оновіть Power Pages рішення
• Вам потрібно буде зрозуміти, як використовувати Power Platform інтерфейс командного рядка, Power Pages щоб виконати кроки міграції. Якщо ви не знайомі з Power Platform CLI Power Pages, ви можете переглянути цей Power Platform посібник з CLI та ознайомитися з командами PAC CLI для роботи Power Pages.

Крок 1. Завантажте й перевірте настроювання для наявних стандартних метаданих сайту

1. Відкрийте командний рядок.

2. Використовуйте наведену нижче команду для автентифікації в Dataverse організації для вашого Power Platform середовища, щоб завантажити запис веб-сайту для міграції.

   pac auth create -u [Dataverse URL]

   Приклад

   pac auth create -u https://contoso-org.crm.dynamics.com

   Більше інформації: pac auth create

3. За допомогою наведеної нижче команди створіть список веб-сайтів у поточній організації.

   pac powerpages list

   Більше інформації: pac список powerpages

4. Скористайтеся наведеною нижче командою, щоб завантажити звіт про налаштування.

   pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

   Приклад

   pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

Якщо ви знайдете будь-які налаштування у завантаженому звіті, дотримуйтеся вказівок у звіті, щоб виправити їх після переходу на розширену модель даних. Додаткові відомості: Міркування щодо налаштування сайту під час міграції сайтів зі стандартної до розширеної моделі даних

Крок 2. Перенесіть дані сайту зі стандартної до розширеної моделі даних

За допомогою наведеної нижче команди можна перенести дані сайту в модель розширеного використання даних.

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

Режим може мати 3 значення:

• configurationData: перенесення метаданих для веб-сайту. Додаткові відомості: Список таблиць для зберігання даних конфігурації

• configurationDataReferences: перенесення даних транзакцій для веб-сайту. Додаткові відомості: Список таблиць для зберігання даних, не пов’язаних з конфігурацією

• Усі: міграція обох типів даних.

Приклад

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

Інструмент міграції перевіряє рішення. У разі наявності стандартного рішення моделі даних без відповідного рішення розширеної моделі даних для зазначеного шаблону, відображається попередження: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Існують спеціальні шаблони, такі як «Реєстрація в програмі» та «Планування та керування зустрічами», які вимагають узгодження пакетів розширених моделей даних для забезпечення належної роботи перенесеного веб-сайту. Щоб отримати ці пакети розширених моделей даних, необхідно створити новий сайт для відповідного шаблону (середовище має бути включено для розширеної моделі даних), щоб надати рішення, сумісні з розширеними моделями даних для міграції.

Підтримувані шаблони для міграції

Для міграції підтримуються сайти з такими шаблонами:

• Початковий макет 1-5
• Обробка програми
• Пуста сторінка
• Реєстрація в програмі
• Планування нарад і керування ними

Крок 3. Перевірте стан перенесення

За допомогою наведеної нижче команди перевірте статус міграції сайту:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

Приклад

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

Крок 4. Оновіть версію моделі даних сайту після успішного перенесення даних

Використовуйте таку команду для оновлення версії моделі даних сайту:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

Приклад

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

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

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

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

Приклад

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

Перенесіть виробничий сайт зі стандартної на вдосконалену модель даних

Перед міграцією виробничого сайту ми рекомендуємо створити повну копію виробничого сайту. Ми також рекомендуємо міграцію виробничого майданчика проводити в неробочий час.

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

1. Спробуйте міграцію на сайті в скопійованому середовищі за допомогою команди PAC CLI migrate-datamodel .
2. Додавайте дані конфігурації сайту в кероване рішення та імпортуйте його виробниче середовище.
3. Використовуйте команди PAC CLI, щоб перенести дані, не пов’язані з конфігурацією, і завершити їх, оновивши версію моделі даних для продакшн.

Міркування щодо налаштування сайту під час міграції сайтів зі стандартної до розширеної моделі даних

У цьому розділі наведено вказівки щодо налаштування виправлення для переходу сайту зі стандартної до розширеної моделі даних.

Існує п’ять типів налаштувань сайту в таблицях метаданих adx:

• Настроювані стовпці в таблицях метаданих adx
• Зв’язок між користувацькими таблицями та таблицями adx
• Посилання на таблицю Adx у рідкому фрагменті коду
• Посилання на таблиці Adx у fetch xml
• Користувацький робочий процес і плагіни на таблицях adx

Настроювані стовпці в таблицях метаданих adx

Щоб виправити це настроювання в моделі розширених даних, створіть зв’язок між системними таблицями та новою настроюваною таблицею та перенесіть дані в нову таблицю.

Стандартна модель даних: Таблиця adx_webpage містить користувальницький стовпець як contoso_pagetype.

Удосконалена модель даних: Створіть нову таблицю з contoso_webpage іменем. Це включатиме викликаний contoso_pagetype стовпець і стовпець contoso_webpage_id підстановки, який пов’язано з powerpagescomponent. Використовуйте робочу область «Дані» для створення таблиць.

Зв’язок між користувацькими таблицями та таблицями adx

Щоб виправити це настроювання в моделі розширених даних, створіть зв’язок між настроюваними та системними таблицями.

Стандартна модель даних: Таблиця adx_webpage має зв’язок з іменем adx_webpage_contoso_pagelogs таблиці contoso_pagelogs .

Удосконалена модель даних: створіть новий зв’язок з іменем powerpagecomponent_contoso_pagelogs таблиці contoso_webpage . Використовуйте робочу область «Дані» для створення таблиць.

Посилання на таблицю Adx у рідкому фрагменті коду

Щоб виправити цю кастомізацію в розширеній моделі даних, замініть посилання на таблицю adx у рідкому коді посиланнями на віртуальні таблиці з розширеною моделлю даних. Крім того, ви можете використовувати таблицю Компонент сайту (логічне ім’я powerpagecomponent) разом із атрибутом Тип компонента (логічне ім’я powerpagecomponenttype) для отримання відповідних посилань.

Стандартний тег даних model:entities liquid використовується для доступу до значень веб-посилань у {% assign app_weblinks= entities['adx_weblinks'] %} коді.

Покращена модель даних: замість використання веб-посилань через entities тег liquid, використовуйте відповідні рідкі об’єкти. entities[adx_weblinks] Безпосередньо. В цьому випадку entities['adx_weblinks'] його можна замінити рідким weblinks предметом.

Посилання на таблиці Adx у fetch xml

Щоб виправити цю кастомізацію в удосконаленій моделі даних, замініть посилання на таблиці adx у fetch xml на прямі посилання віртуальних таблиць із розширеною моделлю даних. Крім того, ви можете використовувати таблицю Компонент сайту (логічне ім’я powerpagecomponent) разом із атрибутом Тип компонента (логічне ім’я powerpagecomponenttype) для отримання відповідних посилань.

Стандартна модель даних: ім’я adx_webrole таблиці використовується в запиті fetch xml.

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

Покращена модель даних: використовуйте компонент сайту (логічне ім’я ) у поєднанні з атрибутом типу компонента (логічне ім’я powerpagecomponent) для отримання відповідних посилань. powerpagecomponenttype

{% fetchxml app_webroles %}
<fetch>
 <entity name='powerpagecomponent'>
  <attribute name='adx_name'/>
  <filter type='and'>
   <condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
  <entity>
</fetch>
{% endfetchxml %}

Тип і значення компонентів сайту

Користувацький робочий процес і плагіни на таблицях adx

Щоб виправити цю кастомізацію в розширеній моделі даних, робочий процес і логіку плагіна потрібно провести рефакторинг і повторно зареєструвати у відповідній таблиці сайту.

Для екземпляр, якщо користувач зареєстрував робочий процес/плагін у таблиці Primary Entity як веб-сторінка (логічне ім’я adx_webpage) у стандартній моделі даних, то код у робочому процесі/плагіні має бути змінений на таблицю компонентів сайту (логічне ім’я powerpagecomponent) та її атрибути для розширеної моделі даних.

Відомі проблеми

Команда міграції обробляє лише пакет із 5K записів зі стандартної моделі даних до моделі розширених даних.