Microsoft Power Platform CLI tugi rakenduse Power Pages jaoks

Microsoft Power Platform CLI (Command Line Interface) on lihtne, ühe peatusega arendaja käsuliiniliin, mis pakub 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. Lisateabe saamiseks minge lehele Mis on Microsoft Power Platform CLI?

Selle funktsiooniga, Microsoft Power Platform CLI lubab CI/CD (Continuous Integration/Continuous Deployment) Power Pages saidi konfiguratsioonis. Saate nüüd kontrollida veebisaidil konfiguratsioonilähtekontrolli ja liigutada veebisaidi konfiguratsiooni igasse 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 CLI installimine Microsoft Power Platform .
• Alates CLI versioonist Power Platform 1.27 muudetakse käsk. pac paportalpac powerpages paportal jätkab tööd, kuid soovitame kasutada powerpages ka edaspidi. Seda artiklit värskendatakse peagi, et seda selle asemel kasutada powerpagespaportal.

Miks kasutada Microsoft Power Platform CLI-d veebisaidi arendamiseks?

Koos Microsoft Power Platform CLI-ga saate nüüd kasutada veebisaidi kohandamiseks ühenduseta režiimi võimalusi, tehes veebisaidi sisus muudatusi. Kui kõik kohandused või muudatused on salvestatud, saate veebisaidi konfiguratsiooni laadige tagasi üles rakendusse Microsoft Dataverse. Veebisaidi sisu allalaadimisel kasutades Microsoft Power Platform CLI abi, on sisu struktureeritud YAML ja HTML-vormingus, muutes kohandamise hõlpsaks, võimaldades eel-arenduskogemust.

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

Kasutamise lihtsus

• Veebisaidi konfiguratsiooni andmete allalaadimise/üleslaadimise tugi lokaalsest süsteemist/lokaalsesse süsteemi

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

Rakenduse elutsükli haldus (ALM)

• Veebisaidi 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 CLI-le Microsoft Power Platform on piiratud järgmiste 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. Saate lisada -v parameetri, mis näitab, kas sait kasutab standardset või täiustatud andmemudelit	pac paportal list
Laadi alla	Portaali veebisaidi sisu allalaadimine praegusest Dataverse'i keskkonnast. Sellel on järgmised parameetrid: - tee: tee, kuhu veebisaidi sisu alla laaditakse (pseudonüüm: -p) - webSiteId: portaali veebisaidi ID allalaadimiseks (alias: -id) - üle kirjutama: (valikuline) tõene – olemasoleva sisu ülekirjutamiseks; väär – nurjumiseks, kui kaustas on juba veebisaidi sisu (alias: -o) - modelVersion: 1 või 2 näitamaks, kas allalaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2).	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
Laadi üles	Portaali veebisaidi sisu üleslaadimine praegusesse Dataverse'i keskkonda. Sellel on järgmine parameeter: - tee: Veebisaidi sisu hoiustamise tee (alias: -p) -deploymentProfile: laadige portaali andmed üles keskkonnaandmetega, mis on määratletud profiili muutujate kaudu deployment-profiles/[profile-name].deployment.yaml failis - modelVersion: 1 või 2 näitamaks, kas üleslaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

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“ (see on <profileTag>.deployment.yml). Ja saate käivitada käsu sildiga (<profileTag>) selle profiili kasutamiseks:

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

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 veebisaidi sisu alla pac paportal laadige alla CLI käsk, koos saidi sisu allalaadimisega genereerib see ka kaks manifestifaili;

• 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 keskkonnafaili ja värskendab keskkonda kustutatud kirjeid või loob keskkonda kaasava faili, juhul 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.

Keskkonnamanifesti faili saab lugeda ainult siis, kui see loob ühenduse sama keskkonnaga (keskkonna URL vastendatakse failinimega), et vältida juhuslikke muudatusi.

Märkus.

• Keskkonna manifestfaili ei ole kujundatud jälitama muudatusi veebisaidi erinevatesse keskkondades juurutamisel.
• Keskkonna manifest fail on välja töötatud nii, et arendajad kasutavad seda kohalikult juurutamiseks oma arenduskeskkonnas, ja see tuleks lisada git ignoreerimise loendisse.

Jälgimise kustutamise manifesti fail (manifest.yml)

Seda faili kasutatakse keskkonnast kustutatud kirjete jälgimiseks.

Kui veebisaidi sisu laaditakse alla käsuga pac paportal , lisab see kustutatud kirjed keskkonna manifesti failist (org-url-manifest.yml) manifest.yml failile. Niisiis, kui laadite veebisaidi sisu üles käsuga pac paportal upload , kustutab see failid keskkonnast (isegi teise keskkonda). Seda faili ei kustutata ja seda kasutatakse sõltumata sellest, millisesse keskkonda te ühendatud olete. Seda faili tuleb arvesse võtta lähtekeskkonna juhtelemendi muutmisel, et kaaluda üksuste kustutamist sihtkeskkonnas.

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 allalaadimineenne 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

Samuti saate kasutada VS Code laiendit Power Platform VS Code laiend, et kasutada sisseehitatud Liquid koodi IntelliSense, Code lõpetamise juhend, vihjamine ja interakteerumine rakenduse Microsoft Power Platform CLI-ga, kasutades VS Code integreeritud terminali. Lisateave: Kasutage Visual Studio Code laiendit (eelversioon)

Rohkem kaalutlusi

• Tõrkest teatatakse juhul, kui teie failitee ületab teepikkuse tähemärkide ülempiiri. Lisateave: Teepikkuse tähemärkide maksimumpiirang Windowsis
• Duplikaatsete kirjete jaoks, nagu 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: Kasuta Microsoft Power Platform CLI portaalidega

Vaata ka

• Microsoft Power Platform CLI
• Kasutage Visual Studio Code laiendit (eelversioon)