Omówienie migracji ze standardowego do rozszerzonego modelu danych

Narzędzie migracji Microsoft Power Platform CLI przenosi obsługiwaną konfigurację istniejącej witryny Power Pages oraz powiązane rekordy ze standardowego modelu danych do rozszerzonego modelu danych, a następnie przełącza witrynę na korzystanie ze zmigrowanej konfiguracji.

Standardowy model danych przechowuje konfigurację lokacji Power Pages między tabelami używającymi prefiksu adx_. Rozszerzony model danych przechowuje konfigurację lokacji w tabeli Składnik lokacji (składnik programu powerpage) i identyfikuje każdy składnik według jego typu składnika. Informacje o tym, jak działa narzędzie do migracji, które szablony obsługuje, i które dostosowania nie są aktualizowane automatycznie, pomagają zdecydować, kiedy i jak przenieść witrynę.

Zapoznanie się z rozszerzonymi korzyściami z modelu danych wyjaśnia, dlaczego warto rozważyć migrację witryny.

Należy pamiętać, że nie wszystkie tabele adx_* są przenoszone do powerpagecomponent. Tylko tabele metadanych adx_* — te, które opisują strukturę i interfejs tworzenia witryny, takie jak adx_webpage, adx_pagetemplate, adx_contentsnippet, adx_webtemplate, adx_weblink, adx_entityform, adx_sitesetting i adx_entitylist — są scalane do powerpagecomponent (a ich właściwości przypisane do poszczególnych wierszy są przenoszone do kolumny JSON zawartości).

Tabele transakcyjne / środowiska uruchomieniowego adx_* — czyli te, które rejestrują aktywność użytkownika końcowego w czasie działania, takie jak adx_invitation, adx_inviteredemption, adx_portalcomment, adx_externalidentity oraz tabele przesłań i dzienników formularzy encji / formularzy zaawansowanych — nie są migrowane do powerpagecomponent; pozostają w swoich istniejących schematach i nadal przechowują dane środowiska uruchomomieniowego tak jak wcześniej. To, co zmienia się w przypadku tych tabel transakcyjnych, to fakt, że ich odwołania do rekordów metadanych zostają przepięte podczas migracji odwołań tak, aby wskazywały nowe wiersze powerpagecomponent, zamiast starszych wierszy metadanych adx_*.

Istniejące witryny utworzone w standardowym modelu danych nadal działają w tabelach adx_*, więc każda witryna musi zostać zmigrowana, aby korzystać z ulepszonego modelu danych. Migracja przenosi metadane konfiguracji witryny do postaci rozszerzonego modelu danych powerpagecomponent, przepina odwołania transakcyjne na nowe rekordy metadanych i przełącza rekord witryny tak, aby korzystał z rozszerzonego modelu danych. Jest to również miejsce, w którym identyfikowane i naprawiane są dostosowania — niestandardowe kolumny adx_*, kod Liquid odczytujący atrybuty adx_*, zapytania FetchXML dotyczące tabel adx_*, wtyczki i przepływy pracy — ponieważ te dostosowania nie są przenoszone automatycznie i muszą zostać przepisane lub przeorganizowane, aby działały z rozszerzonym modelem danych.

Wymagania wstępne

Możliwości narzędzia do migracji

Narzędzie do migracji kopiuje obsługiwaną konfigurację lokacji i powiązane rekordy do rozszerzonego modelu danych. Po zakończeniu migracji aktywna lokacja przełącza się do ulepszonego modelu danych i jest weryfikowana przed powrotem do normalnego użycia.

Narzędzie do migracji:

  • Generuje raport dostosowań, które mogą wymagać ręcznych zmian.
  • Migruje obsługiwaną konfigurację witryny i powiązane rekordy.
  • Umożliwia sprawdzenie stanu migracji przed przełączeniem aktywnego modelu danych.
  • Umożliwia przywrócenie witryny do standardowego modelu danych, jeśli walidacja zidentyfikuje krytyczny problem.

Ważna

Narzędzie do migracji nie aktualizuje automatycznie każdego dostosowania, które zależy bezpośrednio od standardowych tabel modelu danych. Przejrzyj raport dotyczący dostosowywania, napraw dotyczący go kod niestandardowy i przetestuj zmigrowaną witrynę przed rozpoczęciem korzystania z niej w środowisku produkcyjnym.

Obsługiwane szablony

