Samouczek: Używanie interfejsu wiersza polecenia platformy Microsoft Power Platform CLI z Power Pages

  • Artykuł

W tym przykładzie zobaczysz, jak rozpocząć pracę z Microsoft Power Platform CLI, aby zaktualizować przykładową konfigurację witryny.

Uwaga

  • W tym samouczku skupiono się na wymaganych poleceniach Microsoft Power Platform CLI dla Power Pages. Aby uzyskać więcej informacji na temat poleceń używanych w CLI w Power Platform, zobacz Informacje o typowych poleceniach.
  • Zaczynając od wersji Power Platform CLI 1.27, to polecenie pac paportal jest zmieniane na pac powerpages. paportal Kontynuować pracę, ale zalecane jest skorzystanie z funkcji krok powerpages w przód. Ten artykuł zostanie wkrótce zaktualizowany do użycia powerpages zamiast paportal.

Pobierz i zainstaluj Visual Studio Code

Aby połączyć się z portalami Power Apps i używać poleceń CLI w Microsoft Power Platform, należy użyć Visual Studio Code i zintegrowanego terminalu. Zintegrowany terminal ułatwia łączenie się ze środowiskiem Dataverse oraz pobieranie, zmianę i przesyłanie konfiguracji portali. Można również użyć programu Windows PowerShell.

Krok 1. Uwierzytelnij

Przed połączeniem, listą, pobraniem lub wysłaniem jakichkolwiek zmian dla portalu Power Apps, musisz najpierw uwierzytelnić się do środowiska Dataverse. Aby uzyskać więcej informacji na temat uwierzytelniania przy użyciu CLI w Microsoft Power Platform, przejdź do pac auth.

Aby się uwierzytelnić, otwórz Windows PowerShell i uruchom polecenie pac auth create używając adresu URL środowiska Dataverse:

pac auth create -u [Dataverse URL]

Przykład

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

Postępuj zgodnie z instrukcjami uwierzytelniania, aby zalogować się do środowiska.

Przykład uwierzytelniania w środowisku Dataverse przy użyciu CLI w Microsoft Power Platform

Krok 2. Lista dostępnych witryn

Użyj polecenia pac paportal list, aby wyświetlić listę dostępnych witryn sieci Web Power Pages w środowisku Dataverse, z którym połączono w poprzednim kroku.

pac paportal list

Przykładowa lista witryn.

Krok 3. Pobieranie zawartości witryny

Pobierz zawartość witryny z połączonego środowiska Dataverse za pomocą polecenia pac paportal download.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Przykład

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

Dla parametru id należy użyć identyfikatora WebSiteId zwróconego z parametru wyjściowego poprzedniego kroku.

Ten tekst jest używany przez czytniki ekranu.

Krok 4. Zmień zawartość witryny

Zmień konfigurację przy Visual Studio Code i zapisz zmiany.

Uwaga

Upewnij się, że są aktualizowane tylko obsługiwane tabele do użycia z Power Platform CLI. Aby uzyskać więcej informacji, zobacz listę obsługiwanych tabel.

Na przykład domyślna strona portalu pokazuje tekst w następujący sposób:

Przykładowy tekst strony portali

Ten tekst jest widoczny ze strony html:

Visual Studio Code z tekstem wyróżnionym do zmiany.

Możesz zmienić ten tekst i zapisać zmiany:

Zaktualizowany tekst przy użyciu Visual Studio Code.

Napiwek

Można zmienić lokalizację ścieżki folderu w programie PowerShell/zintegrowanym terminalu na pobraną lokalizację, a następnie wprowadzić „code .”, by otworzyć folder bezpośrednio w Visual Studio Code.

Krok 5. Prześlij zmiany

Uwaga

  • Jeśli przekazujesz do wielu środowisk, zobacz Przekazywanie zmian przy użyciu profilu wdrożenia, aby dowiedzieć się, jak przekazywać zmiany przy użyciu profilu wdrożenia.
  • Upewnij się, że maksymalny rozmiar załącznika w środowisku docelowym jest ustawiony na taki sam lub większy jak rozmiar środowiska źródłowego.
  • Maksymalny rozmiar plików jest określony przez ustawienie Maksymalny rozmiar pliku na karcie e-mail ustawień systemowych w oknie dialogowym ustawień systemu środowiska.

