Споделяне чрез

pac canvas

Работа с .msapp файлове на Power Apps

[Тази статия е предварителна версия на документацията и подлежи на промяна.]

Важно

  • Командите pack и unpack са отхвърлени.
  • За да управлявате източника на вашето приложение за платно, използвайте Power Platform Git Integration.
  • Командата create е общодостъпна.

Команди

Command Описание
pac canvas create Генериране на приложение за платно от конектор по избор
pac canvas download Изтегляне на приложението canvas като .msapp файл
pac canvas list Списък на приложенията за платно
pac canvas pack (Предварителен преглед) Пакет на източници в msapp файл
pac canvas unpack (Предварителен преглед) Извличане на msapp файл в източници
pac canvas validate (Предварителен преглед) Проверка на източника .pa.yaml за разархивифициран msapp файл

pac canvas create

Генериране на приложение за платно от конектор по избор

Тази команда ще генерира приложение за .msapp платно въз основа на дефиницията OpenAPI на съществуващ конектор по избор. Приложението ще съдържа екрани, оформление на контроли и код на Power Fx, генериран въз основа на начина, по който са дефинирани действията на конектора по избор, с предварително зададен изглед и усещане. Приложението може да се използва за директно изпълнение на действията, дефинирани в конектора по избор.

Създателите могат да импортират генерираните .msapp в Power Apps Studio, за да възпроизвеждат приложението, или да извършват редакции и да правят допълнителни персонализации. Импортирайте генерираното приложение в Power Apps Studio, като отидете на"Преглед при> на >" в Studio.

Примери

Следващите примери показват използването на командата pac canvas create .

Създаване на приложение за платно въз основа на дефиниция на Open API по показвано име

Този пример създава приложение за платно (като *.msapp файл) въз основа на дефиниция на Open API с помощта на показваното име на конектора.

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

Създаване на приложение за платно въз основа на дефиниция на Open API по ИД

Този пример създава приложение за платно (като *.msapp файл) въз основа на дефиниция на Open API с помощта на ИД на конектора.

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

connector-display-name Или connector-id са задължителни.

Задължителни параметри за canvas create

--msapp

Път до .msapp файл, който трябва да бъде генериран

Незадължителни параметри за canvas create

--connector-display-name

Показваното име на конектора, от който да се генерира Power App.

--connector-id

ИД на конектора, от който да се генерира Power App.

--environment

ИД или URL адрес на целевата среда. Стойността по подразбиране е средата на вашия активен профил за удостоверяване на Dataverse.

Забележки

Съображения и ограничения:

  • Конекторът по избор, към който има препратка към параметъра connector-display-name или connector-id , трябва да бъде част от решение.
  • След импортирането на приложението в Studio няма да има връзка към конектора по избор. Създателят трябва ръчно да добави препратка към конектора по избор, от който е генерирано приложението, преди да може да се възпроизвежда приложението. Вижте Добавяне на връзки с данни към платно на приложения за стъпки. Докато това приключи, може да видите грешки във формули в приложението, които ще се отстранят, след като бъде добавена препратката към конектора. Името на конектора по избор, който добавяте към приложението, трябва да съвпада с показваното име на конектора по избор, посочен в командата canvas create .
  • Приложението ще съдържа по един екран за всяко POST действие и GET действие, дефинирано от конектора.
    • Други глаголи, налични в конекторите по избор, не се поддържат.
  • Контролите, рендирани на екрана на всяко действие, се генерират динамично въз основа на това как са дефинирани типовете входни и изходни данни на всяко действие. Някои типове входни и изходни данни, дефинирани в конектора по избор, не се поддържат от canvas create. Командата ще генерира предупреждения в конзолата, когато се натъкнат на тях. Конкретни случаи:
    • Масивите от обекти и масиви от масиви не се поддържат като входни данни
    • Контролите не се генерират за обекти или вложени масиви над дълбочина 20
    • Типовете "Файл" и "двоичен формат" не се поддържат за въвеждане или изход.

pac canvas download

Изтегляне на приложението canvas като .msapp файл

Задължителни параметри за canvas download

--name -n

Приложението Canvas – точно, частично име или ИД на приложение

Незадължителни параметри за canvas download

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--extract-to-directory -d

Име на директорията за извличане на приложението за платно в

--file-name -f

Име на файл (обикновено с разширение .msapp). Ако не е предоставен файл, е записан в текущата директория с "appname".msapp

--overwrite -o

Разреши презаписване на файлове

Този параметър не изисква стойност. Това е превключвател.

