Panoramica della migrazione dal modello dati standard al modello dati avanzato

L'utilità di migrazione dell'interfaccia della riga di comando Microsoft Power Platform sposta la configurazione supportata di un sito Power Pages esistente e i record correlati dal modello di dati standard al modello di dati avanzato e quindi passa al sito per usare la configurazione migrata.

Il modello di dati standard archivia la configurazione del sito di Power Pages nelle tabelle che utilizzano il prefisso adx_. Il modello di dati avanzato archivia la configurazione del sito nella tabella Componente sito (powerpagecomponent) e identifica ogni componente in base al tipo di componente. Comprendere il funzionamento dell'utilità di migrazione, quali modelli supporta e quali personalizzazioni non vengono aggiornate automaticamente consente di decidere quando e come spostare un sito.

La revisione dei vantaggi del modello di dati avanzato spiega perché è consigliabile eseguire la migrazione di un sito.

È importante notare che non tutte le tabelle adx_* vengono spostate in powerpagecomponent. Solo le tabelle di metadati adx_* — quelle che descrivono la struttura e l'interfaccia di creazione del sito, come adx_webpage, adx_pagetemplate, adx_sitesetting, adx_weblink, adx_contentsnippet, adx_webtemplate, adx_entityform e adx_entitylist — sono consolidate in powerpagecomponent (con le proprietà di ogni riga spostate nella colonna JSON del contenuto).

Le tabelle transazionali/runtime adx_*, quelle che acquisiscono l'attività dell'utente finale in fase di esecuzione, ad esempio adx_invitation, adx_inviteredemptionadx_portalcomment, adx_externalidentity, e le tabelle entity-form/advanced-form e log, non vengono migrate in powerpagecomponent; rimangono sugli schemi esistenti e mantengono l'archiviazione dei dati di runtime come prima. Per queste tabelle transazionali, ciò che cambia è che i riferimenti ai record di metadati vengono reindirizzati durante la migrazione dei riferimenti, in modo che puntino alle nuove righe powerpagecomponent anziché alle righe legacy dei metadati adx_*.

I siti esistenti creati nel modello di dati standard continuano a essere eseguiti in tabelle adx_*, quindi è necessario eseguire la migrazione di ogni sito per trarre vantaggio dal modello di dati avanzato. La migrazione sposta i metadati di configurazione del sito nella struttura del modello dati avanzato powerpagecomponent, reindirizza i riferimenti transazionali ai nuovi record di metadati e imposta il record del sito affinché utilizzi il modello dati avanzato. È anche il punto in cui vengono individuate e corrette le personalizzazioni — colonne adx_* personalizzate, codice Liquid che legge gli attributi adx_*, query FetchXML sulle tabelle adx_*, plug-in e flussi di lavoro — perché tali personalizzazioni non vengono trasferite automaticamente e devono essere riscritte o ristrutturate per funzionare con il modello dati migliorato.

Prerequisiti

• Microsoft Power Platform CLIversione 2.11.2 o successiva, che esegue i comandi per il download, la migrazione, lo stato, l'attivazione e il ripristino del sito. Per altre informazioni, vedi Installare la versione più recente di Power Platform CLI.
• Pacchetto di base del portale Dataverse CDSBasePortal9.3.2607.x o versione successiva, che fornisce i componenti di base del portale necessari.
• pacchetto Core di Power Pages PowerPages_Core1.0.2605.x o versione successiva, che fornisce i componenti runtime necessari di Power Pages. Aggiornare la soluzione Power Pages.
• Ruolo Amministratore di sistema, amministratore Dynamics 365 o amministratore di Power Platform, necessario per cambiare o ripristinare il modello di dati attivo.
• Familiarità con Power Platform CLI for Power Pages.
• Operazioni in background abilitate se l'ambiente è in modalità di amministrazione.

Funzionalità dell'utilità di migrazione

L'utilità di migrazione copia la configurazione del sito supportata e i record correlati al modello di dati avanzato. Al termine della migrazione, il sito attivo passa al modello di dati avanzato e viene convalidato prima di tornare al normale utilizzo.

Utilità di migrazione:

• Genera un report di personalizzazioni che potrebbero richiedere modifiche manuali.
• Esegue la migrazione della configurazione del sito supportata e dei record correlati.
• Consente di controllare lo stato della migrazione prima di passare al modello di dati attivo.
• Consente di ripristinare il sito al modello di dati standard se la convalida identifica un problema critico.

Modelli supportati

È possibile eseguire la migrazione dei siti del modello di dati standard esistenti creati dai modelli seguenti:

• Layout iniziale 1-5
• Elaborazione delle applicazioni
• Pagina vuota
• Registrazione al programma
• Pianifica e gestisci riunioni
• FAQ
• Portale della community (Dynamics 365)
• Portale Self-Service del cliente (Dynamics 365)
• Portale self-service dei dipendenti (Dynamics 365)
• Portale partner (Dynamics 365)

Prima di iniziare

Considerazioni aggiuntive sulla pianificazione:

• L'impostazione Passa all'ambiente del modello di dati avanzato controlla il modello di dati usato per i nuovi siti. L'attivazione dell'impostazione non esegue la migrazione dei siti esistenti.
• Eseguire prima la migrazione in una copia completa dell'ambiente di produzione. Completare la correzione e la convalida della personalizzazione prima della migrazione.
• Usare il processo di backup e ripristino standard dell'organizzazione per eseguire il backup dell'ambiente di produzione.
• Pianificare una finestra di manutenzione per il passaggio finale in produzione e la validazione.
• Registrare l'ID del sito Web, l'ID del portale, l'URL dell'ambiente, la versione dell'interfaccia della riga di comando, le versioni del pacchetto, l'ora di inizio della migrazione e il modulo di output del comando come parte del record di migrazione.

Pianificare la sequenza degli ambienti

La migrazione supporta ambienti diversi, con una modalità diversa per ogni ambiente.

Creare una cartella di lavoro

Usare una cartella di lavoro vuota per contenere report, origine del sito scaricato e file di confronto. Gli esempi seguenti utilizzano \<OUTPUT\> per questa posizione.

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

Fasi di migrazione

Il processo di migrazione è costituito da quattro fasi:

1. Controlli preliminari : verificare il sito, gli ID, l'interfaccia della riga di comando, i pacchetti, la soluzione modello e lo stato della migrazione.
2. Configurazione : eseguire la migrazione della configurazione nello sviluppo o nell'importazione di configurazioni testate negli ambienti downstream.
3. Eseguire la migrazione e l'attivazione: eseguire la migrazione di record correlati, confermare il completamento, cambiare modelli e riavviare.
4. Verifica — Testa il comportamento, le autorizzazioni, il codice personalizzato e i flussi del modello.

La fase 1 (individuazione del sito e controlli preliminari) e la fase 4 (convalida post-migrazione) vengono eseguite nello stesso modo per ogni sito.

La fase 2 e la fase 3 sono ramificate in base alla traccia: la loro struttura dipende dalla modalità di migrazione, che determina la traccia in base al tipo di ambiente.

La traccia di creazione (modalità configurationData o all) viene usata per le configurazioni di sviluppo e ambiente singolo. I metadati stessi vengono migrati localmente e le personalizzazioni vengono analizzate e corrette rispetto all'origine del modello di dati standard prima dello spostamento dei riferimenti transazionali.

Downstream Track (modalità configurationDataReferences) viene usato per gli ambienti Test, UAT e Production in cui si presuppone che i metadati di configurazione siano arrivati tramite l'importazione della soluzione ALM da Dev. In questa fase vengono migrati solo i riferimenti transazionali. Eventuali elementi di personalizzazione rilevati indicano una lacuna dell’ALM a monte, anziché attività da svolgere localmente.

Fase 1: Controlli preliminari

1. Verifica la versione di Power Platform CLI con pac --version. Se la tua versione è precedente a quella richiesta, installa o aggiorna Microsoft Power Platform CLI prima di continuare.

2. Eseguire l'autenticazione nell'ambiente di destinazione.

   1. Eseguire pac auth list.
   2. Eseguire pac auth who.

3. Verificare che il profilo di autenticazione attivo punti all'ambiente che contiene il sito. Per selezionare un altro profilo o creare un profilo, usare pac auth select o pac auth create -u "https://contoso.crm.dynamics.com".

4. Installare soluzioni del modello di dati avanzato per il modello usando uno dei metodi seguenti:

   1. Esegui il provisioning di un sito dal modello con il flag EDM (modello dati avanzato) abilitato nell'interfaccia di amministrazione.
   2. Usare l'interfaccia della riga di comando per eseguire l'installazione con il comando pac application install --application-name "PowerPages_PartnerPortal_V2"

5. Trovare il sito e registrarne gli identificatori con pac pages list -v.

6. Registrare i valori illustrati nella tabella seguente.

   valore	Utilizzato per
   ID sito Web	Tutti i migrate-datamodel comandi.
   ID del portale	Passaggio al modello di dati avanzato e ripristino del modello di dati standard.
   Nome descrittivo e URL	Conferma che è stato selezionato il sito corretto nell'interfaccia di amministrazione.
   Versione del modello di dati	Deve essere Standard. Se è già avanzato, la migrazione non è necessaria.

   Importante

   L'ID del portale non è l'ID dell'app Power Pages. Se la CLI non mostra l'ID del portale, è disponibile nel Power Platform Admin Center in Risorse>Siti di Power Pages>Dettagli del sito, oppure aggiungendo /_services/about all'URL del sito dopo aver effettuato l'accesso con le autorizzazioni necessarie per accedere al sito Web.

7. Verificare la presenza di una migrazione precedente o in corso con il comando seguente:

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

   Status	significato	Action
   NotStarted o nessun tracker	Nessuna migrazione avviata.	Continua con le verifiche del pacchetto.
   Ripristinato	È stato effettuato il rollback di una migrazione precedente.	Verifica perché è stato annullato, quindi continua quando sei pronto.
   Completato	La migrazione è stata completata, ma il sito potrebbe non essere stato modificato.	Confermare il modello di dati attivo. Se è ancora Standard, continuare con l'attivazione.
   In esecuzione	La migrazione è ancora in fase di elaborazione.	Continuare a controllare lo stato. Non avviare un'altra migrazione per lo stesso sito.
   Non riuscito	Si è verificato un errore durante la migrazione.	Raccolga l'output del comando e i dettagli dell'ambiente, corregga la causa del problema e riprovi solo dopo aver compreso l'errore.

   Annotazioni

   Se una migrazione rimane più lunga del previsto, è necessario l'ID del sito Web, l'ID ambiente, la versione dell'interfaccia della riga di comando, le versioni dei pacchetti, l'output dei comandi e l'ora di inizio della migrazione prima di contattare il supporto Microsoft. Una migrazione attiva non deve essere reimpostata, a meno che il supporto tecnico o un runbook approvato non lo indichino.

8. Verificare i pacchetti di prima parte necessari con pac solution list --includeSystemSolutions.

   1. Verificare che CDSBasePortal, PowerPages_Coree le soluzioni EDM per il modello del sito siano installate nelle versioni necessarie.

9. Se un pacchetto è mancante o obsoleto, aggiornarlo dall'interfaccia di amministrazione di Power Platform:

   1. Apri l'ambiente di destinazione.
   2. Passare a Resources>Dynamics 365 apps.
   3. Trovare il pacchetto richiesto.
   4. Selezionare Installa o Aggiorna.
   5. Attendere il completamento dell'operazione, quindi eseguire pac solution list --includeSystemSolutions di nuovo.

   Annotazioni

   Se non è possibile installare direttamente la soluzione modello EDM, la creazione di un sito del modello dati avanzato temporaneo nello stesso ambiente con lo stesso modello consente di installare la soluzione EDM corrispondente. È possibile eliminare il sito temporaneo dopo la conferma della soluzione.

10. Generare il report di personalizzazione con pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". La generazione del report non modifica il sito.

11. Aprire il file CSV generato ed esaminare ogni elemento che fa riferimento a tabelle del modello di dati standard. Assegnare un responsabile e una fase di convalida per ogni intervento correttivo richiesto prima della migrazione in produzione.

    Categoria di personalizzazione	Piano
    Colonne personalizzate nelle tabelle di metadati adx_	Spostare i dati personalizzati in una tabella personalizzata supportata correlata a powerpagecomponent.
    Relazioni con adx_ tabelle di metadati	Ricreare la relazione rispetto alla tabella del modello di dati avanzato supportato.
    Riferimenti Liquid o FetchXML alle tabelle adx_	Aggiornare il codice per usare oggetti Liquid supportati, tabelle virtuali o powerpagecomponent.
    Flussi di lavoro e plug-in nelle tabelle adx_	Effettua il refactoring e registra la logica nelle tabelle del modello di dati avanzate supportate.

    Annotazioni

    Un report di personalizzazione non dimostra che tutto il comportamento del sito funziona dopo la migrazione; la convalida è ancora necessaria.

12. Scegliere la modalità di migrazione per determinare l'utilità di cui viene eseguita la migrazione in una singola operazione.

    Mode	Elementi di cui viene eseguita la migrazione	Da utilizzare
    configurationData	Metadati di configurazione del sito supportati, ad esempio pagine, modelli Web, frammenti di codice, impostazioni, moduli, elenchi, ruoli Web e autorizzazioni di tabella.	Sviluppo, in cui è possibile correggere la configurazione e spostarla tra soluzioni.
    Riferimenti ai dati di configurazione	Record supportati che fanno riferimento alla configurazione del sito migrata.	Test, UAT e produzione dopo l'arrivo della configurazione del sito tramite l'importazione di una soluzione.
    tutto	Sia la configurazione che i record correlati supportati.	Un singolo ambiente o una semplice migrazione che non usa la sequenza di ambiente basata su soluzioni.

