Visió general de la migració del model de dades estàndard a millorat

La utilitat de migració CLI de Microsoft Power Platform trasllada la configuració suportada d'un lloc de Power Pages existent i els registres relacionats del model de dades estàndard al model de dades millorat, i després canvia el lloc per utilitzar la configuració migrada.

El model de dades estàndard emmagatzema Power Pages configuració del lloc a través de taules que utilitzen el prefix adx_. El model de dades millorat emmagatzema la configuració del lloc a la taula de Components del Lloc (powerpagecomponent) i identifica cada component pel seu tipus de component. Entendre com funciona la utilitat de migració, quines plantilles suporta i quines personalitzacions no actualitza automàticament t'ajuda a decidir quan i com traslladar un lloc.

Revisar els beneficis del model de dades millorat explica per què podries considerar migrar un lloc.

És important tenir en compte que no totes les taules adx_* es traslladen a powerpagecomponent. Només es consoliden les taules de metadades adx_* — aquelles que descriuen l'estructura i la superfície d'autoria del lloc, com adx_webpage, adx_webtemplate, adx_contentsnippetadx_sitesetting, adx_pagetemplate, adx_weblink, , adx_entityform, , i adx_entitylist — powerpagecomponent (amb les seves propietats per fila traslladades a la columna JSON de contingut).

Les taules transaccionals / en temps d'execució adx_* — aquelles que capturen l'activitat de l'usuari final en temps d'execució, com adx_invitationara , adx_inviteredemption, adx_portalcomment, adx_externalidentity, i les taules d'enviament i registre d'entitat-form / formulari avançat — no es migren a powerpagecomponent; es mantenen als seus esquemes existents i continuen emmagatzemant les dades d'execució com abans. El que canvia en aquestes taules transaccionals és que les seves consultes als registres de metadades es reconfiguren durant la migració de referències perquè apuntin a les noves powerpagecomponent files en lloc de les metadades antigues adx_ files*.

Els llocs existents creats amb un model de dades estàndard continuen funcionant en taules adx_*, així que cada lloc ha de ser migrat per beneficiar-se d'un model de dades millorat. La migració trasllada les metadades de configuració del lloc a la forma millorada del model powerpagecomponent de dades, reconfigura les referències transaccionals en aquests nous registres de metadades i inverteix el registre del lloc per servir des del model de dades millorat. També és on sorgeixen i es corregeixen les personalitzacions — columnes adx_* personalitzades, Liquid que llegeix atributs adx_*, taules FetchXML over adx_*, plugins i fluxos de treball — perquè aquestes personalitzacions no es traslladen automàticament i s'han de reescriure o reestructurar per encaixar amb un model de dades millorat.

Requisits previs

Microsoft Power PlatformCLI versió 2.11.2 o posterior, que executa les comandes de descàrrega, migració, estat, activació i retrocés del lloc. Per a més informació, vegeu Instal·lar l'última CLI de Power Platform.
Paquet CDSBasePortal del portal base de Dataverse 9.3.2607.x o posterior, que proporciona els components necessaris del portal base.
El paquet PowerPages_Core Power Pages Core 1.0.2605.x o posterior, que proporciona els components d'execució requerits per a Power Pages. Actualitza la solució de Power Pages.
El rol d'Administrador de Sistemes, Administrador de Dynamics 365 o Administrador de Power Platform, que ha de canviar o revertir el model de dades actiu.
Familiaritat amb la línia de comandament de Power Platform per a Power Pages.
Operacions en segon pla activades si l'entorn està en mode d'administració.

Capacitats de la utilitat de migració

La utilitat de migració copia la configuració suportada del lloc i els registres relacionats al model de dades millorat. Un cop acabada la migració, el lloc actiu canvia al model de dades millorat i es valida abans de tornar a l'ús normal.

La utilitat de migració:

Genera un informe de personalitzacions que podrien requerir canvis manuals.
Migra la configuració del lloc suportada i els registres relacionats.
Et permet comprovar l'estat de migració abans de canviar el model de dades actiu.
Et permet revertir el lloc al model de dades estàndard si la validació identifica un problema crític.

Important

