Migrarea site-urilor cu modele de date standard către modele de date îmbunătățite (previzualizare)

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

În acest articol, aflați cum să migrați site-ul existent cu model de date standard 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 particularizarea pentru metadatele existente standard ale site-ului

  1. Deschideți o linie de comandă.

  2. Folosește următoarea comandă pentru a te autentifica la organizația din mediul tău, pentru a descărca înregistrarea site-ului web pentru migrare. Dataverse Power Platform

    pac auth create -u [Dataverse URL]

    Exemplu

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

    Mai multe informații: creare autorizare pac

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

    pac pages list

    Informații suplimentare: lista de pagini pac

  4. Folosește următoarea comandă pentru a descărca raportul de personalizare.

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

    Exemplu

    pac pages 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 instrucțiunile din raport pentru a o remedia după migrarea la modelul de date îmbunătățit. Mai multe informații: Considerații privind personalizarea site-ului la migrarea site-urilor de la modelul de date standard la cel îmbunătățit

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

Folosește următoarea comandă pentru a migra datele site-ului tău către modelul de date îmbunătățit.

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

Modul poate avea 3 valori:

Exemplu

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

Instrumentul de migrare verifică soluțiile. Dacă există o soluție standard pentru modelul de date fără o soluție îmbunătățită corespunzătoare pentru modelul de date menționat, se afișează 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ă pachete de modele de date îmbunătățite corespunzătoare pentru a asigura buna funcționare a site-ului web migrat. Pentru a obține aceste pachete de modele de date îmbunătățite, trebuie să creați un site nou pentru șablonul corespunzător (mediul trebuie 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
  • Întrebări frecvente

Important

Modelul de date îmbunătățit susține crearea de noi site-uri pentru Comunitate (Dynamics 365), Customer Self Service Portal (Dynamics 365), Employee Self Service Portal (Dynamics 365) și Partner Portal (Dynamics 365), însă site-urile create anterior cu aceste șabloane folosind modelul standard de date nu pot fi încă migrate.

Pasul 3. Verificați starea de migrare

Folosește următoarea comandă pentru a verifica starea migrării site-ului tău:

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

Exemplu

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

Notă

Dacă migrarea site-ului durează mai mult decât era anticipat, acest lucru se poate datora 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.

Pasul 4. Actualizați versiunea modelului de date pentru site, după migrarea reușită a datelor

Folosește următoarea comandă pentru actualizarea versiunii modelului de date al site-ului:

pac pages 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” adăugat la adresa URL a site-ului web. Pentru a vizualiza aceste opțiuni, utilizatorul trebuie să aibă un rol web cu toate permisiunile de acces la site-ul web atribuite. ...
  • După actualizarea versiunii modelului de date al site-ului, înregistrarea site-ului web legată de modelul de date standard va fi dezactivată. În schimb, site-ul va face acum referire la înregistrarea site-ului web asociată cu modelul de date îmbunătățit.
  • Utilizatorul trebuie 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 pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

Revenirea site-ului migrat de la modelul de date îmbunătățit la modelul de date standard

Folosiți următoarea comandă pentru a reveni la modelul de date îmbunătățit al unui site cu model de date standard după migrare:

pac pages 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ă, iar înregistrarea site-ului web pentru modelul de date standard va fi reactivată.

Exemplu

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

Migrarea unui site de producție de la un model de date standard la unul î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 site-ului de producție să fie efectuată în afara orelor de program.

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

  1. Încercați migrarea pe site în mediul copiat utilizând comanda PAC CLI migrate-datamodel .
  2. Adăugați datele de configurare a site-ului în soluția gestionată și importați-le în mediul de producție.
  3. Folosește comenzile CLI PAC pentru a migra datele care nu sunt de configurare și finalizează procesul prin actualizarea versiunii modelului de date pentru producție.

Notă

Pentru migrare, ID-ul site-ului web sursă și cel de producție sunt aceleași.

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

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

Există cinci tipuri de personalizări ale site-ului în tabelele de metadate ADX:

Notă

Toate remedierile legate de personalizare vor fi efectuate după migrarea la modelul de date îmbunătățit.

Coloane personalizate în tabelele de 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 asociată cu powerpagescomponent. Utilizați Spațiul de lucru Date pentru crearea tabelelor.

Creați tabelul contoso_webpage în modelul de date îmbunătățit pentru a corecta 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 contoso_pagelogs tabelul.

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 Date pentru crearea tabelelor.

Referințe la tabelul Adx în fragmentul de cod Liquid

Pentru a remedia această personalizare în modelul de date îmbunătățit, înlocuiți referințele tabelului ADX din Liquid Code cu referințe mspp pentru tabelele virtuale ale modelului de date îmbunătățit. Alternativ, puteți utiliza tabelul Site Component (logical name powerpagecomponent) împreună cu atributul Component Type (logical name powerpagecomponenttype) pentru a prelua referințele corespunzătoare.

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

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

Referințe la tabelul Adx în fișierul XML de tip „fetch”

Pentru a remedia această personalizare în modelul de date îmbunătățit, înlocuiți referințele tabelului ADX din fișierul XML Fetch cu referințe directe la tabelele virtuale ale modelului de date îmbunătățit. Alternativ, puteți utiliza tabelul Site Component (logical name powerpagecomponent) împreună cu atributul Component Type (logical name powerpagecomponenttype) pentru a prelua referințele corespunzătoare.

Model de date standard: Numele tabelului adx_webrole este utilizat în cadrul interogării XML fetch.

{% 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-ului (nume logic powerpagecomponent) împreună cu atributul 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 componentei 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 tabelele adx

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

De exemplu, dacă un utilizator a înregistrat fluxul de lucru/pluginul în tabelul *Primary Entity* (Entitate principală) ca *Web Page* (nume logic) din modelul de date standard, atunci codul din fluxul de lucru/plugin trebuie modificat în tabelul *Site Component* (nume logic) și atributele sale pentru modelul de date îmbunătățit. adx_webpagepowerpagecomponent

Utilizați tabelul Componente site în cadrul fluxului de lucru și atributele sale pentru modelul de date îmbunătățit

Probleme cunoscute

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

  • Last updated on