Microsoft Power Platform CLI подршка за Power Pages

Microsoft Power Platform CLI (интерфејс са командном линијом) је једноставан интерфејс са командном линијом за програмере где је све на једном месту и који омогућава програмерима и ауторима апликација да креирају компоненте кода.

Microsoft Power Platform CLI алат је први корак ка свеобухватној причи о управљању животним циклусом апликација (ALM), где програмери предузећа и ISV могу брзо и ефикасно да креирају, граде, отклањају грешке и објављују своја проширења и прилагођавања. За више информација посетите шта је Microsoft Power Platform ЦЛИ?

Са овом функцијом, Microsoft Power Platform CLI омогућава CI/CD (континуирана интеграција/континуирана примена) конфигурације Power Pages локације. Сада можете да пријавите конфигурацију веб-локације за контролу извора и преместите конфигурацију веб-локације у било које окружење које користи Microsoft Power Platform CLI.

Напомена

• Ова функција је обично доступна почевши од Power Platform CLI верзије 1.9.8. Да бисте сазнали више о инсталирању најновије верзије, идите на дугме "Инсталирај Microsoft Power Platform ЦЛИ".
• Почевши од Power Platform ЦЛИ верзије 1.27, команда pac paportal се мења у pac powerpages. paportal наставља да ради, али препоручујемо коришћење унапред powerpages . Овај чланак ће ускоро бити ажуриран да би се користио powerpages уместо paportal.

Зашто користите Microsoft Power Platform CLI за развој веб-локације?

Уз Microsoft Power Platform CLI, сада можете да користите могућности сличне раду ван мреже за прилагођавање веб-локације уношењем промена у садржај веб-локације. Када се сва прилагођавања или промене сачувају, можете отпремити конфигурацију веб-локације назад у Microsoft Dataverse. Када садржај веб-локације преузимате помоћу Microsoft Power Platform CLI интерфејса, садржај је структуриран у YAML и HTML форматима што олакшава прилагођавање, омогућавајући искуство професионалног развоја апликације.

Ево листе функција и могућности од којих портали имају користи уз подршку Microsoft Power Platform CLI:

Лакоћа коришћења

• Подршка за преузимање/отпремање података конфигурације веб-локације у локални систем датотека и из њега

• Креирајте се на постојећем Microsoft Power Platform CLI алату.

Управљање животним циклусом апликације (ALM)

• Праћење промена у конфигурацији веб-локације унутар организације

• Премештајте конфигурационе датотеке у организацијама или закупцима

Професионална подршка за програмере и предузећа

• Помаже у неприметној интеграцији са било којим алаткама за контролу извора, као што је „git“

• једноставно подешавање CI/CD канала

Инсталирај Microsoft Power Platform CLI

За детаљна упутства погледајте Инсталирање Microsoft Power Platform CLI.

Подржане табеле

Подршка портала за Microsoft Power Platform ЦЛИ је ограничена на следеће табеле.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (само преузимање)

adx_websitelanguage

adx_webtemplate

Напомена

Важно

• Прилагођене табеле и табеле специфичне за предложак портала (попут блога, заједнице или портала идеја) нису подржане за прилагођавање помоћу Microsoft Power Platform CLI интерфејса.
• Прилози датотека слике у записима огласа (adx_ad) не преузимају се помоћу услуге Power Platform CLI. Као заобилазно решење, користите поље URL адреса слике или додавањем HTML референце у пољу Копирај у запис веб-датотеке који садржи датотеку слике.

Инсталирајте и верификујте Microsoft Power Platform CLI interfejs за портале

Да бисте сазнали више о инсталирању Microsoft Power Platform CLI интерфејса, идите на инсталирај Microsoft Power Platform CLI.

Након инсталирања Microsoft Power Platform CLI, отворите командну линију и покрените CLI да бисте проверили да ли излаз садржи „paportal“ – команду за Power Apps портале.

Microsoft Power Platform CLI команде за портале

Microsoft Power Platform CLI команда за портале је „paportal“.

Следећи одељци пружају више детаља о различитим својствима команде „paportal“.

Параметри

Назив својства	Опис	Пример
list	Наводи све веб-локације портала из тренутног Dataverse окружења. Можете да додате параметар -v да бисте назначили да ли локација користи стандардни или побољшани модел података	pac paportal list
download	Преузмите садржај веб-локације портала од актуелног Dataverse окружења. Има следеће параметре: - путања : Путања на којој се преузима садржај wеб сајта (псеудоним: -п) - webSiteId: ID веб-странице портала за преузимање (псеудоним: -id) - overwrite: (Опционално) true – да замени постојећи садржај, false – да не успе ако фасцикла већ има садржај веб-локације (псеудоним: -o) - моделВерсион : 1 или да 2 бисте назначили да ли подаци локације за преузимање користе стандард (1) или побољшани модел података (2).	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
upload	Отпремите садржај веб-локације портала у актуелно Dataverse окружење. Има следећи параметар: - path: Путања на којој је ускладиштен садржај веб-локације (псеудоним: -p) - deploymentProfile: Отпремајте податке о порталу са детаљима о окружењу дефинисаним путем променљивих профила у датотеци deployment-profiles/[profile-name].depoyment.yaml - моделВерсион : 1 или да 2 означи да ли подаци локације за отпремање користе стандардни (1) или побољшани модел података (2).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Коришћење профила за примену