La utilitat de migració no actualitza automàticament totes les personalitzacions que depenen directament de taules estàndard de models de dades. Revisa l'informe de personalització, corregeix el codi personalitzat afectat i prova el lloc migrat abans d'utilitzar-lo en producció.

Plantilles admeses

Pots migrar llocs de models de dades estàndard existents que s'han creat a partir de les següents plantilles:

Disposició d'inici 1-5
S'està processant l'aplicació
Pàgina en blanc
Registre del programa
Planifica i administra reunions
P+F
Portal Comunitari (Dynamics 365)
Portal Self-Service de Clients (Dynamics 365)
Portal de Self-Service d'empleats (Dynamics 365)
Portal de Socis (Dynamics 365)

Nota

Crear nous llocs amb el model de dades millorat i migrar els llocs existents són capacitats separades. Si la plantilla original d'un lloc no està llistada aquí, no facis servir la utilitat de migració d'aquell lloc.

Abans de començar

Consideracions addicionals de planificació:

La configuració d'entorn del model de dades Switch a millorada controla el model de dades utilitzat per als nous emplaçaments. Activar la configuració no migra els llocs existents.
Executa la migració primer en una còpia completa de l'entorn de producció. Completa la personalització, la remediació i la validació abans de migrar.
Utilitza el procés estàndard de còpia de seguretat i restauració de la teva organització per fer còpies de seguretat de l'entorn de producció.
Planifica una finestra de manteniment per al canvi final de producció i la validació.
Registra l'ID del lloc web, l'ID del portal, la URL de l'entorn, la versió de la CLI, les versions del paquet, l'hora d'inici de la migració i la sortida de la comanda com a part del registre de migració.

Planifica la seqüència ambiental

La migració suporta diferents entorns, amb un mode diferent per a cada entorn.

Entorn	Mode recomanat	El que fas
Desenvolupament	`configurationData`	Migrar la configuració, revisar l'informe de personalització, corregir personalitzacions, validar i capturar la configuració en una solució.
Prova o UAT	`configurationDataReferences`	Importar la solució provada des del desenvolupament, migrar els registres relacionats suportats, activar el model de dades millorat i validar.
Producció	`configurationDataReferences`	Importa la solució gestionada validada, migra els registres relacionats amb suport, activa durant la finestra de manteniment i completa la validació de producció.
Entorn únic o lloc senzill	`all`	Migra la configuració i els registres relacionats en una sola operació només quan entenguis l'impacte de la personalització i no utilitzis el camí de la solució multientorn.

Crea una carpeta funcional

Utilitza una carpeta de treball buida per guardar informes, la font del lloc descarregat i els fitxers de comparació. Els següents exemples s'utilitzen \<OUTPUT\> per a aquesta ubicació.

mkdir C:\PowerPagesMigration\<site-name>
cd C:\PowerPagesMigration\<site-name>

Fases de migració

El procés de migració consta de quatre fases:

Pre-comprovacions — Verifica el lloc, IDs, CLI, paquets, solució de plantilla i estat de migració.
Configuració — Migrar configuració en desenvolupament o importar configuració provada en entorns posteriors.
Migra i activa — Migra els registres relacionats, confirma la finalització, canvia de model i reinicia.
Validar — Prova el comportament, els permisos, el codi personalitzat i els viatges de plantilles.

La Fase 1 (descobriment i pre-comprovacions del lloc) i la Fase 4 (validació post-migració) funcionen de la mateixa manera per a cada lloc.

La Fase 2 i la Fase 3 són ramificades per la via: la seva forma depèn del mode de migració, que deriva la pista del tipus d'entorn.

La Via d'Autoria (mode configurationData o all) s'utilitza per a configuracions de desenvolupament i d'un sol entorn. Les metadades es migren localment i les personalitzacions s'escanegen i fixen amb la font estàndard del model de dades abans que les referències transaccionals es moguin.

El Downstream Track (mode configurationDataReferences) s'utilitza per a entorns de prova, UAT i producció on es pressuposa que les metadades de configuració han arribat mitjançant la importació de solucions ALM des de Dev. Només les referències transaccionals migren en aquesta via. Qualsevol troballa de personalització indica una bretxa d'ALM ascendent en lloc de feina que hauries de fer localment.

Fase 1: Pre-comprovacions

