Kopīgot, izmantojot


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.

Komandas paportal apstiprināšana programmā Microsoft Power Platform CLI.

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

Skatiet arī