Llegeix en anglès

Comparteix a través de


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

En aquest tutorial, aprendràs a començar a utilitzar la Microsoft Power Platform CLI per actualitzar la 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 versió 1.27 de la Power Platform CLI, l'ordre pac paportal es canvia a pac powerpages. paportal continua funcionant, però recomanem utilitzar-lo powerpages en el futur.

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.

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

Pas 2. Enumerar llocs web disponibles

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

pac powerpages list

Exemple de llista de llocs web.

Pas 3. Baixar el contingut de lloc web

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

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

Exemple

pac powerpages 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.

Els lectors de pantalla utilitzen aquest text.

Nota

  • Utilitzeu modelVersion1 o 2 per indicar si les dades del lloc que s'han de 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:

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.

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

Després de fer els canvis necessaris, carregueu-los mitjançant l'ordre pac powerpages upload :

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

Exemple

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

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

Pujada completada només per al contingut canviat

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

Quan treballeu amb diversos entorns diferents, podeu considerar l'ús de perfils de desplegament per assegurar-vos que els canvis es carreguen a l'entorn correcte mitjançant el perfil de desplegament.

  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.

    Carpeta per a perfils d'implementació

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

    YAML del perfil d'implementació per a dev

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

    yml
    <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)".

    yml
    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ó, primer heu d'autenticar-lo a l'organització de destinació.

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

    pac powerpages 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, aneu a la pàgina web.

    Visualitzar el contingut de la pàgina actualitzat.

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

    Sufix de títol del navegador de l'aplicació d'administració del portal

    El sufix de títol del navegador actualitzat amb el 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

Utilitzar l'extensió Visual Studio Code

Consulteu també