Istniejące standardowe witryny modelu danych utworzone na podstawie następujących szablonów można migrować:

  • Układ startowy 1–5
  • Przetwarzanie wniosku
  • Pusta strona
  • Rejestracja w programie
  • Planowanie spotkań i zarządzanie nimi
  • Często zadawane pytania
  • Portal społeczności (Dynamics 365)
  • Portal samoobsługowy klienta (Dynamics 365)
  • Portal samoobsługowy pracownika (Dynamics 365)
  • Portal partnerski (Dynamics 365)

Note

Tworzenie nowych lokacji za pomocą ulepszonego modelu danych i migrowanie istniejących lokacji to oddzielne możliwości. Jeśli oryginalny szablon witryny nie znajduje się na liście, nie uruchamiaj narzędzia migracji dla tej witryny.

Zanim rozpoczniesz

Dodatkowe zagadnienia dotyczące planowania:

  • Ustawienie Przełącz do rozszerzonego środowiska modelu danych steruje modelem danych używanym dla nowych lokacji. Włączenie ustawienia nie powoduje migracji istniejących lokacji.
  • Uruchom migrację najpierw w pełnej kopii środowiska produkcyjnego. Ukończ korygowanie i walidację dostosowywania przed migracją.
  • Użyj standardowego procesu tworzenia i przywracania kopii zapasowych w organizacji, aby utworzyć kopię zapasową środowiska produkcyjnego.
  • Zaplanuj okno obsługi dla końcowego przełącznika produkcyjnego i walidacji.
  • Zapisz identyfikator witryny internetowej, identyfikator portalu, adres URL środowiska, wersję interfejsu wiersza polecenia, wersje pakietu, godzinę rozpoczęcia migracji i dane wyjściowe polecenia w ramach rekordu migracji.

Planowanie sekwencji środowiska

Migracja obsługuje różne środowiska z innym trybem dla każdego środowiska.

Środowisko Tryb zalecany Co robisz
Development configurationData Przeprowadź migrację konfiguracji, przejrzyj raport dostosowywania, koryguj dostosowania, zweryfikuj i przechwyć konfigurację w rozwiązaniu.
Testowanie lub UAT configurationDataReferences Zaimportuj przetestowane rozwiązanie z programowania, przeprowadź migrację obsługiwanych rekordów pokrewnych, aktywuj ulepszony model danych i zweryfikuj je.
Produkcyjne configurationDataReferences Zaimportuj zweryfikowane rozwiązanie zarządzane, zmigruj obsługiwane rekordy pokrewne, aktywuj je podczas okna obsługi i zakończ walidację produkcji.
Pojedyncze środowisko lub prosta witryna all Migruj konfigurację i powiązane rekordy w ramach jednej operacji tylko wtedy, gdy rozumiesz wpływ dostosowań i nie używasz ścieżki rozwiązania dla wielu środowisk.

Tworzenie folderu roboczego

Użyj pustego folderu roboczego, aby przechowywać raporty, pobrane źródło witryny i pliki porównania. W poniższych przykładach dla tej lokalizacji użyto \<OUTPUT\>.

mkdir C:\PowerPagesMigration\<site-name>
cd C:\PowerPagesMigration\<site-name>

Fazy migracji

Proces migracji składa się z czterech faz:

  1. Kontrole wstępne — Zweryfikuj witrynę, identyfikatory, CLI, pakiety, szablon rozwiązania i stan migracji.
  2. Konfiguracja — migrowanie konfiguracji w środowisku podrzędnym podczas programowania lub importowania testowanej konfiguracji.
  3. Migrowanie i aktywowanie — migrowanie powiązanych rekordów, potwierdzanie uzupełniania, przełączanie modeli i ponowne uruchamianie.
  4. Weryfikacja — sprawdź zachowanie, uprawnienia, kod niestandardowy i ścieżki szablonów.

Zrzut ekranu przedstawiający schemat blokowy procesu migracji modelu danych ze standardowego do rozszerzonego.

Faza 1 (odnajdywanie lokacji i sprawdzanie wstępne) oraz faza 4 (weryfikacja po migracji) działają tak samo dla każdej lokacji.

Faza 2 i Faza 3 są rozgałęzione według ścieżki — ich postać zależy od trybu migracji, który określa ścieżkę na podstawie typu środowiska.

Ścieżka Authoring Track (tryb configurationData lub all) jest używana na potrzeby środowisk deweloperskich i konfiguracji z jednym środowiskiem. Metadane są migrowane lokalnie, a dostosowania są skanowane i poprawiane w odniesieniu do standardowego źródła modelu danych, zanim zostaną przeniesione odwołania transakcyjne.

