Migrazione dei siti del modello dati standard al modello dati avanzato (anteprima)

[Questo argomento fa parte della documentazione di pre-rilascio, pertanto è soggetto a modifiche.]

In questo articolo, scopri come eseguire la migrazione del sito del modello di dati standard esistente al modello dati avanzato.

Prerequisiti

• Devi installare Microsoft Power Platform CLI con la versione 1.31.6 o successiva per migrare i tuoi siti al modello dati avanzato. Ulteriori informazioni: Installa Power Platform CLI più recente
• Pacchetto del portale base di Dataverse 9.3.2307.x o versione successiva. 
• Pacchetto core Power Pages 1.0.2309.63 o successiva. Maggiori informazioni: Aggiornare la soluzione Power Pages
• Dovrai comprendere come utilizzare Power Platform CLI in Power Pages per completare i passaggi della migrazione. Se non hai familiarità con Power Platform CLI in Power Pages, potresti voler rivedere questa esercitazione di Power Platform CLI e fai riferimento a Comandi PAC CLI per lavorare con Power Pages.

Passaggio 1: Scarica e controlla la personalizzazione per i metadati del sito standard esistenti

1. Apri un prompt dei comandi.

2. Utilizza il comando seguente per autenticarti presso l'organizzazione Dataverse per il tuo ambiente Power Platform per scaricare il record del sito Web per la migrazione.

   pac auth create -u [Dataverse URL]

   Esempio

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

   Ulteriori informazioni: pac auth create

3. Utilizzare il comando seguente per generare un elenco di siti Web nell'organizzazione corrente.

   pac powerpages list

   Ulteriori informazioni: pac powerpages list

4. Usare il seguente comando per scaricare il report di personalizzazione.

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

   Esempio

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

Se trovi eventuali personalizzazioni nel report scaricato, segui le indicazioni nel report per correggerle dopo la migrazione al modello dati avanzato. Ulteriori informazioni: Considerazioni sulla personalizzazione del sito durante la migrazione dei siti dal modello dati standard a quello avanzato

Passaggio 2. Migrazione dei dati del sito dal modello dati standard al modello dati avanzato

Utilizza il comando seguente per eseguire la migrazione dei dati del sito al modello dati avanzato.

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

La Modalità può avere 3 valori:

• configurationData: esegue la migrazione dei metadati per il sito Web. Maggiori informazioni: Elenco delle tabelle in cui memorizzare i dati di configurazione

• configurationDataReferences: migrare i dati transazionali per il sito Web. Maggiori informazioni: Elenco delle tabelle in cui memorizzare i dati di non configurazione

• all: esegue la migrazione di entrambi i tipi di dati.

Esempio

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

Lo strumento di migrazione verifica le soluzioni. Se è presente una soluzione del modello di dati standard senza una rispettiva soluzione del modello di dati avanzata per il modello menzionato, viene visualizzato un avviso: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Esistono modelli specifici, come Registrazione programma e Pianifica e gestisci riunioni, che richiedono la corrispondenza di pacchetti di modelli di dati avanzati per garantire il corretto funzionamento del sito Web migrato. Per ottenere questi pacchetti di modelli di dati avanzati, è necessario creare un nuovo sito per il modello corrispondente (l'ambiente deve essere abilitato per il modello di dati avanzato) per fornire soluzioni compatibili con il modello di dati avanzato per la migrazione.

Modelli supportati per la migrazione

Per la migrazione sono supportati i siti con i seguenti modelli:

• Layout avvio 1-5
• Elaborazione applicazione
• Pagina vuota
• Registrazione programma
• Pianifica e gestisci riunioni

Passaggio 3: Verificare lo stato della migrazione

Utilizza il seguente comando per verificare lo stato della migrazione del tuo sito:

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

Esempio

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

Passaggio 4: Aggiorna la versione del modello di dati del sito dopo aver eseguito correttamente la migrazione dei dati

Utilizza il seguente comando per aggiornare la versione del modello dati del sito:

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

Esempio

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

Ripristina il sito migrato dal modello dati standard al modello dati avanzato

Utilizzare il comando seguente per ripristinare un sito dal modello di dati standard a un modello di dati avanzato dopo la migrazione:

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

Esempio

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

Esegui la migrazione di un sito di produzione dal modello dati standard al modello dati avanzato

Prima di eseguire la migrazione di un sito di produzione, consigliamo di creare una copia completa del sito di produzione. Consigliamo inoltre di effettuare la migrazione del sito di produzione durante gli orari non lavorativi.

Utilizza questi passaggi per eseguire la migrazione del sito di produzione al modello dati avanzato:

1. Prova la migrazione sul sito nell'ambiente copiato utilizzando il comando PAC CLI migrate-datamodel.
2. Aggiungi i dati di configurazione del sito a una soluzione gestita e importala nell'ambiente di produzione.
3. Utilizzare i comandi PAC CLI per eseguire la migrazione dei dati non di configurazione e completarla aggiornando la versione del modello dati per la produzione.

Considerazioni sulla personalizzazione del sito durante la migrazione dei siti dal modello dati standard a quello avanzato

Questa sezione fornisce indicazioni sulla correzione della personalizzazione per la migrazione del sito dal modello di dati standard a quello avanzato.

Esistono cinque tipi di personalizzazioni del sito sulle tabelle di metadati adx:

• Colonne personalizzate sulle tabelle di metadati adx
• Relazione tra tabelle personalizzate e le tabelle adx
• Riferimenti alla tabella Adx nel frammento di codice Liquid
• Riferimenti alla tabella Adx nel fetch XML
• Flusso di lavoro personalizzato e plugin su tabelle adx

Colonne personalizzate sulle tabelle di metadati adx

Per correggere questa personalizzazione nel modello dati avanzato, creare una relazione tra le tabelle di sistema e la nuova tabella personalizzata ed eseguire la migrazione dei dati nella nuova tabella.

Modello dati standard: La tabella adx_webpage contiene una colonna personalizzata come contoso_pagetype.

Modello dati avanzato: crea una nuova tabella denominata contoso_webpage. Ciò includerà una colonna chiamata contoso_pagetype e una colonna di ricerca contoso_webpage_id associata a powerpagescomponent. Utilizza l'area di lavoro Dati per la creazione di tabelle.

Relazione tra tabelle personalizzate e tabelle adx

Per correggere questa personalizzazione nel modello dati avanzato, crea una relazione tra le tabelle personalizzate e le tabelle di sistema.

Modello di dati standard: La tabella adx_webpage ha una relazione denominata adx_webpage_contoso_pagelogs con la tabella contoso_pagelogs.

Modello dati avanzato: crea una nuova relazione denominata powerpagecomponent_contoso_pagelogs con la tabella contoso_webpage. Utilizza l'area di lavoro Dati per la creazione di tabelle.

Riferimenti alla tabella Adx nel frammento di codice Liquid

Per correggere questa personalizzazione nel modello di dati avanzato, sostituisci i riferimenti alle tabelle adx nel codice Liquid con i riferimenti mspp alle tabelle virtuali del modello di dati avanzato. In alternativa, puoi utilizzare la tabella Componente sito (nome logico powerpagecomponent) insieme all'attributo Tipo componente (nome logico powerpagecomponenttype) per recuperare i riferimenti corrispondenti.

Modello di dati standard:entities il tag Liquid viene utilizzato per accedere ai valori dei collegamenti Web nel codice {% assign app_weblinks= entities['adx_weblinks'] %}.

Modello di dati avanzato: Invece di utilizzare collegamenti Web tramite entities tag Liquid, utilizza i rispettivi oggetti Liquid. entities[adx_weblinks] direttamente. In questo caso entities['adx_weblinks'] può essere sostituito con un oggetto Liquid weblinks.

Riferimenti alla tabella Adx nel fetch XML

Per correggere questa personalizzazione nel modello di dati avanzato, sostituisci i riferimenti alle tabelle adx in fetch xml con i riferimenti diretti alle tabelle virtuali del modello di dati avanzato. In alternativa, puoi utilizzare la tabella Componente sito (nome logico powerpagecomponent) insieme all'attributo Tipo componente (nome logico powerpagecomponenttype) per recuperare i riferimenti corrispondenti.

Modello di dati standard: Il nome della tabella adx_webrole viene utilizzato all'interno della query di recupero xml.

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

Modello di dati avanzato: Utilizzare Componente sito (nome logico powerpagecomponent) insieme all'attributo Tipo componente (nome logico powerpagecomponenttype) per recuperare i riferimenti corrispondenti.

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

Tipo e valori dei componenti del sito

Flusso di lavoro personalizzato e plug-in su tabelle adx

Per correggere questa personalizzazione nel modello di dati avanzato, è necessario sottoporre a refactoring e registrare nuovamente il flusso di lavoro e la logica del plug-in nella rispettiva tabella del sito.

Ad esempio, se un utente ha registrato il flusso di lavoro/plug-in nell'Entità primaria come tabella pagina Web (nome logico adx_webpage) nel modello di dati standard, il codice all'interno del flusso di lavoro/plug-in deve essere modificato nella tabella Componente sito (nome logico powerpagecomponent) e i relativi attributi per il modello di dati avanzato.

Problemi noti

Il comando della migrazione sta elaborando solo un batch di 5.000 record dal modello di dati standard al modello di dati avanzato.