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 анықтамасына негізделген кенеп бағдарламасын жасайды. Бағдарламада экрандар, басқару элементтерінің орналасуы және реттелетін қосқыштың әрекеттері қалай анықталатындығына негізделген Power Fx коды болады, алдын ала анықталған көрініс пен сезім. Қолданбаны әдеттегі коннекторда анықталған әрекеттерді тікелей орындау үшін пайдалануға болады.

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

Examples

Төменде келтірілген мысалдар бұйрықты 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 аутентификация профилінің ортасы.

Remarks

Пікірлер мен шектеулер:

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

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

File format

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

Өзгерістерді 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