Ścieżka podrzędna (tryb configurationDataReferences) służy do obsługi środowisk Test, UAT i produkcyjnych, w których zakłada się, że metadane konfiguracji zostały zaimportowane z Dev za pomocą importu rozwiązania ALM. W tym przebiegu migrowane są tylko odwołania transakcyjne. Wszelkie ustalenia dotyczące dostosowań wskazują na lukę w ALM na wcześniejszym etapie, a nie na prace, które należy wykonać lokalnie.

Faza 1. Wstępne kontrole

  1. Sprawdź wersję narzędzia Power Platform CLI za pomocą polecenia pac --version. Jeśli wersja jest starsza niż wymagana, przed kontynuowaniem zainstaluj lub zaktualizuj interfejs wiersza polecenia Microsoft Power Platform.

  2. Uwierzytelnij się w środowisku docelowym.

    1. Uruchom program pac auth list.
    2. Uruchom program pac auth who.

  3. Upewnij się, że aktywny profil uwierzytelniania wskazuje na środowisko, które zawiera witrynę. Aby wybrać inny profil lub utworzyć profil, użyj polecenia pac auth select lub pac auth create -u "https://contoso.crm.dynamics.com".

  4. Zainstaluj rozszerzone rozwiązania modelu danych dla szablonu przy użyciu jednej z następujących metod:

    1. Utwórz w centrum administracyjnym witrynę na podstawie szablonu z włączoną flagą rozszerzonego modelu danych (EDM).
    2. Użyj CLI, aby zainstalować za pomocą polecenia pac application install --application-name "PowerPages_PartnerPortal_V2"

  5. Znajdź witrynę i zapisz jej identyfikatory za pomocą polecenia pac pages list -v.

  6. Zapisz wartości pokazane w poniższej tabeli.

    Wartość Sposób użycia
    Identyfikator witryny sieci Web Wszystkie polecenia migrate-datamodel.
    Identyfikator portalu Przełączenie do ulepszonego modelu danych i przywrócenie standardowego modelu danych.
    Przyjazna nazwa i adres URL Potwierdzenie, że wybrano poprawną witrynę w centrum administracyjnym.
    Wersja modelu danych Musi być Standard. Jeśli jest już Enhanced, to migracja nie jest konieczna.

    Ważna

    Identyfikator portalu nie jest identyfikatorem aplikacji Power Pages. Jeśli interfejs CLI nie wyświetla identyfikatora portalu, można go znaleźć w centrum administracyjnym Power Platform w obszarze Zasoby>Witryny Power Pages> lub dodać /_services/about na końcu adresu URL witryny po zalogowaniu się przy użyciu wymaganych uprawnień dostępu do witryny.

  7. Sprawdź poprzednią lub w toku migrację za pomocą następującego polecenia:

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
    Status Znaczenie Action
    Nie rozpoczęto lub brak modułu śledzącego Nie rozpoczęto migracji. Kontynuuj sprawdzanie pakietów.
    Przywrócone Poprzednia migracja została wycofana. Sprawdź, dlaczego to cofnięto, a następnie kontynuuj, gdy będziesz gotowy(-a).
    Zakończone Migracja zakończyła się, ale przełączenie witryny mogło nie nastąpić. Potwierdź aktywny model danych. Jeśli nadal ma warstwę Standard, kontynuuj proces aktywacji.
    Bieganie Migracja nadal trwa. Kontynuuj sprawdzanie stanu. Nie uruchamiaj innej migracji dla tej samej witryny.
    Failed Migracja napotkała błąd. Zbierz dane wyjściowe polecenia i szczegóły środowiska, popraw przyczynę i spróbuj ponownie dopiero po zrozumieniu błędu.

    Note

    Jeśli migracja pozostanie uruchomiona dłużej niż oczekiwano, przed skontaktowaniem się z pomocą techniczną Microsoft potrzebujesz identyfikatora witryny internetowej, identyfikatora środowiska, wersji interfejsu wiersza polecenia, wersji pakietu, danych wyjściowych poleceń i czasu rozpoczęcia migracji. Aktywnej migracji nie należy resetować, chyba że zaleci to dział wsparcia lub zatwierdzona procedura operacyjna.

  8. Zweryfikuj wymagane pakiety pierwszej firmy za pomocą polecenia pac solution list --includeSystemSolutions.

    1. Upewnij się, że zainstalowano CDSBasePortal, PowerPages_Core oraz rozwiązania EDM dla szablonu witryny w wymaganych wersjach.

  9. Jeśli brakuje pakietu lub jest on nieaktualny, zaktualizuj go w centrum administracyjnym platformy Power Platform:

    1. Otwórz środowisko docelowe.
    2. Przejdź do Resources>Dynamics 365 apps.
    3. Znajdź wymagany pakiet.
    4. Wybierz pozycję Zainstaluj lub uaktualnij.
    5. Poczekaj na zakończenie operacji, a następnie uruchom pac solution list --includeSystemSolutions ponownie.

    Note

    Jeśli rozwiązanie EDM dla tego szablonu nie jest dostępne do bezpośredniej instalacji, utworzenie tymczasowej witryny rozszerzonego modelu danych w tym samym środowisku i przy użyciu tego samego szablonu instaluje odpowiadające mu rozwiązanie EDM. Po potwierdzeniu rozwiązania można usunąć lokację tymczasową.

  10. Wygeneruj raport dostosowywania za pomocą polecenia pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Generowanie raportu nie powoduje zmiany witryny.

  11. Otwórz wygenerowany plik CSV i przejrzyj każdy element odwołujący się do standardowych tabel modelu danych. Dla każdego wymaganego działania naprawczego przypisz osobę odpowiedzialną oraz etap weryfikacji przed migracją na środowisko produkcyjne.

    Kategoria dostosowywania Plan
    Kolumny niestandardowe w tabelach metadanych adx_ Przenieś dane niestandardowe do obsługiwanej tabeli niestandardowej powiązanej z elementem powerpagecomponent.
    Relacje z tabelami metadanych adx_ Utwórz ponownie relację z obsługiwaną rozszerzoną tabelą modelu danych.
    Odwołania liquid lub FetchXML do tabel adx_ Zaktualizuj kod, aby używał obsługiwanych obiektów Liquid, tabel wirtualnych lub elementu powerpagecomponent.
    Przepływy pracy i wtyczki w tabelach adx_ Przeprowadź refaktoryzację i zarejestruj logikę dla obsługiwanych tabel rozszerzonego modelu danych.

    Note

    Raport dostosowywania nie dowodzi, że wszystkie zachowania witryny działają po migracji; Weryfikacja jest nadal wymagana.

  12. Wybierz tryb migracji, aby określić, jakie narzędzie migruje w ramach jednej operacji.

    Mode Co migruje Okoliczności użycia
    configurationData Obsługiwane metadane konfiguracji witryny, takie jak strony, szablony sieci Web, fragmenty kodu, ustawienia, formularze, listy, role sieci Web i uprawnienia tabeli. Środowisko programistyczne, w którym naprawiasz konfigurację i przenosisz ją za pomocą rozwiązań.
    odwołania do danych konfiguracji Obsługiwane rekordy odwołujące się do konfiguracji zmigrowanej lokacji. Test, UAT i środowisko produkcyjne po dostarczeniu konfiguracji witryny za pośrednictwem importu rozwiązania.
    all Zarówno konfiguracja, jak i obsługiwane powiązane rekordy. Pojedyncze środowisko lub prosta migracja, która nie korzysta z sekwencji środowisk opartej na rozwiązaniach.