Verifica la versió de la teva CLI de Power Platform amb pac --version. Si la teva versió és anterior a la requerida, instal·la o actualitza la CLI de Microsoft Power Platform abans de continuar.
Autentica't a l'entorn objectiu.
1. Corre pac auth list.
2. Corre pac auth who.
Confirma que el perfil d'autenticació actiu apunta a l'entorn que conté el lloc. Per seleccionar un altre perfil o crear un perfil, utilitza pac auth select o pac auth create -u "https://contoso.crm.dynamics.com".
Instal·la solucions de model de dades millorades per a la teva plantilla utilitzant un dels següents mètodes:
1. Provisiona un lloc web de la teva plantilla amb la bandera del model de dades millorat (EDM) activada al centre d'administració.
2. Utilitza la CLI per instal·lar-la amb la comanda pac application install --application-name "PowerPages_PartnerPortal_V2"
Troba el lloc i registra els seus identificadors amb pac pages list -v.

Registreu els valors que es mostren a la taula següent.

Valor	Utilitzat per a
ID del lloc web	Totes `migrate-datamodel` les ordres.
Portal ID	Canviant al model de dades millorat i tornant al model de dades estàndard.
Nom amistós i URL	Confirmar que has seleccionat el lloc correcte al centre d'administració.
Versió del model de dades	Ha de ser Standard. Si ja està millorat, la migració no és necessària.

Important

L'ID del portal no és l'ID de l'aplicació de Power Pages. Si la CLI no mostra l'ID del portal, està disponible al centre d'administració de Power Platform sota Resources>Power Pages> sitesDetails, o bé afegir-la /_services/about a la URL del lloc mentre estàs connectat amb els permisos d'accés requerits.

Comproveu si hi ha una migració anterior o en curs amb la següent ordre:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

Estatus	Significat	Acció
NotStarted o sense rastrejador	No ha començat cap migració.	Continua amb les comprovacions dels paquets.
Revertit	Una migració anterior es va revertir.	Revisa per què es va revertir i continua quan estiguis preparat.
Completat	La migració va acabar, però el lloc potser no s'ha canviat.	Confirma el model de dades actiu. Si encara és Estàndard, continua amb l'activació.
En execució	La migració encara s'està processant.	Continua comprovant l'estat. No comencis una altra migració pel mateix lloc.
Suspès	La migració va trobar un error.	Recull la sortida de la comanda i els detalls de l'entorn, corregeix la causa i torna-ho a intentar només quan s'hagi entès la fallada.

Nota

Si una migració es manté més temps del previst, necessites l'ID del lloc web, l'ID de l'entorn, la versió de la CLI, les versions del paquet, la sortida de comandes i l'hora d'inici de la migració abans de contactar amb el suport de Microsoft. Una migració activa no s'hauria de reiniciar tret que el suport o un llibre d'execució aprovat ho indiqui.

Verifica els paquets de primera part necessaris amb pac solution list --includeSystemSolutions.
1. Confirma que CDSBasePortal, PowerPages_Core, i les solucions EDM per a la plantilla del lloc estan instal·lades a les versions requerides.
Si falta un paquet o està desactualitzat, actualitza'l des del centre d'administració de Power Platform:
1. Obre l'entorn objectiu.
2. Ves a les aplicacions de ResourcesDynamics>365.
3. Troba el paquet necessari.
4. Selecciona Instal·lar o Actualitzar.
5. Espera que acabi l'operació i torna a executar pac solution list --includeSystemSolutions .
Nota

Si la solució EDM de plantilla no està disponible per a la instal·lació directa, crear un lloc temporal de model de dades millorat en el mateix entorn amb la mateixa plantilla instal·la la solució EDM corresponent. Pots eliminar el lloc temporal després que la solució estigui confirmada.
Genera l'informe de personalització amb pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Generar l'informe no canvia el lloc.

Obre el fitxer CSV generat i revisa cada element que faci referència a taules de models de dades estàndard. Assigna un propietari i un pas de validació per a cada remediació necessària abans de la migració en producció.

