Udostępnij za pośrednictwem

Migrowanie standardowej witryny modelu danych do rozszerzonego modelu danych (wersja zapoznawcza)

  • Artykuł

[Ten temat stanowi wstępną wersję dokumentacji i może ulec zmianie].

W tym artykule dowiesz się, jak przeprowadzić migrację istniejącej standardowej witryny modelu danych do rozszerzonego modelu danych.

Ważne

  • Jest to funkcja w wersji zapoznawczej.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Wymagania wstępne

Krok 1. Pobieranie i sprawdzanie dostosowywania istniejących standardowych metadanych witryny

  1. Otwórz wiersz polecenia.

  2. Użyj następującego polecenia w celu uwierzytelnienia w organizacji Dataverse dla środowiska Power Platform w celu pobrania rekordu witryny sieci Web do migracji.

    pac auth create -u [Dataverse URL]

    Przykład

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

    Więcej informacji: pac auth create

  3. Użyj poniższego polecenia, aby wygenerować listę witryn sieci Web w bieżącej organizacji.

    pac powerpages list

    Więcej informacji: pac powerpages list

  4. Aby pobrać raport o dostosowaniach, użyj następującego polecenia.

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

    Przykład

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

Jeśli w pobranym raporcie zostanie znalezione dostosowanie, należy postępować zgodnie z wytycznymi w raporcie, aby naprawić je po migracji do rozszerzonego modelu danych. Więcej informacji: Uwagi dotyczące dostosowywania witryny podczas migracji witryn ze standardowego do rozszerzonego modelu danych

Krok 2. Migrowanie danych witryny ze standardowego do rozszerzonego modelu danych

Użyj poniższego polecenia, aby przeprowadzić migrację danych witryny do rozszerzonego modelu danych.

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

Tryb może mieć 3 wartości:

Przykład

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

Narzędzie do migracji sprawdza rozwiązania. Jeśli we wspomnianym szablonie istnieje rozwiązanie standardowego modelu danych bez odpowiedniego rozwiązania rozszerzonego modelu danych, zostanie wyświetlone ostrzeżenie: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Istnieją określone szablony, takie jak Rejestracja w programie czy Planowanie spotkań i zarządzanie nimi, które wymagają dopasowania rozszerzonych pakietów modeli danych, aby zapewnić poprawne działanie zmigrowanych funkcji witryny internetowej. Aby uzyskać te pakiety rozszerzonych modeli danych, należy utworzyć nową witrynę dla odpowiedniego szablonu (w środowisku należy włączyć rozszerzony model danych) w celu zapewnienia ulepszonych rozwiązań zgodnych z modelami danych podczas migracji.

Szablony obsługiwane w przypadku migracji

Migracja witryn z następującymi szablonami jest obsługiwana:

  • Układ startowy 1–5
  • Przetwarzanie wniosku
  • Pusta strona
  • Rejestracja w programie
  • Planowanie spotkań i zarządzanie nimi

Krok 3. Sprawdzanie stanu migracji

Użyj następującego polecenia, aby sprawdzić stan migracji witryny:

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

Przykład

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

Uwaga

Jeśli migracja witryny trwa dłużej niż oczekiwano, może to być spowodowane wielkością danych. Jeśli wiersz polecenia zamknie się, otwórz nowy wiersz polecenia i użyj go w tym kroku, aby sprawdzić stan witryny.

Krok 4. Aktualizowanie wersji modelu danych witryny po pomyślnej migracji danych

Użyj następującej wersji modelu danych witryny aktualizacji poleceń:

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

