Microsoft Power Platform CLI portaalide tugi

Märkus

Alates 12. oktoobrist 2022 on Power Appsi portaalid Power Pages. Lisateave: Microsoft Power Pages on nüüd üldiselt saadaval (ajaveebipostitus)
Peagi migreerime ja ühendame Power Appsi portaalide dokumentatsiooni Power Pagesi dokumentatsiooniga.

Microsoft Power Platform CLI (Command Line Interface) on lihtne, ühe peatusega arendaja käsuliiniliides, mis annab arendajatele ja rakenduse tegijatele koodikomponentide loomise võimalusi.

Microsoft Power Platform CLI tööriistad on esimene samm laiaulatusliku rakenduse elutsükli halduse (ALM) halduse poole, kus ettevõtte arendajad ja tarkvaraarendajad saavad oma laiendusi ja kohandusi kiiresti ja tõhusalt luua, koostada ja avaldada. Lisateavet teenuse kohta vt jaotisest Mis on Microsoft Power Platform CLI?

Selle funktsiooniga toetavad portaalid CLI-d Microsoft Power Apps , Microsoft Power Platform et lubada portaali konfiguratsiooni CI/CD (Continuous Integration/Continuous Deployment). Nüüd saate kontrollida portaali konfiguratsiooni allika juhtimiseks ja teisaldada portaali konfiguratsiooni mis tahes keskkonda, kasutades Microsoft Power Platform CLI-d.

Märkus

See funktsioon on üldjuhul saadaval alates Power Platform CLI versioonist 1.9.8. Lisateavet uusima versiooni installimise kohta leiate teemast Microsoft Power Platform CLI installimine.

Miks kasutada Microsoft Power Platform CLI-d portaalide arendamiseks?

Portaalide toega Microsoft Power Platform CLI-le saate nüüd kasutada portaalide kohandamiseks ühenduseta režiimi võimalusi, tehes portaalide sisus muudatusi. Kui kõik kohandused või muudatused on salvestatud, laadige need portaali üles. Portaalide sisu allalaadimisel Microsoft Power Platform CLI abil on sisu struktureeritud YAML-i ja HTML-vormingus, muutes kohandamise hõlpsaks, võimaldades arenduskogemust.

Siin on loend funktsioonidest ja võimalustest, mida portaalid Microsoft Power Platform CLI toe puhul saavad.

Kasutamise lihtsus

• Portaaliandmete kohalikku failisüsteemi/sealt allalaadimise/üleslaadimise tugi

• Tugineda olemasolevale Microsoft Power Platform CLI tööriistale.

Rakenduse elutsükli haldus (ALM)

• Portaali konfiguratsiooni muudatuste jälitamine organisatsioonis

• Konfiguratsioonifailide teisaldamine organisatsioonides või rentnikes

Professionaalse arendus- ja ettevõttetugi

• Aitab sujuvalt integreerida mis tahes lähte juhtelemendi tööriistadega, näiteks "git"

• CI/CD konveierite lihtne seadistamine

Microsoft Power Platform CLI installimine

Juhised samm-sammult leiate Installimisest Microsoft Power Platform CLI.

Toetatud tabelid

Portaalide tugi Microsoft Power Platform CLI-le on piiratud allolevate tabelitega.

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 (ainult allalaadimine)

adx_websitelanguage

adx_webtemplate

märge

Oluline

• Kohandatud tabeleid ja portaali mallipõhiseid tabeleid (nt ajaveebi, kogukonna või mõtteportaali) ei toetata kohandamiseks Microsoft Power Platform CLI-ga.
• Pildifaili manuseid ad (adx_ad) kirjetele ei laadita Power Platformi CLI abil alla. Probleemi lahendamiseks kasutage välja pildi URL või lisage HTML-viide pildifaili sisaldava veebifaili kirje väljale Koopia.

Installige ja kontrollige Microsoft Power Platform CLI portaalide jaoks

Microsoft Power Platform CLI installimise kohta lisateabe saamiseks minge Microsoft Power Platform CLI installimine.

Pärast Microsoft Power Platform CLI installimist avage käsuviip ja käivitage pac, et kontrollida, kas väljund sisaldab "paportaali" – Power Appsi portaalide käsku.

Microsoft Power Platform CLI käsud portaalide jaoks

Microsoft Power Platform CLI käsk portaalidele on "paportal".

Järgmised jaotised täiendavad üksikasju käsu "paportaal" erinevate atribuutide kohta.

Parameetrid

Atribuudi nimi	Kirjeldus	Näide
loend	Loetleb kõik praeguse Dataverse'i keskkonna portaali veebisaidid.	pac paportal list
allalaadimine	Portaali veebisaidi sisu allalaadimine praegusest Dataverse'i keskkonnast. Sellel on järgmised parameetrid. - path: veebisaidi sisu allalaadimise tee (alias: -p) - webSiteId: portaali veebisaidi ID allalaadimiseks (alias: -id) - overwrite: (valikuline) tõene – olemasoleva sisu ülekirjutamiseks, väär – nurjumiseks, kui kaustas on juba veebisaidi sisu (alias: -o)	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
üleslaadimine	Portaali veebisaidi sisu üleslaadimine praegusesse Dataverse'i keskkonda. Sellel on järgmine parameeter. - path: veebisaidi sisu hoiustamise tee (alias: -p) -deploymentProfile: laadige portaali andmed üles keskkonnaandmetega, mis on määratletud profiili muutujate kaudu failis deployment-profiles/[profile-name].deployment.yaml	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

