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.
Nota
Aquest tutorial se centra en les ordres de la CLI del Microsoft Power Platform necessàries per a l'ús dels portals del Power Apps. Per obtenir més informació sobre les ordres utilitzades al Power Platform CLI, llegiu Ordres habituals.
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 CLI del Microsoft Power Platform: autenticació.
Per autenticar-vos, obriu el Windows PowerShell i executeu la següent ordre 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. Llista els portals disponibles
Utilitzeu l'ordre llista per enumerar els portals del Power Apps disponibles a l'entorn del Dataverse al qual us heu connectat al pas anterior.
pac paportal list

Pas 3. Baixar el contingut dels portals
Baixeu el contingut del lloc web de l'entorn del Dataverse connectat.
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. Canvia el contingut dels portals
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:

Suggeriment
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 al Visual Studio Code.
Pas 5. Puja els canvis
Nota
Si penges en diversos entorns, consulta penjar els canvis mitjançant el perfil d'implementació per obtenir informació sobre com pots penjar canvis mitjançant el perfil d'implementació.
Després de fer els canvis necessaris, pugeu-los utilitzant la següent ordre:
pac paportal upload --path [Folder-location]
Exemple
pac paportal upload --path C:\pac-portals\downloads\custom-portal\

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 portal-personalitzat, el camí per a l'ordre anterior (--path) hauria de ser C:\pac-portals\downloads\portal-personalitzat.
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.

Carrega els canvis amb el perfil d'implementació
Quan treballeu amb diversos entorns diferents, podeu considerar l'ús de perfils d'implementació per assegurar-vos que els canvis es pengin a l'entorn correcte mitjançant el perfil d'implementació.
Creeu una carpeta anomenada deployment-profiles dins de la carpeta que conté el contingut del portal. Per exemple, si el contingut del portal baixat es troba dins de "starter-portal", la carpeta de perfils d'implementació hauria d'estar dins d'aquesta carpeta.
Dins de la carpeta de perfils d'implementació, creeu un fitxer YAML de desplegament que contingui els canvis específics de l'entorn. Per exemple, l'entorn de desenvolupament es pot anomenar "dev.deployment.yml".
Edita el fitxer YAML de desplegament utilitzant Visual Studio Codi amb el format següent:
<table-name>: - <record-id>: <GUID> <column-name>: <Name> <column-value>: <Value>Per exemple, el següent codi YAML d'exemple actualitza el valor de "Sufix de títol del navegador" des del "Portal personalitzat" per defecte fins al "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 valuePer carregar els canvis a un entorn diferent mitjançant un fitxer YAML de perfil d'implementació, autentica't primer a l'organització de destinació.
Després d'autenticar-lo i connectar-lo a l'entorn correcte, utilitzeu l'ordre següent per penjar el contingut:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile devNota
A l'exemple anterior, el nom del perfil d'implementació utilitzat és "dev" després de seguir els passos anteriors per crear un perfil de desplegament de dev. Canvieu el nom de "dev" a qualsevol altre (com ara QA per a "qa.deployment.yml" o Prova per a "test.deployment.yml") si heu utilitzat un altre nom de fitxer per al fitxer YAML de desplegament.
Pas 6. Confirmar els canvis
Per confirmar els canvis fets a la pàgina web del portal:
Esborreu la memòria cau del servidor o utilitzeu Sincronitza la configuració amb l'estudi de portals del Power Apps.
Navegueu a la pàgina web del portal per veure el canvi.
Si heu utilitzat l'exemple de perfil de desplegament explicat anteriorment, el fragment YAML actualitzarà el valor tal com es mostra a continuació.
El sufix de títol del navegador actualitzat a través del 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
Informació general de la compatibilitat dels portals amb la CLI del Microsoft Power Platform