Uwaga

  • Identyfikator portalu można znaleźć, przechodząc do witryny internetowej z elementem „/_services/about” dołączonym do jej adresu URL. Aby wyświetlić te opcje, użytkownik powinien mieć przypisaną rolę Internet ze wszystkimi uprawnieniami dostępu do witryny internetowej .
  • Po zaktualizowaniu wersji modelu danych witryny rekord witryny internetowej połączony ze standardowym modelem danych zostanie zdezaktywowany. Zamiast tego witryna będzie teraz odnosić się do rekordu witryny internetowej skojarzonego z rozszerzonym modelem danych.
  • Użytkownik powinien mieć dowolną z następujących ról do wykonywania polecenia migracji z argumentami updateDatamodelVersion lub revertToStandardDataModel. W ten sposób administrator wykonuje akcję mającą na celu przełączenie witryny na model danych lub na odwrót.

Przykład

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

Przywracanie migrowanej witryny z rozszerzonego do standardowego modelu danych

Użyj następującego polecenia, aby przywrócić witrynę standardową modelu danych do rozszerzonego modelu danych po migracji:

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

Uwaga

Po przełączeniu migrowanej witryny z rozszerzonego modelu danych z powrotem do standardowego modelu danych rekord witryny internetowej skojarzony z rozszerzonym modelem danych zostanie zdezaktywowany, a rekord witryny internetowej dla standardowego modelu danych zostanie ponownie uaktywniony.

Przykład

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

Migrowanie witryny produkcyjnej ze standardowego do rozszerzonego modelu danych

Przed migracją witryny produkcyjnej zaleca się utworzenie pełnej kopii jej witryny produkcyjnej. Zaleca się również, aby migrację witryny produkcyjnej przeprowadzić poza godzinami pracy.

Użyj tych kroków, aby przeprowadzić migrację witryny produkcyjnej do rozszerzonego modelu danych:

  1. Spróbuj wykonać migrację witryny w skopiowanym środowisku przy użyciu polecenia migrate-datamodel interfejsu wiersza polecenia PAC.
  2. Dodaj dane konfiguracji witryny do rozwiązania zarządzanego i zaimportuj ją do środowiska produkcyjnego.
  3. Użyj poleceń interfejsu wiersza polecenia PAC CLI w celu migrowania danych nieskonfigurowanych i ich ukończenia przez zaktualizowanie wersji modelu danych dla produktu.

Uwaga

Przy migracji źródłowy i produkcyjny identyfikator witryny internetowej są takie same.

Uwagi dotyczące dostosowywania witryny podczas migracji witryn ze standardowego do rozszerzonego modelu danych

W tej sekcji przedstawiono wskazówki dotyczące poprawiania dostosowań migracji witryny ze standardowego do rozszerzonego modelu danych.

W tabelach metadanych ADX istnieje pięć typów dostosowań witryny:

Uwaga

Wszystkie poprawki dotyczące dostosowywania zostaną wykonane po migracji do rozszerzonego modelu danych.

Niestandardowe kolumny w tabelach metadanych ADX

Aby poprawić to dostosowanie w rozszerzonym modelu danych, należy utworzyć relację między tabelami systemowymi a nową tabelą niestandardową oraz migrować dane do nowej tabeli.

Standardowy model danych standardowych: tabela adx_webpage zawiera niestandardową kolumnę jako contoso_pagetype.

Rozszerzony model danych: tworzenie nowej tabeli o nazwie contoso_webpage. Zawiera ona kolumnę o nazwie contoso_pagetype oraz kolumnę wyszukiwania contoso_webpage_id skojarzoną z powerpagescomponent. Użyj opcji Obszar roboczy danych w celu utworzenia tabel.

Tworzenie tabeli contoso_webpage w rozszerzonym modelu danych w celu naprawienia kodu

Relacja między tabelami niestandardowymi a tabelami ADX

Aby poprawić to dostosowanie w rozszerzonym modelu danych, należy utworzyć relację między tabelami niestandardowymi i tabelami systemowymi.

Standardowy model danych : tabela adx_webpage ma relację o nazwie adx_webpage_contoso_pagelogs z tabelą contoso_pagelogs.

Rozszerzony model danych: tworzenie nowej relacji o nazwie powerpagecomponent_contoso_pagelogs z tabelą contoso_webpage. Użyj opcji Obszar roboczy danych w celu utworzenia tabel.