Faza 2. Konfiguracja lokacji

Śledzenie tworzenia: programowanie lub pojedyncze środowisko

  1. Pobierz bazę odniesienia SDM, uruchamiając pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Polecenie tworzy podfolder nazwany nazwą witryny. Określ folder, który bezpośrednio zawiera website.yml.

  2. Zmigruj konfigurację witryny, uruchamiając polecenie pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Jeśli chcesz użyć ścieżki jednooperacyjnej, zastąp all elementem configurationData.

  3. Sprawdź stan migracji, uruchamiając polecenie pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Użyj następującej pętli programu PowerShell, aby sprawdzić stan raz na minutę przez maksymalnie 30 minut:

    $webSiteId = "<WEBSITE_ID>"
for ($i = 1; $i -le 30; $i++) {
    $output = pac pages migrate-datamodel `
        --webSiteId $webSiteId `
        --checkMigrationStatus 2>&1 | Out-String
    if ($output -match "Completed|Failed|Reverted") {
        Write-Host $output
        break
    }
    Write-Host "Attempt $i/30 - migration is still running."
    Start-Sleep -Seconds 60
}

    Jeśli pętla zakończy się, gdy stan nadal ma wartość Running, sprawdzanie jest kontynuowane przy użyciu --checkMigrationStatus. Długotrwała operacja nie musi być operacją, która zakończyła się niepowodzeniem.

  4. Korygowanie zgłoszonych dostosowań przy użyciu raportu dostosowywania i wskazówek zawartych w tym artykule w celu zaktualizowania dotkniętych elementów FetchXML, Liquid, kolumn niestandardowych, relacji, przepływów pracy i wtyczek. Przetestuj ponownie każdy zmieniony składnik. Jeśli zaktualizujesz pobrane źródło, prześlij folder witryny, który bezpośrednio zawiera website.yml, za pomocą polecenia pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Ścieżka docelowa: test, UAT lub produkcja

  1. Zaimportuj rozwiązanie zawierające zmigrowaną i skorygowaną konfigurację lokacji. Użyj centrum administracyjnego platformy Power Platform lub ustanowionego potoku wdrażania.

    pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true

  2. Upewnij się, że konfiguracja witryny jest dostępna, otwierając aplikację Power Pages Management w środowisku docelowym. Rekord lokacji i oczekiwana konfiguracja muszą być obecne przed migracją powiązanych rekordów.

  1. Migrowanie obsługiwanych rekordów pokrewnych. Jeśli już użyto --mode all, pomiń ten krok. Sprawdzaj stan, aż pojawi się Ukończono.

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

  2. Gdy stan migracji wskaże pomyślne zakończenie, przełącz aktywną witrynę na ulepszony model danych. Standardowy rekord witryny internetowej modelu danych jest dezaktywowany, a odpowiedni rozszerzony rekord witryny internetowej modelu danych staje się aktywny.

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"

  3. Uruchom ponownie witrynę.

    1. Otwórz centrum administracyjne platformy Power Platform.
    2. Przejdź do środowiska, a następnie wybierz pozycję Zasoby>witryny Power Pages.
    3. Wybierz witrynę.
    4. Wybierz Uruchom ponownie. Jeśli ponowne uruchomienie nie jest dostępne, dezaktywuj, a następnie aktywuj witrynę.
    5. Poczekaj na zakończenie operacji przed walidacją.

  4. Potwierdź aktywny model danych przy użyciu co najmniej jednej z następujących metod:

    1. W centrum administracyjnym platformy Power Platform wybierz witrynę i upewnij się, że model danych ma wartość Rozszerzone.
    2. Otwórz obszar roboczy Konfiguracja witryny w studio projektowym usługi Power Pages i potwierdź wyświetlany model danych.
    3. Upewnij się, że konfiguracja zaawansowana zostanie otwarta w aplikacji Power Pages Management.
    4. Uruchom pac pages list -v i potwierdź wersję modelu danych.

    Tip

    Adres URL witryny i projekt wizualizacji nie zmieniają się tylko dlatego, że aktywny model danych uległ zmianie. Aby zweryfikować migrację, użyj tych testów — a nie wyglądu witryny.

