Dela via

Migrera webbplatsen för standarddatamodell till en förbättrad datamodell (förhandsgranskning)

  • Artikel

[Det här ämnet är en förhandsversion av dokumentationen och kan ändras.]

I denna artikel lär du dig hur du migrerar den befintliga webbplatsen för standarddatamodell till den förbättrade datamodellen.

Viktigt

  • Denna funktion är en förhandsversion.
  • Förhandsversionsfunktioner ska inte användas i produktion och funktionerna kan vara begränsade. funktionerna är tillgängliga före den officiella publiceringen så att kunderna kan få tillgång tidigare och ge oss feedback.

Förutsättningar

Steg 1. Hämta och kontrollera anpassning av befintliga standardmetadata för webbplatser

  1. Öppna kommandotolken.

  2. Använd följande kommando för att autentisera för Dataverse-organisationen för Power Platform-miljön om du vill hämta webbplatsposten för migrering.

    pac auth create -u [Dataverse URL]

    Exempel

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

    Mer information: pac auth create

  3. Använd följande kommando för att skapa en lista över webbplatser i den aktuella organisationen.

    pac powerpages list

    Mer information: pac powerpages list

  4. Använd följande kommando för att hämta anpassningsrapporten.

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

    Exempel

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

Om du hittar någon anpassning i den hämtade rapporten följer du instruktionerna i rapporten för att åtgärda den efter migreringen till en förbättrad datamodell. Mer information: Att tänka på när du ska anpassa webbplatser när du migrerar webbplatser från standard till förbättrad datamodell

Steg 2. Migrera webbplatsen från standard till en förbättrad datamodell

Använd följande kommando när du migrerar webbplatsdata till den förbättrade datamodellen.

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

Läget kan ha tre värden:

Exempel

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

Migreringsverktyget verifierar lösningarna. Om det finns en standardlösning för en datamodell utan en respektive förbättrad datamodellösning för den nämnda mallen visas en varning: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Det finns specifika mallar, till exempel Programregistrering och Schemalägg och Hantera möten, som kräver matchande förbättrade datamodellpaket för att säkerställa att den migrerade webbplatsen fungerar som den ska. För att kunna hämta dessa förbättrade datamodellpaket måste du skapa en ny webbplats för motsvarande mall (miljön bör aktiveras för den förbättrade datamodellen) för att kunna tillhandahålla lösningar för migrering som är kompatibla med den förbättrad datamodellen.

Mallar som stöds för migrering

Webbplatser med följande mallar stöds för migrering:

  • Startlayout 1-5
  • Appen bearbetas
  • Tom sida
  • Programregistrering
  • Schemalägg och hantera möten

Steg 3. Verifiera migreringsstatus

Kontrollera migreringsstatus för webbplatsen med hjälp av följande kommando:

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

Exempel

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

Kommentar

Om migreringen av webbplats tar längre tid än förväntat kan det bero på mängden data. Om kommandotolken stängs öppnar du en ny kommandotolk och använder kommandot i det här steget för att verifiera webbplatsens status.

Steg 4. Uppdatera webbplatsens datamodellversion efter datamigrering

Använd följande kommando för att uppdatera webbplatsens datamodellversion:

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

Kommentar

  • Du hittar portal-ID:t genom att gå till webbplatsen med "/_services/about" som tillägg till webbplatsens URL. För att kunna visa de här alternativen bör användaren ha en webbroll med alla behörigheter för webbplatsåtkomst tilldelade.
  • När du har uppdaterat webbplatsens datamodellversion kommer webbplatsposten som är kopplad till den standardiserade datamodellen att inaktiveras. Istället refererar webbplatsen till den webbplatspost som är kopplad till den förbättrade datamodellen.
  • Användaren bör ha någon av följande roller för att köra migreringskommandot med argumentet updateDatamodelVersion eller revertToStandardDataModel. När du gör detta utför du administratörsåtgärd för att byta till den förbättrade datamodellen eller vice versa.

Exempel

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

Återställ migrerad webbplats från förbättrad till standarddatamodell

Använd följande kommando för att återställa en webbplats för standarddatamodell till en förbättrad datamodell efter migreringen:

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

Kommentar

När du växlar tillbaka en migrerad webbplats från den förbättrade datamodellen till standarddatamodellen inaktiveras webbplatsposten som är kopplad till den förbättrade datamodellen och webbplatsposten för standarddatamodellen återaktiveras.

Exempel

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

Migrera en produktionswebbplats från standard till en förbättrad datamodell

Innan du migrerar en produktionswebbplats rekommenderar vi att du skapar en fullständig kopia av produktionswebbplatsen. Vi rekommenderar också att produktionsmigrering utförs utanför kontorstid.

Använd dessa steg för att migrera din produktionswebbplats till den förbättrade datamodellen:

  1. Prova migrering för webbplatsen i den kopierade miljön med kommandot PAC CLI migrate-datamodel.
  2. Lägg till webbplatskonfigurationsdata för hanterad lösning och importera produktionsmiljön.
  3. Använd kommandon PAC CLI för att migrera icke-konfigurationsdata och avsluta dem genom att uppdatera datamodellversionen för produktion.

Kommentar

