Міграція сайтів зі стандартними моделями даних на розширену модель даних (підготовча версія)
[Ця тема є передрелізною документацією та може бути змінена.]
З цієї статті ви дізнаєтеся, як перенести наявний сайт зі стандартною моделлю даних на розширену модель даних.
Важливо
- Це функція попереднього перегляду.
- Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.
вимоги
- Щоб перенести сайти на розширену модель даних, потрібно встановити 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. Завантажте й перевірте настроювання для наявних стандартних метаданих сайту
Відкрийте командний рядок.
Використовуйте наведену нижче команду для автентифікації в Dataverse організації для вашого Power Platform середовища, щоб завантажити запис веб-сайту для міграції.
pac auth create -u [Dataverse URL]
Приклад
pac auth create -u https://contoso-org.crm.dynamics.com
Більше інформації: pac auth create
За допомогою наведеної нижче команди створіть список веб-сайтів у поточній організації.
pac powerpages list
Більше інформації: pac список powerpages
Скористайтеся наведеною нижче командою, щоб завантажити звіт про налаштування.
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]
Нотатка
- Ідентифікатор порталу можна знайти, перейшовши на веб-сайт, додавши до URL-адреси веб-сайту «/_services/about». Щоб переглянути ці опції, користувач повинен мати веб-роль із призначеними всіма дозволами на доступ до веб-сайту.
- Після оновлення версії моделі даних сайту запис веб-сайту, пов’язаний зі стандартною моделлю даних, буде деактивовано. Замість цього сайт тепер буде посилатися на запис веб-сайту, пов’язаний з удосконаленою моделлю даних.
- Користувач повинен мати будь-яку з наведених нижче ролей для виконання команди міграції з
updateDatamodelVersion
аргументами orrevertToStandardDataModel
. В якості цього буде виконуватися дія адміністратора для перемикання вашого сайту на модель даних 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
Перенесіть виробничий сайт зі стандартної на вдосконалену модель даних
Перед міграцією виробничого сайту ми рекомендуємо створити повну копію виробничого сайту. Ми також рекомендуємо міграцію виробничого майданчика проводити в неробочий час.
Виконайте наведені нижче дії, щоб перенести свій виробничий сайт на модель розширеного використання даних.
- Спробуйте міграцію на сайті в скопійованому середовищі за допомогою команди PAC CLI
migrate-datamodel
. - Додавайте дані конфігурації сайту в кероване рішення та імпортуйте його виробниче середовище.
- Використовуйте команди 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 %}
Тип і значення компонентів сайту
Тип компонентів | Значення |
---|---|
Стан публікації | 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 записів зі стандартної моделі даних до моделі розширених даних.