Поділитися через

pac canvas

Робота з файлами MSAPP у надбудові Power Apps

[Ця стаття стосується попередньої версії, і її буде змінено.]

Важливо

Команди

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, перейшовши до розділу Огляд відкриття> файлу >в студії.

Приклади

У наведених нижче прикладах показано використання pac canvas create команди.

Створення програми полотна на основі визначення відкритого API за відображуваним іменем

У цьому прикладі створюється програма полотна (як файл *.msapp) на основі визначення Open API за допомогою короткого імені сполучної лінії.

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

Створення програми полотна на основі визначення відкритого API за ідентифікатором

У цьому прикладі створюється програма полотна (як файл *.msapp) на основі визначення open API за допомогою ідентифікатора сполучної лінії.

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

Або connector-display-nameconnector-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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--extract-to-directory -d

Ім'я каталогу для видобування програми canvas до

--file-name -f

Ім'я файлу (зазвичай з розширенням MSAPP). Якщо не вказано, файл зберігається в поточному каталозі з 'appname'.msapp

--overwrite -o

Дозволити перезаписування файлу

Для цього параметра не потрібне значення. Це перемикач.

pac canvas list

Список програм із полотном

Необов'язкові параметри для canvas list

--environment -env

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

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 – файл маніфесту, який містить відомості, які зазвичай містяться в заголовку, властивостях і publishInfo.
    • *.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