Tutorial: Ús del Microsoft Power Platform CLI amb el Power Pages

En aquest tutorial, apreneu a començar a utilitzar el CLI per actualitzar la Microsoft Power Platform configuració d'un lloc web d'exemple.

Nota

• Aquest tutorial se centra en les ordres de Microsoft Power Platform CLI necessàries per a l'ús de Power Pages. Per obtenir més informació sobre les ordres utilitzades al Power Platform CLI, llegiu Ordres habituals.
• A partir de la Power Platform versió 1.27 de CLI, l'ordre pac paportal es canvia a pac powerpages. paportal continua funcionant, però recomanem utilitzar-lo powerpages en el futur. Aquest article aviat s'actualitzarà per utilitzar-lo powerpages en lloc de paportal.

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 llocs web disponibles

Utilitzeu l'ordre pac paportal list per enumerar els llocs web de Power Pages disponibles a l'entorn del Dataverse al qual us heu connectat utilitzant el pas anterior.

pac paportal list

Pas 3. Baixar el contingut de lloc web

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

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

Exemple

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

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

Nota

• Utilitzeu modelVersion1 o 2 per indicar si les dades del lloc a carregar utilitzaran el model de dades estàndard (1) o millorat(2).
• Executeu pac powerpages list -v l'ordre per veure quin model de dades s'utilitza per al vostre lloc. Per obtenir més informació, aneu a Model de dades millorat.

Pas 4. Canviar el contingut del lloc web

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

Nota

Assegureu-vos d'actualitzar només les taules compatibles amb l'ús de la CLI del Power Platform. Per obtenir més informació, vegeu Taules compatibles.

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:

Propina

Podeu canviar la ubicació del camí de la carpeta al terminal del PowerShell/integrat a la ubicació baixada i introduir "code ." per obrir la carpeta directament a Visual Studio Code.

Pas 5. Pujar els canvis

Nota

• Si carregueu a diversos entorns, vegeu pujar els canvis mitjançant el perfil d'implementació per obtenir informació sobre com pujar els canvis mitjançant el perfil d'implementació.
• Assegureu-vos que la mida màxima de fitxers adjunts de l'entorn de destinació sigui la mateixa mida o una mida superior que l'entorn d'origen.
• La mida màxima dels fitxers la determina l'opció Mida màxima dels fitxers a la pestanya Correu electrònic de la Configuració del sistema del quadre de diàleg Configuració del sistema de l'entorn.

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

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

Exemple

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

Nota

Assegureu-vos que el camí per al contingut dels portals que heu introduït sigui correcte. Per defecte, es crea una carpeta amb el nom pel portal (nom descriptiu) amb el contingut del portal baixat. Per exemple, si el nom descriptiu del portal és custom-portal,, el camí per a l'ordre anterior (--path) hauria de ser C:\pac-portals\downloads\custom-portal.

La pujada només es fa per al contingut que es canvia. 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 plantejar-vos utilitzar perfils d'implementació per assegurar-vos que els canvis es carreguin a l'entorn correcte mitjançant 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 --modelVersion 2

   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:

1. A l'estudi de disseny de Power Pages, seleccioneu Sincronitza

2. Per veure el canvi, navegueu fins a la pàgina web.

   

3. Si heu utilitzat l'exemple de perfil de desplegament explicat anteriorment, el fragment YAML actualitza el valor tal com es mostra a la següent captura de pantalla.

   

   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