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.

Exemple de com autenticar-se a un entorn del Dataverse amb la CLI del Microsoft Power Platform

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

Llista d'exemples de portals

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.

Exemple de baixada de contingut dels portals

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:

Text d'exemple de la pàgina dels portals

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

Visual Studio Code amb text ressaltat per al canvi

Podeu alterar aquest text i desar-ne els canvis:

Text actualitzat amb el Visual Studio Code

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

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\

Inici de la pujada

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.

Pujada completada només per al contingut canviat

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ó.

  1. 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.

    Carpeta per als perfils d'implementació

  2. 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".

    Perfil d'implementació YAML for dev

  3. 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:  &nbsp;· Custom Portal (Dev) # Setting value
    
  4. Per carregar els canvis a un entorn diferent mitjançant un fitxer YAML de perfil d'implementació, autentica't primer a l'organització de destinació.

  5. 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 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 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:

  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.

    Visualitzar el contingut de la pàgina actualitzat.

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

    Sufix de títol del navegador des de l'aplicació Administració del portal

    El sufix de títol del navegador actualitzat a través del canvi anterior mostra el canvi quan obriu el portal en un navegador:

    Canvi de 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

Consulteu també