Delen via

Standaardgegevensmodelsites migreren naar het verbeterde gegevensmodel (preview)

  • Artikel

[Dit onderwerp maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

In dit artikel ontdekt u hoe u uw bestaande standaardgegevensmodelsite kunt migreren naar het verbeterde gegevensmodel.

Belangrijk

  • Dit is een previewfunctie.
  • Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

Vereisten

Stap 1. Download en controleer de aanpassing voor bestaande standaard sitemetagegevens

  1. Open een opdrachtprompt.

  2. Gebruik de volgende opdracht om u te authenticeren bij de Dataverse-organisatie voor uw Power Platform-omgeving en de websiterecord te downloaden voor migratie.

    pac auth create -u [Dataverse URL]

    Voorbeeld

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

    Meer informatie: pac auth create

  3. Gebruik de volgende opdracht om een lijst met websites in de huidige organisatie te genereren.

    pac powerpages list

    Meer informatie: pac powerpages list

  4. Gebruik het onderstaande commando om het aanpassingsrapport te downloaden.

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

    Voorbeeld

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

Als u aanpassingen aantreft in het gedownloade rapport, volgt u de richtlijnen in het rapport om deze na de migratie naar het verbeterde gegevensmodel op te lossen. Meer informatie: Overwegingen bij het aanpassen van sites bij migratie van sites van standaard naar verbeterd gegevensmodel

Stap 2. De sitegegevens migreren van het standaard naar het verbeterde gegevensmodel

Gebruik het volgende commando om uw sitegegevens te migreren naar het verbeterde gegevensmodel.

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

De Modus kan 3 waarden hebben:

Voorbeeld

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

De migratietool verifieert de oplossingen. Als er een oplossing met standaard gegevensmodel aanwezig is zonder een respectieve oplossing met het verbeterde gegevensmodel voor de genoemde sjabloon, wordt een waarschuwing weergegeven: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Er zijn specifieke sjablonen, zoals Programmaregistratie en Vergaderingen plannen en beheren, waarvoor bijpassende verbeterde gegevensmodelpakketten nodig zijn om ervoor te zorgen dat de gemigreerde website naar behoren functioneert. Om deze pakketten met verbeterd gegevensmodel te verkrijgen, moet u een nieuwe site maken voor de overeenkomstige sjabloon (de omgeving moet zijn ingeschakeld voor het verbeterde gegevensmodel) om oplossingen te bieden die compatibel zijn met het verbeterde gegevensmodel voor migratie.

Ondersteunde sjablonen voor migratie

Sites met de volgende sjablonen worden ondersteund voor migratie:

  • Starter-indeling 1-5
  • Verwerken van toepassing
  • Lege pagina
  • Programmaregistratie
  • Vergaderingen plannen en beheren

Stap 3. De migratiestatus controleren

Gebruik de volgende opdracht om de migratiestatus van uw site te verifiëren:

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

Voorbeeld

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

Opmerking

Als de migratie van uw site langer duurt dan verwacht, kan dit te wijten zijn aan de hoeveelheid gegevens. Als uw opdrachtprompt sluit, opent u een nieuwe opdrachtprompt en gebruikt u de opdracht in deze stap om de status van uw site te controleren.

Stap 4. De versie van het sitegegevensmodel bijwerken na een geslaagde gegevensmigratie

Gebruik de volgende opdracht om de versie van het sitegegevensmodel bij te werken:

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

Opmerking

  • U kunt het Portal-ID vinden door naar de website te navigeren met '/_services/about' toegevoegd aan de URL van de website. Om deze opties te kunnen bekijken, moet de gebruiker over een webrol beschikken waaraan alle toegangsmachtigingen voor websites zijn toegewezen.
  • Nadat de versie van het sitegegevensmodel is bijgewerkt, wordt de websiterecord die aan het standaardgegevensmodel is gekoppeld gedeactiveerd. In plaats daarvan verwijst de site nu naar de websiterecord die aan het verbeterde gegevensmodel is gekoppeld.
  • De gebruiker moet over een van de volgende rollen beschikken om de migratieopdracht uit te voeren met updateDatamodelVersion of revertToStandardDataModel argumenten. Omdat hierdoor een beheerdersactie wordt uitgevoerd om uw site over te schakelen naar het verbeterde gegevensmodel of omgekeerd.

Voorbeeld

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

Een gemigreerde site terugzetten van verbeterd naar standaard gegevensmodel

Gebruik de volgende opdracht om een site met een standaardgegevensmodel na de migratie terug te zetten naar een verbeterd gegevensmodel:

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

Opmerking

Wanneer u een gemigreerde site van het verbeterde gegevensmodel terugschakelt naar het standaardgegevensmodel, wordt de websiterecord die is gekoppeld aan het verbeterde gegevensmodel gedeactiveerd en wordt de websiterecord voor het standaardgegevensmodel opnieuw geactiveerd.

Voorbeeld

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

Een productiesite migreren van het standaard naar het verbeterde gegevensmodel

Voordat u een productiesite migreert, raden we u aan een volledige kopie van de productiesite te maken. Ook raden we u aan de migratie van de productiesite buiten kantooruren uit te voeren.

Gebruik deze stappen om uw productiesite te migreren naar het verbeterde gegevensmodel:

  1. Probeer de migratie op de site in de gekopieerde omgeving uit met behulp van de PAC CLI migrate-datamodel-opdracht.
  2. Voeg siteconfiguratiegegevens toe aan een beheerde oplossing en importeer deze in de productieomgeving.
  3. Gebruik PAC CLI-opdrachten om niet-configuratiegegevens te migreren en voltooi deze door de gegevensmodelversie bij te werken voor productie.

Opmerking

Voor migratie zijn de bron- en productiewebsite-id hetzelfde.

Overwegingen bij het aanpassen van sites bij migratie van sites van standaard naar verbeterd gegevensmodel

Deze sectie biedt richtlijnen voor het herstellen van aanpassingen voor een sitemigratie van een standaard naar een verbeterd gegevensmodel.

Er zijn vijf soorten siteaanpassingen in adx-metagegevenstabellen:

Opmerking

Alle aan de aanpassing gerelateerde oplossingen worden uitgevoerd na de migratie naar het verbeterde gegevensmodel.

Aangepaste kolommen in adx-metagegevenstabellen

Om deze aanpassing in het verbeterde gegevensmodel te herstellen, maakt u een relatie tussen systeemtabellen en de nieuwe aangepaste tabel en migreert u de gegevens naar de nieuwe tabel.

Standaardgegevensmodel: De tabel adx_webpage bevat een aangepaste kolom als contoso_pagetype.

Verbeterd datamodel: Maak een nieuwe tabel met de naam contoso_webpage. Deze zal een kolom bevatte met de naam contoso_pagetype en een opzoekkolom contoso_webpage_id die is gekoppeld aan powerpagescomponent. Gebruik de Gegevenswerkruimte voor het maken van tabellen.

Een tabel contoso_webpage maken in het verbeterde gegevensmodel om code te corrigeren

Relatie tussen aangepaste tabellen en adx-tabellen

Om deze aanpassing in het verbeterde gegevensmodel te herstellen, maakt u een relatie tussen aangepaste tabellen en systeemtabellen.

Standaardgegevensmodel: De tabel adx_webpage heeft een relatie met de naam adx_webpage_contoso_pagelogs met de contoso_pagelogs tabel.

Verbeterd datamodel: Maak een nieuwe relatie met de naam powerpagecomponent_contoso_pagelogs met de contoso_webpage tabel. Gebruik de Gegevenswerkruimte voor het maken van tabellen.

Adx-tabelverwijzingen in Liquid-codefragment

Om deze aanpassing in het verbeterde gegevensmodel te herstellen, vervangt u de adx-tabelverwijzingen in Liquid-code door mspp-referenties voor virtuele tabellen in het verbeterde gegevensmodel. U kunt ook de tabel Siteonderdeel (logische naam powerpagecomponent) gebruiken samen met het kenmerk Onderdeeltype (logische naam powerpagecomponenttype) om de bijbehorende verwijzingen op te halen.

Standaard datamodel:entities de liquid tag wordt gebruikt om toegang te krijgen tot weblinkwaarden in {% assign app_weblinks= entities['adx_weblinks'] %} code.

Verbeterd datamodel: gebruik in plaats van weblinks via de entities liquid-tag, de bijbehorende liquid-objecten. entities[adx_weblinks] direct. In dit geval kan entities['adx_weblinks'] worden vervangen door het liquid object weblinks.

Adx-tabelverwijzingen in fetch-XML

Om deze aanpassing in het verbeterde gegevensmodel te herstellen, vervangt u de tabelverwijzingen in fetch xml door rechtstreekse verwijzingen naar virtuele tabellen in het verbeterde gegevensmodel. U kunt ook de tabel Siteonderdeel (logische naam powerpagecomponent) gebruiken samen met het kenmerk Onderdeeltype (logische naam powerpagecomponenttype) om de bijbehorende verwijzingen op te halen.

Standaardgegevensmodel: De tabelnaam adx_webrole wordt gebruikt in de fetch-xml-query.

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

Verbeterd datamodel: gebruik Site Component (logische naam powerpagecomponent) in combinatie met het kenmerk Component Type (logische naam powerpagecomponenttype) om de bijbehorende referenties op te halen.

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

Type en waarden van siteonderdeel

Onderdeeltype Weergegeven als
Publicatiestatus 0
Webpagina 2
Webbestand 5
Webkoppelingsset 4
Webkoppeling 5
Paginasjabloon 6
Inhoudsfragment 7
Websjabloon 8
Site-instelling 9
Toegangsbeheerregel voor webpagina's 10
Webrol 11
Websitetoegang 12
Sitemarkering 13
Basisformulier 15
Metagegevens van basisformulier 16
List 17
Tabelmachtiging 18
Geavanceerd formulier 19
Stap van geavanceerd formulier 20
Metagegevens van geavanceerd formulier 21
Plaatsing van peiling 24
Plaatsing van advertentie 26
Botconsument 27
Profiel voor kolommachtiging 28
Kolommachtiging 29
Omleiden 30
Overgangsregel voor publicatiestatussen 31
Snelkoppeling 32
Cloudstroom 33
UX-onderdeel 34

Aangepaste werkstroom en invoegtoepassingen in adx-tabellen

Om deze aanpassing in het verbeterde gegevensmodel te herstellen, moeten de logica voor werkstroom en invoegtoepassing opnieuw worden opgebouwd en opnieuw worden geregistreerd in de betreffende tabel van de site.

Als een gebruiker bijvoorbeeld de werkstroom/invoegtoepassing heeft geregistreerd bij de Primaire Entiteit als Webpagina (logische naam adx_webpage) tabel in het standaard gegevensmodel, dan moet de code binnen de werkstroom/invoegtoepassing worden gewijzigd in Siteonderdeel (logische naam powerpagecomponent) tabel en kenmerken voor het verbeterde gegevensmodel.

De tabel Siteonderdeel gebruiken binnen de werkstroom en de bijbehorende kenmerken voor het verbeterde gegevensmodel

Bekende problemen

De migratieopdracht verwerkt slechts een batch van 5k-records van het standaardgegevensmodel naar het verbeterde gegevensmodel.