Microsoft Power Platform CLI-rako atarien laguntza-zerbitzua
Oharra
2022ko urriaren 12tik aurrera, Power Pages izango da Power Apps atarien izen berria. Informazio gehiago: Microsoft Power Pages erabilgarri dago modu orokorrean (bloga)
Laster migratuko eta konbinatuko dugu Power Apps atarien dokumentazioa Power Pages dokumentazioarekin.
Microsoft Power Platform CLI (Command Line Interface) garatzaileen geldialdi bakarreko komando-lerroaren interfaze sinplea da, garatzaileei eta aplikazioen egileei 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 gehiagorako, ikusi Zer da Microsoft Power Platform CLI?
Ezaugarri honekin, Microsoft Power Apps portalek Microsoft Power Platform CLI onartzen dute atariaren konfigurazioaren CI/CD (Etengabeko Integrazioa/Etengabeko Hedapena) gaitzeko. Orain atariaren konfigurazioa egiaztatu dezakezu iturburua kontrolatzeko eta atariaren konfigurazioa edozein ingurunetara eraman dezakezu Microsoft Power Platform CLI erabiliz.
Oharra
Ezaugarri hau, oro har, erabilgarri dago Power Platform CLI bertsioa 1.9.8. Azken bertsioa instalatzeari buruz jakiteko, ikus Instalatu Microsoft Power Platform CLI.
Zergatik erabili Microsoft Power Platform Atariak garatzeko CLIa?
Atarietarako euskarriarekin Microsoft Power Platform CLI, lineaz kanpoko moduko gaitasuna erabil dezakezu atariak pertsonalizatzeko atarien edukian aldaketak eginez. Eta pertsonalizazio edo aldaketa guztiak gorde ondoren, igo atarira. Erabiliz atarien 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
Atariko datuak tokiko fitxategi sistemara / bertatik deskargatzeko / kargatzeko laguntza
Existitzen denaren gainean eraiki Microsoft Power Platform CLI tresna.
Aplikazioen bizi-zikloaren kudeaketa (ALM)
Atariaren 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
Atarien laguntza Microsoft Power Platform CLI behean zerrendatutako tauletara mugatuta dago.
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
oharra
Garrantzitsua
- Taula pertsonalizatuak eta atariko txantiloien araberako taulak (esaterako, bloga, komunitatea edo ideien ataria) ez dira onartzen pertsonalizatzeko Microsoft Power Platform CLI.
- Iragarkien erregistroen irudi-fitxategien eranskinak (adx_ad) ez dira deskargatzen erabiliz Power Platform CLI. 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. | pac paportal list |
| deskargatu | Deskargatu atariaren webguneko edukia uneko Dataverse ingurunetik. Honako parametro hauek ditu: - path: webguneko edukia deskargatuko den bide-izena (aliasa: -p) - webSiteId: atariaren webgunearen IDa deskargatzeko (aliasa: -id) - overwrite: (aukerakoa) egia - dagoen edukia gainidazteko, faltsua - huts egiteak karpetak dagoeneko webguneko edukia badu (aliasa: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| kargatu | Kargatu atariaren webguneko edukia uneko Dataverse ingurunera. Honako parametro hau du: - path: webguneko edukia gordeta duen bide-izena (aliasa: -p). -deploymentProfile: Kargatu atariko datuak inguruneko xehetasunekin definituta profil aldagaiak deployment-profiles/[profile-name].deployment.yaml fitxategian |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
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 paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
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 erabiliz deskargatzen duzunean pac paportal download CLI komandoa, gunearen edukia deskargatzearekin batera bi manifestu-fitxategi ere sortuko ditu;
- Inguruneko manifestu fitxategia (org-url-manifest.yml)
- Ezabatu jarraipen-fitxategia (manifest.yml)
Inguruneko manifestu fitxategia (org-url-manifest.yml)
Inguruneko manifestu-fitxategia sortzen da pac paportal download komandoa exekutatzen 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.
Exekutatzen duzunean pac paportal upload komandoa atariko webgunearen edukia kargatzeko. 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.
Inguruneko manifestu fitxategia irakurtzeko soilik izango da ingurune berera konektatzen denean (ingurunearen URLa fitxategi-izenarekin bat dator), ustekabeko aldaketak ekiditeko.
Ezabatu jarraipen-fitxategia (manifest.yml)
Fitxategi hau ingurunetik ezabatutako erregistroen jarraipena egiteko erabiltzen da.
Webgunearen edukia deskargatzen denean pac paportal download komandoa, honek ezabatutako erregistroak gehituko ditu inguruneko manifestu-fitxategia (org-url-manifest.yml) manifest.yml fitxategira. Beraz, webgunearen edukia kargatzen duzunean pac paportal upload komandoak fitxategiak ezabatuko ditu ingurunetik (nahiz eta beste ingurune batera). Fitxategi hau ez da ezabatzen, eta konektatuta zauden ingurunea edozein dela ere erabiltzen da.
Oharra
Ingurune batean guneko eduki-erregistroak ezabatzeko eta beste ingurune bateko eduki-erregistroak ere ezabatzeko PAC CLI erabiliz, exekutatu beharko duzu pac paportal download agindua aurretik eta ondoren webguneko erregistroaren edukia ezabatzea. Manifest.yml-k aldaketa horien jarraipena egingo du eta xede-ingurunean dagozkien erregistroak kenduko ditu pac paportal upload komandoa exekutatzen da.
Erabili Visual Studio Code-ren luzapena
You can also use VS Code extension Power Platform VS Code Extension to benefit built-in Liquid language from IntelliSense, code completion assistance, hinting, and interact with the Microsoft Power Platform CLI using the VS Code Integrated Terminal. Informazio gehiago: Erabili Visual Studio Code luzapena (aurrebista)
Considerations gehigarria
- 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 CLIak 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 Microsoft Power Platform CLIa atariekin
Ikus baita ere
Oharrak
Laster erabilgarri: 2024an, GitHub-eko arazoak edukiari buruzko oharrak bidaltzeko mekanismo gisa kenduko dugu apurka-apurka, eta oharrak bidaltzeko sistema berri batekin ordeztuko. Informazio gehiagorako, ikusi: https://aka.ms/ContentUserFeedback.
Bidali eta ikusi honi buruzko oharrak: