Tutorial: Utilitzar el Microsoft Power Platform CLI amb portals

En aquest tutorial d'exemple, veureu com començar amb la CLI del Microsoft Power Platform per actualitzar la configuració dels portals d'exemple.

Baixar i instal·lar el Visual Studio Code

Per connectar-vos als portals del Power Apps i per utilitzar les ordres de la CLI del Microsoft Power Platform, utilitzeu el Visual Studio Code i el terminal integrat. El terminal integrat facilita la connexió amb l'entorn del Dataverse i la descàrrega, modificació i càrrega de la configuració dels portals. També podeu utilitzar el Windows PowerShell en el seu lloc.

Pas 1. Autenticar

Abans de connectar-vos, enumerar, baixar o pujar qualsevol canvi per a un portal del Power Apps, primer heu d'autenticar-vos a l'entorn del Dataverse. Per obtenir més informació sobre l'autenticació mitjançant la CLI del Microsoft Power Platform, aneu a pac auth.

Per autenticar-vos, obriu el Windows PowerShell i executeu l'ordre pac auth create utilitzant l'URL de l'entorn del Dataverse:

pac auth create -u [Dataverse URL]

Exemple

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

Seguiu les indicacions d'autenticació per iniciar la sessió a l'entorn.

Pas 2. Enumerar els portals disponibles

Utilitzeu l'ordre pac paportal list per enumerar els portals del Power Apps disponibles a l'entorn del Dataverse al qual us heu connectat en el pas anterior.

pac paportal list

Pas 3. Baixar el contingut dels portals

Baixeu el contingut del lloc web del portal de l'entorn del Dataverse connectat mitjançant l'ordre pac paportal download.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Exemple

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

Per al paràmetre id, utilitzeu el valor WebSiteId retornat de la sortida del pas anterior.

Pas 4. Canviar el contingut dels portals

Canvieu la configuració utilitzant el Visual Studio Code i deseu els canvis.

Per exemple, la pàgina del portal per defecte mostra text com aquest:

Aquest text és visible des de la pàgina web html:

Podeu alterar aquest text i desar-ne els canvis:

Pas 5. Pujar els canvis

Després de fer els canvis necessaris, pugeu-los utilitzant l'ordre pac paportal upload:

pac paportal upload --path [Folder-location]

Exemple

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Només es carrega el contingut que s'ha canviat. En aquest exemple, com que el canvi es fa a una pàgina web, el contingut només es carrega per a la taula adx_webpage.

Carregar els canvis mitjançant el perfil d'implementació

Quan treballeu amb diversos entorns diferents, podeu considerar utilitzar perfils d'implementació per garantir que els canvis es carreguin a l'entorn correcte utilitzant el perfil d'implementació.

1. Creeu una carpeta anomenada perfils d'implementació dins de la carpeta del contingut del portal. Per exemple, si el contingut del portal baixat és a "starter-portal", la carpeta de perfils d'implementació hauria d'estar dins d'aquesta carpeta.

   

2. Dins de la carpeta de perfils d'implementació, creeu un fitxer YAML d'implementació que contingui els canvis específics de l'entorn. Per exemple, l'entorn de desenvolupament es pot anomenar "dev.deployment.yml".

   

3. Editeu el fitxer YAML d'implementació mitjançant el Visual Studio Code amb el format següent:

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

   Per exemple, el codi YAML següent actualitza el valor del valor de "Sufix de títol del navegador" del valor per defecte "Portal personalitzat" a "Portal personalitzat (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. Per carregar els canvis a un entorn diferent mitjançant un fitxer YAML de perfil d'implementació, primer heu d'autenticar-lo a l'organització de destinació.

5. Després d'autenticar-lo i connectar-lo a l'entorn correcte, utilitzeu l'ordre pac paportal upload per carregar el contingut:

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

   Nota

   A l'exemple anterior, el nom del perfil d'implementació utilitzat és "dev" després de seguir els passos anteriors per crear un perfil d'implementació dev. Canvieu el nom "dev" per qualsevol altre (com ara QA per a "qa.deployment.yml" o Prova per a "test.deployment.yml") si heu utilitzat un nom de fitxer diferent per al fitxer YAML d'implementació.

Pas 6. Confirmar els canvis

Per confirmar els canvis fets a la pàgina web del portal:

1. Esborreu la memòria cau del servidor o utilitzeu Sincronitza la configuració amb l'estudi de portals del Power Apps.

2. Navegueu a la pàgina web del portal per veure el canvi.

   

3. Si heu utilitzat l'exemple del perfil d'implementació explicat anteriorment, el fragment YAML actualitzarà el valor com es mostra a continuació.

   

   El sufix de títol del navegador actualitzat amb el canvi anterior mostra el canvi quan obriu el portal en un navegador:

   

Això conclou el tutorial. Podeu repetir els passos anteriors i canviar el contingut dels portals per a altres taules compatibles.

Passos següents

Utilitzar l'extensió del Visual Studio Code

Consulteu també

• Microsoft Power Platform CLI
• Utilitzar l'extensió del Visual Studio Code (versió preliminar)