Bendrinti naudojant


Portalai palaiko „Microsoft Power Platform“ CLI

Pastaba

Nuo 2022 m. spalio 12 d. „Power Apps“ portalai tampa „Power Pages“. Daugiau informacijos: „Microsoft Power Pages“ dabar yra visuotinai prieinama (tinklaraštis)
Greitai perkelsime ir suliesime „Power Apps“ portalų dokumentaciją su „Power Pages“ dokumentacija.

„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. Daugiau informacijos apie, žr.Kas tai Microsoft Power Platform CLI?

Naudodami šią funkciją, portalai palaiko Microsoft Power Apps CLI, Microsoft Power Platform kad įgalintų portalo konfigūracijos CI/CD (Continuous Integration/Continuous Deployment). Dabar galite patikrinti portalo konfigūraciją, kad galėtumėte valdyti šaltinį, ir perkelti portalo konfigūraciją į bet kurią aplinką naudodami Microsoft Power Platform CLI.

Pastaba

Šią funkciją paprastai galima pradėti nuo „Power Platform“ 1.9.8 versijos CLI. Jei norite sužinoti apie naujausios versijos diegimą, žr. „Microsoft Power Platform“ CLI

Kodėl verta „Microsoft Power Platform“ kurti portalus naudojant CLI?

Naudodami portalų funkciją, norėdami tinkinti portalus, dabar galite naudoti į neprisijungus funkciją įjungiant „Microsoft Power Platform“ funkcijas: portalų turinį galite keisti. Įrašę visus tinkinimus arba pakeitimus, įkelkite juos į portalą. Kai atsisiunčiate portalų turinį naudodami CLI, turinys struktūriškai struktūrizuotas YAML ir HTML formatais, todėl jį lengva tinkinti ir taip galima „Microsoft Power Platform“ kurti profesionalus funkcijas.

Čia pateikiamas funkcijų ir galimybių, kurias portalai gauna naudos palaikę „Microsoft Power Platform“ CLI, sąrašas:

Naudojimo paprastumas

  • Portalo duomenų atsisiuntimo / įkėlimo į vietinę failų sistemą palaikymas

  • Kurkite pagal esamą „Microsoft Power Platform“ CLI įrankį.

Programos ciklo valdymas (ALM)

  • Portalo 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 palaiko „Microsoft Power Platform“ CLI ir apribotas lenteles išvardytas toliau.

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 į žiniatinklio failo įrašą, kuriame yra vaizdo failas, įtraukdami Kopijuoti lauką į žiniatinklio failą įrašui, 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.

Paportalinės komandos 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. pac paportal list
atsisiųsti Atsisiųsti portalo svetainės turinį iš dabartinės „Dataverse“ aplinka. Joje yra šie parametrai:
- Kelias: Kelias, kur bus atsisiųstas svetainės turinys (alias: -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)
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
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 kurie yra deployment-profiles/[profile-name].deployment.yaml faile
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"
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ą visuotinio diegimo-profiliuose 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

Š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 paportalą atsisiuntimas CLI, kartu su svetainės turinio atsisiuntimu taip pat bus sugeneruoti du "atsisiųsti" 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.

Po kiekvieno atsisiuntimo PAC CLI įrankis nuskaito esamą aplinkos aprašo failą ir atnaujina aplinkoje panaikintus įrašus arba sukuria aplinkos deklaracijos 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 failas "kompiuterio failas" bus lengvai skaitomas, kai jis prisijungs prie tos pačios aplinkos (aplinkos URL atitiks failo vardą), kad nebūtų atsitiktinių pakeitimų.

Naikinti sekimą, sekimą, failą (a. yml)

Šis failas naudojamas panaikintims aplinkos įrašams sekti.

Kai žiniatinklio turinys atsisiunčiamas naudojant "elementų paportal atsisiuntimo komandą, panaikintus įrašus iš aplinkos esamos failo (org-url-nemokamai.yml) bus įtraukti į failo manifest.yml failą. Todėl, kai nusiunčiate svetainės turinį naudodami pac paportal įkėlimo komandą, failai bus panaikinti iš aplinkos (net ir kitoje aplinkoje). Šis failas nepanaikinamas ir naudojamas neatsižvelgiant į tai, kurioje aplinkoje esate prisijungę.

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į

Taip pat galite naudoti VS kodo plėtinį VS kodo plėtinį **Power Platform ** , kad galėtumėte naudotis integruota "IntelliSense" skysta kalba, kodo užbaigimo pagalba, užuominomis ir sąveikauti su Microsoft Power Platform CLI naudodami VS kodo integruotą terminalą. Daugiau informacijos: Naudokite „Visual Studio Code“ plėtinį (peržiūra)

Papildomos pastabos

  • 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, JIH sukuria du skirtingus aplankus, viename jų yra tinklalapio pavadinimas, o kitą – su tuo pačiu pavadinimu, prieš kurį yra priešdėlis su „Microsoft Power Platform“ ir — hash kodu. Pavyzdžiui, "Mano puslapis" ir "Mano puslapis – hash-kodas“.

Paskesni veiksmai

Mokymo priemonė: naudokite „Microsoft Power Platform“ CLI su portalais

Taip pat žr.