Po wprowadzenie wymaganych zmian należy przekazać je, używając następującego polecenia pac paportal upload:

pac paportal upload --path [Folder-location]

Przykład

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Rozpoczynanie przekazywania.

Uwaga

Upewnij się, że wprowadzona ścieżka do zawartości portali jest prawidłowa. Domyślnie tworzony jest folder nazwany przez portal (przyjazna nazwa) z zawartością pobranych portali. Na przykład, jeśli przyjazna nazwa portalu to custom-portal, ścieżka do powyższego polecenia (--path) powinna być następująca: C:\pac-portals\downloads\custom-portal.

Przesyłanie odbywa się tylko w przypadku zawartości, która została zmieniona. W tym przykładzie, ponieważ zmiana jest dokonywana na stronie internetowej, treść jest przesyłana tylko dla tabeli adx_webpage.

Przesyłanie zakończone tylko dla zmienionej zawartości.

Przekazywanie zmian przy użyciu profilu wdrożenia

Podczas pracy z wieloma różnymi środowiskami można rozważyć użycie profili wdrażania, aby upewnić się, że zmiany są przekazywane do właściwego środowiska przy użyciu profilu wdrożenia.

  1. Utwórz folder o nazwie deployment-profiles wewnątrz folderu zawierającego zasoby portalu. Na przykład, jeśli pobrana zawartość portalu znajduje się w „starter-portal”, folder profili wdrażania powinien znajdować się w tym folderze.

    Folder dla profili wdrażania

  2. W folderze profili wdrażania utwórz plik YAML wdrożenia zawierający zmiany specyficzne dla środowiska. Na przykład środowisko programistyczne można nazwać „dev.deployment.yml”.

    Profil wdrożenia YAML dla programistów

  3. Edytuj plik YAML wdrożenia przy użyciu Visual Studio Code w następującym formacie:

    <table-name>:
- <record-id>: <GUID>
  <column-name>: <Name>
  <column-value>: <Value>

    Na przykład poniższy przykładowy kod YAML aktualizuje wartość „Browser Title Suffix” z domyślnej „Custom Portal” na „Custom Portal (Dev)”.

    adx_contentsnippet:
    - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
      adx_name: Browser Title Suffix # Setting name
      adx_value:  &nbsp;· Custom Portal (Dev) # Setting value

  4. Aby przekazać zmiany do innego środowiska przy użyciu pliku YAML profilu wdrożenia, najpierw uwierzytelnij się w organizacji docelowej.

  5. Po uwierzytelnieniu i połączeniu z odpowiednim środowiskiem użyj polecenia pac paportal upload, aby przekazać zawartość:

    pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

    Uwaga

    W powyższym przykładzie użyta nazwa profilu wdrożenia to „dev” po wykonaniu poprzednich kroków w celu utworzenia profilu wdrożenia dewelopera. Zmień nazwę z „dev” na dowolną inną (na przykład QA dla „qa.deployment.yml” lub Test dla „test.deployment.yml”), jeśli używasz innej nazwy pliku dla pliku YAML wdrożenia.

Krok 6. Potwierdź zmiany

Aby potwierdzić zmiany wprowadzone na stronie witryny:

  1. Wybierz Synchronizacja w studio projektowym Power Pages.

  2. Przejdź na stronę witryny, aby zobaczyć zmianę.

    Wyświetlanie zaktualizowanej zawartości strony.

  3. Jeśli użyto wcześniej przykładu profilu wdrożenia, wstawka YAML zaktualizuje wartość, jak pokazano poniżej.

    Sufiks tytułu przeglądarki z aplikacji Zarządzanie portalem

    Sufiks tytułu przeglądarki zaktualizowany w ramach powyższej zmiany pokazuje zmianę po otwarciu portalu w przeglądarce:

    Zmiana przeglądarki

Na tym kończymy ten samouczek. Możesz powtórzyć powyższe kroki i zmienić zawartość portali dla innych wspieranych tabel.

Następne kroki

Używanie rozszerzenia Visual Studio Code

Zobacz też