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

холст pac

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

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

Это важно

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

Commands

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

Создание холста pac

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

Эта команда создаст .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 требуются.

Обязательные параметры для создания холста

--msapp

Путь к msapp-файлу для создания

Необязательные параметры для создания холста

--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

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

Обязательные параметры для скачивания холста

--name -n

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

Необязательные параметры для скачивания холста

--environment -env

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

--extract-to-directory -d

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

--file-name -f

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

--overwrite -o

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

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

Список холста pac

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

Необязательные параметры для списка холстов

--environment -env

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

пакет холста pac

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

Example

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

Обязательные параметры для пакета холста

--msapp

Путь к MSAPP-файлу

--sources

Каталог к источникам для упаковки

Замечания

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

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

распаковка холста pac

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

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Распаковка в каталог по умолчанию HelloWorld_src .

Обязательные параметры для распаковки холста

--msapp

Путь к MSAPP-файлу

Необязательные параметры для распаковки холста

--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

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

Обязательные параметры для проверки холста

--directory -d

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

См. также

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

  • Last updated on