Migrar els llocs del model de dades estàndard al model de dades millorat (versió preliminar)

[Aquest tema és documentació preliminar i està subjecte a canvis.]

En aquest article, obteniu informació sobre com podeu migrar el lloc del model de dades estàndard existent al model de dades millorat.

Requisits previs

• Heu d'instal·lar Microsoft Power Platform la CLI amb la versió 1.31.6 o superior per migrar els vostres llocs al model de dades millorat. Més informació: Instal·lar la CLI més recent Power Platform
• Dataverse Paquet de portal base 9.3.2307.x o superior. 
• Power Pages Paquet bàsic 1.0.2309.63 o superior. Més informació: Actualitzar la Power Pages solució
• Haureu d'entendre com utilitzar Power Platform la CLI per Power Pages completar els passos de migració. Si no esteu familiaritzat amb Power Platform la CLI Power Pages, potser voldreu revisar aquest Power Platform tutorial de la CLI i fer referència a les ordres de la CLI PAC per treballar-hi Power Pages.

Pas 1. Baixeu i comproveu la personalització per a les metadades dels llocs estàndards existents

1. Obriu un indicador d'ordres.

2. Utilitzeu l'ordre següent per autenticar-vos a l'organització Dataverse del vostre Power Platform entorn per baixar el registre del lloc web per a la migració.

   pac auth create -u [Dataverse URL]

   Exemple

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

   Més informació: pac auth create

3. Utilitzeu l'ordre següent per generar una llista de llocs web de l'organització actual.

   pac powerpages list

   Més informació: pac powerpages list

4. Utilitzeu l'ordre següent per baixar l'informe de personalització.

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

   Exemple

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

Si trobeu alguna personalització a l'informe baixat, seguiu les instruccions de l'informe per solucionar-la després de la migració al model de dades millorat. Més informació: Consideracions sobre la personalització del lloc en migrar llocs del model de dades estàndard al millorat

Pas 2. Migreu les dades del lloc del model estàndard al model de dades millorat

Utilitzeu l'ordre següent per migrar les dades del lloc al model de dades millorat.

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

El mode pot tenir 3 valors:

• configurationData: migra les metadades per al lloc web. Més informació: Llista de taules per emmagatzemar dades de configuració

• configurationDataReferences: migra les dades transaccionals per al lloc web. Més informació: Llista de taules per emmagatzemar dades no configuratives

• Tots: migreu els dos tipus de dades.

Exemple

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

L'eina de migració verifica les solucions. Si hi ha una solució de model de dades estàndard present sense una solució de model de dades millorada respectiva per a la plantilla esmentada, es mostra un advertiment: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Hi ha plantilles específiques, com ara el registre del programa i la programació i gestió de reunions, que requereixen que coincideixin amb paquets de models de dades millorats per garantir que el lloc web migrat funcioni correctament. Per obtenir aquests paquets de models de dades millorats, heu de crear un lloc nou per a la plantilla corresponent (l'entorn hauria d'estar habilitat per al model de dades millorat) per proporcionar solucions compatibles amb el model de dades millorat per a la migració.

Plantilles admeses per a la migració

Els llocs amb les plantilles següents s'admeten per a la migració:

• Disposició d'inici 1-5
• S'està processant l'aplicació
• Pàgina en blanc
• Registre del programa
• Planifica i administra reunions

Pas 3. Verificació de l'estat de migració

Utilitzeu l'ordre següent per verificar l'estat de migració del lloc web:

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

Exemple

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

Pas 4. Actualitzeu la versió del model de dades del lloc després d'una migració de dades correcta

Utilitzeu l'ordre següent actualitza la versió del model de dades del lloc:

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

Exemple

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

Reverteix el lloc migrat del model de dades millorat al estàndard

Utilitzeu l'ordre següent per revertir un lloc de model de dades estàndard a un model de dades millorat després de la migració:

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

Exemple

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

Migreu un lloc de producció d'un model de dades estàndard a un model de dades millorat

Abans de migrar un lloc de producció, us recomanem que creeu una còpia completa del lloc de producció. També recomanem que la migració del lloc de producció es dugui a terme durant l'horari no comercial.

Seguiu aquests passos per migrar el vostre lloc de producció al model de dades millorat:

