„Microsoft Power Platform CLI“ palaikymas „Power Pages“

"Microsoft Power Platform" CLI (komandų eilutės sąsaja) yra paprasta, vieno langelio kūrėjo komandų eilutės sąsaja, leidžianti kūrėjams ir programų kūrėjams 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 .
  • Naudojant "Power Platform CLI" 1.32 versiją, komanda pac powerpages buvo pakeista į pac puslapius. Su pac cli versija 1.27, pac paportal komanda buvo pakeista į pac powerpages. Tiek powerpages, tiek paportal veiks toliau, tačiau rekomenduojame naudoti puslapius ateityje.

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

komentaras

Svarbu

  • Pasirinktinių lentelių ir konkrečių portalo šablonų lentelių (pvz., tinklaraščio, bendruomenės ar idėjų portalo) tinkinimas naudojant "Microsoft Power Platform" CLI nepalaikomas.
  • Vaizdo failų priedai prie skelbimų (adx_ad) įrašų neatsisiunč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 pages 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, kurį reikia atsisiųsti (pseudonimas: -id)
- perrašyti: (Pasirinktinai) teisinga - perrašyti esamą turinį; klaidinga - nepavyksta, jei aplanke jau yra svetainės turinio (slapyvardis: -o)
- modelVersion: 1 arba 2 nurodyti, ar atsisiunčiamiems svetainės duomenims naudojamas standartinis (1) ar patobulintas duomenų modelis (2).		 pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
nusiuntimas Naujinti portalo svetainės turinį į esamą „Dataverse“ aplinką. Joje yra šie parametrai:
- path: Kelias, kuriame saugomas svetainės turinys (pseudonimas: -p)
- deploymentProfile: nusiųskite portalo duomenis su išsamia aplinkos informacija, apibrėžta naudojant profilio kintamuosiusfaile deployment-profiles/[profile-name].deployment.yaml
- modelVersion: 1 arba 2 nurodyti, ar įkeliami svetainės duomenys naudoja standartinį (1) ar patobulintą duomenų modelį (2).
- forceUploadAll: perkelia visus vietinius failus į aplinką. Naudokite, jei manote, kad nuotolinė būsena yra sugadinta, nesinchronizuota arba kai paskutinis atsisiuntimas gautas iš kitos šakos.		 pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Pastaba.

  • Kai atsisiunčiate portalą iš aplinkos A ir įkeliate jį į aplinką B, PAC CLI atlieka visą įkėlimą. Taip atsitinka, nes keitimų sekimas naudoja deklaracijos failus, kurie neperduoda būsenos informacijos įvairiose aplinkose.
  • "Delta" nusiuntimai, kai įkeliami tik modifikuoti failai, palaikomi tik tada, kai atsisiuntimo ir nusiuntimo operacijos vyksta toje pačioje aplinkoje. Tokiu atveju PAC CLI aptinka vietinius pakeitimus ir įkelia tik atnaujintus failus. Norėdami sužinoti daugiau apie tai, kaip veikia pakeitimų sekimas, žr.
  • Tokiose situacijose naudokite --forceUploadAll . (Šiuo metu šis parametras taikomas tik CLI. "Azure DevOps" užduotys dar nepateikia.)
    • Vamzdyno būsenos dreifas (jūs perkūrėte arba pasirinkote įsipareigojimus, todėl paskutinė serverio būsena nebeatitinka jūsų šakos).
    • Įtariamas delta nepakankamumas (pavyzdžiui, po normalaus uploadatsiranda tik daliniai pokyčiai).

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 pages 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 komandą pac pages download CLI, kartu su svetainės turinio atsisiuntimu ji taip pat sugeneruoja du manifesto failus;

  • Aplinkos aplinkos failas (org-url-klaidingas.yml)
  • Naikinti sekimą, sekimą, failą (a. yml)

Aplinkos aplinkos failas (org-url-klaidingas.yml)

Aplinkos deklaracijos failas generuojamas kiekvieną kartą, kai vykdoma pac puslapių 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 vykdote komandą PAC puslapių nusiuntimas , 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 sekti pakeitimus diegiant svetainę 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 komandą pac pages download , tai prideda ištrintus įrašus iš aplinkos deklaracijos failo (org-url-manifest.yml) į manifest.yml failą. Taigi, kai įkeliate svetainės turinį naudodami pac puslapių įkėlimo komandą, 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.

Norėdami panaikinti svetainės turinio įrašus vienoje aplinkoje ir panaikinti tuos pačius turinio įrašus kitoje aplinkoje naudodami PAC CLI, prieš ir po svetainės įrašo turinio panaikinimo turėsite paleisti komandą PAC puslapių atsisiuntimas. manifest.yml seks šiuos keitimus ir pašalins atitinkamus įrašus paskirties aplinkoje, kai bus vykdoma pac puslapių nusiuntimo komanda.

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

Vadovėlis: CLI naudojimas Microsoft Power Platform portaluose

Taip pat žr.

  • Last updated on