Power Pages-ren Microsoft Power Platform CLI laguntza

Microsoft Power Platform CLI (komando-lerroko interfazea) garatzaileen komando-lerroko interfaze sinplea da, garatzaileei eta aplikazioen sortzaileei kode-osagaiak sortzeko aukera ematen diena.

Microsoft Power Platform CLI tresneria aplikazioen bizitza zikloaren kudeaketa (ALM) istorio integral baterako lehen urratsa da, non enpresa garatzaileek eta ISVek beren luzapenak eta pertsonalizazioak azkar, modu eraginkor eta azkarrean sortu, eraiki, araztu eta argitaratu ditzaketen. Informazio gehiago lortzeko, joan honera: Zer da Microsoft Power Platform CLI?

Eginbide honekin, Microsoft Power Platform CLI konfigurazioaren CI/CD (Etengabeko Integrazioa/Etengabeko Inplementazioa) onartzen du Power Pages gunean. Gunearen konfigurazioan egiaztatu dezakezu iturburuko kontrola eta gunearen konfigurazioa edozein ingurunera eraman Microsoft Power Platform CLI erabiliz.

Oharra

• Ezaugarri hau, oro har, erabilgarri dago Power Platform CLI bertsioa 1.9.8. Azken bertsioa instalatzeari buruzko informazioa lortzeko, joan Instalatu Microsoft Power Platform CLI atalera.
• Power Platform CLI 1.32 bertsioarekin, pac powerpages komandoa pac orrialdeetara aldatu zen. Pac CLI 1.27 bertsioarekin, pac paportal komandoa pac powerpages-era aldatu zen. Powerpages eta paportal funtzionatzen jarraituko dute, baina aurrerantzean orrialdeak erabiltzea gomendatzen dugu.

Zergatik erabili Microsoft Power Platform CLIa guneak garatzeko?

Microsoft Power Platform CLI-rekin, lineaz kanpoko moduko gaitasuna erabil dezakezu guneak pertsonalizatzeko guneen edukian aldaketak eginez. Eta pertsonalizazio edo aldaketa guztiak gorde ondoren, gunearen konfigurazioa berriro karga dezakezu Microsoft Dataverse-ra. Erabiliz guneen edukia deskargatzen duzunean Microsoft Power Platform CLI, edukia YAML eta HTML formatuetan egituratuta dago pertsonalizatzea errazteko, garapenaren aldeko esperientzia ahalbidetuz.

Hona hemen atariek onartzen dituzten ezaugarri eta gaitasunen zerrenda Microsoft Power Platform CLI:

Erabiltzeko erraztasuna

• Gunea konfiguratzeko datuak tokiko fitxategi sistemara / bertatik deskargatzeko / kargatzeko laguntza

• Existitzen denaren gainean eraiki Microsoft Power Platform CLI tresna.

Aplikazioen bizi-zikloaren kudeaketa (ALM)

• Gunearen konfigurazioaren aldaketen jarraipena egin erakunde batean

• Mugitu konfigurazio fitxategiak erakundeen edo maizterren artean

Garatzaile profesionalentzako eta enpresetarako laguntza

• Iturburuak kontrolatzeko tresnekin integratzen laguntzen du, hala nola "git"

• Erraz konfiguratu CI/CD kanalizazioak

Instalatu Microsoft Power Platform CLIa

Urratsez urratseko argibideak lortzeko, ikusi Instalatu Microsoft Power Platform CLI.

Onartutako taulak

CLIrako atarien laguntza hurrengo tauletara mugatzen da. Microsoft Power Platform

adx_ad

adx_plazamendua

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 (deskargatu soilik)

adx_websitelanguage

adx_webtemplate

oharpena

Garrantzitsua da

• Taula pertsonalizatuak eta atariaren txantiloi-taula espezifikoak (adibidez, bloga, komunitatea edo ideien ataria) ez dira onartzen Microsoft Power Platform CLI erabiliz pertsonalizaziorako.
• Irudi-fitxategien eranskinak iragarkien (adx_ad) erregistroei ez zaizkie deskargatzen Power Platform CLI erabiliz. Konponbide gisa, erabili Irudiaren URLa eremuan, edo HTML erreferentzia bat gehituz Kopiatu eremura web fitxategia irudi-fitxategi bat duen erregistroa.

Instalatu eta egiaztatu atarietarako Microsoft Power Platform CLIa

Instalazioari buruz ikasteko Microsoft Power Platform CLI, irakurri Instalatu Microsoft Power Platform CLIa.

