Obsługa CLI platformy Microsoft Power Platform dla usługi 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 interfejsu wiersza polecenia platformy Microsoft Power Platform to pierwszy krok w kierunku kompleksowego scenariusza zarządzania cyklem życia aplikacji (ALM), w którym deweloperzy przedsiębiorstwa i dostawcy oprogramowania mogą tworzyć, kompilować, debugować i publikować swoje rozszerzenia oraz dostosowania szybko i wydajnie. Aby uzyskać więcej informacji, zobacz Co to jest interfejs wiersza polecenia platformy Microsoft Power Platform?

Dzięki tej funkcji interfejs wiersza polecenia Microsoft Power Platform CLI umożliwia ciągłą integrację i ciągłe wdrażanie konfiguracji witryny Power Pages. Teraz możesz zaewidencjonować konfigurację witryny internetowej w celu kontroli źródła i przenieść konfigurację witryny internetowej do dowolnego środowiska przy użyciu interfejsu wiersza polecenia Microsoft Power Platform CLI.

Dlaczego warto używać interfejsu wiersza polecenia platformy Microsoft Power Platform do tworzenia witryn internetowych?

Za pomocą interfejsu wiersza polecenia platformy Microsoft Power Platform można teraz używać funkcji podobnych do trybu offline na potrzeby dostosowywania witryny internetowej, wprowadzając zmiany w zawartości witryny internetowej. Po zapisaniu wszystkich dostosowań lub zmian możesz przekazać konfigurację witryny internetowej z powrotem do usługi Microsoft Dataverse. Podczas pobierania zawartości witryny internetowej za pomocą Microsoft Power Platform CLI, zawartość jest ustrukturyzowana w formatach YAML i HTML, co ułatwia dostosowywanie, umożliwiając profesjonalne środowisko rozwoju.

Oto lista funkcji i możliwości, z których portale mogą korzystać dzięki obsłudze Microsoft Power Platform CLI:

Łatwość użycia

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

• Rozwijanie istniejącego narzędzia CLI platformy Microsoft Power Platform.

Zarządzanie cyklem życia aplikacji (ALM)

• Śledzenie zmian w konfiguracji witryny internetowej w organizacji

• Przenieś pliki konfiguracyjne między organizacjami lub dzierżawami

Wsparcie techniczne dla programistów i przedsiębiorstw

• Ułatwia bezproblemową integrację z dowolnymi narzędziami kontroli źródła, takimi jak "git"

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

Instalowanie CLI platformy Microsoft Power Platform

Aby uzyskać instrukcje krok po kroku, zobacz Instalowanie interfejsu wiersza polecenia platformy Microsoft Power Platform.

Obsługiwane tabele

Obsługa portalu dla interfejsu wiersza polecenia platformy Microsoft Power Platform jest ograniczona do poniższych tabel.

Instalowanie i weryfikowanie interfejsu wiersza polecenia Microsoft Power Platform CLI dla portali

Aby dowiedzieć się więcej na temat instalowania interfejsu wiersza polecenia platformy Microsoft Power Platform, przejdź do tematu Instalowanie interfejsu wiersza polecenia platformy Microsoft Power Platform.

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

Polecenia CLI platformy Microsoft Power Platform dla portali

Polecenie interfejsu wiersza polecenia platformy Microsoft Power Platform dla portali to "paportal".

Poniższe sekcje zawierają więcej szczegółów na temat różnych właściwości polecenia "paportal".

Parametry

Korzystanie z profilu wdrożenia

Przełącznik deploymentProfile umożliwia zdefiniowanie zestawu zmiennych dla środowiska w formacie YAML. Na przykład można mieć różne profile wdrażania (takie jak tworzenie, testowanie, prod), które mają różne szczegóły schematu zdefiniowane w profilu.

Jeśli tworzysz profil testowy, możesz utworzyć plik w obszarze profile-wdrożenia o nazwie "test.deployment.yml" (czyli <profileTag>.deployment.yml). Aby użyć tego profilu, możesz uruchomić polecenie z tagiem (<profileTag>):

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

W tym pliku możesz mieć nazwę tabeli (jednostki) z identyfikatorem tabeli, listą atrybutów i wartościami, które mają zostać zastąpione podczas przekazywania konfiguracji portalu przy użyciu parametru deploymentProfile .

Ponadto można użyć zmiennej OS , aby uzyskać dostęp do zmiennych środowiskowych systemu operacyjnego.

Oto przykład tego pliku YAML 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

Pliki manifestu

Podczas pobierania zawartości witryny internetowej przy użyciu polecenia pac pages download CLI, wraz z zawartością strony generowane są również dwa pliki manifestu;

• Plik manifestu środowiska (org-url-manifest.yml)
• Usuwanie pliku manifestu śledzenia (manifest.yml)

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

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

Po każdym pobraniu narzędzie interfejsu wiersza polecenia PAC 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 pac pages upload, aby przesłać zawartość witryny internetowej portalu. Odczytuje plik manifestu środowiska i identyfikuje zmiany wprowadzone od ostatniego pobrania i przekazuje tylko zaktualizowaną zawartość. Pomaga to w optymalizacji procesu przesyłania, ponieważ tylko aktualizowana zawartość strony internetowej zostanie przesłana, zamiast przesyłać wszystkie treści z każdą komendą przesyłania.

Plik manifestu środowiska jest odczytywany podczas nawiązywania połączenia z tym samym środowiskiem (adres URL środowiska jest zgodny z nazwą pliku), aby uniknąć przypadkowych zmian.

Usuwanie pliku manifestu śledzenia (manifest.yml)

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

Gdy zawartość witryny internetowej zostanie pobrana za pomocą polecenia pac pages download , spowoduje to dodanie usuniętych rekordów z pliku manifestu środowiska (org-url-manifest.yml) do pliku manifest.yml. Dlatego podczas przesyłania zawartości witryny internetowej przy użyciu polecenia pac pages upload usunięte zostaną pliki ze środowiska (nawet do innego środowiska). Ten plik nie jest usuwany i jest używany niezależnie od tego, które środowisko jest połączone. Ten plik musi być uwzględniony podczas pchania zmian do kontroli źródła, aby rozważyć usunięcie elementów w środowisku docelowym.

Korzystanie z rozszerzenia programu Visual Studio Code

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

Więcej zagadnień

• Zgłaszany jest błąd, jeśli ścieżka pliku przekracza ograniczenie maksymalnej długości ścieżki. Więcej informacji: Ograniczenie maksymalnej długości ścieżki w systemie Windows
• W przypadku zduplikowanych rekordów, takich jak zduplikowana nazwa strony internetowej, interfejs wiersza polecenia platformy Microsoft Power Platform tworzy dwa różne foldery — jeden z nazwą strony internetowej, a drugi o tej samej nazwie poprzedzony kodem skrótu. Na przykład "My-page" i "My-page-hash-code".

Dalsze kroki

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

Zobacz także

• Interfejs wiersza poleceń Microsoft Power Platform
• Korzystanie z rozszerzenia programu Visual Studio Code (wersja zapoznawcza)