Partajați prin

Migrați site-urile cu modele de date standard către modele de date îmbunătățite (versiune preliminară)

  • Articol

[Acest subiect este documentație preliminară și poate fi modificat.]

În acest articol, aflați cum să migrați site-ul dvs. de model de date standard existent la modelul de date îmbunătățit.

Important

  • Aceasta este o caracteristică de previzualizare.
  • Caracteristicile în regim de previzualizare nu sunt destinate utilizării în producție și pot avea funcționalitate restricționată. Aceste caracteristici sunt disponibile înainte de lansarea oficială, astfel încât clienții să poată obține acces din timp și să poată oferi feedback.

Cerințe preliminare

Pasul 1. Descărcați și verificați personalizarea pentru metadatele standard existente ale site-ului

  1. Deschideți un prompt de comandă.

  2. Utilizați următoarea comandă pentru a vă autentifica la Dataverse organizația pentru Power Platform mediul dvs. pentru a descărca înregistrarea site-ului web pentru migrare.

    pac auth create -u [Dataverse URL]

    Exemplu

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

    Mai multe informații: pac auth create

  3. Utilizați următoarea comandă pentru a genera o listă de site-uri web din organizația curentă.

    pac powerpages list

    Mai multe informații: lista de pagini de putere pac

  4. Utilizați următoarea comandă pentru a descărca raportul de personalizare.

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

    Exemplu

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

Dacă găsiți vreo personalizare în raportul descărcat, urmați îndrumările din raport pentru a o remedia după migrarea la modelul de date îmbunătățit. Mai multe informații: Considerații pentru personalizarea site-ului la migrarea site-urilor de la modelul standard la modelul de date îmbunătățit

Pasul 2. Migrați datele site-ului de la modelul standard la cel îmbunătățit

Utilizați următoarea comandă pentru a migra datele site-ului dvs. la modelul de date îmbunătățit.

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

Modul poate avea 3 valori:

Exemplu

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

Instrumentul de migrare verifică soluțiile. Dacă există o soluție de model de date standard prezentă fără o soluție de model de date îmbunătățită respectivă pentru șablonul menționat, este afișat un avertisment: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Există șabloane specifice, cum ar fi înregistrarea programului și programarea și gestionarea întâlnirilor, care necesită potrivire pachete de modele de date îmbunătățite pentru a asigura funcționarea corectă a site-ului web migrat. Pentru a obține aceste pachete de model de date îmbunătățite, trebuie să creați un nou site pentru șablonul corespunzător (mediul ar trebui să fie activat pentru modelul de date îmbunătățit) pentru a oferi soluții compatibile cu modelul de date îmbunătățit pentru migrare.

Șabloane acceptate pentru migrare

Site-urile cu următoarele șabloane sunt acceptate pentru migrare:

  • Aspect pentru începători 1-5
  • Procesarea aplicațiilor
  • Pagină necompletată
  • Înregistrarea în program
  • Planificarea și gestionarea întâlnirilor

Pasul 3. Verificați starea migrației

Utilizați următoarea comandă pentru a verifica starea de migrare a site-ului dvs.:

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

Exemplu

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

Notă

Dacă migrarea site-ului dvs. durează mai mult decât era anticipat, poate fi din cauza volumului de date. Dacă linia de comandă se închide, deschideți o nouă linie de comandă și utilizați comanda din acest pas pentru a verifica starea site-ului dvs.

Pasul 4. Actualizați versiunea modelului de date de site după migrarea cu succes a datelor

Utilizați următoarea comandă update site data model version:

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

Notă

  • Puteți găsi ID-ul portalului navigând pe site-ul web cu „/_services/about” atașat la adresa URL a site-ului web. Pentru a vedea aceste opțiuni, utilizatorul trebuie să aibă un rol web cu toate permisiunile de acces la site-ul alocate.
  • După ce versiunea modelului de date de site este actualizată, înregistrarea site-ului web legată de modelul de date standard va fi dezactivată. În schimb, site-ul se va referi acum la înregistrarea site-ului web asociată cu modelul de date îmbunătățit.
  • Utilizatorul ar trebui să aibă oricare dintre următoarele roluri pentru a executa comanda de migrare cu argumente updateDatamodelVersion sau revertToStandardDataModel . Deoarece aceasta va efectua o acțiune de administrare pentru a schimba site-ul dvs. pentru a îmbunătăți modelul de date sau invers.

Exemplu

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

Reveni a migrat site-ul de la modelul de date îmbunătățit la cel standard

Utilizați următoarea comandă pentru a reveni un site de model de date standard la un model de date îmbunătățit după migrare:

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

Notă

Când comutați un site migrat de la modelul de date îmbunătățit înapoi la modelul de date standard, înregistrarea site-ului web asociată cu modelul de date îmbunătățit va fi dezactivată și înregistrarea site-ului web pentru modelul de date standard va fi reactivată.

Exemplu

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

Migrați un site de producție de la un model de date standard la un model îmbunătățit

Înainte de a migra un site de producție, vă recomandăm să creați o copie completă a site-ului de producție. De asemenea, recomandăm ca migrarea locului de producție să fie efectuată în afara orelor de lucru.

Utilizați acești pași pentru a migra site-ul dvs. de producție la modelul de date îmbunătățit:

  1. Încercați migrarea pe site în mediul copiat folosind comanda PAC CLI migrate-datamodel .
  2. Adăugați datele de configurare a site-ului la soluție gestionată și importați-l în mediul de producție.
  3. Utilizați comenzile PAC CLI pentru a migra datele neconfigurabile și a le finaliza prin actualizarea versiunii modelului de date pentru producție.

Notă

Pentru migrare, sursa și id-ul site-ului de producție sunt același.

Considerații pentru personalizarea site-urilor la migrarea site-urilor de la modelul standard la modelul de date îmbunătățit

Această secțiune oferă îndrumări pentru remedierea personalizării pentru o migrare a site-ului de la un model de date standard la un model îmbunătățit.

Există cinci tipuri de personalizări ale site-urilor pe tabelele de metadate adx:

Notă

Toate corecțiile legate de personalizare vor fi făcute după migrarea la modelul de date îmbunătățit.

Coloane personalizate pe tabelele cu metadate adx

Pentru a remedia această personalizare în modelul de date îmbunătățit, creați o relație între tabelele de sistem și noul tabel personalizat și migrați datele în noul tabel.

Model de date standard: Tabelul adx_webpage conține o coloană personalizată ca contoso_pagetype.

Model de date îmbunătățit: Creați un tabel nou numit contoso_webpage. Aceasta va include o coloană numită contoso_pagetype și o coloană de căutare contoso_webpage_id care este asociată cu powerpagescomponent. Utilizați spațiul de lucru pentru date pentru crearea tabelelor.

Creați tabel contoso_webpage în modelul de date îmbunătățit pentru a remedia codul

Relația dintre tabelele personalizate și tabelele adx

Pentru a remedia această personalizare în modelul de date îmbunătățit, creați o relație între tabelele personalizate și tabelele de sistem.

Model de date standard: Tabelul adx_webpage are o relație numită adx_webpage_contoso_pagelogs cu tabelul contoso_pagelogs .

Model de date îmbunătățit: creați o nouă relație numită powerpagecomponent_contoso_pagelogs cu tabelul contoso_webpage . Utilizați spațiul de lucru pentru date pentru crearea tabelelor.

Referințe de tabel Adx în lichid fragment de cod

Pentru a remedia această personalizare în modelul de date îmbunătățit, înlocuiți referințele de tabel adx în cod lichid cu referințe mspp de tabele virtuale de model de date îmbunătățite. Ca alternativă, puteți utiliza tabelul Componenta site-ului (nume logic powerpagecomponent) împreună cu Tipul componentei (nume logic powerpagecomponenttype) atribut pentru a prelua referințele corespunzătoare.

Model de date standard:entities eticheta lichidă este utilizată pentru a accesa linkurile web valorile din {% assign app_weblinks= entities['adx_weblinks'] %} cod.

Model de date îmbunătățit: În loc să utilizați linkuri web prin entities etichetă lichidă, utilizați obiectele lichide respective. entities[adx_weblinks] direct. În acest caz entities['adx_weblinks'] poate fi înlocuit cu weblinks obiect lichid.

Referințe de tabel Adx în fetch xml

Pentru a remedia această personalizare în modelul de date îmbunătățit, înlocuiți referințele de tabel adx din fetch xml cu referințe directe de tabele virtuale de model de date îmbunătățite. Ca alternativă, puteți utiliza tabelul Componenta site-ului (nume logic powerpagecomponent) împreună cu Tipul componentei (nume logic powerpagecomponenttype) atribut pentru a prelua referințele corespunzătoare.

Model de date standard: numele tabelului adx_webrole este utilizat în interogarea de preluare xml.

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

Model de date îmbunătățit: Utilizați Componenta site (nume logic powerpagecomponent) împreună cu Tip component (nume logic powerpagecomponenttype) pentru a prelua referințele corespunzătoare.

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

Tipul și valorile componentelor site-ului

Tip de componentă Valoare
Stare de publicare 1
Pagină web 2
Fișier web 3
Set de linkuri web 4
Link web 5
Șablon de pagină 6
Fragment de conținut 7
Șablon web 8
Setare de site 9
Regula pentru controlul accesului la pagina web 10
Rol web 11
Acces la site-ul web 12
Marker de site 13
Formular de bază 15
Metadate formular de bază 16
Listă 17
Permisiune pentru tabel 18
Formular complex 19
Pas formular complex 20
Metadate de formular complex 21
Amplasare sondaj 24
Amplasare reclame 26
Consumator de roboți 27
Profil permisiune de coloană 28
Permisiune pentru coloană 29
Redirecționare 30
Regulă de tranziție pentru starea de publicare 31
Comandă rapidă 32
Flux pentru cloud 33
Componentă UX 34

Flux de lucru personalizat și pluginuri pe tabele adx

Pentru a remedia această personalizare în modelul de date îmbunătățit, fluxul de lucru și logica pluginului trebuie refactorizate și reînregistrate pe tabelul respectiv al site-ului.

De exemplu, dacă un utilizator a înregistrat fluxul de lucru/plugin-ul la Entitatea principală ca Pagina web (nume logic adx_webpage) din modelul de date standard, apoi codul din fluxul de lucru/plugin trebuie modificat la Componenta site (nume logic powerpagecomponent) tabelul și atributele acestuia pentru modelul de date îmbunătățit.

Utilizați tabelul Site Component în fluxul de lucru și atributele acestuia pentru modelul de date îmbunătățit

Probleme cunoscute

Comanda de migrare procesează doar un lot de înregistrări de 5K de la modelul de date standard la modelul de date îmbunătățit.