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 uz pac powerpages. paportal turpina strādāt, bet mēs iesakām izmantot powerpages turpmāk. Šis raksts drīz tiks atjaunināts, lai to izmantotu powerpagespaportal.

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ādepirms 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

Skatiet arī:

• Microsoft Power Platform CLI
• Visual Studio Code paplašinājuma (priekšskatījums) izmantošana