Asistență de portaluri pentru Microsoft Power Platform CLI

Microsoft Power Platform CLI (Command Line Interface) este o interfață de linie de comandă pentru dezvoltatori simplă, cu o singură oprire, care permite dezvoltatorilor și persoanelor care creează aplicații să creeze componente de cod.

Instrumentele Microsoft Power Platform CLI reprezintă primul pas către o poveste comprehensivă de gestionare a ciclului de viață a aplicațiilor (ALM) în care dezvoltatorii de întreprindere și ISV-urile pot crea, construi, depana și publica extensiile și particularizările lor rapid și eficient. Pentru mai multe informații, consultați Ce este Microsoft Power Platform CLI?

Cu această caracteristică, Microsoft Power Apps portals acceptă Microsoft Power Platform CLI pentru a activa CI/CD (integrare continuă/implementare continuă) a configurației portalului. Acum puteți verifica configurația portalului pentru controlul sursei și mutați configurația portalului în orice mediu folosind Microsoft Power Platform CLI.

De ce să folosești Microsoft Power Platform CLI pentru dezvoltarea portalurilor?

Cu asistență de portaluri pentru Microsoft Power Platform CLI, puteți utiliza acum capacitatea offline pentru particularizarea portalurilor, modificând conținutul portalurilor. Și odată ce toate particularizările sau modificările sunt salvate, încărcați-le pe portal. Când descărcați conținut de portaluri folosind Microsoft Power Platform CLI, conținutul este structurat în formate YAML și HTML, făcându-l ușor de particularizat, permițând o experiență pro-dezvoltare.

Iată o listă de caracteristici și capabilități de care beneficiază portalurile, cu ajutorul Microsoft Power Platform CLI:

Ușurință în utilizare

• Asistență la descărcarea/încărcarea datelor portalului către/din sistemul de fișiere local

• Instrumentul Construiți pe Microsoft Power Platform CLI existent.

Gestionarea ciclului de viață al aplicațiilor (ALM)

• Urmăriți modificările la configurația portalului în cadrul unei organizații

• Mutați fișierele de configurare între organizații sau entități găzduite

Pro-dezv și asistență pentru întreprinderi

• Ajută la integrarea perfectă cu orice instrumente de control sursă, cum ar fi „git”

• Configurați cu ușurință canalele CI/CD

Instalare Microsoft Power Platform CLI

Pentru instrucțiuni pas cu pas, consultați Instalare Microsoft Power Platform CLI.

Tabele acceptate

Asistența portaluri pentru Microsoft Power Platform CLI este limitată la tabelele enumerate mai jos.

Instalați și verificați Microsoft Power Platform CLI pentru portaluri

Pentru a afla mai multe despre instalarea Microsoft Power Platform CLI, accesați Instalare Microsoft Power Platform CLI.

După instalarea Microsoft Power Platform CLI, deschideți o solicitare de comandă și rulați pac pentru a verifica dacă ieșirea conține „paportal” - comanda pentru portaluri Power Apps.

Comenzi Microsoft Power Platform CLI pentru portaluri

Comanda Microsoft Power Platform CLI pentru portaluri este „paportal".

Următoarele secțiuni furnizează mai multe detalii despre diferitele proprietăți ale comenzii „paportal”.

Parametri

Utilizați profilul de implementare

Comutatorul deploymentProfile vă permite să definiți un set de variabile pentru mediu în format YAML. De exemplu, puteți avea diferite profiluri de implementare (cum ar fi dev, test, prod) care au diferite detalii de schemă definite în profil.

Dacă creați profilul de test, puteți crea fișierul în profiluri de implementare cu numele „test.deployment.yml” (adică <profileTag>.deployment.yml). Și puteți rula comanda cu etichetă (<profileTag>) pentru a utiliza acest profil:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test

În acest fișier, puteți avea numele tabelului (entitatea) cu ID-ul tabelului, lista de atribute și valorile pe care doriți să le suprascrieți în timp ce încărcați configurația portalului utilizând parametrul deploymentProfile.

În plus, puteți utiliza variabila OS pentru a accesa variabilele de mediu ale sistemului de operare.

Iată un exemplu al acestui fișier YAML de profil „test.deployment.yml” care are detalii de schemă unice:

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

Fișiere manifest

Când descărcați conținutul site-ului folosind comanda descărcare pac paportal CLI, împreună cu descărcarea conținutului site-ului, va genera și două fișiere manifest;

• Fișierul manifest de mediu (org-url-manifest.yml)
• Ștergeți fișierul manifest de urmărire (manifest.yml)

Fișierul manifest de mediu (org-url-manifest.yml)

Fișierul manifest de mediu este generat de fiecare dată când comanda descărcare pac paportal este rulată.

După fiecare descărcare, instrumentul PAC CLI citește fișierul manifest de mediu existent și actualizează intrările șterse din mediu sau creează fișierul manifest de mediu dacă acesta nu există.

Când rulați comanda încărcare pac paportal pentru a încărca conținutul site-ului web al portalului. Citiție fișierul manifest de mediu și identificați modificările efectuate de la ultima descărcare și încărcați numai conținutul actualizat. Acest lucru ajută la optimizarea procesului de încărcare, deoarece este încărcat numai conținutul actualizat al site-ului web, în loc să încărcați tot conținutul de la fiecare comandă de încărcare.

Fișierul manifest de mediu va fi doar citit atunci când se conectează la același mediu (URL-ul mediului se potrivește cu numele fișierului), pentru a evita modificări accidentale.

Ștergeți fișierul manifest de urmărire (manifest.yml)

Acest fișier este utilizat pentru urmărirea înregistrărilor șterse din mediu.

Când conținutul site-ului este descărcat cu comanda descărcare pac paportal, aceasta va adăuga înregistrările șterse din fișierul manifest de mediu (org-url-manifest.yml) la fișierul manifest.yml. Deci, atunci când încărcați conținutul site-ului web folosind comanda încărcare pac paportal va șterge fișierele din mediu (chiar și într-un mediu diferit). Acest fișier nu este șters și este utilizat indiferent de mediul la care sunteți conectat.

Folosiți extensia Visual Studio Code

De asemenea, puteți utiliza extensia VS Code Power Platform VS Code Extension pentru a beneficia de limbajul Liquid încorporat de la IntelliSense, asistență pentru completarea codului, sugestii și interacțiune cu Microsoft Power Platform CLI folosind terminalul integrat VS Code. Mai multe informatii: Folosiți Extensia Visual Studio Code (versiune preliminară)

Considerații suplimentare

• Este raportată o eroare dacă calea fișierului dvs. depășește limita maximă a lungimii căii. Mai multe informații: Limitarea lungimii căii maxime în Windows
• Pentru înregistrări duplicate, cum ar fi un nume de pagină web duplicat, Microsoft Power Platform CLI creează două foldere diferite—unul cu numele paginii web și celălalt cu același nume cu prefix cu un cod hash. De exemplu, „Pagina mea” și „Pagina mea-cod hash".

Pașii următori

Tutorial: Utilizarea Microsoft Power Platform CLI cu portaluri

Consultați și

• Microsoft Power Platform CLI
• Folosiți extensie Visual Studio Code (versiune preliminară)