Categoria de personalització	Pla
Columnes personalitzades a les taules de metadades adx_	Mou les dades personalitzades a una taula personalitzada compatible relacionada amb powerpagecomponent.
Relacions amb adx_ taules de metadades	Recrea la relació amb la taula del model de dades millorat suportat.
Referències líquides o FetchXML a taules adx_	Actualitza el codi per utilitzar objectes Liquid compatibles, taules virtuals o powerpagecomponent.
Fluxos de treball i complements en taules adx_	Refactoritza i registra la lògica contra les taules de models de dades millorades suportades.

Nota

Un informe de personalització no demostra que tot el comportament del lloc funcioni després de la migració; la validació encara és necessària.

Tria el mode de migració per determinar què migra l'utilitat en una sola operació.

Moda	Què migra	Quan utilitzar-lo
configurationData	Metadades de configuració del lloc compatibles, com pàgines, plantilles web, fragments, configuracions, formularis, llistes, rols web i permisos de taula.	Desenvolupament, on es corregeix la configuració i es mou a través de solucions.
configurationDataReferences	Registres compatibles que es refereixen a la configuració migrada del lloc.	La prova, l'UAT i la producció després de la configuració del lloc arriben a través d'una importació de solucions.
tot	Tant la configuració com els registres relacionats amb suport.	Un únic entorn o una migració simple que no utilitza la seqüència d'entorn basada en solucions.

Fase 2: Configuració del lloc

Itinerari d'autoria: Desenvolupament o un únic entorn

Descarrega una línia base SDM executant pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". La comanda crea una carpeta filla amb el nom del lloc. Grava la carpeta que conté website.ymldirectament .
Migra la configuració del lloc executant pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Si vols el camí d'operació única, substitueix-lo configurationData per all.
Comprova l'estat de la migració executant pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Utilitza el següent bucle PowerShell per comprovar l'estat una vegada per minut durant fins a 30 minuts:
```
$webSiteId = "<WEBSITE_ID>"
for ($i = 1; $i -le 30; $i++) {
    $output = pac pages migrate-datamodel `
        --webSiteId $webSiteId `
        --checkMigrationStatus 2>&1 | Out-String
    if ($output -match "Completed|Failed|Reverted") {
        Write-Host $output
        break
    }
    Write-Host "Attempt $i/30 - migration is still running."
    Start-Sleep -Seconds 60
}
```
Si el bucle acaba mentre l'estat encara està en funcionament, la comprovació continua amb --checkMigrationStatus. Una operació de llarga durada no és necessàriament una operació fallida.
Solucioneu les personalitzacions reportades utilitzant l'informe de personalització i les directrius d'aquest article per actualitzar FetchXML afectat, Liquid, columnes personalitzades, relacions, fluxos de treball i complements. Tornar a provar cada component canviat. Si actualitzes el codi font descarregat, puja la carpeta del lloc que conté website.yml directament executant pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Via posterior: Prova, UAT o producció

Importa la solució que conté la configuració migrada i remediada del lloc. Utilitza el centre d'administració de Power Platform o la teva pipeline de desplegament establerta.
```
pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true
```
Confirma que la configuració del lloc és present obrint l'aplicació Power Pages Management a l'entorn objectiu. El registre del lloc i la configuració esperada han d'estar presents abans que es migrin els registres relacionats.

Migra els registres relacionats amb suport. Si ja l'has utilitzat --mode all, salta aquest pas. Comprova l'estat fins que aparegui com a completat.

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

Un cop l'estat de la migració informi de la finalització exitosa, canvieu el lloc actiu al model de dades millorat. El registre del lloc web del model de dades estàndard es desactiva i el registre corresponent del model de dades millorat esdevé actiu.
```
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
```
Reinicieu el lloc.
1. Centre d'administració d'Open Power Platform.
2. Ves a l'entorn i després selecciona ResourcesPower>Pages sites.
3. Selecciona el lloc.
4. Selecciona Reiniciar. Si Reiniciar no està disponible, desactiva i després activa el lloc.
5. Espera que l'operació acabi abans de validar-la.
Confirmeu el model de dades actiu utilitzant un o més d'aquests mètodes:
1. Al centre d'administració de Power Platform, selecciona el lloc i confirma que el model de dades mostra Millorat.
2. Obre l'espai de treball de configuració del lloc a Power Pages design studio i confirma el model de dades mostrat.
3. Confirma que la configuració avançada s'obre a l'aplicació Power Pages Management.
4. Executa pac pages list -v i confirma la versió del model de dades.
Suggeriment