Faza 4. Weryfikowanie zmigrowanej lokacji

Zakończ walidację przed ponownym otwarciem lokacji produkcyjnej dla użytkowników. Używaj kont testowych dla każdego ważnego typu użytkownika i roli sieci Web oraz rejestruj wynik każdego testu krytycznego.

Obszar Co należy zweryfikować
Strony i zawartość Strona główna, reprezentatywne strony zawartości, szablony internetowe, fragmenty zawartości, pliki internetowe, nawigacja, przekierowania i wielojęzyczna zawartość.
Authentication Logowanie, wylogowanie, rejestracja, zaproszenia, zewnętrzni dostawcy tożsamości i komunikaty o odmowie dostępu.
Authorization Role sieci Web, uprawnienia tabeli, uprawnienia kolumn i reguły dostępu do stron umożliwiają i odrzucają oczekiwane akcje.
Formularze i listy Formularze podstawowe, formularze wieloetapowe, listy, metadane formularza, przesyłanie, powiązane rekordy i sesje formularzy internetowych używane przez witrynę.
Dynamics 365 szablony ścieżek klienta Główne ścieżki klienta, pracownika, społeczności lub partnera wykorzystywane w implementacji, w tym strony specyficzne dla danego szablonu i wzorce dostępu.
Kod niestandardowy Liquid, FetchXML, JavaScript, wtyczki, przepływy pracy i integracje zidentyfikowane w raporcie dostosowywania.
Ustawienia i pliki witryny Ustawienia witryny, obrazy, załączniki, pliki SVG i inne pliki internetowe są ładowane poprawnie.
Dane i odwołania Ważna liczba rekordów i obsługiwane rekordy powiązane wskazują właściwe zmigrowane składniki witryny.
Administracja i ALM Witryna otwiera się w usłudze Power Pages Management i można ją zgodnie z oczekiwaniami dodawać do rozwiązań, eksportować w nich i importować z nich.