Kasuta juurutusprofiili

Lüliti juurutusprofiil võimaldab teil YAML-vormingus määratleda keskkonna muutujate komplekti. Näiteks võivad teil olla erinevad juurutusprofiilid (näiteks juurutus, testimine, tootmine), mille profiilis on määratletud erinevad skeemi üksikasjad.

Testprofiili loomisel saate luua faili juurutusprofiilide all nimega "test.deployment.yml (ehk <profileTag>.deployment.yml). Ja saate käivitada käsu sildiga (<profileTag>) selle profiili kasutamiseks:

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

Selles failis võib olla tabeli (olemi) nimi koos tabeli ID-ga, atribuutide loend ja väärtused, mida soovite portaali konfiguratsiooni parameetri abil üleslaadimisel deploymentProfile alistada.

Lisaks pääsete muutuja OS abil juurde operatsioonisüsteemi keskkonna muutujatele.

Siin on näide sellest "test.deployment.yml" profiili YAML failist, mis sisaldab kordumatuid skeemi üksikasju:

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

Märkus

Kõigi CLI-s kasutatavate käskude kohta lisaks portaalidele minge aadressile Tavalised Microsoft Power Platform CLI käsud.

Manifesti failid

Kui laadite alla veebisaidi sisu kasutades pac paportaali allalaadimise CLI käsu, genereeritakse koos saidi sisu allalaadimisega ka kaks manifesti faili.

• Keskkonna manifesti fail (org-url-manifest.yml)
• Jälgimise kustutamise manifesti fail (manifest.yml)

Keskkonna manifesti fail (org-url-manifest.yml)

Keskkonna manifesti fail genereeritakse iga kord käsu pac paportaali allalaadimine käivitamisel.

Pärast iga allalaadimist loeb PAC CLI tööriist olemasolevat keskkonna manifestifaili ja värskendab keskkonnas kustutatud kirjeid või loob keskkonna manifestifaili, kui seda pole olemas.

Kui käivitate portaali veebisaidi sisu üleslaadimiseks käsu pac paportaali üleslaadimine. Loeb see keskkonna manifesti faili ja tuvastab päast viimast allalaadimist tehtud muudatused ning laadib üles ainult uuendatud sisu. See aitab üleslaadimise protsessi optimeerida, sest üles laaditakse ainult uuendatud veebisaidi sisu, selle asemel et laadida kogu sisu iga üleslaadimiskäsuga üles.

Keskkonna manifesti faili loetakse ainult siis, kui see ühendub sama keskkonnaga (keskkonna URL vastab faili nimele), et vältida tahtmatuid muudatusi.

Jälgimise kustutamise manifesti fail (manifest.yml)

Seda faili kasutatakse keskkonnast kustutatud kirjete jälgimiseks.

Kui veebisaidi sisu laaditakse alla käsuga pac paportaali allalaadimine, lisab see kustutatud kirjed keskkonna manifesti failist (org-url-manifest.yml) faili manifest.yml. Seega, kui laadite veebisaidi sisu üles kasutades käsku pac paportaali üleslaadimine, kustutab see failid keskkonnast (isegi erinevasse keskkonda). Seda faili ei kustutata ja seda kasutatakse olenemata sellest, millises keskkonnas olete ühendatud.

Märkus

Selleks, et kustutada saidi sisukirjed ühes keskkonnas ja kustutada samad sisukirjed ka mõnes muus keskkonnas, kasutades PAC CLI-d, peate käivitama käsu pac paportaali allalaadimine enne ja pärast veebisaidi kirje sisu kustutamist. Fail manifest.yml jälgib neid muudatusi ja eemaldab vastavad kirjed sihtkeskkonnast käsu pac paportaali üleslaadimine käivitamisel.

Visual Studio Code'i laienduse kasutamine

Võite kasutada ka VS-koodi laiendust Power Platform VS-koodi laiendus, et saada kasu IntelliSense’i sisseehitatud vedeliku keelest, koodi täitmise abist, vihjetest ja suhelda CLI-ga Microsoft Power Platform , kasutades VS-koodi integreeritud terminali. Lisateave: Kasutage Visual Studio Code laiendit (eelversioon)

Lisakaalutlused

• Tõrkest teatatakse juhul, kui teie failitee ületab teepikkuse tähemärkide ülempiiri. Lisateave: Teepikkuse tähemärkide maksimumpiirang Windowsis
• Duplikaatsete kirjete jaoks, näiteks duplikaadiveebilehe nimi, loob Microsoft Power Platform CLI kaks erinevat kausta—üks neist koos veebilehe nimega ja teine sama nimega, millele on lisatud räsikood. Näiteks "Minu leht" ja "Minu-leht-hash-kood".

Järgmised etapid

Õpetus: Microsoft Power Platform CLI kasutamine portaalidega

Vt ka

• Microsoft Power Platform CLI
• Visual Studio Code'i laiendi kasutamine (eelversioon)