Бөлісу құралы:

pac canvas

Power Apps .msapp файлдарымен жұмыс істеу.

[Бұл мақала — шығарылым алдындағы құжаттама және ол өзгеруі мүмкін.]

Маңызды

  • pack Бұйрықтар мен unpack бұйрықтар бұзылады.
  • Кенеп бағдарламасын басқару үшін Power Platform Git интеграциясын пайдаланыңыз.
  • create Бұйрық әдетте қол жетімді.

Раа

Пәрмен Сипаттамасы
pac canvas create Реттелетін қосқыштан кенеп бағдарламасын жасау
pac canvas download Кенеп бағдарламасын .msapp файлы ретінде жүктеу
pac canvas list Кенеп бағдарламаларын тізімдеу
pac canvas pack (Алдын ала қарау) Көздерді msApp файлына орау
pac canvas unpack (Алдын ала қарау) msApp файлын көздерге шығару
pac canvas validate (Алдын ала қарау) Архивтелмеген msapp файлы үшін .pa.yaml көзін тексеріңіз

pac canvas create

Реттелетін қосқыштан кенеп бағдарламасын жасау

Бұл пәрмен .msapp OpenAPI анықтамасына негізделген кенеп бағдарламасын жасайды. Бағдарламада экрандар, басқару элементтерінің орналасуы және реттелетін қосқыштың әрекеттері қалай анықталатындығына негізделген Power Fx коды болады, алдын ала анықталған көрініс пен сезім. Қолданбаны әдеттегі коннекторда анықталған әрекеттерді тікелей орындау үшін пайдалануға болады.

Өндірушілер қолданбаны ойнату үшін немесе .msapp өңдеулер жасап, одан әрі теңшеулер жасау үшін Power Apps Studio-ға импорттай алады. Жасалған бағдарламаны Power Apps Studio бағдарламасында Файлды>ашу> шолу тармағына өту арқылы импорттаңыз.

Мысалдар

Төменде келтірілген мысалдар бұйрықты pac canvas create орындау тәртібін көрсетеді.

Көрсетілетін атау бойынша Open API анықтамасына негізделген кенеп бағдарламасын жасау

Бұл мысал коннектордың көрсетілетін атауын пайдалану арқылы Open API анықтамасына негізделген кенеп бағдарламасын (*.msapp файлы ретінде) жасайды.

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

Идентификатор бойынша Open API анықтамасына негізделген кенеп бағдарламасын жасау

Бұл мысал коннектордың идентификаторын пайдалану арқылы Open API анықтамасына негізделген кенеп бағдарламасын (*.msapp файлы ретінде) жасайды.

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-name сілтеме connector-id жасалған әдеттегі коннектор Шешімнің бөлігі болуы керек.
  • Бағдарламаны Studio-ға импорттағаннан кейін, реттелетін коннектормен байланыс болмайды. Өндіруші қолданбаны ойнатпас бұрын қолданба жасалған реттелетін қосқышқа сілтемені қолмен қосуы керек. Қадамдар үшін кенеп бағдарламаларына деректер қосылымдарын қосу бөлімін қараңыз. Мұны жасамайынша, қосқыш сілтемесі қосылғаннан кейін шешілетін қолданбадағы формула қателерін көре аласыз. Бағдарламаға қосылатын реттелетін қосқыштың атауы пәрменде canvas create көрсетілген реттелетін қосқыштың көрсетілетін атауына сәйкес келуі керек.
  • Қолданбада әрқайсысы POST үшін бір экран және GET коннектор анықтайтын әрекет болады.
    • Реттелетін коннекторларда қол жетімді басқа етістіктерге қолдау көрсетілмейді.
  • Әр әрекеттің экранында көрсетілген басқару элементтері әр әрекеттің кіріс және шығыс түрлерінің қалай анықталатынына негізделген динамикалық түрде жасалады. Әдеттегі коннекторда анықталған кіріс пен шығыстың кейбір түрлеріне қолдау canvas createкөрсетілмейді. Бұйрықтар кездескен кезде консольде ескерту жасайды. Нақты жағдайлар:
    • Объектілер мен массивтердің массивтері кірістер ретінде қолдау көрсетілмейді
    • Басқару элементтері 20 тереңдіктен асатын нысандар немесе кірістірілген массивтер үшін жасалмайды
    • "Файл" және "екілік пішім" түрлері енгізу немесе шығару үшін қолдау көрсетілмейді.

