kanwa pac

Obsługa plików msapp w usłudze Power Apps

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Commands

pac canvas create

Generowanie aplikacji kanwy na podstawie łącznika niestandardowego

To polecenie spowoduje wygenerowanie .msapp aplikacji kanwy na podstawie definicji interfejsu OpenAPI istniejącego łącznika niestandardowego. Aplikacja będzie zawierać ekrany, układ sterowania i kod Power Fx wygenerowany w oparciu o sposób akcji łącznika niestandardowego ze wstępnie zdefiniowanym wyglądem i działaniem. Aplikacja może służyć do bezpośredniego wykonywania akcji zdefiniowanych w łączniku niestandardowym.

Twórcy mogą zaimportować wygenerowane .msapp dane do programu Power Apps Studio, aby odtworzyć aplikację, lub wprowadzić zmiany i wprowadzić dalsze dostosowania. Zaimportuj wygenerowaną aplikację do programu Power Apps Studio, przechodząc do pozycji Plik>Otwórz>przeglądaj w programie Studio.

Przykłady

W poniższych przykładach pokazano użycie pac canvas create polecenia .

• Tworzenie aplikacji kanwy na podstawie definicji interfejsu OPEN API według nazwy wyświetlanej
• Tworzenie aplikacji kanwy na podstawie definicji interfejsu OPEN API według identyfikatora

Tworzenie aplikacji kanwy na podstawie definicji interfejsu OPEN API według nazwy wyświetlanej

W tym przykładzie jest tworzona aplikacja kanwy (jako plik *.msapp) oparta na definicji interfejsu OPEN API przy użyciu nazwy wyświetlanej łącznika.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

Tworzenie aplikacji kanwy na podstawie definicji interfejsu OPEN API według identyfikatora

W tym przykładzie tworzona jest aplikacja kanwy (jako plik *.msapp) oparta na definicji interfejsu OPEN API przy użyciu identyfikatora łącznika.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

Albo connector-display-name albo connector-id są wymagane.

Wymagane parametry do utworzenia kanwy

--msapp

Ścieżka do pliku msapp do wygenerowania

Opcjonalne parametry dla tworzenia kanwy

--connector-display-name

Nazwa wyświetlana łącznika do wygenerowania aplikacji Power App.

--connector-id

Identyfikator łącznika do wygenerowania aplikacji Power App.

--environment

Docelowy identyfikator środowiska lub adres URL. Wartość domyślna to środowisko aktualnie aktywnego profilu uwierzytelniania usługi Dataverse.

Uwagi

Zagadnienia i ograniczenia:

• Łącznik niestandardowy, do których odwołuje się connector-display-name parametr lub connector-id , musi być częścią rozwiązania.
• Po zaimportowaniu aplikacji do programu Studio nie będzie skojarzenia z łącznikiem niestandardowym. Twórca musi ręcznie dodać odwołanie do łącznika niestandardowego, z którego aplikacja została wygenerowana, zanim będzie można odtworzyć aplikację. Aby uzyskać instrukcje, zobacz Dodawanie połączeń danych z aplikacjami kanwy . Dopóki nie zostanie to zrobione, w aplikacji mogą pojawić się błędy formuły, które zostaną rozwiązane po dodaniu odwołania do łącznika. Nazwa łącznika niestandardowego dodawanego do aplikacji musi być zgodna z nazwą wyświetlaną łącznika niestandardowego, do którego odwołujesz się w poleceniu canvas create .
• Aplikacja będzie zawierać jeden ekran dla każdego POSTGET i akcję zdefiniowaną przez łącznik.
  • Inne czasowniki dostępne w łącznikach niestandardowych nie są obsługiwane.
• Kontrolki renderowane na ekranie każdej akcji są generowane dynamicznie na podstawie sposobu definiowania typów danych wejściowych i wyjściowych każdej akcji. Niektóre typy danych wejściowych i wyjściowych zdefiniowanych w łączniku niestandardowym nie są obsługiwane przez program canvas create. Polecenie spowoduje wygenerowanie ostrzeżeń w konsoli programu , gdy zostaną one napotkane. Konkretne przypadki:
  • Tablice obiektów i tablic tablic tablic nie są obsługiwane jako dane wejściowe
  • Kontrolki nie są generowane dla obiektów ani tablic zagnieżdżonych poza głębokością 20
  • Typy "Plik" i "Format binarny" nie są obsługiwane dla danych wejściowych ani wyjściowych.

pobieranie kanwy pac

Pobieranie aplikacji kanwy jako pliku msapp

Wymagane parametry do pobrania kanwy

--name -n

Dokładna, częściowa nazwa aplikacji kanwy lub identyfikator aplikacji

Opcjonalne parametry pobierania kanwy

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--extract-to-directory -d

Nazwa katalogu do wyodrębnienia aplikacji kanwy do

--file-name -f

Nazwa pliku (zwykle z rozszerzeniem msapp). Jeśli nie podano pliku, zostanie zapisany w bieżącym katalogu z ciągiem "appname". msapp

--overwrite -o

Zezwalaj na zastępowanie plików

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

lista kanwy pac

Wyświetlanie listy aplikacji kanwy

Opcjonalne parametry listy kanwy

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

pac canvas pack