Fase 2: Configurazione del sito

Traccia di creazione: ambiente singolo o per sviluppatori

1. Scarica una baseline di SDM eseguendo pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Il comando crea una sottocartella con il nome del sito. Annotare la cartella che contiene direttamente website.yml.

2. Eseguire la migrazione della configurazione del sito eseguendo pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Se si desidera il percorso a singola operazione, sostituire configurationData con all.

3. Controllare lo stato della migrazione eseguendo pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Usare il ciclo powerShell seguente per controllare lo stato una volta al minuto per un massimo di 30 minuti:

   $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
   }
   

   Se il ciclo termina mentre lo stato è ancora in esecuzione, la verifica continua con --checkMigrationStatus. Un'operazione a esecuzione prolungata non è necessariamente un'operazione non riuscita.

4. Correggere le personalizzazioni segnalate usando il report sulle personalizzazioni e le indicazioni contenute in questo articolo per aggiornare i componenti FetchXML e Liquid interessati, nonché colonne personalizzate, relazioni, flussi di lavoro e plug-in. Testare nuovamente ogni componente modificato. Se aggiorni la sorgente scaricata, carica la cartella del sito che contiene direttamente website.yml eseguendo pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Traccia downstream: test, UAT o produzione

1. Importare la soluzione contenente la configurazione del sito migrata e risolta. Usa l'interfaccia di amministrazione di Power Platform o la pipeline di distribuzione esistente.

   pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true
   

2. Verificare che la configurazione del sito sia presente aprendo l'app di gestione Power Pages nell'ambiente di destinazione. Il record del sito e la configurazione prevista devono essere presenti prima della migrazione dei record correlati.

Fase 3: record correlati e attivazione

1. Esegui la migrazione dei record correlati supportati. Se è già stato usato --mode all, ignorare questo passaggio. Controllare lo stato finché non viene indicato Completato.

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

2. Quando lo stato della migrazione indica il completamento corretto, passare il sito attivo al modello dati avanzato. Il record del sito Web del modello di dati standard viene disattivato e il record del sito Web del modello di dati avanzato corrispondente diventa attivo.

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

3. Riavvia il sito.

   1. Aprire l'interfaccia di amministrazione di Power Platform.
   2. Passare all'ambiente e quindi selezionare Risorse>Siti Power Pages.
   3. Selezionare il sito.
   4. Seleziona Riavvia. Se Riavvia non è disponibile, disattiva e poi riattiva il sito.
   5. Attendere il completamento dell'operazione prima della convalida.

4. Verificare il modello di dati attivo usando uno o più di questi metodi:

   1. Nell'interfaccia di amministrazione di Power Platform selezionare il sito e verificare che il modello di dati mostri Avanzato.
   2. Apri l'area di lavoro Configurazione del sito in Power Pages Design Studio e conferma il modello di dati visualizzato.
   3. Verificare che la configurazione avanzata sia aperta nell'app di gestione Power Pages.
   4. Eseguire pac pages list -v e confermare la versione del modello di dati.

   Tip

   L'URL del sito e la progettazione visiva non cambiano solo perché il modello di dati attivo è stato modificato. Per verificare la migrazione, usare questi controlli, non l'aspetto del sito.

Fase 4: Convalidare il sito migrato

Completare la convalida prima di riaprire un sito di produzione agli utenti. Usare gli account di test per ogni tipo di utente e ruolo Web importanti e registrare il risultato di ogni test critico.

Controlla la diagnostica del browser

Aprire gli strumenti di sviluppo del browser durante il test delle pagine rappresentative. Investiga:

• Errori della console che menzionano adx\_, entità, Liquid o FetchXML.
• Risposte HTTP 401 o 403 da \_api, che possono indicare un problema di autorizzazione o ruolo Web.
• Risposte HTTP 500, che possono indicare un errore di Liquid, di FetchXML, del plug-in o dell'integrazione.

Criteri di completamento della migrazione

Prendere in considerazione il completamento della migrazione solo quando il sito mostra il modello di dati avanzato, i percorsi aziendali critici superati, il comportamento di sicurezza previsto viene confermato e ogni ricerca di personalizzazione ad alto impatto viene risolta o accettata.

Sequenza di migrazione di produzione