L'URL del lloc i el disseny visual no canvien només perquè el model de dades actiu hagi canviat. Per verificar la migració, utilitza aquestes comprovacions — no l'aspecte del lloc.

Fase 4: Validar el lloc migrat

Completa la validació abans de reobrir un lloc de producció als usuaris. Utilitza comptes de prova per a cada tipus d'usuari important i rol web, i registra el resultat de cada prova crítica.

Àrea	Què validar
Pàgines i contingut	Pàgina d'inici, pàgines representatives de contingut, plantilles web, fragments de contingut, fitxers web, navegació, redireccions i contingut multilingüe.
Autenticació	Inici de sessió, tancament de sessió, registre, invitacions, proveïdors d'identitat externs i experiències d'accés denegat.
Autorització	Els rols web, permisos de taula, permisos de columna i regles d'accés a pàgines permeten i denegen les accions esperades.
Formes i llistes	Formularis bàsics, formularis de diversos passos, llistes, metadades de formularis, enviaments, registres relacionats i sessions de formularis web utilitzades pel lloc.
Viatges de plantilles de Dynamics 365	Els principals recorreguts de clients, empleats, comunitats o socis utilitzats per la teva implementació, incloent-hi pàgines específiques de plantilla i patrons d'accés.
Codi personalitzat	Liquid, FetchXML, JavaScript, complements, fluxos de treball i integracions identificats a l'informe de personalització.
Configuració del lloc i fitxers	La configuració del lloc, les imatges, els fitxers adjunts, els fitxers SVG i altres fitxers web es carreguen correctament.
Dades i referències	Els recomptes importants de registres i els registres relacionats amb suport apunten als components migrats correctes del lloc.
Administració i ALM	El lloc s'obre a Power Pages Management i es pot afegir, exportar i importar des de solucions segons s'esperi.

Comprova el diagnòstic del navegador

Obre eines de desenvolupador de navegadors mentre proves pàgines representatives. Investiga:

Errors a la consola que mencionen adx\_, entitats, Liquid o FetchXML.
Les respostes HTTP 401 o 403 de \_api, que poden indicar un problema de permís o de rol web.
respostes HTTP 500, que poden indicar una fallada de Liquid, FetchXML, plug-in o integració.

Criteris de finalització de la migració

Considera la migració completa només quan el lloc mostra el model de dades millorat, passen viatges empresarials crítics, es confirma el comportament de seguretat esperat i es resolgui o accepti cada troballa d'alta personalització d'impacte.

Seqüència de migració de producció

Utilitza la següent seqüència de producció per reduir el risc de migració:

Crea una còpia completa de l'entorn de producció per als assajos.
Confirma els requisits previs de la solució CLI, paquet i plantilla a l'entorn copiat.
Genera i revisa l'informe de personalització.
Migra la configuració a l'entorn de desenvolupament copiat.
Remediar les personalitzacions i capturar la configuració validada del lloc en una solució gestionada.
Importa la solució a l'entorn d'assaig, migra els registres relacionats suportats, activa el model de dades millorat i completa la llista completa de validació.
Repeteix la remediació i assaig fins que passin totes les proves crítiques.
Programeu la finestra de manteniment de producció, comuniceu els punts de validació i decisió de retrocés, i feu còpies de seguretat a la producció.
Confirma de nou els requisits previs del paquet de producció i la plantilla de la solució.
Importa la solució gestionada validada a producció.
Executa configurationDataReferences, comprova l'estat de la migració, canvia el model de dades actiu i reinicia el lloc.
Executeu la llista de comprovació de validació de producció i torneu el lloc a l'ús normal només després que superin les proves crítiques.

Revertir un lloc migrat al model de dades estàndard

Si la validació identifica un problema crític després de l'activació, utilitzeu la següent ordre per reactivar el registre del lloc web del model de dades estàndard:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Un cop acabada la comanda:

Reinicia el lloc des del centre d'administració de Power Platform.
Confirma que el lloc mostra Standard com a model de dades actiu.
Repeteix les proves crítiques de validació del lloc.
Conserveu l'informe de migració, els detalls dels errors i les notes de remediació abans d'intentar una altra migració.

Important

