Obsługa Microsoft Power Platform CLI dla Power Pages

Microsoft Power Platform CLI (interfejs wiersza polecenia) to prosty, jednokierunkowy interfejs wiersza polecenia dla deweloperów, który umożliwia deweloperom i twórcom aplikacji tworzenie składników kodu.

Narzędzia Microsoft Power Platform CLI to pierwszy krok do kompleksowego zarządzania cyklem życia aplikacji (ALM), w którym deweloperzy przedsiębiorstw i ISV mogą szybko i sprawnie tworzyć, tworzyć, debugować i publikować rozszerzenia oraz dostosowania. Aby uzyskać więcej informacji, przejdź do Czym jest Microsoft Power Platform CLI?

Dzięki tej funkcji, Microsoft Power Platform CLI umożliwia CLI/CD(Continuous Integration/Continuous Deployment) konfigurację witryny Power Pages. Możesz teraz zameldować konfigurację witryny internetowej do kontroli źródła i przenieść konfigurację witryny internetowej do dowolnego środowiska za pomocą Microsoft Power Platform CLI.

Uwaga

• Ta funkcja jest ogólnie dostępna, zaczynając od wersji CLI Power Platform 1.9.8. Aby dowiedzieć się więcej o instalowaniu najnowszej wersji, przejdź do Instalacja Microsoft Power Platform CLI.
• 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.

Dlaczego warto używać w Microsoft Power Platform CLI do projektowania witryn?

Dzięki wsparciu portali dla Microsoft Power Platform CLI, można teraz korzystać z możliwości dostosowywania witryn w trybie offline poprzez wprowadzanie zmian w zawartości witryny. A gdy wszystkie dostosowania lub zmiany zostaną zapisane, można przekazać je do konfiguracji witryny z powrotem Microsoft Dataverse. Kiedy pobierasz zawartość witryn za pomocą Microsoft Power Platform CLI, zawartość jest ustrukturyzowana w formatach YAML i HTML, dzięki czemu jest łatwa do dostosowania, umożliwiając doświadczenie pro-developerskie.

Oto lista funkcji i możliwości, z których portale korzystają dzięki wsparciu dla CLI w Microsoft Power Platform:

Łatwość użycia

• Obsługa pobierania/przesyłania danych konfiguracji danych witryny do/z lokalnego systemu plików

• W oparciu o istniejące narzędzie CLI w Microsoft Power Platform.

Zarządzanie cyklem życia aplikacji (ALM)

• Śledzenie zmian w konfiguracji witryny w organizacji

• Przenoszenie plików konfiguracyjnych pomiędzy organizacjami lub dzierżawami

Wsparcie pro-dev i dla przedsiębiorstw

• Pomaga bezproblemowo zintegrować się z dowolnym narzędziem kontroli źródła, takim jak „git”

• Łatwa konfiguracja potoków ciągła integracja/ciągłe wdrażanie

Zainstaluj Microsoft Power Platform CLI

Instrukcje krok po kroku można znaleźć w Instalacji CLI Microsoft Power Platform.

Obsługiwane tabele

Obsługa portali w Microsoft Power Platform CLI jest ograniczona do następujących tabel.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet – wstawka zawartości

adx_entityform – forma encji

adx_entityformmetadata – metadane formularza encji

adx_entitylist – lista encji

adx_entitypermission – uprawnienie encji

adx_forumthreadtype

adx_pagetemplate – szablon strony

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage – język portalu

adx_publishingstate – stan publikowania

adx_redirect – przekieruj do

adx_shortcut – skrót

adx_sitemarker – znaczniki witryn

adx_sitesetting – ustawienia strony

adx_tag

adx_urlhistory – historia URL

adx_webfile – plik strony

adx_webform – formularz strony

adx_webformmetadata – metadane formularza strony

adx_webformstep – formularz strony, krok

adx_weblink – link do strony

adx_weblink – zestaw linków do strony

adx_webpage– witryna

adx_webpageaccesscontrolrule – reguła kontroli dostępu do stron internetowych

adx_webrole

adx_website – witryna sieci web

adx_websiteaccess – dostęp do witryn internetowych

adx_websitebinding (tylko do pobrania)

adx_websitelanguage – język witryny internetowej