Usare la sequenza di produzione seguente per ridurre il rischio di migrazione:

1. Creare una copia completa dell'ambiente di produzione per le prove.
2. Verificare i prerequisiti di CLI, pacchetto e modello di soluzione nell'ambiente copiato.
3. Generare ed esaminare il report di personalizzazione.
4. Eseguire la migrazione della configurazione nell'ambiente di sviluppo copiato.
5. Correggere le personalizzazioni e acquisire la configurazione del sito convalidata in una soluzione gestita.
6. Importare la soluzione nell'ambiente di prova, eseguire la migrazione dei record correlati supportati, attivare il modello di dati avanzato e completare l'elenco di controllo completo per la convalida.
7. Ripetere la correzione e ripetere le prove fino al superamento di tutti i test critici.
8. Pianificare la finestra di manutenzione di produzione, comunicare i punti decisionali di convalida e rollback e eseguire il backup dell'ambiente di produzione.
9. Confermare di nuovo i prerequisiti per il pacchetto di produzione e la soluzione modello.
10. Importare la soluzione gestita convalidata nell'ambiente di produzione.
11. Eseguire configurationDataReferences, controllare lo stato della migrazione, cambiare il modello di dati attivo e riavviare il sito.
12. Eseguire l'elenco di controllo di convalida della produzione e restituire il sito all'uso normale solo dopo il superamento dei test critici.

Ripristinare un sito migrato al modello di dati standard

Se la convalida identifica un problema critico dopo l'attivazione, usare il comando seguente per riattivare il record del sito Web del modello di dati standard:

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

Al termine del comando:

1. Riavviare il sito dall'interfaccia di amministrazione di Power Platform.
2. Verificare che il sito mostri Standard come modello di dati attivo.
3. Eseguire di nuovo i test di convalida critici del sito.
4. Conservare il report di migrazione, i dettagli dell'errore e le note di correzione prima di tentare un'altra migrazione.

Troubleshooting

Considerazioni sulle personalizzazioni del sito

Il report di personalizzazione identifica le dipendenze dirette dalle tabelle del modello di dati standard. Completare la correzione richiesta prima dell'uso in produzione.

Colonne personalizzate nelle tabelle di metadati

Se una tabella del modello di dati standard, ad adx_webpage esempio contiene una colonna personalizzata, creare una tabella personalizzata per archiviare i dati personalizzati e aggiungere una ricerca a powerpagecomponent. Eseguire la migrazione dei valori personalizzati alla nuova tabella e aggiornare il codice che legge o scrive la colonna.

Relazioni tra tabelle personalizzate e tabelle di metadati

Ricreare relazioni personalizzate che puntano alle tabelle adx_ in modo che puntino alla tabella appropriata del modello di dati avanzato, in genere powerpagecomponent. Aggiorna moduli dipendenti, visualizzazioni, plug-in, flussi e integrazioni.

Riferimenti liquid alle tabelle di metadati

Sostituire l'accesso diretto entities['adx_*'] con un oggetto Liquid supportato, se disponibile. Ad esempio, utilizzare l'oggetto Liquid weblinks anziché interrogare direttamente adx_weblinkset o le tabelle correlate. Esaminare ogni utilizzo perché l'oggetto restituito e gli attributi disponibili possono differire.

Riferimenti FetchXML alle tabelle di metadati

Sostituire i riferimenti di entità adx_ diretta con la tabella virtuale o la query powerpagecomponent corrispondente e filtrare in base a powerpagecomponenttype

Esempio di modello di dati standard:

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

Esempio di modello di dati avanzato:

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

Flussi di lavoro personalizzati e plug-in

Effettuare il refactoring della logica personalizzata di workflow e plug-in registrata nelle tabelle adx_. Registrare la logica aggiornata nella tabella del modello di dati avanzata appropriata e usare lo schema e gli attributi avanzati. Testare il comportamento di creazione, aggiornamento, eliminazione e sicurezza in un ambiente non di produzione.

Informazioni di riferimento sui comandi

Informazioni di riferimento sul tipo di componente del sito

Quando si esegue una query powerpagecomponent, usare i valori seguenti nel filtro powerpagecomponenttype .

Informazioni di riferimento sulla soluzione modello EDM

Eseguire pac solution list --includeSystemSolutions per verificare che sia installata la soluzione del modello di dati avanzato per il modello del sito.

Contenuti correlati

• Modello di dati ottimizzato
• Riferimento di Power Platform CLI per Power Pages
• Usare l'interfaccia della riga di comando di Power Platform con Power Pages
• Aggiornare le soluzioni Power Pages