Microsoft Power Platform CLI atbalsts programmai Power Pages
Microsoft Power Platform CLI (komandrindu interfeiss) ir vienkāršs, vienas apturēšanas izstrādātāja komandrindu interfeiss, kas izstrādātājiem un programmu veidotājiem sniedz iespēju izveidot koda komponentus.
Microsoft Power Platform CLI rīku izmantošana ir pirmais solis uz visaptverošu lietojumprogrammas dzīves cikla pārvaldības (ALM) uzsācību, kurā uzņēmumu izstrādātāji un ISV var ātri un efektīvi izveidot, būvēt, atkļūdot un publicēt to paplašinājumus un pielāgojumus. Lai iegūtu papildinformāciju, dodieties uz Kas ir Microsoft Power Platform CLI?
Izmantojot šo līdzekli, Microsoft Power Platform CLI iespējo Power Pages vietnes konfigurācijas CI/CD (nepārtraukta integrācija/nepārtraukta izvietošana). Tagad varat veikt pārbaudi vietnes konfigurācijā, lai kontrolētu avotu, un pārvietot vietnes konfigurāciju uz jebkuru vidi, izmantojot Microsoft Power Platform CLI.
Piezīmes
- Šis līdzeklis ir pieejams, sākot ar Power Platform CLI versiju 1.9.8. Lai uzzinātu par jaunākās versijas instalēšanu, dodieties uz CLI instalēšana Microsoft Power Platform .
- Sākot ar Power Platform CLI versiju 1.27, komanda tiek mainīta
pac paportal
uzpac powerpages
.paportal
turpina strādāt, bet mēs iesakām izmantotpowerpages
turpmāk. Šis raksts drīz tiks atjaunināts, lai to izmantotupowerpages
paportal
.
Kāpēc Microsoft Power Platform CLI tiek izmantots vietnes izstrādei?
Izmantojot Microsoft Power Platform CLI, tagad vietnes pielāgošanai varat izmantot bezsaistei līdzīgas iespējas, veicot izmaiņas vietnes saturā. Un, kad visi pielāgojumi vai izmaiņas ir saglabātas, varat augšupielādēt vietnes konfigurāciju atpakaļ programmā Microsoft Dataverse. Kad lejupielādējat vietnes saturu, izmantojot Microsoft Power Platform CLI, saturs tiek strukturēts YAML un HTML formātos, ļaujot to viegli pielāgot, iespējojot profesionālās izstrādes pieredzi.
Tālāk ir saraksts ar līdzekļiem un iespējām, kuras portāli gūst, izmantojot atbalstu saistībā ar Microsoft Power Platform CLI:
Lietošanas ērtums
Atbalsts vietnes konfigurācijas datu lejupielādei/augšupielādei/no lokālās failu sistēmas
Izmantojiet esošu Microsoft Power Platform CLI rīku.
Lietojumprogrammu dzīves cikla pārvaldība (ALM)
Sekot izmaiņām vietnes konfigurācijā organizācijā
Konfigurācijas failu pārvietošana pa organizācijām vai nomniekiem
Pro-dev un enterprise atbalsts
Palīdz netraucēti integrēties ar visiem avota vadības rīkiem, piemēram, "git"
Viegli iestatīt CI/CD konveijerus
Instalēt Microsoft Power Platform CLI
Detalizētus norādījumus skatiet rakstā Microsoft Power Platform CLI instalēšana.
Atbalstītās tabulas
Portālu atbalsts Microsoft Power Platform CLI ir ierobežots ar tālāk norādītajām tabulām.
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 (tikai lejupielāde)
adx_websitelanguage
adx_webtemplate
anotācija
Svarīgi
- Pielāgošanai netiek atbalstītas pielāgotas tabulas un no portāla veidnēm pielāgotas tabulas (piemēram, emuāru, kopienas vai ideju portāli), izmantojot Microsoft Power Platform CLI.
- Izmantojot Power Platform CLI, netiek lejupielādēti attēlu failu pielikumi reklāmu ierakstiem (adx_ad). Kā risinājumu izmantojiet Attēla URL lauku vai pievienojiet HTML atsauci Kopēšanas laukā tīmekļa faila ierakstam, kurā ir attēla fails.
Portālu Microsoft Power Platform CLI instalēšana un pārbaude
Lai uzzinātu par Microsoft Power Platform CLI instalēšanu, dodieties uz Instalēt Microsoft Power Platform CLI.
Pēc Microsoft Power Platform CLI instalēšanas atveriet komandu uzvedni un palaidiet pac, lai pārbaudītu, vai izvadē ir "paportal" - komanda Power Apps portāliem.
Microsoft Power Platform CLI komandas portāliem
Microsoft Power Platform CLI komanda portāliem ir "paportal".
Nākamajās sadaļās ir sniegta papildinformācija par dažādiem komandas "paportal" rekvizītiem.
Parameters
Rekvizīta nosaukums | Apraksts | Piemērs |
---|---|---|
list | Uzskaitiet visas pašreizējās Dataverse vides portāla tīmekļa vietnes. Var pievienot parametru v , lai norādītu, vai vietne izmanto standarta vai paplašināto datu modeli |
pac paportal list |
download | Lejupielādēt portāla tīmekļa vietnes saturu no pašreizējās Dataverse vides. Tam ir šādi parametri: - ceļš: ceļš, pa kuru tiek lejupielādēts tīmekļa vietnes saturs (aizstājvārds: -p) - webSiteId: lejupielādējamās portāla vietnes ID (alias: -id) - overwrite: (neobligāti) true — lai pārrakstītu esošo saturu, false — neizdoties, ja mapē jau ir vietnes saturs (alias: -o) - modelVersion:vai 1 , lai norādītu, 2 vai lejupielādējamie vietnes dati izmanto standarta (1) vai uzlaboto datu modeli (2). |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2 |
upload | Lejupielādēt portāla tīmekļa vietnes saturu no pašreizējās Dataverse vides. Tam ir šādi parametri: - path: ceļš, kurā tiek glabāts tīmekļa vietnes saturs (alias: -p) - deploymentProfile: augšupielādējiet portāla datus ar vides informāciju, kas definēta, izmantojot profila mainīgos failā deployment-profiles/[profile-name].deployment.yaml - modelVersion:vai 1 , lai norādītu, 2 vai augšupielādējamie vietnes dati izmanto standarta (1) vai uzlaboto datu modeli (2). |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2 |
Izvietošanas profila izmantošana
Slēdzis deploymentProfile ļauj definēt mainīgo kopu videi YAML formātā. Piemēram, var būt dažādi izvietošanas profili (piemēram, dev, test, prod), kam profilā ir definēti dažādi shēmas dati.
Ja veidojat testa profilu, varat izveidot failu sadaļā deployment-profiles ar nosaukumu "test.deployment.yml" (tas ir, <profileTag>.deployment.yml). Un varat izpildīt komandu ar atzīmi (<profileTag>), lai izmantotu šo profilu:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2
Šajā failā var būt tabulas (entītijas) nosaukums ar tabulas ID, atribūtu saraksts un vērtības, ko vēlaties ignorēt, augšupielādējot portāla konfigurāciju, izmantojot deploymentProfile
parametru.
OS
mainīgo var izmantot arī, lai piekļūtu operētājsistēmas vides mainīgajiem.
Šeit parādīts "test.deployment.yml" profila YAML fails ar unikālu shēmas informāciju:
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
Piezīmes
Lai uzzinātu vairāk par visām CLI komandām, kas tiek izmantotas papildus portāliem, dodieties uz Bieži izmantotās komandas Microsoft Power Platform CLI.
Failu manifestācija
Kad lejupielādējat vietnes saturu, izmantojot komandu pac paportal download CLI, kā arī lejupielādējot vietnes saturu, tas ģenerē arī divus manifesta failus;
- Vides anifestācijas fails (org-url-manifest.yml)
- Dzēsiet manifestācijas faila izsekošanu (manifest.yml)
Vides anifestācijas fails (org-url-manifest.yml)
Kad tiek palaista pac paportal lejupielādes komanda, ik reizi tiek ģenerēts vides manifestācijas fails.
Pēc katras lejupielādes PAC CLI rīks nolasa esošo vides manifesta failu un atjaunina ierakstus, kas ir izdzēsti vidē, vai arī izveido vides manifesta failu, ja tāds nepastāv.
Izpildot komandu pac paportal augšupielāde, lai augšupielādētu portāla vietnes saturu. Tā nolasa vides manifestācijas failu un identificē kopš pēdējās lejupielādes veiktās izmaiņas un augšupielādē tikai atjaunināto saturu. Tas palīdz optimizēt augšupielādes procesu, jo tiek augšupielādēts tikai atjauninātais vietnes saturs, nevis augšupielādē visu saturu katrā augšupielādes komandā.
Lai izvairītos no nejaušām izmaiņām, vides manifesta fails tiek lasīts tikai tad, kad tas izveido savienojumu ar to pašu vidi (vides URL atbilst faila nosaukumam).
Piezīmes
- Kad vietne tiek izvietota dažādās vidēs, vides manifesta fails nav izstrādāts, lai sekotu izmaiņām.
- Vides manifesta fails ir izstrādāts tā, lai izstrādātāji to varētu izmantot, lai izvietotu lokāli savā izstrādātāju vidē, un tas ir jāpievieno sarakstam "git ignore".
Dzēsiet manifestācijas faila izsekošanu (manifest.yml)
Šis fails tiek izmantots, lai izsekotu izdzēstos ierakstus no vides.
Kad tīmekļa vietnes saturs tiek lejupielādēts ar komandu pac paportal download , tas pievieno izdzēstos ierakstus no vides manifesta faila (org-url-manifest.yml) manifest.yml failam. Tātad, augšupielādējot vietnes saturu, izmantojot pac paportal augšupielādes komandu, tas izdzēš failus no vides (pat uz citu vidi). Šis fails nav izdzēsts, un tas tiek izmantots neatkarīgi no tā, kurā vidē ir izveidots savienojums. Šis fails ir jāapsver, veicot izmaiņas avota vadīklā, lai ņemtu vērā elementu dzēšanu mērķa vidē.
Piezīmes
Lai vietnes satura ierakstus izdzēstu vienā vidē un dzēstu tos pašus satura ierakstus citā vidē, izmantojot PAC CLI, jums vajadzēs palaist komandu pac paportal lejupielāde pirms un pēc vietnes ieraksta satura dzēšanas. Kad tiek palaista komanda pac paportal augšupielāde, jūs izsekosit šīs izmaiņas un noņemsiet atbilstošos ierakstus mērķa vidē.
Visual Studio Code paplašinājuma izmantošana
Varat arī izmantot VS Code paplašinājumu Power Platform VS Code paplašinājums, lai varētu izmantot iebūvēto Liquid valodu no IntelliSense, koda pabeigšanas palīdzību, kā arī mijiedarboties ar Microsoft Power Platform CLI, izmantojot VS Code integrēto termināli. Papildinformācija: Visual Studio Code paplašinājuma izmantošana (priekšskatījums)
Citi apsvērumi
- Tiek ziņots par kļūdu, ja faila ceļš pārsniedz maksimālo ceļa garuma ierobežojumu. Papildinformācija: Maksimālais ceļa garuma ierobežojums sistēmā Windows
- Attiecībā uz ierakstu dublikātiem, piemēram, tīmekļa lapas nosaukuma dublikātu, Microsoft Power Platform CLI izveido divas dažādas mapes: vienu ar tīmekļa lapas nosaukumu un otru ar tādu pašu nosaukumu, kam prefikss ir jaucējkods. Piemēram, "Mana lapa" un "Manas lapas-hash-code".
Nākamās darbības
Apmācība: Microsoft Power Platform CLI izmantošana portālos