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

Uwaga

12 października 2022 r. funkcja Portale usługi Power Apps została przekształcona w usługę Power Pages. Więcej informacji: Usługa Microsoft Power Pages jest teraz ogólnie dostępna (blog)
Wkrótce zmigrujemy i scalimy dokumentację funkcji Portale usługi Power Apps z dokumentacją usługi Power Pages.

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

Uwaga

• Możesz także użyć Power Platform CLI z Power Pages. Więcej informacji: Co to jest Power Pages
• W tym samouczku skupiono się na wymaganych poleceniach CLI w Microsoft Power Platform dla portali Power Apps. Aby uzyskać więcej informacji na temat poleceń używanych w CLI w Power Platform, zobacz Informacje o typowych poleceniach.

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.

Krok 2. Lista dostępnych portali

Polecenie listy pac paportal służy do listy dostępnych Power Apps Portals w środowisku Dataverse połączonym w poprzednim kroku.

pac paportal list

Krok 3. Pobieranie zawartości portali

Pobierz zawartość witryny portalu 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.

Krok 4. Zmień zawartość portali

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:

Ten tekst jest widoczny ze strony html:

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

Porada

Można zmienić lokalizację ścieżki folderu w programie PowerShell/zintegrowanym terminalu na pobraną lokalizację, a następnie wprowadzić "code ." , aby 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\

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.

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.

   

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”.

   

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:   · 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 portalu:

1. Wyczyść pamięć podręczną na serwerze lub użyj funkcji konfiguracji synchronizacji przy użyciu Power Apps portals studio.

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

   

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 zaktualizowany w ramach powyższej zmiany pokazuje zmianę po otwarciu portalu w przeglądarce:

   

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ż

• Interfejs wiersza polecenia Microsoft Power Platform
• Używanie rozszerzenia Visual Studio Code (wersja zapoznawcza)