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.
Important
- Aquesta és una característica de visualització prèvia.
- Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.
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. Baixar i comprovar la personalització de les metadades estàndard del lloc existents
Obriu un indicador d'ordres.
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
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
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. Migrar les dades del lloc del model de dades estàndard al 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. Verificar l'estat de la 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
Nota
Si la migració del vostre lloc web triga més del previst, pot ser degut al volum de dades. Si es tanca l'indicador d'ordres, obriu un indicador d'ordres nou i utilitzeu-lo en aquest pas per verificar l'estat del vostre lloc.
Pas 4. Actualitzar 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]
Nota
- Podeu trobar l'identificador del portal navegant al lloc web amb "/_services/about" afegit a l'URL del lloc web. Per veure aquestes opcions, l'usuari ha de tenir una funció web amb tots els permisos d'accés al lloc web assignats.
- Després d'actualitzar la versió del model de dades del lloc, es desactivarà el registre del lloc web enllaçat al model de dades estàndard. En lloc d'això, el lloc ara farà referència al registre del lloc web associat amb el model de dades millorat.
- L'usuari ha de tenir qualsevol de les funcions següents per executar l'ordre de migració o
updateDatamodelVersion
revertToStandardDataModel
arguments. Com que això realitzarà l'acció de l'administrador per canviar el vostre lloc al model de dades d'enahance o viceversa.
Exemple
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e
Revertir el lloc migrat del model de dades millorat al model de dades 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]
Nota
Quan canvieu un lloc migrat del model de dades millorat al model de dades estàndard, el registre del lloc web associat amb el model de dades millorat es desactivarà i es reactivarà el registre del lloc web del model de dades estàndard.
Exemple
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e
Migrar 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 realitzi fora de l'horari comercial.
Seguiu aquests passos per migrar el lloc de producció al model de dades millorat:
- Proveu la migració al lloc a l'entorn copiat mitjançant l'ordre PAC CLI
migrate-datamodel
. - Afegiu dades de configuració del lloc a la solució administrada i importeu-la entorn de producció.
- Utilitzeu les ordres de la CLI PAC per migrar dades que no siguin de configuració i acabar-les actualitzant la versió del model de dades per a la producció.
Nota
Per a la migració, l'identificador del lloc web d'origen i de producció són els mateixos.
Consideracions per a la personalització del lloc en migrar llocs del model de dades estàndard al millorat
Aquesta secció proporciona orientació per corregir la personalització d'una migració de lloc de l'estàndard al model de dades millorat.
Hi ha cinc tipus de personalitzacions del lloc 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 al fragment de codi líquid
- Referències de taula Adx a fetch xml
- Flux de treball personalitzat i connectors a les taules adx
Nota
Totes les correccions relacionades amb la personalització es faran després de la migració al model de dades millorat.
Columnes personalitzades a les taules de metadades adx
Per corregir aquesta personalització en el model de dades millorat, creeu una relació entre les taules del sistema i la nova taula personalitzada i migreu les dades a la taula nova.
Model de dades estàndard: La taula adx_webpage
conté una columna personalitzada com contoso_pagetype
.
Model de dades millorat: creeu una taula nova anomenada contoso_webpage
. Això inclourà una columna anomenada contoso_pagetype
i una columna contoso_webpage_id
de cerca associada powerpagescomponent
. Utilitzeu l'àrea de treball Dades per a la creació de taules.
Relació entre taules personalitzades i taules adx
Per corregir 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 amb el nom powerpagecomponent_contoso_pagelogs
de la contoso_webpage
taula. Utilitzeu l'àrea de treball Dades per a la creació de taules.
Referències de la taula Adx al fragment de codi líquid
Per corregir aquesta personalització en el model de dades millorat, substituïu les referències de la taula adx en codi líquid per referències mspp de taules virtuals del model de dades millorat. També podeu utilitzar la taula Component del lloc (nom powerpagecomponent
lògic) juntament amb l'atribut Tipus de component (nom powerpagecomponenttype
lògic) per recuperar les referències corresponents.
Model de dades estàndard:entities
etiqueta líquida s'utilitza per accedir als valors dels enllaços web en {% assign app_weblinks= entities['adx_weblinks'] %}
el codi.
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. També podeu utilitzar la taula Component del lloc (nom powerpagecomponent
lògic) juntament amb l'atribut Tipus de component (nom powerpagecomponenttype
lògic) 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
Tipus de component | Valor |
---|---|
Estat de publicació | 1 |
Pàgina web | 2 |
Fitxer web | 3 |
Conjunt d'enllaços web | 4 |
Enllaç web | 5 |
Plantilla de pàgina | 6 |
Fragment de contingut | 7 |
Plantilla web | 8 |
Configuració del lloc | 9 |
Regla de control d'accés a la pàgina web | 10 |
Funció web | 11 |
Accés al lloc web | 12 |
Marcador de lloc | 13 |
Formulari bàsic | 15 |
Metadades de formulari bàsic | 16 |
Llista | 17 |
Permís de la taula | 18 |
Formulari avançat | 19 |
Pas del formulari avançat | 20 |
Metadades de formulari avançat | 21 |
Ubicació de l'enquesta | 24 |
Ubicació de l'anunci | 26 |
Consumidor de bot | 27 |
Perfil de permís de columna | 28 |
Permís de columna | 29 |
Redirecció | 30 |
Regla de transició de l'estat de publicació | 31 |
Drecera | 32 |
Flux de núvol | 33 |
Component d'UX | 34 |
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.