1. Proveu la migració al lloc a l'entorn copiat mitjançant l'ordre PAC CLI migrate-datamodel .
2. Afegiu dades de configuració del lloc a solució administrada i importeu-les a l'entorn de producció.
3. Utilitzeu les ordres de la PAC CLI per migrar les dades que no són de configuració i acabar-les actualitzant la versió del model de dades per a la producció.

Consideracions per a la personalització del lloc en migrar llocs del model de dades estàndard al millorat

Aquesta secció ofereix una guia per arreglar la personalització per a la migració d'un lloc del model de dades estàndard al millorat.

Hi ha cinc tipus de personalitzacions de llocs a les taules de metadades adx:

• Columnes personalitzades a les taules de metadades adx
• Relació entre taules personalitzades i taules adx
• Referències de la taula Adx en líquid fragment de codi
• Referències de la taula Adx a fetch xml
• Flux de treball personalitzat i connectors a taules adx

Columnes personalitzades a les taules de metadades adx

Per solucionar aquesta personalització en el model de dades millorat, creeu una relació entre les taules del sistema i la taula personalitzada nova i migreu les dades a la taula nova.

Model de dades estàndard: la taula adx_webpage conté una columna personalitzada com a contoso_pagetype.

Model de dades millorat: Creeu una taula nova anomenada contoso_webpage. Això inclourà una columna anomenada contoso_pagetype i una columna de cerca contoso_webpage_id associada amb powerpagescomponent. Utilitzeu l' espai de treball de dades per a la creació de taules.

Relació entre taules personalitzades i taules adx

Per solucionar aquesta personalització en el model de dades millorat, creeu una relació entre les taules personalitzades i les taules del sistema.

Model de dades estàndard: la taula adx_webpage té una relació anomenada adx_webpage_contoso_pagelogs amb la contoso_pagelogs taula.

Model de dades millorat: Creeu una relació nova anomenada powerpagecomponent_contoso_pagelogs amb la taula contoso_webpage . Utilitzeu l' espai de treball de dades per a la creació de taules.

Referències de la taula Adx en líquid fragment de codi

Per solucionar aquesta personalització en el model de dades millorat, substituïu les referències de la taula adx en codi líquid per les referències mspp de taules virtuals del model de dades millorat. Alternativament, podeu utilitzar la taula Component del lloc (nom lògic powerpagecomponent) juntament amb el Tipus de component (nom lògic powerpagecomponenttype) per recuperar les referències corresponents.

Model de dades estàndard:entities l'etiqueta líquida s'utilitza per accedir als enllaços web valors del codi {% assign app_weblinks= entities['adx_weblinks'] %} .

Model de dades millorat: En lloc d'utilitzar enllaços web mitjançant entities etiqueta líquida, utilitzeu els objectes líquids respectius. entities[adx_weblinks] directament. En aquest cas entities['adx_weblinks'] es pot substituir per weblinks un objecte líquid.

Referències de taula Adx a fetch xml

Per corregir aquesta personalització en el model de dades millorat, substituïu les referències de taula adx a fetch xml per referències directes de taules virtuals del model de dades millorat. Alternativament, podeu utilitzar la taula Component del lloc (nom lògic powerpagecomponent) juntament amb el Tipus de component (nom lògic powerpagecomponenttype) per recuperar les referències corresponents.

Model de dades estàndard: El nom adx_webrole de la taula s'utilitza dins de la consulta xml de recuperació.

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

Model de dades millorat: Utilitzeu el component del lloc (nom powerpagecomponent lògic) juntament amb l'atribut Tipus de component (nom powerpagecomponenttype lògic) per recuperar les referències corresponents.

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

Tipus i valors del component del lloc

Flux de treball personalitzat i connectors a les taules adx

Per corregir aquesta personalització en el model de dades millorat, el flux de treball i la lògica del connector s'han de refactoritzar i tornar a registrar a la taula respectiva del lloc.

Per exemple, si un usuari ha registrat el flux de treball/connector a la taula Entitat principal com a pàgina web (nom adx_webpage lògic) al model de dades estàndard, el codi del flux de treball/connector s'ha de modificar a la taula Component del lloc (nom powerpagecomponent lògic) i els seus atributs per al model de dades millorat.

Problemes coneguts

L'ordre de migració només processa un lot de registres de 5K del model de dades estàndard al model de dades millorat.