Делите путем


Подршка за портале за Microsoft Power Platform CLI

Напомена

Од 12. октобра 2022. Power Apps портали постају Power Pages. Више информација: Услуга Microsoft Power Pages је сада општедоступна (блог)
Ускоро ћемо мигрирати и објединити документацију о Power Apps порталима са документацијом о услузи Power Pages.

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

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

Помоћу ове функције портали Microsoft Power Apps подржавају ЦЛИ да Microsoft Power Platform би омогућили ЦИ/ЦД (Континуирана интеграција/непрекидно распоређивање) конфигурације портала. Сада можете да пријавите конфигурацију портала да бисте контролисали извор и преместили конфигурацију портала у било које окружење помоћу Microsoft Power Platform ЦЛИ-ја.

Напомена

Ова функција је обично доступна почевши од Power Platform CLI верзије 1.9.8. Да бисте сазнали више о инсталирању најновије верзије, погледајте чланак Инсталирање Microsoft Power Platform CLI.

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

Са подршком за портале за Microsoft Power Platform CLI, сада можете да користите могућности сличне раду ван мреже за прилагођавање портала уношењем промена у садржај портала. Након што се сва прилагођавања или промене сачувају, отпремите их на портал. Када садржај портала преузимате помоћу 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 CLI је ограничена на доленаведене табеле.

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 портале.

Потврдите команду „paportal“ у Microsoft Power Platform CLI.

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

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

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

Параметри

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

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

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

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

У овој датотеци можете имати назив табеле (ентитета) са 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.

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

Када преузмете садржај веб-локације користећи CLI команду pac paportal download, заједно са преузимањем садржаја локације он ће такође генерисати две датотеке манифеста;

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

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

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

Након сваког преузимања, алатка ПАЦ ЦЛИ чита постојећу датотеку манифеста окружења и ажурира ставке избрисане у окружењу или креира датотеку манифеста окружења ако не постоји.

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

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

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

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

Када се садржај веб-локације преузме помоћу команде pac paportal download, ово ће додати избрисане записе из датотеке манифеста окружења (org-url-manifest.yml) у датотеку manifest.yml. Дакле, када отпремите садржај веб-локације помоћу команде pac paportal upload, он ће избрисати датотеке из окружења (чак и у друго окружење). Ова датотека се не брише и користи се без обзира на окружење у које сте повезани.

Напомена

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

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

Такође можете да користите ВС Цоде еxтенсион Power Platform ВС Цоде Еxтенсион да бисте користили уграђени течни језик од ИнтеллиСенсе-а, помоћ при довршавања кода, хинтинг и интеракцију Microsoft Power Platform са ЦЛИ помоћу ВС цоде интегрисаног терминала. Још информација: Коришћење проширења Visual Studio Code (верзија за преглед)

Додатна разматрања

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

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

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

Такође погледајте