Делите путем


pac canvas

Рад са Повер Аппс .мсапп датотекама

[Овај чланак представља прелиминарну документацију и може се променити.]

Важно

Команде

Command Опис
pac canvas create Генеришите апликацију за платно из прилагођеног конектора
pac canvas download Преузмите апликацију за платно као .мсапп датотеку
pac canvas list Наведите апликације за платно
pac canvas pack (Преглед) Спакујте изворе у мсапп датотеку
pac canvas unpack (Преглед) Извадите мсапп датотеку у изворе
pac canvas validate (Преглед) Потврдите .па.иамл извор за распаковану мсапп датотеку

pac canvas create

Генеришите апликацију за платно из прилагођеног конектора

Ова команда ће генерисати платну апликацију засновану .msapp на ОпенАПИ дефиницији постојећег прилагођеног конектора . Апликација ће садржавати екране, распоред контроле и Повер Фк код генерисан на основу тога како су дефинисане акције прилагођеног конектора, са унапред дефинисаним изгледом и осећајем. Апликација се може користити за директно остваривање акција дефинисаних у прилагођеном конектору.

Креатори могу да увезу генерисане .msapp у Повер Аппс Студио да играју апликацију или да измене и изврше даља прилагођавања. Увезите генерисану апликацију у Повер Аппс Студио тако што ћете се кретати до Филе > Опен > Прегледај у Студио.

Примери

Следећи примери показују употребу команде pac canvas create .

Креирајте апликацију платна засновану на дефиницији отвореног АПИ-ја по имену за приказ

Овај пример креира апликацију за платно (као *.мсапп датотеку) засновану на дефиницији отвореног АПИ-ја користећи име за приказ конектора.

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

Креирајте апликацију за платно засновану на дефиницији отвореног АПИ-ја по ид-у

Овај пример креира апликацију платна (као *.мсапп датотеку) засновану на дефиницији отвореног АПИ-ја користећи ИД конектора.

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

Или connector-display-name или connector-id су потребни.

Потребни параметри за canvas create

--msapp

Путања до .мсапп датотеке која ће се генерисати

Опциони параметри за canvas create

--connector-display-name

Приказно име конектора за генерисање Повер Апп-а.

--connector-id

ИД конектора за генерисање Повер Апп-а.

--environment

ИД или УРЛ циљног окружења. Подразумевана вредност је окружење вашег тренутно активног Датаверсе Аутх профила.

Примедбе

Разматрања и ограничења:

  • Прилагођени конектор који се помиње са connector-display-nameconnector-id или параметрима мора бити део решења .
  • Након увоза апликације у Студио, неће бити повезаности са прилагођеним конектором. Произвођач мора ручно додати референцу на прилагођени конектор из којег је апликација генерисана пре него што се апликација може играти. Погледајте Додавање веза са подацима у апликације за платно за кораке. Док се то не уради, можда ћете видети грешке формуле у апликацији које ће се решити када се дода референца конектора. Име прилагођеног конектора који додате у апликацију мора одговарати називу прилагођеног конектора који се помиње у команди canvas create .
  • Апликација ће садржавати један екран за сваку POST и акцију GET коју конектор дефинише.
    • Остали глаголи доступни у прилагођеним конекторима нису подржани.
  • Контроле приказане на екрану сваке акције се динамички генеришу на основу тога како су дефинисани улазни и излазни типови сваке акције. Одређене врсте улаза и излаза дефинисане у прилагођеном конектору нису подржане од стране canvas create. Команда ће генерисати упозорења у конзоли када се на њих наиђе. Специфични случајеви:
    • Низови објеката и низови низова нису подржани као улази
    • Контроле се не генеришу за објекте или угнежђене низове преко дубине од 20
    • Типови "Датотека" и "бинарни формат" нису подржани за улаз или излаз.

pac canvas download

Преузмите апликацију за платно као .мсапп датотеку

Потребни параметри за canvas download

--name -n

Тачна , делимично име апликације или ИД апликације

Опциони параметри за canvas download

--environment -env

Одређује циљну Датаверсе. Вредност може бити Гуид или апсолутни хттпс УРЛ. Када није наведено, користиће се активна организација изабрана за тренутни профил аутентификације.

--extract-to-directory -d

Име директоријума за издвајање апликације платна

--file-name -f

Име датотеке (обично са .мсапп екстензијом). Ако није обезбеђен фајл се чува у тренутном директоријуму са 'аппнаме'.мсапп

--overwrite -o

Дозволи преписивање датотека

Овај параметар не захтева никакву вредност. То је прекидач.

pac canvas list

Наведите апликације за платно

Опциони параметри за canvas list

--environment -env

