Microsoft Power Platform CLI tugi rakenduse Power Pages jaoks

Microsoft Power Platform CLI (käsurea liides) on lihtne, ühe peatusega arendaja käsurea liides, mis annab arendajatele ja rakenduste tegijatele võimaluse luua koodikomponente.

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 jaotisse 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. Uusima versiooni installimise kohta leiate teavet teemast CLI installimine Microsoft Power Platform .
• Power Platform CLI versioonis 1.32 muudeti pac powerpagesi käsk pac lehtedeks. Pac cli versiooniga 1.27 muudeti pac paportal käsk pac powerpagesiks. Nii powerpages kui ka paportal töötavad edasi, kuid soovitame edaspidi lehti kasutada.

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 CLI tugi 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

marginaal

Oluline

• Kohandatud tabeleid ja portaalimallipõhiseid tabeleid (nt ajaveeb, kogukond või ideede portaal) ei toetata kohandamiseks Microsoft Power Platform CLI abil.
• Reklaami (adx_ad) kirjete pildifaili manuseid ei laadita alla Power Platform CLI abil. 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 pages list
alla laadima	Portaali veebisaidi sisu allalaadimine praegusest Dataverse'i keskkonnast. Sellel on järgmised parameetrid: - path: tee, kuhu veebisaidi sisu alla laaditakse (pseudonüüm: -p) - webSiteId: allalaaditav portaali veebisaidi ID (pseudonüüm: -id) - overwrite: (valikuline) true - olemasoleva sisu ülekirjutamiseks; false - nurjub, kui kaustas on juba veebisaidi sisu (pseudonüüm: -o) - modelVersion: 1 või 2 näitab, kas allalaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2).	pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
Laadida	Portaali veebisaidi sisu üleslaadimine praegusesse Dataverse'i keskkonda. Sellel on järgmine parameeter: - path: tee, kuhu veebisaidi sisu salvestatakse (pseudonüüm: -p) - deploymentProfile: laadige üles portaali andmed koos keskkonna üksikasjadega, mis on määratletud faili deployment-profiles/[profile-name].deployment.yamlprofiilimuutujate kaudu - modelVersion: 1 või 2 näitab, kas üleslaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2). - forceUploadAll: lükkab kõik kohalikud failid keskkonda. Kasutage seda siis, kui arvate, et kaugolek on rikutud, sünkroonimata või kui viimane allalaadimine pärineb mõnest muust harust.	pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Märkus.

• Kui laadite portaali alla keskkonnast A ja laadite selle üles keskkonda B, teostab PAC CLI täieliku üleslaadimise. See käitumine ilmneb seetõttu, et muudatuste jälitus kasutab manifestifaile, mis ei edasta olekuteavet keskkondade vahel.
• Deltaüleslaadimist – kus laaditakse üles ainult muudetud faile – toetatakse ainult siis, kui nii allalaadimis- kui ka üleslaadimistoimingud toimuvad samas keskkonnas. Sel juhul tuvastab PAC CLI kohalikud muudatused ja laadib üles ainult värskendatud failid. Lisateavet muudatuste jälgimise toimimise kohta leiate teemast Manifestifailid.
• Kasutage sellistes olukordades --forceUploadAll . (See parameeter on praegu ainult CLI. Azure DevOpsi ülesanded ei ilmu seda veel.)
  • Konveieri oleku triiv (te põhinesite ümber või valisite commitsid, nii et viimane serveri olek ei vasta enam teie harule).
  • Kahtlustatav delta rike (näiteks pärast normaalset uploadilmnevad ainult osalised muutused ).

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 pages 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 lehtede käsu allalaadimise CLI abil, genereerib see koos saidi sisu allalaadimisega 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 manifestifail genereeritakse iga kord, kui käivitatakse käsk pac lehtede allalaadimine .

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 pages upload . 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 manifestifail on kirjutuskaitstud, kui see loob ühenduse sama keskkonnaga (keskkonna URL vastab faili nimele), et vältida juhuslikke muudatusi.

Märkus.

• Keskkonna manifestifail ei ole mõeldud muudatuste jälgimiseks veebisaidi juurutamisel erinevates keskkondades.
• 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 pages download , lisab see kustutatud kirjed keskkonna manifestifailist (org-url-manifest.yml) manifest.yml faili. Seega, kui laadite veebisaidi sisu üles pac lehtede üleslaadimise käsu abil, 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.

Saidi sisukirjete kustutamiseks ühes keskkonnas ja samade sisukirjete kustutamiseks teises keskkonnas, kasutades PAC CLI-d, peate enne ja pärast veebisaidi kirje sisu kustutamist käivitama käsu pac pages download. manifest.yml jälgib neid muudatusi ja eemaldab vastavad kirjed sihtkeskkonnast, kui käivitatakse käsk pac lehtede üleslaadimine .

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: CLI kasutamine Microsoft Power Platform portaalidega

Vaata ka

• Microsoft Power Platform CLI
• Koodilaiendi kasutamine Visual Studio (eelvaade)