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