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

Перенос сайтов со стандартной моделью данных на расширенную модель данных (предварительная версия)

  • Статья

[Данный раздел посвящен предварительному выпуску и может быть изменен.]

Из этой статьи вы узнаете, как перенести существующий сайт со стандартной моделью данных на расширенную модель данных.

Важно

  • Эта функция находится на этапе предварительной версии.
  • Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

Предварительные условия

Шаг 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 list

  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]

Заметка

  • Вы можете найти идентификатор Portal, перейдя на веб-сайт с добавлением '/_services/about' к URL-адресу веб-сайта. Чтобы просмотреть эти параметры, у пользователя должна быть веб-роль со всеми назначенными разрешениями на доступ к веб-сайту.
  • После обновления версии модели данных сайта запись веб-сайта, связанная со стандартной моделью данных, будет деактивирована. Вместо этого сайт теперь будет ссылаться на запись веб-сайта, связанную с расширенной моделью данных.
  • Пользователь должен иметь любую из следующих ролей для выполнения команды миграции с аргументами updateDatamodelVersion или revertToStandardDataModel. Поскольку это приведет к выполнению действий администратором по переключению вашего сайта на расширенную модель данных или наоборот.

Пример

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 во фрагменте кода Liquid

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

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

Расширенная модель данных: вместо использования веб-ссылок через тег Liquid entities используйте соответствующие объекты Liquid. entities[adx_weblinks] напрямую. В этом случае entities['adx_weblinks'] можно заменить объектом Liquid weblinks.

Ссылки на таблицы adx при извлечении XML

Чтобы исправить эту настройку в расширенной модели данных, замените ссылки на таблицы adx в Fetch XML прямыми ссылками на виртуальные таблицы расширенной модели данных mspp. Кроме того, вы можете использовать таблицу Компонент сайта (логическое имя powerpagecomponent) вместе с таблицей Тип компонента (логическое имя powerpagecomponenttype) для получения соответствующих ссылок.

Стандартная модель данных: имя таблицы adx_webrole используется в запросе на выборку 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
Список (List) 17
Разрешение в отношении таблицы 18
Расширенная форма 19
Шаг расширенной формы 20
Метаданные расширенной формы 21
Место размещения опроса 24
Место размещения рекламы 26
Бот (потребительский) 27
Профиль разрешений столбца 28
Разрешение столбца 29
Перенаправление 30
Правило перехода состояния публикации 31
Ярлык 32
Облачный поток 33
Компонент взаимодействия с пользователем 34

Настраиваемый рабочий процесс и подключаемые модули для таблиц adx

Чтобы исправить эту настройку в расширенной модели данных, необходимо выполнить рефакторинг рабочего процесса и логику подключаемого модуля и перерегистрировать его в соответствующей таблице сайта.

Например, если пользователь зарегистрировал рабочий процесс/подключаемый модуль в Основной сущности как Веб-страницу (логическое имя adx_webpage) в стандартной модели данных, то код в рабочем процессе/подключаемом модуле необходимо изменить на таблицу Компонент сайта (логическое имя powerpagecomponent) и ее атрибуты для расширенной модели данных.

Используйте таблицу компонентов сайта в рабочем процессе и ее атрибуты для расширенной модели данных

Известные проблемы

Команда миграции обрабатывает только пакет из 5000 записей из стандартной модели данных в расширенную модель данных.