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

pac canvas

Работа с msapp-файлами Power Apps

[Данная статья посвящена предварительному выпуску и может быть изменена.]

Это важно

  • pack Не unpack рекомендуется использовать команды.
  • Чтобы управлять версиями приложения на основе холста, используйте интеграцию Power Platform Git.
  • Команда create общедоступна.

Commands

Command Description
pac canvas create Создание приложения на основе холста из пользовательского соединителя
pac canvas download Скачивание приложения на основе холста в виде MSAPP-файла
pac canvas list Вывод списка приложений на основе холста
pac canvas pack (предварительная версия) Упаковка источников в msapp-файл
pac canvas unpack (предварительная версия) Извлечение msapp-файла в источники
pac canvas validate (предварительная версия) Проверка источника PA.yaml для распакованного msapp-файла

pac canvas create

Создание приложения на основе холста из пользовательского соединителя

Эта команда создаст .msapp приложение на основе определения OpenAPI существующего пользовательского соединителя. Приложение будет содержать экраны, макет элемента управления и код PowerFx, созданный на основе определения действий пользовательского соединителя с предопределенным видом и чувством. Приложение можно использовать для непосредственного выполнения действий, определенных в пользовательском соединителе.

Создатели могут импортировать созданные .msapp в Power Apps Studio для воспроизведения приложения или вносить изменения и вносить дополнительные настройки. Импортируйте созданное приложение в Power Apps Studio, перейдя настраницу "Открыть>файл>" в Студии.

Примеры

В следующих примерах показано использование pac canvas create команды.

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

В этом примере создается приложение холста (как файл *.msapp) на основе определения Открытого API с помощью отображаемого имени соединителя.

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

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

В этом примере создается приложение холста (как файл *.msapp) на основе определения Открытого 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-nameconnector-id на который ссылается или параметры, должен быть частью решения.
  • После импорта приложения в Studio связь с пользовательским соединителем не будет. Создатель должен вручную добавить ссылку на пользовательский соединитель, из которого было создано приложение, прежде чем приложение можно будет воспроизвести. Инструкции см. в разделе "Добавление подключений к данным" в приложениях холста . Пока это не будет сделано, в приложении могут появиться ошибки формул, которые будут разрешаться после добавления ссылки на соединитель. Имя настраиваемого соединителя, добавляемого в приложение, должно соответствовать отображаемой имени настраиваемого соединителя, на который ссылается команда canvas create .
  • Приложение будет содержать один экран для каждого POST и GET действия, которое определяет соединитель.
    • Другие команды, доступные в пользовательских соединителях, не поддерживаются.
  • Элементы управления, отображаемые на экране каждого действия, динамически создаются на основе определения входных и выходных типов каждого действия. Некоторые типы входных и выходных данных, определенные в пользовательском соединителе, не поддерживаются canvas create. Команда создаст предупреждения в консоли при обнаружении этих предупреждений. Конкретные случаи:
    • Массивы объектов и массивов массивов не поддерживаются в качестве входных данных
    • Элементы управления не создаются для объектов или вложенных массивов за пределами глубины 20
    • Типы "Файл" и "двоичный формат" не поддерживаются для входных или выходных данных.

pac canvas download

Скачивание приложения на основе холста в виде MSAPP-файла

Обязательные параметры для canvas download

--name -n

Точное, частичное имя или идентификатор приложения на холсте

Необязательные параметры для canvas download

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--extract-to-directory -d

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

--file-name -f

Имя файла (обычно с расширением MSAPP). Если файл не указан, сохраняется в текущем каталоге с именем appname.msapp

--overwrite -o

Разрешить перезапись файла

Этот параметр не требует значения. Это переключатель.

pac canvas list

Вывод списка приложений на основе холста

Необязательные параметры для canvas list

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac canvas pack

(предварительная версия) Упаковка источников в msapp-файл

Example

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-файла в источники

Example

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, например то, что находится в \references.

Формат файла

Файлы .fx.yaml используют подмножество YAML. Как и в Excel, все выражения должны начинаться с знака =равенства. Дополнительные сведения: Грамматика формулы YAML PowerFx

Слияние изменений с 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

Открытый исходный код

Команды холста в Microsoft Power Platform CLI — это открытый исходный код. Обсудите улучшения, вызовите проблемы и получите доступ к коду из репозитория инструментов языка Power Apps.

pac canvas validate

(предварительная версия) Проверка источника PA.yaml для распакованного msapp-файла

Обязательные параметры для canvas validate

--directory -d

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

См. также

Группы команд Командной строки Microsoft Power Platform
Обзор интерфейса командной строки Microsoft Power Platform

  • Last updated on