adx_webtemplate – szablon strony

annotation

Ważne

• Tabele niestandardowe oraz tabele specyficzne dla szablonów portali (takich jak blog, społeczność czy portal pomysłów) nie są obsługiwane przy dostosowywaniu za pomocą CLI w Microsoft Power Platform.
• Załączniki do plików obrazów do rekordów ad (adx_ad) nie są pobierane przy użyciu funkcji interfejsu wiersza polecenia Power Platform. Aby obejść ten problem, należy użyć pola Adresu URL obrazu albo dodać odwołanie do HTML w polu Kopiuj do rekordu pliku sieci Web zawierającego plik obrazu.

Zainstaluj i zweryfikuj Microsoft Power Platform CLI dla portali

Aby dowiedzieć się więcej o instalowaniu CLI w Microsoft Power Platform, przejdź do instalacji CLI w Microsoft Power Platform.

Po zainstalowaniu CLI w Microsoft Power Platform, otwórz okno poleceń i uruchom pac, aby sprawdzić, czy na wyjściu znajduje się „paportal” – polecenie dla portali Power Apps.

Więcej poleceń CLI dla portali Microsoft Power Platform

Polecenie CLI w Microsoft Power Platform dla portali to „paportal”.

W poniższych sekcjach znajdują się dodatkowe informacje o różnych właściwościach polecenia "paportal".

Parametry

Nazwa właściwości	opis	Przykład
lista	Listuje wszystkie strony portalu z bieżącego środowiska Dataverse. Możesz dodać parametr -v, aby wskazać, czy witryna używa standardowego lub rozszerzonego modelu danych	pac paportal list
pobierz	Pobieranie zawartości witryny internetowej portalu z bieżącego środowiska usługi Dataverse. Posiada on następujące parametry: - ścieżka: ścieżka lokalizacji, gdzie pobierana jest zawartość witryny internetowej (alias: -p) - webSiteId: Identyfikator strony internetowej portalu do pobrania (alias: -id) - overwrite: (opcjonalnie) true – aby nadpisać istniejącą zawartość, false – aby nie powiodło się, jeśli folder ma już zawartość strony (alias: -o) - modelVersion: 1 lub 2 w celu wskazania, czy pobierane dane witryny używa standardowego (1) lub ulepszonego modelu danych (2).	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
przekaż	Wgraj zawartość strony portalu do aktualnego środowiska Dataverse. Posiada on następujące parametry: - path: ścieżka lokalizacji, gdzie przechowywana jest zawartość witryny internetowej (alias: -p) - deploymentProfile: przekazywanie danych portalu przy użyciu szczegółów środowiska zdefiniowanych za pośrednictwem zmiennych profilu w pliku deployment-profiles/[profile-name].deployment.yaml - modelVersion: 1 lub 2 w celu wskazania, czy przekazuje dane witryny używa standardowego (1) lub ulepszonego modelu danych (2).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Użyj profilu rozmieszczenia

Przełącznik deploymentProfile pozwala zdefiniować zestaw zmiennych dla środowiska w formacie YAML. Na przykład, możesz mieć różne profile wdrożeń (takie jak dev, test, prod), które mają różne szczegóły schematu zdefiniowane w profilu.

Jeśli tworzysz profil testowy, możesz utworzyć plik pod deployment-profiles o nazwie „test.deployment.yml” (czyli <profileTag>.deployment.yml). I możesz uruchomić polecenie z tagiem (<profileTag>), aby użyć tego profilu:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

W tym pliku możesz mieć nazwę tabeli (encji) z ID tabeli, listę atrybutów oraz wartości, które chcesz nadpisać podczas wgrywania konfiguracji portalu za pomocą parametru deploymentProfile.

Dodatkowo, możesz użyć zmiennej OS by uzyskać dostęp do zmiennych środowiskowych systemu operacyjnego.

Poniżej podano przykład pliku o profilu „test.deployment.yml”, który zawiera unikatowe szczegóły schematu:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Uwaga

Aby dowiedzieć się więcej o wszystkich poleceniach używanych w CLI oprócz portali, przejdź do menu Typowe polecenia w CLI w Microsoft Power Platform.

Pliki manifestów

