Portālu atbalsts pakalpojumam Microsoft Power Platform CLI
Piezīme
No 2022. gada 12. oktobra, Power Apps portāli ir Power Pages. Papildinformācija. Pakalpojums Microsoft Power Pages tagad ir vispārēji pieejams (emuārs)
Drīzumā Power Apps portālu dokumentācija tiks migrēta un sapludināta ar Power Pages dokumentāciju.
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. Papildinformāciju skatiet Kas ir Microsoft Power Platform CLI?
Izmantojot šo līdzekli, portāli atbalsta Microsoft Power Apps CLI, Microsoft Power Platform lai iespējotu portāla konfigurācijas CI/CD (nepārtraukta integrācija/nepārtraukta izvietošana). Tagad varat pārbaudīt portāla konfigurāciju, lai iegūtu avota vadīklu, un pārvietot portāla konfigurāciju uz jebkuru vidi, izmantojot Microsoft Power Platform CLI.
Piezīme
Šis līdzeklis ir pieejams, sākot ar Power Platform CLI versiju 1.9.8. Informāciju par jaunākās versijas instalēšanu skatiet sadaļā Microsoft Power Platform CLI instalēšana.
Kāpēc Microsoft Power Platform CLI tiek izmantots portālu izstrādei?
Izmantojot portālu atbalstu Microsoft Power Platform CLI, tagad portālu pielāgošanai varat izmantot bezsaistei līdzīgas iespējas, veicot izmaiņas portālu saturā. Un, kad visi pielāgojumi vai izmaiņas ir saglabātas, augšupielādējiet tos portālā. Kad lejupielādējat portālu 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 portāla 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 portāla 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 līdz tabulām, kas norādītas tālāk.
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 |
---|---|---|
saraksts | Uzskaitiet visas pašreizējās Dataverse vides portāla tīmekļa vietnes. | pac paportal list |
lejupielādēt | Lejupielādēt portāla tīmekļa vietnes saturu no pašreizējās Dataverse vides. Tam ir šādi parametri: - path: Ceļš, kurā tiks lejupielādēts tīmekļa vietnes saturs (alias: -p) - webSiteId: lejupielādējamās portāla vietnes ID (alias: -id) - pārrakstīt: (neobligāti) patiess — lai pārrakstītu esošo saturu, nepatiesi — neizdoties, ja mapē jau ir vietnes saturs (alias: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
augšupielādēt | Lejupielādēt portāla tīmekļa vietnes saturu no pašreizējās Dataverse vides. Tam ir šādi parametri: - path: Ceļš, kurā tiks 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 izvietošanas-profilos/[profila-nosaukums].deployment.yaml failu |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
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 izvietošanas profilos 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
Š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īme
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 jūs lejupielādējat vietnes saturu, izmantojot pac paportal CLI lejupielādi, kopā ar vietnes satura lejupielādi tiks ģenerēti arī divi faili;
- 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šās vides manifesta failu un atjaunina vidē izdzēstos ierakstus vai izveido vides manifesta failu, ja tā nav.
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ā.
Kad vides fails būs savienots ar to pašu vidi (vides URL atbilst faila nosaukumam), fails būs tikai lasāms, lai izvairītos no nejaušām izmaiņām.
Dzēsiet manifestācijas faila izsekošanu (manifest.yml)
Šis fails tiek izmantots, lai izsekotu izdzēstos ierakstus no vides.
Kad vietnes saturs tiek lejupielādēts ar komandu pac paportal lejupielāde, šis fails ielādē izdzēstos ierakstus no vides manifestācijas faila (org-url-dzīvoklis.yml) manifest.yml failā. Tāpēc, kad augšupielādējat vietnes saturu, izmantojot komandu pac paportal augšupielāde, faili tiks izdzēsti no vides (pat citā vidē). Šis fails netiek izdzēsts, un tas tiek izmantots neatkarīgi no tā, kurā vidē ir izveidots savienojums.
Piezīme
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 koda paplašinājumu VS koda paplašinājumu Power Platform, lai gūtu labumu no iebūvētās šķidrās valodas no IntelliSense, koda pabeigšanas palīdzības, mājieniem un mijiedarbības Microsoft Power Platform ar CLI, izmantojot VS koda integrēto termināli. Papildinformācija: Visual Studio Code paplašinājuma izmantošana (priekšskatījums)
Papildu 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—ar tīmekļa lapas nosaukumu un otru ar tādu pašu nosaukumu, kam prefikss ir mirkļkods. 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