Odwołania do tabeli ADX we fragmencie kodu Liquid

Aby poprawić to dostosowanie w rozszerzonym modelu danych, należy zastąpić odwołania do tabeli ADX w kodzie źródłowym odwołaniami MSPP do tabel wirtualnych rozszerzonego modelu danych. Można także użyć tabeli Składnik witryny (nazwa logiczna powerpagecomponent) wraz z atrybutem Typ składnika (nazwa logiczna powerpagecomponenttype) w celu pobrania odpowiednich odwołań.

Standardowy model danych: tag Liquid entities jest używany do uzyskiwania dostępu do wartości linków internetowych w kodzie {% assign app_weblinks= entities['adx_weblinks'] %}.

Rozszerzony model danych: zamiast używania linków internetowych za pośrednictwem tagu Liquid entities użyj odpowiednich obiektów Liquid. Bezpośrednio entities[adx_weblinks]. W tym przypadku entities['adx_weblinks'] może zostać zastąpiony obiektem Liquid weblinks.

Odwołania do tabeli ADX w pliku Fetch XML

Aby poprawić to dostosowanie w rozszerzonym modelu danych, należy zastąpić odwołania do tabeli ADX w kodzie Fetch XML odwołaniami bezpośrednimi do tabel wirtualnych rozszerzonego modelu danych. Można także użyć tabeli Składnik witryny (nazwa logiczna powerpagecomponent) wraz z atrybutem Typ składnika (nazwa logiczna powerpagecomponenttype) w celu pobrania odpowiednich odwołań.

Standardowy model danych: nazwa tabeli adx_webrole jest używana w zapytaniu Fetch XML.

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

Rozszerzony model danych: użyj tabeli Składnik witryny (nazwa logiczna powerpagecomponent) w połączeniu z atrybutem Typ składnika (nazwa logiczna powerpagecomponenttype) w celu pobrania odpowiednich odwołań.

{% 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 i wartości składnika witryny

Typ składnika Wartość
Stan publikowania 1
Strona sieci Web 2
Plik sieci Web 3
Zestaw linków sieci Web 100
Link internetowy 5
Szablon strony 6
Wstawka zawartości 7
Szablon sieci Web 8
Ustawienie witryny 9
Reguła kontroli dostępu do stron internetowych 10
Rola sieci Web 11
Dostęp do witryn internetowych 12
Znacznik witryny 13
Formularz podstawowy 15
Metadane formularza podstawowego 16
List 17
Uprawnienie do tabeli 18
Formularz zaawansowany 19
Krok formularza zaawansowanego 20
Metadane formularza zaawansowanego 21
Położenie ankiety 24
Położenie reklamy 26
Konsument bota 27
Profil uprawnień do kolumn 28
Uprawnienie kolumny 29
Przekieruj 30
Reguła przejścia stanu publikowania 31
Skrót 32
Przepływ w chmurze 33
Składnik środowiska użytkownika 34

Niestandardowy przepływ pracy i dodatek plug-in w tabelach ADX

Aby poprawić to dostosowanie w rozszerzonym modelu danych, logika przepływu pracy i dodatków plug-in musi zostać ponownie zarejestrowana w odpowiedniej tabeli witryny.

Jeśli na przykład użytkownik zarejestrował przepływ pracy/dodatek plug-in do encji podstawowej jako tabelę Strona internetowa (nazwa logiczna adx_webpage) w standardowym modelu danych, wówczas kod w ramach przepływu pracy/dodatków plug-in musi zostać zmodyfikowany na tabelę Składnik witryny (nazwa logiczna powerpagecomponent) i jej atrybuty w celu użycia rozszerzonego modelu danych.

Używanie tabeli składnika witryny w przepływie pracy i jej atrybutach na potrzeby rozszerzonego modelu danych

Znane problemy

Polecenie migracji przetwarza tylko partie zawierające 5000 rekordów ze standardowego modelu danych do rozszerzonego modelu danych.