För migrering är ID för käll- och produktionswebbplats samma.

Att tänka på när du ska anpassa webbplatser när du migrerar webbplatser från standard till förbättrad datamodell

Det här avsnittet innehåller vägledning om hur du åtgärdar anpassning av en webbplatsmigrering från standard till förbättrad datamodell.

Det finns fem typer av webbplatsanpassningar i adx-metadatatabeller:

Kommentar

Alla anpassningsrelaterade korrigeringar görs efter migreringen till den förbättrade datamodellen.

Anpassade kolumner i adx-metadatatabeller

Om du vill åtgärda anpassningen i en förbättrad datamodell skapar du en relation mellan systemtabeller och en ny anpassad tabell och migrerar data till den nya tabellen.

Standarddatamodell: Tabellen innehåller adx_webpage en anpassad kolumn som contoso_pagetype.

Förbättrad datamodell: Skapa en ny tabell med namnet contoso_webpage. Detta omfattar en kolumn som kallas contoso_pagetype och en uppslagskolumn contoso_webpage_id som associeras med powerpagescomponent. Använd Dataarbetsytan för att skapa tabeller.

Skapa tabellen contoso_webpage i en förbättrad datamodell för att åtgärda kod

Relation mellan anpassade tabeller och adx-tabeller

Om du vill åtgärda anpassningen i en förbättrad datamodell skapar du en relation mellan anpassade tabeller och systemtabeller.

Standarddatamodell: Tabellen adx_webpage har en relation med namnet adx_webpage_contoso_pagelogs i contoso_pagelogs-tabellen.

Förbättrad datamodell: Skapa en ny relation med namnet powerpagecomponent_contoso_pagelogs med contoso_webpage-tabellen. Använd Dataarbetsytan för att skapa tabeller.

Adx-tabellreferenser i Liquid-kodavsnitt

Om du vill åtgärda anpassningen i den förbättrade datamodellen ersätter du adx-tabellreferenserna i Liquid-kod med mspp virtuella tabellreferenser i den förbättrade datamodellen. Alternativt kan du använda tabellen Webbplatskomponent (logiskt namn powerpagecomponent) tillsammans med attributet Komponenttyp (logiskt namn powerpagecomponenttype) för att hämta motsvarande referenser.

Standarddatamodell:entities Liquid-tagg används för åtkomst till värden för webblänkar i {% assign app_weblinks= entities['adx_weblinks'] %}-kod.

Förbättrad datamodell: Istället för att använda webblänkar via entities Liquid-tagg använder du respektive Liquid-objekt. entities[adx_weblinks] direkt. I det här fallet entities['adx_weblinks'] kan den ersättas med weblinks Liquid-objekt.

Adx-tabellreferenser i fetch xml

Om du vill åtgärda anpassningen i den förbättrade datamodellen ersätter du adx-tabellreferenserna i fetch xml med direkta virtuella tabellreferenser i den förbättrade datamodellen. Alternativt kan du använda tabellen Webbplatskomponent (logiskt namn powerpagecomponent) tillsammans med attributet Komponenttyp (logiskt namn powerpagecomponenttype) för att hämta motsvarande referenser.

Standarddatamodell: Tabellnamnet används adx_webrole i Fetch XML-frågan.

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

Förbättrad datamodell: Använd Webbplatskomponent (logiskt namn powerpagecomponent) tillsammans med attributet Komponenttyp (logiskt namn powerpagecomponenttype) för att hämta motsvarande referenser.

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

Typ och värden för webbplatskomponent

Komponenttyp Värde
Publiceringstillstånd 1
Webbsida 2
Webbfil 3
Webblänksuppsättning 4
Webblänk 5
Sidmall 6
Innehållskodavsnitt 7
Webbmall 8
Webbplatsinställning 9
Åtkomstkontrollregel för webbsida 10
Webbroll 11
Webbplatsåtkomst 12
Webbplatsmarkör 13
Grundläggande formulär 15
Metadata för grundläggande formulär 16
List 17
Tabellbehörighet 18
Avancerat formulär 19
Avancerat formulärsteg 20
Metadata för avancerat formulär 21
Undersökningsplacering 24
Annonsplacering 26
Robotkonsument 27
Kolumnbehörighetsprofil 28
Kolumnbehörighet 29
Omdirigera 30
Övergångsregel för publiceringstillstånd 31
Genväg 32
Molnflöde 33
UX-komponent 34

Anpassat arbetsflöde och plugin-program i adx-tabeller

För att kunna åtgärda anpassningen i en förbättrad datamodell måste arbetsflödes- och plugin-logiken registreras igen och registreras på nytt i respektive tabell.

Till exempel, om en användare registrerade arbetsflödet/plugin-programmet till Primär entitet som tabellen Webbsida (logiskt namn adx_webpage) i standarddatamodellen måste koden i arbetsflödet/plugin-programmet ändras till tabellen Webbplatskomponent (logiskt namn powerpagecomponent) och dess attribut för den förbättrade datamodellen.

Använd tabellen Webbplatskomponent i arbetsflödet och attributen för den förbättrade datamodellen

Kända problem

Migreringskommandot bearbetar endast en grupp med 5 000 poster från standarddatamodellen till den förbättrade datamodellen.