Planifica la decisió de retrocés abans de la migració de producció. Revisa els canvis fets després del canvi de model de dades millorat abans de revertir-los, perquè els registres estàndard i millorat del lloc web són registres separats.

Solucionar problemes

Missatge o símptoma	Causa probable	Acció
`pac powerpages migrate-datamodel` no es reconeix	L'ordre utilitza un espai de noms incorrecte o una CLI obsoleta.	Actualitza la CLI de Power Platform i utilitza `pac pages migrate-datamodel`.
`CDSBasePortal` o `PowerPages_Core` no està llistat	Les solucions del sistema no s'incloïen a la sortida de comandes, o el paquet no està instal·lat.	Corre `pac solution list --includeSystemSolutions`. Instal·la o actualitza el paquet que falta des del centre d'administració de Power Platform.
Lloc web no compatible amb migració	La plantilla original no està suportada, les versions dels paquets són insuficients o falta la solució de plantilla EDM que coincideix.	Confirmeu l'elegibilitat de la plantilla, les versions del paquet i la solució EDM que apareix a la referència de la plantilla de la solució.
Es va aprovar un argument `--webSiteId` desconegut a favor `pac pages upload`	L'ordre de pujada no accepta l'argument de l'ID del lloc web.	Omet la discussió. El lloc s'identifica a partir de `website.yml`.
La pujada apunta al lloc equivocat o no el troba	El camí apunta a la carpeta wrapper en lloc de la carpeta del lloc.	Utilitza la carpeta filla que conté directament website.yml.
Mostra `Unknown` l'ID del portal o `N/A`	El lloc està inactiu o la CLI instal·lada no retorna el valor.	Obtingues l'ID del portal al centre d'administració de Power Platform o a la pàgina del `/_services/about` lloc. No facis servir l'ID de l'aplicació.
Informes `Completed` de migració però el lloc encara mostra `Standard`	El model de dades actives no es va canviar, o es va utilitzar l'ID de portal incorrecte.	Executa la comanda d'activació amb l'ID del lloc web i l'ID correcte del portal, després reinicia i verifica el lloc.
L'estatus es manté `Running`	La migració processa un gran volum de dades o està bloquejada.	Continua comprovant l'estat. Recull l'entorn, el paquet, la línia de crèdit, l'hora d'inici i els detalls de la comanda abans de contactar amb el suport. No comencis una segona migració.
L'estat és `Failed`	Un error de paquet, plantilla, personalització, dades o servei va aturar l'operació.	Desa la sortida completa de la comanda, corregeix la causa identificada i torna a intentar-ho només després de revisar l'estat de migració fallit.
El lloc s'obre, però els usuaris no poden accedir a les dades esperades	Els rols web, els permisos de taules o les consultes personalitzades no es comporten com s'espera després de la migració.	Revisa els rols web, permisos de taula, permisos de columna, FetchXML, Liquid i errors de xarxa del navegador.

Consideració per a la personalització del lloc

L'informe de personalització identifica les dependències directes de les taules estàndard de models de dades. Completa la remediació necessària abans de l'ús en producció.

Columnes personalitzades a les taules de metadades

Si una taula estàndard de models de dades, com ara, adx_webpage conté una columna personalitzada, creeu una taula personalitzada per emmagatzemar les dades personalitzades i afegiu una consulta a powerpagecomponent. Migra els valors personalitzats a la nova taula i actualitza el codi que llegeix o escriu la columna.

Relacions entre taules personalitzades i taules de metadades

Recrear relacions personalitzades que apuntin a adx_ taules perquè apuntin a la taula adequada del model de dades millorat, habitualment powerpagecomponent. Actualitza formularis, vistes, plug-ins, fluxos i integracions dependents.

Referències líquides a taules de metadades

Substitueix l'accés directe entities['adx_*'] per un objecte Liquid suportat quan n'hi hagi un. Per exemple, utilitza l'objecte weblinks Liquid en lloc de consultar adx_weblinkset directament o taules relacionades. Revisa cada ús perquè l'objecte retornat i els atributs disponibles poden ser diferents.

Referències FetchXML a taules de metadades

Substitueix les referències directes adx_ d'entitats per la taula virtual o consulta powerpagecomponent corresponent i filtra per powerpagecomponenttype

Exemple de model de dades estàndard:

