Поділитися через


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

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

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

Важливо

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

вимоги

Крок 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 значення:

Приклад

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]

Нотатка

  • Ідентифікатор порталу можна знайти, перейшовши на веб-сайт, додавши до URL-адреси веб-сайту «/_services/about». Щоб переглянути ці опції, користувач повинен мати веб-роль із призначеними всіма дозволами на доступ до веб-сайту.
  • Після оновлення версії моделі даних сайту запис веб-сайту, пов’язаний зі стандартною моделлю даних, буде деактивовано. Замість цього сайт тепер буде посилатися на запис веб-сайту, пов’язаний з удосконаленою моделлю даних.
  • Користувач повинен мати будь-яку з наведених нижче ролей для виконання команди міграції з updateDatamodelVersion аргументами or revertToStandardDataModel . В якості цього буде виконуватися дія адміністратора для перемикання вашого сайту на модель даних enahance або навпаки.

Приклад

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_webpage містить користувальницький стовпець як contoso_pagetype.

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

Створення таблиці contoso_webpage в удосконаленій моделі даних для виправлення коду

Зв’язок між користувацькими таблицями та таблицями 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 %}

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

Тип компонентів Значення
Стан публікації 1
Веб-сторінка 2
Веб-файл 3
Набір веб-посилань 4
Веб-посилання 5
Шаблон сторінки 6
Фрагмент вмісту 7
Веб-шаблон 8
Настройка сайту 9
Правило управління доступом до веб-сторінки 10
Веб-роль 11
Доступ до веб-сайту 12
Маркер сайту 13
Базова форма 15
Метадані базової форми 16
Список 17
Дозвіл для таблиці 18
Розширена форма 19
Крок розширеної форми 20
Метадані розширеної форми 21
Розміщення опитування 24
Розміщення рекламних оголошень 26
Споживач бота 27
Профіль дозволів для стовпців 28
Дозвіл для стовпців 29
Переспрямувати 30
Правило переходу стану публікації 31
Ярлик 32
Хмарний цикл 33
Компонент інтерфейсу 34

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

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

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

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

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

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