Microsoft Power Platform CLIa instalatu ostean, ireki komando-gonbita eta exekutatu pac irteerak "paportal" duela egiaztatzeko: atarietarako Power Apps komandoa.

Atarietarako Microsoft Power Platform CLI komandoak

Atarietarako Microsoft Power Platform CLI komandoa "paportal" da.

Ondorengo ataletan “paportal” komandoaren propietate ezberdinei buruzko xehetasun gehiago ematen dira.

Parametroak

Propietate-izena	Deskribapenak	Adibidez
zerrenda	Uneko Dataverse erakundeko soluzio atari-webgune guztiak zerrendatzen du. Gehitu dezakezu -v gunea estandarra erabiltzen ari den adierazteko parametroa edo datu-eredu hobetua	pac pages list
deskargatu	Deskargatu atariaren webguneko edukia uneko Dataverse ingurunetik. Honako parametro hauek ditu: - path: Webguneko edukia deskargatzen den bidea (alias: -p) - webSiteId: Deskargatzeko atariaren webgunearen IDa (alias: -id) - overwrite: (Aukerakoa) true - dagoen edukia gainidazteko; false - huts egiteko karpetak dagoeneko webguneko edukia badu (alias: -o) - modelVersion: 1 edo 2 deskargatu beharreko gunearen datuek datu-eredu estandarra (1) edo hobetua (2) erabiltzen duten adierazteko.	pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
igo	Kargatu atariaren webguneko edukia uneko Dataverse ingurunera. Honako parametro hau du: - path: Webgunearen edukia gordetzen den bidea (alias: -p) - deploymentProfile: Igo atariaren datuak profil-aldagaien bidez definitutako ingurunearen datuak deployment-profiles/[profile-name].deployment.yaml fitxategian - modelVersion: 1 edo 2 igo beharreko gunearen datuek datu-eredu estandarra (1) edo hobetua (2) erabiltzen duten adierazteko. - forceUploadAll: fitxategi lokal guztiak ingurunera bultzatzen ditu. Erabili hau urruneko egoera hondatuta dagoela uste duzunean, sinkronizatu gabe dagoela edo azken deskarga beste adar batetik etorri denean.	pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Oharra

• Atari bat A ingurunetik deskargatzen duzunean eta B ingurunera igotzen duzunean, PAC CLIk igoera osoa egiten du. Portaera hau gertatzen da aldaketen jarraipenak Manifest Fitxategiak erabiltzen dituelako, eta horrek ez du ingurune batetik bestera egoeraren informazioa eramaten.
• Delta igoerak, non aldatutako fitxategiak soilik kargatzen diren, deskargatu eta igotzeko eragiketak ingurune berean gertatzen direnean soilik onartzen dira. Kasu honetan, PAC CLIk aldaketa lokalak detektatzen ditu eta eguneratutako fitxategiak soilik kargatzen ditu. Aldaketaren segimenduak nola funtzionatzen duen jakiteko, ikus Manifestu fitxategiak.
• Erabili --forceUploadAll egoera horietan. (Parametro hau CLI soilik da. Azure DevOps zereginak oraindik ez dira azaleratzen.)
  • Kanalizazioaren egoeraren noraeza (biroinarritu edo egikariak aukeratu dituzu, beraz, azken zerbitzariaren egoera jada ez dator bat zure adarra).
  • Delta huts susmagarria (adibidez, aldaketa partzialak bakarrik agertzen dira normal uploadbaten ondoren).

Erabili inplementazio profila

deploymentProfile etengailuak inguruneko aldagai multzo bat YAML formatuan definitzeko aukera ematen dizu. Adibidez, inplementazio profil desberdinak izan ditzakezu (adibidez, dev, test, prod) profilean eskema xehetasun desberdinak dituztenak.

Proba profila sortzen ari bazara, fitxategia sor dezakezu deployment-profiles atalean "test.deployment.yml" izenarekin (hau da, <profileTag>.deployment.yml). Profila erabiltzeko komandoa etiketa erabil dezakezu (<profileTag>):

pac pages upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

Fitxategi honetan, taularen (entitatea) izena taulako IDarekin, atributuen zerrendarekin eta atariaren konfigurazioa kargatu bitartean deploymentProfile parametroa erabiliz gainidatzi nahi dituzun balioak izan ditzakezu.

Gainera, OS aldagaia erabil dezakezu sistema eragilearen inguruneko aldagaietara sartzeko.

Hona hemen "test.deployment.yml" profileko YAML fitxategi honen adibide bat, eskemaren xehetasun bakarrak dituena:

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

Oharra

