Wsparcie portali dla CLI w Microsoft Power Platform
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.
Microsoft Power Platform CLI (Command Line Interface) 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 dotyczących , zobacz Co to jest interfejs wiersza polecenia Microsoft Power Platform CLI?
Dzięki tej funkcji, portale Microsoft Power Apps wspierają Microsoft Power Platform CLI, aby umożliwić CI/CD (Continuous Integration/Continuous Deployment) konfiguracji portalu. Możesz teraz zameldować konfigurację portalu do kontroli źródła i przenieść konfigurację portalu 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, zobacz Instalacja CLI Microsoft Power Platform.
Dlaczego warto używać CLI w Microsoft Power Platform do projektowania portali?
Dzięki wsparciu portali dla Microsoft Power Platform CLI, można teraz korzystać z możliwości dostosowywania portali w trybie offline poprzez wprowadzanie zmian w zawartości portali. A gdy wszystkie dostosowania lub zmiany zostaną zapisane, prześlij je do portalu. Kiedy pobierasz zawartość portali za pomocą CLI w Microsoft Power Platform, 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 portalu 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 portalu 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 CLI w Microsoft Power Platform jest ograniczona do tabel wymienionych poniżej.
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. | pac paportal list |
| pobierz | Pobieranie zawartości witryny internetowej portalu z bieżącego środowiska usługi Dataverse. Posiada on następujące parametry: - path: ścieżka lokalizacji, do której zostanie pobrana 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) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| 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 |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
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
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 będą również generować 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 będzie tylko do odczytu, gdy połączy się z tym samym środowiskiem (adres URL środowiska pasuje do nazwy pliku), aby uniknąć przypadkowych zmian.
Usuń plik śledzenia (manifest.yml)
Ten plik służy do śledzenia usuniętych rekordów ze środowiska.
Gdy zawartość witryny zostanie pobrana za pomocą polecenia pac paportal download, spowoduje to dodanie usuniętych rekordów z pliku manifestu środowiska do pliku manifest (org-url-manifest.yml). W związku z tym przekazanie zawartości witryny sieci Web przy użyciu polecenia pac paportal upload spowoduje 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.
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)
Uwagi dodatkowe
- 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, CLI w Microsoft Power Platform 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