Bendrinti naudojant


„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 naudoti powerpages toliau. Šis straipsnis netrukus bus atnaujintas naudoti powerpages vietoj paportal.

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.

Komandos „paportal“ patvirtinimas „Microsoft Power Platform CLI“.

„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

Taip pat žr.