„Microsoft Power Platform CLI“ palaikymas „Power Pages“
„Microsoft Power Platform CLI“ (komandų eilučių sąsaja) yra paprasta, vieno langelio programų kūrėjų komandų eilučių sąsaja, kuri suteikia kūrėjams ir programų kūrėjams galimybę kurti kodo komponentus.
„Microsoft Power Platform“ CLI įrankiai yra pirmasis žingsnis į išsamų programų gyvavimo ciklo valdymą (ALM) – įmonės kūrėjai ir ISV gali greitai ir efektyviai kurti, kurti, deaktyvūs ir publikuoti savo plėtinius bei tinkinimus. Norėdami gauti daugiau informacijos, eikite į Kas yra Microsoft Power Platform CLI?
Naudodami šią funkciją „Microsoft Power Platform CLI“ įgalina CI / CD (nuolatinis integravimas / nuolatinis visuotinis diegimas) „Power Pages“ svetainės konfigūraciją. Dabar galite patikrinti svetainės konfigūraciją ir iš esmės valdyti bei perkelti svetainės konfigūraciją į bet kurią aplinką naudojant „Microsoft Power Platform CLI“.
Pastaba.
- Šią funkciją paprastai galima pradėti nuo „Power Platform“ 1.9.8 versijos CLI. Norėdami sužinoti apie naujausios versijos diegimą, eikite į CLI diegimas Microsoft Power Platform .
- Pradedant nuo Power Platform CLI versijos 1.27,
pac paportal
komanda pakeičiama įpac powerpages
.paportal
ir toliau dirba, tačiau rekomenduojame naudotipowerpages
toliau. Šis straipsnis netrukus bus atnaujintas naudotipowerpages
vietojpaportal
.
Kodėl verta naudoti „Microsoft Power Platform CLI“ kuriant svetaines?
Naudodami „Microsoft Power Platform CLI“ dabar galite naudoti neprisijungus prieinamą funkciją, skirtą svetainių tinkinimui atlikdami svetainės turinio pakeitimus. Įrašę visus tinkinimus arba pakeitimus, galite įkelti svetainės konfigūraciją atgal į „Microsoft Dataverse“. Kai atsisiunčiate svetainės turinį naudodami „Microsoft Power Platform CLI“, turinys struktūrizuotas YAML ir HTML formatais, todėl jį lengva tinkinti ir taip kurti profesionalias funkcijas.
Čia pateikiamas funkcijų ir galimybių, kurias portalai gauna naudos palaikę „Microsoft Power Platform“ CLI, sąrašas:
Naudojimo paprastumas
Svetainės konfigūracijos duomenų atsisiuntimo / įkėlimo į vietinę failų sistemą palaikymas
Kurkite pagal esamą „Microsoft Power Platform“ CLI įrankį.
Programos ciklo valdymas (ALM)
Svetainės konfigūravimo organizacijoje keitimų sekmas
Konfigūracijos failus perkelkite į organizacijas arba nuomotojus
Pro-dev ir įmonės palaikymas
Sklandžiai integruoti galima naudojant bet kokius šaltinio valdymo įrankius, pvz., „git"
Lengvai nustatykite CI / CD galimybes
Diegti „Microsoft Power Platform“ CLI
Nuoseklių instrukcijų žr. Microsoft Power Platform" CLI ".
Palaikomos lentelės
Portalai CLI palaiko Microsoft Power Platform tik toliau nurodytas lenteles.
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 (tik atsisiuntimas)
adx_websitelanguage
adx_webtemplate
anotacija
Svarbu
- Pasirinktinių lentelių ir portalo šablonams pritaikytų lentelių (pvz., interneto dienoraščio, bendruomenės ar idėjos portalo) tinkinimas naudojant „Microsoft Power Platform“ CLI nepalaikomas.
- Vaizdų failų priedai prie reklamos (adx_ad) įrašų nėra atsisiunčiami naudojant Power Platform CLI. Kaip sprendimą naudokite lauką Vaizdo URL arba lauke Kopijuoti esančią HTML nuorodą įtraukite į žiniatinklio failo įrašą, kuriame yra vaizdo failas.
Diekite ir patikrinkite „Microsoft Power Platform“ CLI portalams
Norėdami sužinoti apie „Microsoft Power Platform CLI diegimą, eikite į „Microsoft Power Platform“ CLI .
Įdiegus „Microsoft Power Platform“ CLI, atverkite komandos langą ir vykdykite pac siekiant patikrinti, ar rezultate yra „paportalinis” - komanda „Power Apps“ portalams.
„Microsoft Power Platform“ CLI komandos portalams
„Microsoft Power Platform“ CLI portalams yra paportalinis.
Toliau skyriuose pateikiama papildomos informacijos apie skirtingas komandos “Paportalo“ ypatybes.
Parametrai
Ypatybės pavadinimas | Aprašą | Pavyzdžiui |
---|---|---|
sąrašas | Išvardyti visas portalo svetaines iš dabartinės „Dataverse“ aplinkos. Galite įtraukti parametrą -v ir nurodyti, ar svetainė naudoja standartinį ar patobulintą duomenų modelį |
pac paportal list |
atsisiųsti | Atsisiųsti portalo svetainės turinį iš dabartinės „Dataverse“ aplinka. Joje yra šie parametrai: - path: kelias, kuriuo atsisiunčiamas svetainės turinys (pseudonimas: -p) - webSiteId: portalo svetainės ID, kad būtų galima atsisiųsti (alias: -id) - perrašyti: (pasirinktinis) teisinga – perrašyti esamą turinį, klaidinga – nepavyks, jei aplanke jau yra svetainės turinys (al: -o) - modelVersion: 1 arba 2 nurodyti, ar svetainės duomenims, kuriuos reikia atsisiųsti, naudojamas standartinis (1) ar patobulintas duomenų modelis [2]. |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2 |
nusiųsti | Naujinti portalo svetainės turinį į esamą „Dataverse“ aplinką. Joje yra šie parametrai: - kelias: Kelias, kur bus laikomas svetainės turinys (alias: -p) - deploymentProfile: įkelkite portalo duomenis naudodami išsamią informaciją apie aplinką, apibrėžtą naudojant profilio kintamuosius faile deployment-profiles/[profile-name].deployment.yaml - modelVersion: 1 arba 2 nurodyti, ar svetainės duomenims, kuriuos reikia įkelti, naudojamas standartinis (1) ar patobulintas duomenų modelis [2]. |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2 |
Visuotinio diegimo profilio naudojimas
"DeploymentProfile jungiklį galima apibrėžti aplinkos kintamųjų rinkinį YAML formatu. Pavyzdžiui, galite turėti skirtingus visuotinio diegimo profilius (pvz., visuotinio diegimo, tikrinimo, prod) su skirtingomis profilio schemos išsamiomis išsamiomis informacija.
Jei kuriate bandomąjį profilį, galite sukurti failą skyriujevisuotinio-diegimo-profiliai su pavadinimu „test.deployment.yml“ (kuris yra <profileTag>.deployment.yml). O šiam profiliui naudoti galite vykdyti komandą su žyma (<profileTag>):
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2
Šiame faile galite nurodyti lentelės (objekto) pavadinimą su lentelės ID, atributų sąrašą ir reikšmes, kurias norite perrašyti įkeldami portalo konfigūraciją naudodami deploymentProfile
parametrą.
Be to, kintamąjį OS
galite naudoti operacinės sistemos aplinkos kintamiesiems pasiekti.
Štai šio „test.deployment.yml“ profilio YAML failo, kuriame pateikiama unikali schemos informacija, pavyzdys:
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
Pastaba.
Norėdami sužinoti daugiau apie visas komandas naudojamas CLI kartu su portalais, eikite į Bendras komandas „Microsoft Power Platform“ CLI.
Failų išsaidimas
Kai atsisiunčiate svetainės turinį naudodami pac paportal download CLI komandą, kartu su svetainės turinio atsisiuntimu taip pat sugeneruojami du manifesto failai;
- Aplinkos aplinkos failas (org-url-klaidingas.yml)
- Naikinti sekimą, sekimą, failą (a. yml)
Aplinkos aplinkos failas (org-url-klaidingas.yml)
Aplinkos "kasdien" failas generuojamas kiekvieną kartą, kai vykdoma sporto atsisiuntimo komanda.
Kiekvieną kartą atsisiuntus, PAC CLI įrankis skaito esamą aplinkos failo deklaracijos failą ir atnaujina įrašus, panaikintus aplinkoje, arba sukuria aplinkos failą, jei jo nėra.
Kai paleidžiate komandą pac įkėlimo sistema, kad nusiųstumėte portalo svetainės turinį. Jis skaito aplinkos failo failą, nustato pakeitimus, atliktus nuo paskutinio atsisiuntimo, ir tik nusiunčia atnaujintą turinį. Tai padeda optimizuoti įkėlimo procesą kaip tik atnaujintą svetainės turinį, o ne įkelti visą turinį į kiekvieną įkėlimo komandą.
Aplinkos deklaracijos failas yra skaitomas tik tada, kai jis prisijungia prie tos pačios aplinkos (aplinkos URL atitinka failo vardą), kad būtų išvengta atsitiktinių pakeitimų.
Pastaba.
- Aplinkos deklaracijos failas nėra skirtas stebėti pakeitimus, kai žiniatinklio svetainė diegiama skirtingose aplinkose.
- Aplinkos deklaracijos failas skirtas programų kūrėjams naudoti vietoje jų programų kūrėjų aplinkoje ir jį reikia įtraukti į git nepaisymo sąrašą.
Naikinti sekimą, sekimą, failą (a. yml)
Šis failas naudojamas panaikintims aplinkos įrašams sekti.
Kai svetainės turinys atsisiunčiamas naudojant pac paportal atsisiuntimo komandą, panaikinti įrašai iš aplinkos deklaracijos failo (org-url-manifest.yml) įtraukiami į manifest.yml failą. Taigi, kai įkeliate svetainės turinį naudodami komandą pac paportal upload , failai ištrinami iš aplinkos (net į kitą aplinką). Šis failas nepanaikinamas ir jis naudojamas neatsižvelgiant į tai, kurioje aplinkoje esate prisijungę. Į šį failą reikia atsižvelgti stumiant šaltinio valdiklio pakeitimus, kad būtų galima naikinti elementus paskirties aplinkoje.
Pastaba.
Jei norite panaikinti svetainės turinio įrašus vienoje aplinkoje ir panaikinti tuos pačius turinio įrašus kitoje aplinkoje, naudodami PAC CLI, prieš naikindami svetainės įrašo turinį ir jį panaikinę turėsite komandą prieš ir po panaikinant svetainės įrašų turinį. Kai bus vykdoma seks įkėlimo komanda šie pakeitimai bus sekami ir pašalinami atitinkami įrašai paskirties aplinkoje.
Naudokite Visual Studio Code plėtinį
Galite taip pat naudoti „VS Code“ plėtinį „Power Platform VS Code Extension“ norėdami gauti pranašesnę integruotą „Liquid“ kalbą iš „IntelliSense“, kodo pabaigimo pagalbą, nuorodas ir sąveiką su „Microsoft Power Platform CLI“ naudojant „VS Code Integrated Terminal“. Daugiau informacijos: Naudokite „Visual Studio Code“ plėtinį (peržiūra)
Daugiau aspektų
- Pranešama apie klaidą, jei jūsų failo kelias viršija maksimalų kelio ilgio apribojimą. Daugiau informacijos: Didžiausias kelio ilgio apribojimas sistemoje „Windows"
- Jei įrašai dublikatai yra tokie kaip tinklalapio pavadinimo dublikatas, „Microsoft Power Platform CLI“ sukuria du skirtingus aplankus, vieną su jų tinklalapio pavadinimu, o kitą – su tuo pačiu pavadinimu, ir maišos kodo priešdėliu. Pavyzdžiui, "Mano puslapis" ir "Mano puslapis – hash-kodas“.
Paskesni veiksmai
Mokymo priemonė: „Microsoft Power Platform CLI“ naudojimas su portalais