pac canvas list

Списък на приложенията за платно

Незадължителни параметри за canvas list

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac canvas pack

(Предварителен преглед) Пакет на източници в msapp файл

Пример

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

Задължителни параметри за canvas pack

--msapp

Път до .msapp файл

--sources

Справочен указател към източниците, които трябва да бъдат опаковани

Забележки

.msapp Създава файл от предварително разархивирани файлове източник. Резултатът може да бъде отворен в Power Apps Studio, като отидете наПреглед при отваряне на>файл>.

След като бъдат разопаковани, файловете източници могат да бъдат редактирани и управлявани с външни инструменти, като например Visual Studio Code и GitHub.

pac canvas unpack

(Предварителен преглед) Извличане на msapp файл в източници

Пример

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

pac canvas unpack --msapp HelloWorld.msapp

Разопакова в директория по подразбиране HelloWorld_src .

Задължителни параметри за canvas unpack

--msapp

Път до .msapp файл

Незадължителни параметри за canvas unpack

--sources

Директория с източници за разопаковане

Забележки

Разопакова файла .msapp източник.

Изтеглете .msapp файла от Power Apps Studio, като отидете на Файл запиши>като>Този компютър.

Ако параметърът за източници не е указан, с суфикс се използва .msapp директория със същото име и местоположение като на _src файла.

Структура на папките

Свойствата за разопаковане и пакетиране използват следната структура на папките:

  • \src – Файлове за управление и компоненти. Това съдържа източниците.
    • *.fx.yaml – формулите, извлечени от control.json файла.

      Бележка

      Това е мястото, където можете да редактирате формулите си.

    • CanvasManifest.json – с манифестен файл, съдържащ нормално присъстващата информация в заглавката, свойствата и информацията за публикуване.
    • *.json - Суров control.json файл.
    • \EditorState*.editorstate.json – кеширана информация за използване от Power Apps Studio.
  • \DataSources – всички източници на данни, използвани от приложението.
  • \Connections – екземпляри на връзка, записани с приложението и използвани при презареждане в Power Apps Studio.
  • \Assets – мултимедийни файлове, вградени в приложението.
  • \pkgs – изтеглено копие на външни препратки, като например шаблони, файлове с дефиниции на API и библиотеки с компоненти. Те са подобни на препратки nuGet/NPM.
  • \other – всички други файлове, необходими за повторно създаване на .msapp.
    • entropy.json – в този файл се извличат непостоянни елементи (като времеви клейма). Това помага да се намалят шумните разлики в другите файлове, като същевременно се гарантира, че все още можем да се отбием обратно.
    • Задържа други файлове от msapp, като например какво има в \rференции.

Файлов формат

Файловете .fx.yaml използват подмножество от YAML. Подобно на Excel, всички изрази трябва да започват със знак =за равенство . Повече информация: Граматика на формула на Power Fx YAML

Обединяване на промените с Power Apps Studio

Когато обединявате промени, които са направени в две различни сесии на Power Apps Studio:

  • Уверете се, че всички имена на контроли са уникални. Например вмъкването на бутон в две различни сесии може да доведе до две Button1 контроли. Препоръчваме ви да наименуване на контролите скоро след създаването им. Инструментът не приема две контроли с едно и също име.
  • За тези файлове ги обединете, както обикновено:
    • \src*.fx.yaml
  • Ако има конфликти или грешки, можете да изтриете тези файлове:
    • \src\editorstate*.json – тези файлове съдържат опционална информация в Power Apps Studio.
    • \other\entropy.jsвкл.
  • За всякакви конфликти в тези файлове е добре да приемете най-новата версия:
    • \checksum.jsвкл.
  • Ако има конфликти при обединяването под тези пътища, не е безопасно да обедините. Уведомете ни, ако това се случва често; ще работим по преструктурирането на файловия формат, за да избегнем конфликти.
    • \Връзки*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Отворен източник

Командите на платното в CLI на Microsoft Power Platform са с отворен код. Обсъждайте подобрения, повдигайте проблеми и осъществявайте достъп до кода от хранилището за инструменти за език на Power Apps.

pac canvas validate

(Предварителен преглед) Проверка на източника .pa.yaml за разархивифициран msapp файл

Задължителни параметри за canvas validate

--directory -d

Път до извлечения msapp указател, съдържащ .pa.yaml файлове за проверка

Вижте също

CLI командни групи на Microsoft Power Platform
Общ преглед на CLI за Microsoft Power Platform

  • Last updated on