Atariez gain CLIan erabilitako komando guztiak ezagutzeko, irakurri Ohiko komandoak Microsoft Power Platform CLIan.

Manifestu fitxategiak

Webgunearen edukia pac pages download CLI komandoa erabiliz deskargatzen duzunean, gunearen edukia deskargatzearekin batera, bi manifestu fitxategi ere sortzen ditu;

• Inguruneko manifestu fitxategia (org-url-manifest.yml)
• Ezabatu jarraipen-fitxategia (manifest.yml)

Inguruneko manifestu fitxategia (org-url-manifest.yml)

Ingurunearen manifestu-fitxategia pac pages download komandoa exekutatzen den bakoitzean sortzen da.

Deskarga bakoitzaren ondoren, PAC CLI tresnak lehendik dagoen inguruneko manifestu fitxategia irakurtzen du eta ingurunean ezabatutako sarrerak eguneratzen ditu edo inguruneko manifestu fitxategia sortzen du existitzen ez bada.

Pac orriak kargatzeko komandoa exekutatzen duzunean atariaren webgunearen edukia igotzeko. Inguruneko manifestu fitxategia irakurtzen du eta azken deskargatik egindako aldaketak identifikatzen ditu eta eguneratutako edukia soilik kargatzen du. Honek kargatzeko prozesua optimizatzen laguntzen du webguneko eduki eguneratuak soilik kargatzen baitira, kargatzeko komando guztietan eduki guztia kargatu beharrean.

Ingurunearen manifestu fitxategia irakurtzeko soilik da ingurune berera konektatzen denean (ingurunearen URLa fitxategiaren izenarekin bat dator), ustekabeko aldaketak saihesteko.

Oharra

• Ingurunearen manifestu-fitxategia ez diseinatuta webgunea ingurune desberdinetan hedatzean aldaketen jarraipena egiteko.
• Inguruneko manifestu fitxategia garatzaileek beren garatzaileen ingurunean lokalean hedatzeko diseinatuta dago eta "git ignore" zerrendara gehitu behar da.

Ezabatu jarraipen-fitxategia (manifest.yml)

Fitxategi hau ingurunetik ezabatutako erregistroen jarraipena egiteko erabiltzen da.

Webgunearen edukia pac pages download komandoarekin deskargatzen denean, ingurunearen manifestu-fitxategitik (org-url-manifest.yml) ezabatutako erregistroak manifest.yml fitxategiari gehitzen dizkio. Beraz, webgunearen edukia pac pages upload komandoa erabiliz igotzen duzunean, fitxategiak ingurunetik ezabatzen ditu (baita beste ingurune batera ere). Fitxategi hau ez da ezabatzen eta konektatuta zauden ingurunea edozein dela ere erabiltzen da. Fitxategi hau kontuan hartu behar da iturburuko kontrolean aldaketak bultzatzean helburuko inguruneko elementuak ezabatzea kontuan hartzeko.

Oharra

Ingurune bateko gunearen eduki erregistroak ezabatzeko eta beste ingurune batean eduki erregistro berberak ezabatzeko PAC CLI erabiliz, pac pages download komandoa exekutatu beharko duzu webgunearen erregistroaren edukia ezabatu aurretik eta ondoren . manifest.yml aldaketa horien jarraipena egingo du eta dagozkien erregistroak kenduko ditu helburuko ingurunean pac pages upload komandoa exekutatzen denean.

Erabili Visual Studio Code-ren luzapena

VS Code luzapena ere erabil dezakezu Power Platform VS Code luzapena IntelliSense-ren hizkuntza likido integratuari etekina ateratzeko, kodea osatzeko laguntza, aholkuak eta elkarreragina Microsoft Power Platform CLI VS Code Integrated Terminal erabiliz. Informazio gehiago: Erabili Visual Studio Code luzapena (aurrebista)

Kontuan hartzeko elementu gehiago

• Akats baten berri ematen da zure fitxategiaren bideak gehieneko bide luzeraren muga gainditzen badu. Informazio gehiago: Windows-en gehieneko bide luzera mugatzea
• Erregistro bikoiztuetarako, hala nola web orriaren izen bikoiztua, Microsoft Power Platform CLI-ak bi karpeta desberdin sortzen ditu bata web orriaren izenarekin, eta bestea hash kode batekin aurrez jarritako izen bera duena. Adibidez, "Nire orria" eta "Nire orria-hash-code".

Hurrengo urratsak

Tutoriala: Erabili CLI atariekin Microsoft Power Platform

Ikusi ere

• Microsoft Power Platform-en CLI
• Erabili Visual Studio Kode luzapena (aurrebista)