pac canvas

Робота з файлами MSAPP power Apps.

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

Important

Commands

Command Description
pac canvas create Створення програми полотна з настроюваної сполучної лінії
pac canvas download Завантажити програму canvas як файл MSAPP
pac canvas list Список програм із полотном
pac canvas pack (Попередній перегляд) Пакування джерел у файл msapp
pac canvas unpack (Попередній перегляд) Видобування файлу msapp у джерела

pac canvas create

Створення програми полотна з настроюваної сполучної лінії

Ця команда створить .msapp програму полотна на основі визначення OpenAPI наявного настроюваного з'єднувача. Програма міститиме екрани, макет елемента керування та код Power Fx, створені на основі визначених дій настроюваної сполучної лінії з попередньо визначеним виглядом. Програма може використовуватися для безпосереднього виконання дій, визначених у спеціальному з'єднувачі.

Виробники можуть імпортувати створений .msapp в Power Apps Studio, щоб відтворити програму, або внести зміни та внести додаткові настройки. Імпорт створеної програми до Power Apps Studio, перейшовши до розділу Огляд відкриття> файлу >в студії.

Examples

У наведених нижче прикладах показано використання 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.

Remarks

Зауваження та обмеження:

  • Настроюваний з'єднувач connector-display-name , на який посилаються параметри, connector-id має бути частиною рішення.
  • Після імпортування програми до studio не буде зв'язку з настроюваним з'єднувачем. Виробник повинен вручну додати посилання на настроюваний з'єднувач, з якого створено програму, перш ніж відтворювати програму. Кроки див. в статті Додавання зв'язків даних до програм полотна . Доки це не буде зроблено, у програмі можуть відображатися помилки формул, які виправлять після додавання посилання на з'єднувач. Ім'я настроюваної сполучної лінії, доданої до програми, має відповідати короткому імені настроюваної сполучної лінії, на яку посилається canvas create команда.
  • Програма міститиме один екран для кожної з них POST і GET дію, яку визначає сполучна лінія.
    • Інші дієслова, доступні в настроюваних сполучних лініях, не підтримуються.
  • Елементи керування, відтворені на екрані кожної дії, динамічно створюються на основі визначених типів вводу та виводу кожної дії. Певні типи вводу та виводу, визначені в настроюваному з'єднувачі, не підтримуються .canvas create Команда створить попередження в консолі, коли вони виникають. Specific cases:
    • Масиви об'єктів і масивів масивів не підтримуються як вхідні дані
    • Елементи керування не створюються для об'єктів або вкладених масивів понад 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

Example

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

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

--sources

Каталог до джерел, які потрібно упаковувати

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

--disable-load-from-yaml

Коли це вказано, вимикає завантаження пакетного додатку з файлів *.pa.yaml у каталозі 'Src'. Підтримується лише з версткою 'SourceCode'.

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

--layout

Макет для каталогу джерел. Примітка: «Експериментальне» оформлення застаріле і буде видалене у майбутньому релізі. Використовуйте макет 'SourceCode' для останнього підтримуваного макету.

Використайте одне з таких значень:

  • Experimental
  • SourceCode

--msapp

Шлях до файлу MSAPP

--overwrite

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

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

Remarks

.msapp Створює файл із попередньо розпакованих вихідних файлів. Результат можна відкрити в Power Apps Studio, перейшовши доогляду>>.

Після розпакування вихідні файли можна редагувати та керувати ними за допомогою зовнішніх засобів, таких як Visual Studio Code і GitHub.

pac canvas unpack

(Попередній перегляд) Видобування файлу msapp у джерела

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Розпаковування до стандартного HelloWorld_src каталогу.

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

--msapp

Шлях до файлу MSAPP

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

--layout

Макет для каталогу джерел. Примітка: «Експериментальне» оформлення застаріле і буде видалене у майбутньому релізі. Використовуйте макет 'SourceCode' для останнього підтримуваного макету.

Використайте одне з таких значень:

  • Experimental
  • SourceCode

--overwrite

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

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

--sources

Каталог до джерел, які потрібно розпакувати

Remarks

Розпаковує вихідний .msapp файл.

.msapp Завантажте файл зі студії Power Apps Studio, перейшовши до команди Зберегти як>>цей комп'ютер.

Якщо параметр джерела не вказано, каталог з таким самим іменем і розташуванням .msapp , що й файл, використовується з суфіксом _src .

Folder structure

Щоб розпакувати та упакувати властивості, використовуйте таку структуру папок:

  • \src – файли керування та компонентів. Це містить джерела.
    • *.fx.yaml – формули, видобуті з control.json файлу.

      Note

      Це місце для редагування формул.

    • 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висновках.

File format

У .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.json
  • Для конфліктів у цих файлах можна прийняти найновішу версію:
    • \checksum.json
  • Якщо під цими шляхами виникають конфлікти злиття, об'єднати їх не можна. Повідомте нам, чи часто це трапляється; ми працюватимемо над реструктуризацією формату файлу, щоб уникнути конфліктів.
    • \Connections*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open source

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

See also

Microsoft Power Platform групи команд CLI
огляд Microsoft Power Platform CLI

  • Last updated on