(Wersja zapoznawcza) Pakowanie źródeł do pliku msapp

Example

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

Wymagane parametry dla pakietu kanwy

--msapp

Ścieżka do pliku msapp

--sources

Katalog do źródeł do spakowania

Uwagi

.msapp Tworzy plik z wcześniej rozpakowanych plików źródłowych. Wynik można otworzyć w programie Power Apps Studio, przechodząc do pozycji Plik>Otwórz>przeglądaj.

Po rozpakowaniu pliki źródłowe można edytować i zarządzać nimi za pomocą narzędzi zewnętrznych, takich jak Visual Studio Code i GitHub.

rozpakowywanie kanwy pac

(Wersja zapoznawcza) Wyodrębnianie pliku msapp do źródeł

Example

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

Rozpakowuje katalog domyślny HelloWorld_src .

Wymagane parametry do rozpakowywania kanwy

--msapp

Ścieżka do pliku msapp

Opcjonalne parametry rozpakowywania kanwy

--sources

Katalog do źródeł do rozpakowywania

Uwagi

Rozpakowuje .msapp plik źródłowy.

.msapp Pobierz plik z programu Power Apps Studio, przechodząc do pozycji Zapisz plik>jako>ten komputer.

Jeśli parametr źródła nie zostanie określony, katalog o tej samej nazwie i lokalizacji, co .msapp plik jest używany z sufiksem _src .

Struktura folderów

Rozpakowywanie i pakowanie właściwości używa następującej struktury folderów:

• \src — pliki kontrolek i składników. Zawiera on źródła.
  • *.fx.yaml — formuły wyodrębnione z control.json pliku.

    Uwaga / Notatka

    Jest to miejsce do edytowania formuł.

  • CanvasManifest.json — plik manifestu, który zawiera informacje, które zwykle znajdują się w nagłówku, właściwościach i publishInfo.
  • *.json — plik pierwotny control.json .
  • \EditorState*.editorstate.json — informacje buforowane dla programu Power Apps Studio do użycia.
• \DataSources — wszystkie źródła danych używane przez aplikację.
• \Connections — wystąpienia połączeń zapisane w aplikacji i używane podczas ponownego ładowania do programu Power Apps Studio.
• \Assets — pliki multimedialne osadzone w aplikacji.
• \pkgs — pobrana kopia odwołań zewnętrznych, takich jak szablony, pliki definicji interfejsu API i biblioteki składników. Są one podobne do odwołań NuGet/NPM.
• \other — wszystkie różne pliki potrzebne do ponownego utworzenia pliku .msapp.
  • entropy.json — elementy nietrwałe (na przykład znaczniki czasu) są wyodrębniane do tego pliku. Pomaga to zmniejszyć hałaśliwe różnice w innych plikach, zapewniając jednocześnie możliwość rundy.
  • Przechowuje inne pliki z aplikacji msapp, takie jak to, co znajduje się w \references.

Format pliku

Pliki .fx.yaml używają podzbioru YAML. Podobnie jak w przypadku programu Excel wszystkie wyrażenia powinny zaczynać się od znaku =równości . Więcej informacji: Power Fx YAML Formula Grammar

Scalanie zmian za pomocą programu Power Apps Studio

Podczas scalania zmian wprowadzonych w dwóch różnych sesjach programu Power Apps Studio:

• Upewnij się, że wszystkie nazwy kontrolek są unikatowe. Na przykład wstawienie przycisku w dwóch różnych sesjach może spowodować wyświetlenie dwóch Button1 kontrolek. Zalecamy nazywanie kontrolek wkrótce po ich utworzeniu. Narzędzie nie akceptuje dwóch kontrolek o tej samej nazwie.
• W przypadku tych plików scal je w zwykły sposób:
  • \src*.fx.yaml
• Jeśli występują konflikty lub błędy, możesz usunąć te pliki:
  • \src\editorstate*.json — te pliki zawierają opcjonalne informacje w programie Power Apps Studio.
  • \other\entropy.jsw dniu
• W przypadku konfliktów w tych plikach można zaakceptować najnowszą wersję:
  • \checksum.jsw dniu
• Jeśli istnieją jakiekolwiek konflikty scalania w tych ścieżkach, nie można bezpiecznie scalić. Daj nam znać, czy dzieje się to często; Będziemy pracować nad restrukturyzacją formatu pliku, aby uniknąć konfliktów.
  • \Połączenia*
  • \DataSources*
  • \pkgs*
  • CanvasManifest.json

Otwarty kod źródłowy

Polecenia kanwy w interfejsie wiersza polecenia platformy Microsoft Power Platform to open source. Omówienie ulepszeń, zgłaszanie problemów i uzyskiwanie dostępu do kodu z repozytorium narzędzi językowych usługi Power Apps.

walidacja kanwy pac

(Wersja zapoznawcza) Zweryfikuj źródło pa.yaml dla rozpakowanego pliku msapp

Wymagane parametry do weryfikacji kanwy

--directory -d

Ścieżka do wyodrębnionego katalogu msapp zawierającego pliki pa.yaml w celu zweryfikowania

Zobacz także

Grupy poleceń interfejsu wiersza polecenia platformy Microsoft Power Platform
Omówienie interfejsu wiersza polecenia platformy Microsoft Power Platform