Sprawdzanie diagnostyki przeglądarki

Otwórz narzędzia deweloperskie przeglądarki podczas testowania stron reprezentatywnych. Zbadaj:

  • Błędy konsoli, w których wspomniano o adx\_, encjach, Liquid lub FetchXML.
  • Odpowiedzi HTTP 401 lub 403 od \_api, które mogą wskazywać na problem z uprawnieniami lub rolą sieci Web.
  • Odpowiedzi HTTP 500, które mogą wskazywać na błąd Liquid, FetchXML, plug-in lub integration.

Kryteria ukończenia migracji

Migrację uznaj za zakończoną dopiero wtedy, gdy w witrynie jest widoczny ulepszony model danych, kluczowe ścieżki biznesowe przechodzą pomyślnie, potwierdzono oczekiwane działanie mechanizmów zabezpieczeń, a wszystkie ustalenia dotyczące dostosowań o wysokim wpływie zostały rozwiązane lub zaakceptowane.

Sekwencja migracji produkcyjnej

Użyj następującej sekwencji produkcyjnej, aby zmniejszyć ryzyko migracji:

  1. Utwórz pełną kopię środowiska produkcyjnego na potrzeby próby.
  2. Potwierdź wymagania wstępne dotyczące interfejsu wiersza polecenia, pakietu i szablonu rozwiązania w skopiowanym środowisku.
  3. Generowanie i przeglądanie raportu dostosowywania.
  4. Migrowanie konfiguracji w skopiowanych środowiskach deweloperskich.
  5. Napraw dostosowania i zapisz zweryfikowaną konfigurację witryny w rozwiązaniu zarządzanym.
  6. Zaimportuj rozwiązanie do środowiska prób, zmigruj obsługiwane rekordy pokrewne, aktywuj rozszerzony model danych i ukończ pełną listę kontrolną weryfikacji.
  7. Powtarzaj działania naprawcze i próby, aż wszystkie krytyczne testy zostaną zaliczone.
  8. Zaplanuj okno prac konserwacyjnych w środowisku produkcyjnym, przekaż informacje o punktach decyzyjnych dotyczących walidacji i wycofania oraz wykonaj kopię zapasową środowiska produkcyjnego.
  9. Ponownie potwierdź wymagania wstępne dotyczące pakietu produkcyjnego i rozwiązania szablonu.
  10. Zaimportuj zweryfikowane rozwiązanie zarządzane do środowiska produkcyjnego.
  11. Uruchom polecenie configurationDataReferences, sprawdź stan migracji, przełącz aktywny model danych i uruchom ponownie witrynę.
  12. Wykonaj listę kontrolną walidacji produkcyjnej i przywróć witrynę do normalnego użytku dopiero po pomyślnym zakończeniu testów krytycznych.

Przywracanie zmigrowanej lokacji do standardowego modelu danych

Jeśli walidacja zidentyfikuje krytyczny problem po aktywacji, użyj następującego polecenia, aby ponownie uaktywnić standardowy rekord witryny internetowej modelu danych:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Po zakończeniu wykonywania polecenia:

  1. Uruchom ponownie witrynę z poziomu centrum administracyjnego platformy Power Platform.
  2. Upewnij się, że witryna wyświetla Standard jako aktywny model danych.
  3. Uruchom ponownie krytyczne testy walidacyjne witryny.
  4. Przed podjęciem próby przeprowadzenia innej migracji zachowaj raport migracji, szczegóły błędu i uwagi dotyczące korygowania.

Ważna

Zaplanuj decyzję wycofywania przed migracją produkcyjną. Przejrzyj zmiany wprowadzone po przełączeniu rozszerzonego modelu danych przed przywróceniem, ponieważ standardowe i rozszerzone rekordy witryny internetowej są oddzielnymi rekordami.

Rozwiązywanie problemów