Po pobraniu zawartości witryny przy użyciu polecenia CLI pobierania pac paportal po pobraniu zawartości witryny generowane są także dwa pliki manifestów.

• Plik manifestu środowiska (org-url-manifest.yml)
• Usuń plik śledzenia (manifest.yml)

Plik manifestu środowiska (org-url-manifest.yml)

Plik manifestu środowiska jest generowany za każdym razem, gdy jest uruchamiane polecenie pobierania pac paportal.

Po każdym pobraniu narzędzie PAC CLI odczytuje istniejący plik manifestu środowiska i aktualizuje wpisy usunięte w środowisku lub tworzy plik manifestu środowiska, jeśli nie istnieje.

Po uruchomieniu polecenia przekazywania pac paportal w celu przekazania zawartości witryny sieci Web portalu. Odczytuje plik manifestu środowiska i identyfikuje zmiany wprowadzone od ostatniego pobrania i przesyła tylko zaktualizowaną zawartość. Pomaga to zoptymalizować proces przesyłania, ponieważ przesyłana jest tylko zaktualizowana zawartość witryny, zamiast przesyłać całą zawartość przy każdym poleceniu przesyłania.

Plik manifestu środowiska jest odczytywany tylko wtedy, gdy łączy się z tym samym środowiskiem (adres URL środowiska odpowiada nazwie pliku), aby uniknąć przypadkowej zmiany.

Uwaga

• Plik manifestu środowiska nie jest przeznaczony do śledzenia zmian podczas wdrażania witryny do różnych środowisk.
• Plik manifestu środowiska jest przeznaczony do użycia przez programistów do wdrażania lokalnie w ich środowisku deweloperskim i powinien być dodany do listy ignorantów git.

Usuń plik śledzenia (manifest.yml)

Ten plik służy do śledzenia usuniętych rekordów ze środowiska.

Jeśli zawartość witryny sieci Web jest pobierana za pomocą polecenia pobierania pac paportal, powoduje to dodanie usuniętych rekordów z pliku manifestu środowiska (org-url-manifest.yml) do manifest.yml pliku. W związku z tym przekazanie zawartości witryny sieci Web przy użyciu polecenia pac paportal upload powoduje usunięcie plików ze środowiska (nawet do innego środowiska). Ten plik nie jest usuwany i jest używany niezależnie od tego, w którym środowisku użytkownik jest połączony. Ten plik musi być uwzględniony podczas pchania zmian do kontroli źródła, aby rozważyć usunięcie elementów w środowisku docelowym.

Uwaga

Aby usunąć rekordy zawartości witryny w jednym środowisku oraz usunąć te same rekordy zawartości w innym środowisku przy użyciu interfejsu PAC CLI, trzeba będzie uruchomić polecenie pobierania pac paportal download przed usunięciem zawartości rekordu witryny sieci Web i po jej usunięciu. Element manifest.yml będzie śledzić te zmiany i usuwać odpowiednie rekordy w środowisku docelowym po uruchomieniu polecenia przekazywania pac paportal upload.

Używanie rozszerzenia Visual Studio Code

Można również użyć rozszerzenia VS Code Power Platform, aby korzystać z wbudowanego języka Liquid z IntelliSense, pomocy w uzupełnianiu kodu, podpowiedzi i współdziałać z CLI w Microsoft Power Platform za pomocą VS Code Integrated Terminal. Więcej informacji: Użyj rozszerzenia Visual Studio Code (wersja zapoznawcza)

Więcej rozważań

• Błąd jest zgłaszany, jeśli ścieżka do pliku przekracza maksymalne ograniczenie długości ścieżki. Więcej informacji: Ograniczenie maksymalnej długości ścieżki w systemie Windows
• Dla zduplikowanych rekordów, takich jak zduplikowana nazwa strony internetowej, Microsoft Power Platform CLI tworzy dwa różne foldery — jeden z nazwą strony internetowej, a drugi z tą samą nazwą poprzedzoną kodem hash. Na przykład „Moja strona” i „Moja strona-hash-code”.

Następne kroki

Samouczek: Używanie interfejsu wiersza polecenia usługi Microsoft Power Platform z portalami

Zobacz też

• Microsoft Power Platform CLI
• Używanie rozszerzenia Visual Studio Code (wersja zapoznawcza)