<fetch>
  <entity name="adx_webpage">
    <attribute name="adx_name" />
    <filter>
      <condition attribute="adx_partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Exemple de model de dades millorat:

<fetch>
  <entity name="powerpagecomponent">
    <attribute name="name" />
    <filter type="and">
      <condition attribute="powerpagecomponenttype" operator="eq" value="2" />
      <condition attribute="partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Fluxos de treball personalitzats i complements

Refactoritzar flux de treball personalitzat i lògica de connectors registrada a les adx_ taules. Registra la lògica actualitzada a la taula corresponent del model de dades millorat i utilitza l'esquema i els atributs millorats. Provar la creació, actualització, eliminació i comportament de seguretat en un entorn no produït.

Referència de comandament

Propòsit	Manar
Comprova la versió CLI	`pac --version`
Perfils d'autenticació de llista	`pac auth list`
Crea un perfil d'autenticació	`pac auth create -u "<ENV_URL>"`
Llistes de llocs i identificadors	`pac pages list -v`
Solucions de sistemes de llista	`pac solution list --includeSystemSolutions`
Comprova l'estat migratori	`pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus`
Descarrega la font SDM	`pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"`
Descarrega la font EDM	`pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"`
Genera un informe de personalització	`pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"`
Configuració de migració	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData`
Registres relacionats amb la migració	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences`
Migra ambdues categories	`pac pages migrate-datamodel --webSiteId "<ID>" --mode all`
Font del lloc de pujada	`pac pages upload --path "<SITE_ROOT>" --modelVersion 1`
Activa l'EDM	`pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"`
Tornar a SDM	`pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"`

Referència del tipus de component del lloc

Quan consultis powerpagecomponent, utilitza els valors següents al filtre powerpagecomponenttype .

Component	Valor	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

Referència de la solució de plantilla EDM

Executa pac solution list --includeSystemSolutions per confirmar que la solució millorada de model de dades per a la plantilla del lloc està instal·lada.

Plantilla	Solució EDM nom únic
Disposició d'arrencada 1	DefaultPortalTemplate_V2
Disposició inicial 2	PowerPages_BlankDesign002_V2
Disposició d'inici 3	PowerPages_BlankDesign003_V2
Disposició d'arrencada 4	PowerPages_BlankDesign004_V2
Configuració d'arrencada 5	PowerPages_BlankDesign005_V2
Pàgina en blanc	PowerPages_BlankTemplate_V2
P+F	PowerPages_FAQ_V2
S'està processant l'aplicació	PowerPages_BuildingPermit_V2
Registre del programa	PowerPages_ProgramRegistration_V2
Planifica i administra reunions	PowerPages_BookMeeting_V2
Portal Comunitari (Dynamics 365)	PowerPages_CommunityPortal_V2
Portal Self-Service de Clients (Dynamics 365)	PowerPages_CustomerPortal_V2
Portal de Self-Service d'empleats (Dynamics 365)	PowerPages_ESSPortal_V2
Portal de Socis (Dynamics 365)	PowerPages_PartnerPortal_V2

Comentaris

Us ha resultat útil aquesta pàgina?

Last updated on 2026-09-01

Visió general de la migració del model de dades estàndard a millorat

Requisits previs

Capacitats de la utilitat de migració

Plantilles admeses

Abans de començar

Planifica la seqüència ambiental

Crea una carpeta funcional

Fases de migració

Fase 1: Pre-comprovacions

Fase 2: Configuració del lloc

Itinerari d'autoria: Desenvolupament o un únic entorn

Via posterior: Prova, UAT o producció

Fase 3: Registres relacionats i activació

Fase 4: Validar el lloc migrat

Comprova el diagnòstic del navegador

Criteris de finalització de la migració

Seqüència de migració de producció

Revertir un lloc migrat al model de dades estàndard

Solucionar problemes

Consideració per a la personalització del lloc

Columnes personalitzades a les taules de metadades

Relacions entre taules personalitzades i taules de metadades

Referències líquides a taules de metadades

Referències FetchXML a taules de metadades

Fluxos de treball personalitzats i complements

Referència de comandament

Referència del tipus de component del lloc

Referència de la solució de plantilla EDM

Contingut relacionat

Comentaris

Recursos addicionals