Komunikat lub objaw Prawdopodobna przyczyna Action
pac powerpages migrate-datamodel nie jest rozpoznawana Polecenie używa nieprawidłowej przestrzeni nazw lub nieaktualnego interfejsu wiersza polecenia. Zaktualizuj Power Platform CLI i użyj pac pages migrate-datamodel.
CDSBasePortal lub PowerPages_Core nie ma na liście Rozwiązania systemowe nie zostały uwzględnione w danych wyjściowych polecenia lub pakiet nie jest zainstalowany. Uruchom program pac solution list --includeSystemSolutions. Zainstaluj lub uaktualnij brakujący pakiet w centrum administracyjnym platformy Power Platform.
Witryna internetowa nie jest obsługiwana do migracji Oryginalny szablon nie jest obsługiwany, wersje pakietów są niewystarczające lub brakuje pasującego rozwiązania szablonu EDM. Potwierdź uprawnienia szablonu, wersje pakietów i rozwiązanie EDM wymienione w dokumentacji rozwiązania szablonu.
Przekazano nieznany argument --webSiteId do pac pages upload Polecenie przesyłania nie akceptuje argumentu identyfikatora witryny. Pomiń argument. Witryna jest identyfikowana z website.yml.
Przekaż miejsce docelowe nieprawidłowej witryny lub nie można odnaleźć witryny Ścieżka wskazuje folder otoki zamiast folderu lokacji. Użyj folderu podrzędnego, w którym bezpośrednio znajduje się plik website.yml.
Identyfikator portalu pokazuje Unknown lub N/A Witryna jest nieaktywna lub zainstalowany interfejs wiersza polecenia nie zwraca wartości. Pobierz identyfikator portalu z centrum administracyjnego platformy Power Platform lub strony witryny /_services/about . Nie używaj identyfikatora aplikacji.
Raporty Completed dotyczące migracji, ale witryna nadal jest wyświetlana Standard Aktywny model danych nie został przełączony lub użyto nieprawidłowego identyfikatora portalu. Uruchom polecenie aktywacji przy użyciu identyfikatora witryny internetowej i poprawnego identyfikatora portalu, a następnie uruchom ponownie i zweryfikuj witrynę.
Stan pozostaje Running Migracja przetwarza dużą ilość danych lub jest blokowana. Kontynuuj sprawdzanie stanu. Przed skontaktowaniem się z działem wsparcia zbierz dane dotyczące środowiska, pakietu, CLI, czasu uruchomienia oraz użytego polecenia. Nie uruchamiaj drugiej migracji.
Stan: Failed Błąd pakietu, szablonu, dostosowywania, danych lub usługi zatrzymał operację. Zapisz pełne dane wyjściowe polecenia, popraw zidentyfikowaną przyczynę i spróbuj ponownie dopiero po przejrzeniu stanu migracji zakończonej niepowodzeniem.
Zostanie otwarta witryna, ale użytkownicy nie mogą uzyskać dostępu do oczekiwanych danych Role sieci Web, uprawnienia tabeli lub zapytania niestandardowe nie zachowują się zgodnie z oczekiwaniami po migracji. Przejrzyj role sieci Web, uprawnienia tabeli, uprawnienia kolumn, FetchXML, Liquid i błędy sieci przeglądarki.

Zagadnienia dotyczące dostosowywania witryny

Raport dostosowywania identyfikuje bezpośrednie zależności od standardowych tabel modelu danych. Zakończ wymagane działania naprawcze przed użyciem w środowisku produkcyjnym.

Kolumny niestandardowe w tabelach metadanych

Jeśli standardowa tabela modelu danych, taka jak adx_webpage zawiera kolumnę niestandardową, utwórz tabelę niestandardową do przechowywania danych niestandardowych i dodaj odnośnik do elementu powerpagecomponent. Przeprowadź migrację wartości niestandardowych do nowej tabeli i zaktualizuj kod, który odczytuje lub zapisuje kolumnę.

Relacje między tabelami niestandardowymi i tabelami metadanych

Utwórz ponownie relacje niestandardowe, które wskazują na tabele adx_, tak aby wskazywały odpowiednią tabelę rozszerzonego modelu danych, często powerpagecomponent. Aktualizowanie formularzy zależnych, widoków, wtyczek, przepływów i integracji.

Odwołania liquid do tabel metadanych

Zastąp bezpośredni dostęp entities['adx_*'] obsługiwanym obiektem Liquid, jeśli taki istnieje. Na przykład użyj obiektu Liquid weblinks, zamiast bezpośrednio odpytywać adx_weblinkset lub powiązane tabele. Przejrzyj każde użycie, ponieważ zwracany obiekt i dostępne atrybuty mogą się różnić.