Прекидач deploymentProfile вам омогућава да дефинишете скуп променљивих за окружење у YAML формату. На пример, можете имати различите профиле примене (као што су развојни, тестни, производни) који имају различите детаље шеме дефинисане у профилу.

Ако креирате тестни профил, можете да креирате датотеку у оквиру deployment-profiles под називом „test.deployment.yml“ (тј. <profileTag>.deployment.yml). И можете покренути команду са ознаком (<profileTag>) да бисте користили овај профил:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

У овој датотеци можете имати назив табеле (ентитета) са ID-ом табеле, списком атрибута и вредностима које желите да измените приликом отпремања конфигурације портала помоћу deploymentProfile параметра.

Осим тога, можете користити OS променљиву за приступ променљивима окружења оперативног система.

Ево примера ове „test.deployment.yml“ датотеке YAML профила који има јединствене детаље шеме:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Напомена

Да бисте сазнали више о свим наредбама које се користе у CLI поред портала, идите на чланак Уобичајене команде у Microsoft Power Platform CLI.

Датотеке манифеста

Када преузмете садржај Веб локације користећи пац папортал доwнлоад ЦЛИ команду, заједно са преузимањем садржаја локације он такође генерише две манифестне датотеке;

• Датотека манифеста окружења (org-url-manifest.yml)
• Брисање датотеке манифеста праћења (manifest.yml)

Датотека манифеста окружења (org-url-manifest.yml)

Датотека манифеста окружења се генерише сваки пут када се покрене команда pac paportal download.

Након сваког преузимања, алатка PAC CLI чита постојећу датотеку манифеста окружења и ажурира ставке избрисане у окружењу или креира датотеку манифеста окружења ако не постоји.

Када покренете команду pac paportal upload да бисте отпремили садржај веб-локације портала. Она чита датотеку манифеста окружења и идентификује промене направљене од последњег преузимања и отпрема само ажурирани садржај. Ово помаже у оптимизацији процеса отпремања јер се отпрема само ажурирани садржај веб-локације, уместо да се отпрема сав садржај на свакој команди за отпремање.

Датотека манифеста окружења се чита када се повеже са истим окружењем (УРЛ адреса окружења се подудара са именом датотеке), да би се избегле случајне промене.

Напомена

• Датотека манифеста окружења није дизајнирана да прати промене приликом примене веб-локације у различита окружења.
• Датотека манифеста окружења је дизајнирана да је користе програмери за локално распоређивање у развојном окружењу и треба је додати на git листу за игнорисање.

Брисање датотеке манифеста праћења (manifest.yml)

Ова датотека се користи за праћење избрисаних записа из окружења.

Када се садржај Веб локације преузме помоћу команде пац папортал доwнлоад , ово додаје избрисане записе из датотеке манифеста окружења (орг-урл-манифест.yмл) у манифест.yмл датотеку. Дакле, када отпремите садржај Веб локације помоћу команде пац папортал уплоад , он брише датотеке из окружења (чак и у друго окружење). Ова датотека се не брише и користи се без обзира на окружење у које сте повезани. Ову датотеку је потребно узети у обзир приликом прослеђивања промена у изворну контролу да би се размотрило брисање ставки у циљном окружењу.

Напомена

Да бисте избрисали записе садржаја локације у једном окружењу, као и избрисали исте записе садржаја у другом окружењу помоћу PAC CLI, мораћете да покренете команду pac paportal download пре и после брисања садржаја записа веб-локације. Датотека manifest.yml ће пратити ове промене и уклонити одговарајуће записе у циљном окружењу када се покрене команда pac paportal upload.

Коришћење проширења за Visual Studio Code

Такође можете да користите VS Code проширење Power Platform VS Code проширење да бисте имали користи од уграђеног језика Liquid, услуге IntelliSense, помоћи у довршавању кода, наговештавања и интеракције са Microsoft Power Platform CLI интерфејсом који користи VS Code интегрисани терминал. Још информација: Коришћење проширења Visual Studio Code (верзија за преглед)

Још разматрања

• Ако путања датотеке премашује ограничење максималне дужине путање, појављује се порука о грешци. Још информација: Ограничење максималне дужине путање у оперативном систему Windows
• За дуплиране записе, на пример дуплирани назив веб-странице, Microsoft Power Platform CLI креира две различите фасцикле: једну са називом веб-странице, а другу са истим називом са префиксом хеш кода. На пример, „Моја страница“ и „Моја страница-хеш код".

Следећи кораци

Водич: Коришћење Microsoft Power Platform CLI интерфејса са порталима

Погледајте и

• Microsoft Power Platform CLI
• Коришћење проширења услуге Visual Studio Code (верзија за преглед)