Мигриране на сайтове със стандартен модел на данни към подобрен модел на данни (преглед)

[Тази тема е предварителна документация и подлежи на промяна.]

В тази статия научете как да мигрирате съществуващия си сайт със стандартен модел на данни към подобрен модел на данни.

Предварителни изисквания

• Трябва да инсталирате Microsoft Power Platform CLI с версия 1.31.6 или по-нова, за да мигрирате сайтовете си към подобрен модел на данни. Повече информация: Инсталиране на най-новия Power Platform CLI
• Dataverse Базов портален пакет 9.3.2307.x или по-нова версия. 
• Power Pages Основен пакет 1.0.2309.63 или по-висок. Повече информация: Актуализиране на Power Pages решението
• Ще трябва да разберете как да използвате Power Platform CLI, за Power Pages да изпълните стъпките за мигриране. Ако не сте запознати с Power Platform CLI in 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), за да извлечете съответните препратки.

Стандартен модел на данни:entities течен етикет се използва за достъп до стойностите на уеб връзките в {% assign app_weblinks= entities['adx_weblinks'] %} кода.

Подобрен модел на данни: Вместо да използвате уеб връзки чрез entities течен етикет, използвайте съответните течни обекти. entities[adx_weblinks] директно. В този случай entities['adx_weblinks'] може да бъде заменен с weblinks течен предмет.

Препратки към таблици на Adx във fetch xml

За да коригирате това персонализиране в подобрен модел на данни, заменете препратките към таблици adx във fetch xml с препратки към виртуални таблици на подобрен модел на данни. Като алтернатива можете да използвате таблицата Компонент на сайта (логическо име 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 %}

Тип и стойности на компонента на сайта

Персонализиран работен процес и плъгини в таблици на adx

За да се коригира това персонализиране в подобрен модел на данни, работният поток и логиката на плъгина трябва да бъдат преработени и пререгистрирани в съответната таблица на сайта.

Например, ако потребител е регистрирал работния поток/плъгина в таблицата Основен обект като уеб страница (логическо име adx_webpage) в стандартния модел на данни, тогава кодът в работния поток/плъгина трябва да бъде променен на таблица Компонент на сайта (логическо име powerpagecomponent) и неговите атрибути за подобрения модел на данни.

Познати проблеми

Командата за мигриране обработва само партида от 5K записи от стандартния модел на данни към подобрения модел на данни.