Pobieranie odwołań XML do tabel metadanych

Zastąp odwołania do jednostek bezpośrednich adx_ odpowiednią tabelą wirtualną lub kwerendą powerpagecomponent i filtruj według powerpagecomponenttype

Przykład standardowego modelu danych:

<fetch>
  <entity name="adx_webpage">
    <attribute name="adx_name" />
    <filter>
      <condition attribute="adx_partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Przykład rozszerzonego modelu danych:

<fetch>
  <entity name="powerpagecomponent">
    <attribute name="name" />
    <filter type="and">
      <condition attribute="powerpagecomponenttype" operator="eq" value="2" />
      <condition attribute="partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Niestandardowe przepływy pracy i wtyczki

Refaktoryzacja niestandardowego przepływu pracy i logiki wtyczek zarejestrowanych w adx_ tabelach. Zarejestruj zaktualizowaną logikę w odpowiedniej rozszerzonej tabeli modelu danych i użyj rozszerzonego schematu i atrybutów. Przetestuj zachowanie tworzenia, aktualizowania, usuwania i zabezpieczeń w środowisku nieprodukcyjnym.

Referencja poleceń

Purpose Command
Sprawdź wersję CLI pac --version
Wyświetlanie listy profilów uwierzytelniania pac auth list
Tworzenie profilu uwierzytelniania pac auth create -u "<ENV_URL>"
Wyświetlanie listy witryn i identyfikatorów pac pages list -v
Wyświetlanie listy rozwiązań systemowych pac solution list --includeSystemSolutions
Sprawdzanie stanu migracji pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus
Pobieranie źródła SDM pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"
Pobieranie źródła EDM pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"
Generowanie raportu dostosowywania pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"
Migracja konfiguracji pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData
Migrowanie powiązanych rekordów pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences
Migrowanie obu kategorii pac pages migrate-datamodel --webSiteId "<ID>" --mode all
Prześlij kod źródłowy witryny pac pages upload --path "<SITE_ROOT>" --modelVersion 1
Aktywowanie programu EDM pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
Powrót do SDM pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Informacje referencyjne o typie składnika witryny

Podczas wykonywania zapytania powerpagecomponentużyj następujących wartości w filtrze powerpagecomponenttype .

Component Wartość Component Wartość
Stan publikowania 1 Strona internetowa 2
Plik sieci Web 3 Zestaw linków sieci Web 4
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
Uprawnienia tabel 18 Formularz zaawansowany 19
Krok formularza zaawansowanego 20 Metadane formularza zaawansowanego dwadzieścia jeden
Położenie ankiety 24 Położenie reklamy 26
Konsument bota 27 Profil uprawnień do kolumn 28
Uprawnienia do kolumny 29 Redirect 30
Reguła przejścia stanu publikowania 31 Shortcut 32
Przepływ w chmurze 33 Składnik środowiska użytkownika 34

Informacje referencyjne dotyczące szablonu rozwiązania EDM

Uruchom polecenie pac solution list --includeSystemSolutions , aby potwierdzić, że zainstalowano ulepszone rozwiązanie modelu danych dla szablonu witryny.

Szablon Unikatowa nazwa rozwiązania EDM
Układ początkowy 1 DefaultPortalTemplate_V2
Układ początkowy 2 PowerPages_BlankDesign002_V2
Układ początkowy 3 PowerPages_BlankDesign003_V2
Układ początkowy 4 PowerPages_BlankDesign004_V2
Układ początkowy 5 PowerPages_BlankDesign005_V2
Pusta strona PowerPages_BlankTemplate_V2
Często zadawane pytania PowerPages_FAQ_V2
Przetwarzanie wniosku PowerPages_BuildingPermit_V2
Rejestracja w programie PowerPages_ProgramRegistration_V2
Planowanie spotkań i zarządzanie nimi PowerPages_BookMeeting_V2
Portal społeczności (Dynamics 365) PowerPages_CommunityPortal_V2
Portal samoobsługowy klienta (Dynamics 365) PowerPages_CustomerPortal_V2
Portal samoobsługowy pracownika (Dynamics 365) PowerPages_ESSPortal_V2
Portal partnerski (Dynamics 365) PowerPages_PartnerPortal_V2

Treści powiązane

  • Last updated on