pac canvas download

Кенеп бағдарламасын .msapp файлы ретінде жүктеу

Қажетті параметрлер canvas download

--name -n

Кенеп бағдарламасының дәл, ішінара атауы немесе бағдарлама идентификаторы

Қосымша параметрлер canvas download

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--extract-to-directory -d

Кенеп бағдарламасын шығаратын каталог атауы

--file-name -f

Файл атауы (әдетте .msapp кеңейтімі бар). Егер көрсетілмесе, файл 'appname' бар ағымдағы каталогта сақталады.msapp

--overwrite -o

Файлдың үстінен жазуға рұқсат етіледі

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

pac canvas list

Кенеп бағдарламаларын тізімдеу

Қосымша параметрлер canvas list

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac canvas pack

(Алдын ала қарау) Көздерді msApp файлына орау

Мысал

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 файлын көздерге шығару

Мысал

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 - Қолданба пайдаланатын барлық деректер көздері.
  • \Қосылымдар - Бағдарламамен бірге сақталған және Power Apps Studio бағдарламасына қайта жүктеу кезінде пайдаланылатын қосылым даналары.
  • \Assets - Бағдарламаға ендірілген медиафайлдар.
  • \ pkgs - Үлгілер, API анықтау файлдары және компоненттер кітапханалары сияқты сыртқы сілтемелердің жүктелген көшірмесі. Бұл NuGet / NPM сілтемелеріне ұқсас.
  • \other - Қайта құру .msappүшін қажет барлық түрлі файлдар .
    • entropy.json - Құбылмалы элементтер (уақыт белгілері сияқты) осы файлға шығарылады. Бұл басқа файлдардағы шулы айырмашылықтарды азайтуға көмектеседі, сонымен қатар біз әлі де айналмалы сапарға шыға аламыз.
    • MSAPP-тен басқа файлдарды сақтайды, мысалы, \rсілтемелерде не бар.

Файл пішімі

Файлдар .fx.yamlYAML-дің қосалқы жиынын пайдаланады. Excel-ге ұқсас, барлық өрнектер тең белгіден =басталуы керек . Қосымша ақпарат: Power Fx YAML формуласының грамматикасы

Өзгерістерді Power Apps Studio бағдарламасымен біріктіру

Екі түрлі Power Apps Studio сеанстарында жасалған өзгерістерді біріктіру кезінде:

  • Барлық зат есімдердің бірегей екеніне көз жеткізіңіз. Мысалы, екі түрлі сеансқа түймешікті кірістіру екі Button1 басқару элементіне әкелуі мүмкін. Басқару элементтерін жасағаннан кейін көп ұзамай атауға кеңес береміз. Құрал бірдей атаумен екі басқару элементін қабылдамайды.
  • Осы файлдар үшін оларды әдеттегідей біріктіріңіз:
    • \src*.fx.yaml
  • Егер қақтығыстар немесе қателер болса, мына файлдарды жоюға болады:
    • \src\editorstate*.json - Бұл файлдар Power Apps Studio бағдарламасындағы қосымша ақпаратты қамтиды.
    • \other\entropy.js
  • Осы файлдардағы кез-келген қайшылықтар үшін соңғы нұсқаны қабылдау дұрыс:
    • \checksum.js
  • Егер осы жолдар бойынша біріктіру қайшылықтары болса, біріктіру қауіпсіз емес. Бұл жиі болатынын біліңіз; Біз қақтығыстарды болдырмау үшін файл пішімін қайта құрылымдау бойынша жұмыс істейміз.
    • \Байланыстар*
    • \Деректер көздері*
    • \pkgs*
    • CanvasManifest.json

Ашық көзі

Microsoft Power Platform CLI бағдарламасындағы кенеп пәрмендері ашық көзі болып табылады. Жақсартуларды талқылаңыз, мәселелерді көтеріңіз және Power Apps тілдік құралдар репозиторийінен кодқа қатынасыңыз.

pac canvas validate

(Алдын ала қарау) Архивтелмеген msapp файлы үшін .pa.yaml көзін тексеріңіз

Қажетті параметрлер canvas validate

--directory -d

Тексеру үшін .pa.yaml файлдарын қамтитын алынған msapp каталогына апаратын жол

Сонымен қатар қараңыз

Microsoft Power Platform CLI пәрмен топтары
Microsoft Power Platform CLI шолуына шолу

  • Last updated on