pac canvas

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

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

Important

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

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

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

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

Examples

В следующих примерах показано использование 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.

Remarks

Рекомендации и ограничения:

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

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

File format

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

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

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

See also

Microsoft Power Platform группы команд CLI
Обзор Microsoft Power Platform CLI

  • Last updated on