Tutorial: Utilizarea Microsoft Power Platform CLI cu Power Pages

În acest tutorial, învățați cum să începeți să utilizați Microsoft Power Platform CLI pentru a actualiza configurația unui exemplu de site web.

Descărcare și instalare Visual Studio Code

Pentru a vă conecta la portaluri Power Apps și a utiliza comenzi Microsoft Power Platform CLI, utilizați Visual Studio Code și terminal integrat. Terminalul integrat facilitează conectarea la mediul Dataverse și descărcarea, modificarea și încărcarea configurației portalurilor. De asemenea, puteți utiliza Windows PowerShell.

Pasul 1. Autentificați

Înainte de a vă conecta, lista, descărca sau încărca orice modificări pentru un portal Power Apps, trebuie mai întâi să vă autentificați la mediul Dataverse. Pentru mai multe informații despre autentificare folosind Microsoft Power Platform CLI, accesați pac auth.

Pentru autentificare, deschideți Windows PowerShell și rulați comanda pac auth create folosind adresa URL a mediului Dataverse:

pac auth create -u [Dataverse URL]

Exemplu

pac auth create -u https://contoso-org.crm.dynamics.com

Urmați solicitările de autentificare pentru a vă conecta la mediu.

Pasul 2. Listarea siteurilor web disponibile

Utilizați comanda pac powerpages list pentru a lista Power Pages site-urile web disponibile în Dataverse mediul la care v-ați conectat în pas anterior.

pac powerpages list

Pasul 3. Descărcați conținutul site-ului web

Descărcați conținutul site-ului web din mediul Dataverse conectat folosind comanda pac powerpages download .

pac powerpages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Exemplu

pac powerpages download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141 --modelVersion 2

Pentru parametrul id, utilizați WebSiteId returnat de la ieșirea pasului anterior.

Pasul 4. Modificarea conținutului site-ului web

Schimbați configurația folosind Visual Studio Code și salvați modificările.

De exemplu, pagina implicită a portalului afișează un text ca acesta:

Acest text este vizibil de pe pagina web html:

Puteți modifica acest text și salva modificările:

Pasul 5. Încărcați modificările

După ce faceți modificările necesare, încărcați-le utilizând comanda pac powerpages upload :

pac powerpages upload --path [Folder-location] --modelVersion [ModelVersion]

Exemplu

pac powerpages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

Încărcarea are loc numai pentru conținutul care este modificat. În acest exemplu, deoarece modificarea se face unei pagini web, conținutul este încărcat numai pentru tabelul adx_webpage.

Încărcați modificările folosind profilul de implementare

Când lucrați cu mai multe medii diferite, puteți lua în considerare utilizarea profilurilor de implementare pentru a vă asigura că modificările sunt încărcate în mediul corect folosind profilul de implementare.

1. Creați un folder numit profiluri de implementare în interiorul folderului care conține conținutul portalului. De exemplu, dacă conținutul portalului descărcat se află în „portalul pentru începători”, folderul de profiluri de implementare ar trebui să fie în acest folder.

   

2. În dosarul Profiluri de implementare, creați un fișier YAML de implementare care conține modificările specifice mediului. De exemplu, mediul de dezvoltare poate fi numit „dev.deployment.yml”.

   

3. Editați fișierul YAML de implementare folosind Visual Studio Code cu următorul format:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   De exemplu, următorul exemplu de cod YAML actualizează valoarea pentru „Browser Title Suffix” de la „Custom Portal” implicit la „Custom Portal (Dev)”.

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Pentru a încărca modificările într-un mediu diferit utilizând un fișier YAML al profilului de implementare, autentificare mai întâi către organizația țintă.

5. După ce v-ați autentificat și conectat la mediul corect, utilizați comanda pac powerpages upload pentru a încărca conținutul:

   pac powerpages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

   Notă

   În exemplul de mai sus, numele profilului de implementare folosit este „dev” după ce ați urmat pașii anteriori pentru a crea un profil de implementare. Schimbați numele din „dev” în oricare altul (cum ar fi QA pentru „qa.deployment.yml”, sau Test pentru „test.deployment.yml”) dacă ați folosit un alt nume de fișier pentru fișierul YAML de implementare.

Pasul 6. Confirmați modificările

Pentru a confirma modificările aduse paginii web:

1. Selectați Sincronizare în studioul de proiectare Power Pages.

2. Pentru a vedea modificarea, navigați la pagina web.

   

3. Dacă ați folosit exemplul de profil de implementare explicat anterior, YAML fragment actualizează valoarea așa cum se arată în următoarea captură de ecran.

   

   Sufixul titlului browserului actualizat prin modificarea de mai sus arată modificarea atunci când deschideți portalul într-un browser:

   

Aceasta conclude tutorialul. Puteți repeta pașii de mai sus și puteți schimba conținutul portalurilor cu alte tabele acceptate.

Pașii următori

Utilizați extensia Visual Studio Cod

Consultați și

• Microsoft Power Platform CLI
• Utilizați extensia Visual Studio Cod