Одређује циљну Датаверсе. Вредност може бити Гуид или апсолутни хттпс УРЛ. Када није наведено, користиће се активна организација изабрана за тренутни профил аутентификације.

pac canvas pack

(Преглед) Спакујте изворе у мсапп датотеку

Пример

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

Потребни параметри за canvas pack

--msapp

Путања до .мсапп датотеке

--sources

Директоријум изворима који ће бити упаковани

Примедбе

Креира .msapp фајл из претходно распакованих изворних фајлова. Резултат се може отворити у Повер Аппс Студио-у тако што ћете се кретати до Филе > Опен > Броwсе .

Након распакивања, изворне датотеке се могу уређивати и управљати спољним алатима као што су Висуал Студио Цоде и ГитХуб.

pac canvas unpack

(Преглед) Извадите мсапп датотеку у изворе

Пример

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

Распакује се у подразумевани HelloWorld_src директоријум.

Потребни параметри за canvas unpack

--msapp

Путања до .мсапп датотеке

Опциони параметри за canvas unpack

--sources

Директоријум изворима које треба распаковати

Примедбе

Распакује изворни .msapp фајл.

Преузмите датотеку .msapp из Повер Аппс Студио тако што ћете се кретати до Сачувај датотеку > као > Овај рачунар .

Ако параметар соурцес није специфициран, користи се фолдер са истим именом и локацијом као .msapp фајл са _src суфиксом.

Структура фолдера

Распакујте и спакујте особине користе следећу структуру фолдера:

  • \срц - Контролне и компонентне датотеке. Ово садржи изворе.
    • *.фx .yамл - Формуле извађене из датотеке control.json .

      Белешка

      Ово је место за уређивање ваших формула.

    • CanvasManifest.json - Манифест фајл који садржи информације које су нормално присутне у заглављу, својствима и публисхИнфо.
    • *.json - Сирова control.json датотека.
    • \ЕдиторСтате *.editorstate.json - Кеширане информације за Повер Аппс Студио за коришћење.
  • \ДатаСоурцес - Сви извори података које користи апликација.
  • \Цоннецтионс - Инстанце везе сачуване са апликацијом и коришћене приликом поновног учитавања у Повер Аппс Студио.
  • \ Средства - Медијске датотеке уграђене у апликацију.
  • \пкгс - Преузета копија спољних референци, као што су шаблони, датотеке дефиниције АПИ-ја и библиотеке компоненти. Они су слични НуГет / НПМ референцама.
  • \отхер - Сви разни фајлови потребни за поновно креирање . .msapp
    • entropy.json - Испарљиви елементи (као што су временске ознаке) се издвајају у овај фајл. Ово помаже у смањењу бучних разлика у другим датотекама, а истовремено осигурава да и даље можемо да се вратимо.
    • Држи друге датотеке из мсапп-а, као што је оно што је у \rеференцес.

Формат датотеке

Фајлови .fx.yaml користе подскуп YАМЛ-а . Слично Екцелу, сви изрази треба да почну са знаком = једнакости . Више информација: Повер Фк ИАМЛ Формула Граматика

Спајање промена са Повер Аппс Студио

Приликом спајања промена које су направљене у две различите сесије Повер Аппс Студио:

  • Уверите се да су сва контролна имена јединствена. На пример, уметање дугмета у две различите сесије може резултирати са две Button1 контроле. Препоручујемо да именујете контроле убрзо након што их креирате. Алат не прихвата две контроле са истим именом.
  • За ове фајлове, стопите их као и обично:
    • \срц*.фx.yамл
  • Ако постоје конфликти или грешке, можете избрисати ове датотеке:
    • \срц \едиторстате *.json - Ове датотеке садрже опционалне информације у Повер Аппс Студио.
    • \other\entropy.jsна
  • За било какве конфликте у овим фајловима, то је у реду да прихвати најновију верзију:
    • \checksum.jsна
  • Ако постоје било какви конфликти спајања под овим путањама, није безбедно да се споји. Јавите нам да ли се то често дешава; радићемо на реструктурирању формата датотеке како бисмо избегли сукобе.
    • \Везе*
    • \Извори података*
    • \пкгс*
    • CanvasManifest.json

Отвореног кода

Команде платна у Мицрософт Повер Платформ ЦЛИ су отвореног кода. Разговарајте о побољшањима, покрените проблеме и приступите коду из спремишта Повер Аппс језичких алата .

pac canvas validate

(Преглед) Потврдите .па.иамл извор за распаковану мсапп датотеку

Потребни параметри за canvas validate

--directory -d

Путања до издвојеног мсапп директоријума који садржи .па.иамл датотеке за проверу

Погледајте и

Мицрософт Повер Платформ ЦЛИ командне групе
Преглед Мицрософт Повер Платформ ЦЛИ