Titorial: usar a CLI de Microsoft Power Platform con portais

Neste exemplo de titorial, verá como comezar a usar a CLI de Microsoft Power Platform para actualizar a configuración de portais de mostra.

Nota

• Tamén podes usar Power Platform CLI con Power Pages. Máis información: Que é Power Pages
• Este titorial céntrase nos comandos da CLI de Microsoft Power Platform necesarios para usar os portais de Power Apps. Para obter máis información sobre os comandos empregados na CLI de Power Platform, lea Comandos comúns.

Descargar e instalar Visual Studio Code

Para conectarse a portais de Power Apps e para usar os comandos da CLI de Microsoft Power Platform, use Visual Studio Codee o terminal integrado. O terminal integrado facilita a conexión ao ambiente de Dataverse e a descarga, a modificación e a carga da configuración dos portais. No seu lugar, tamén pode usar Windows PowerShell.

Paso 1. Autenticar

Antes de conectarse, listar, descargar ou cargar calquera cambio para un portal de Power Apps, debe autenticarse primeiro no ambiente de Dataverse. Para obter máis información sobre a autenticación mediante a CLI de Microsoft Power Platform, vaia a CLI de Microsoft Power Platform: autenticación.

Para autenticarse, abra Windows PowerShell e execute o seguinte comando usando o URL do seu ambiente de Dataverse:

pac auth create -u [Dataverse URL]

Exemplo

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

Siga as instrucións de autenticación para iniciar sesión no ambiente.

Paso 2. Lista de portais dispoñibles

Use o comando list para enumerar os portais de Power Apps dispoñibles no ambiente de Dataverse ao que se conectou no paso anterior.

pac paportal list

Paso 3. Descargar contido de portais

Descargue o contido do sitio web do portal do ambiente de Dataverse conectado.

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

Exemplo

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

Para o parámetro id, use o WebSiteId devolto dos resultados do paso anterior.

Paso 4. Cambiar o contido dos portais

Cambie a configuración usando Visual Studio Code e garde os seus cambios.

Nota

Asegúrese de actualizar só as táboas compatibles para usar coa CLI de Power Platform. Para obter máis información, consulte Táboas compatibles.

Por exemplo, a páxina predefinida do portal mostra texto como este:

Este texto é visible desde a páxina web html:

Pode modificar este texto e gardar os cambios:

Suxestión

Pode cambiar a situación da ruta do cartafol en PowerShell/terminal integrado á localización descargada e introducir "code ." para abrir o cartafol directamente en Visual Studio Code.

Paso 5. Carga os cambios

Nota

• Se estás cargando a varios ambientes, consulta carga os cambios usando o perfil de implementación para aprender a cargar cambios usando o perfil de implementación.
• Asegúrese de que o tamaño máximo de anexos do contorno de destino estea definido no mesmo ou maior tamaño que o seu contorno de orixe.
• O tamaño máximo dos ficheiros determínao Tamaño máximo do ficheiro configuración no pestana de correo electrónico de configuración do sistema no cadro de diálogo de configuración do sistema do entorno.

Despois de facer os cambios necesarios, cárgueos usando o seguinte comando:

pac paportal upload --path [Folder-location]

Exemplo

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

Nota

Asegúrese de que a ruta do contido dos portais que introduciu é correcta. De xeito predeterminado, créase un cartafol nomeado polo portal (nome amigable) co contido de portais descargados. Por exemplo, se o nome amigable do portal é portal personalizado, o camiño para o comando anterior (--path) debería ser C:\pac-portais\descargas\portal personalizado.

A carga só ocorre con contido modificado. Neste exemplo, dado que o cambio se realiza nunha páxina web, o contido só se carga para a táboa adx_webpage.

Carga os cambios usando o perfil de implementación

Cando traballes con varios ambientes diferentes, podes considerar usar perfís de implementación para asegurarte de que os cambios se carguen no ambiente correcto usando o perfil de implementación.

1. Crea un cartafol co nome perfís de implantación dentro do cartafol que contén o contido do portal. Por exemplo, se o contido do portal descargado está dentro de "starter-portal", o cartafol de perfís de implementación debería estar dentro deste cartafol.

   

2. Dentro do cartafol de perfís de implantación, cree un ficheiro YAML de implantación que conteña os cambios específicos do entorno. Por exemplo, o ambiente de desenvolvemento pódese chamar "dev.deployment.yml".

   

3. Edite o ficheiro YAML de implementación usando Visual Studio Código co seguinte formato:

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

   Por exemplo, a seguinte mostra de código YAML actualiza o valor de "Sufixo de título do navegador" de "Portal personalizado" predeterminado a "Portal personalizado (Desenvolvedor)".

   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. Para cargar os cambios nun ambiente diferente mediante un ficheiro YAML do perfil de implantación, autenticar primeiro á organización de destino.

5. Despois de autenticarse e conectarse ao ambiente correcto, use o seguinte comando para cargar o contido:

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

   Nota

   No exemplo anterior, o nome do perfil de implementación usado é "dev" despois de seguir os pasos anteriores para crear un perfil de implementación. Cambia o nome de "dev" a calquera outro (como QA para "qa.deployment.yml" ou Test para "test.deployment.yml") se utilizaches un nome de ficheiro diferente para o teu ficheiro YAML de implantación.

Paso 6. Confirme os cambios

Para confirmar os cambios realizados na páxina web do portal:

1. Limpe a caché do servidor ou use a Configuración de sincronización empregando Studio de portais de Power Apps.

2. Navegue á páxina web do portal para ver o cambio.

   

3. Se usaches un exemplo de perfil de implementación explicado anteriormente, o YAML fragmento actualizará o valor como se mostra a continuación.

   

   O sufixo do título do navegador actualizado a través do cambio anterior mostra o cambio cando abre o portal nun navegador:

   

Isto conclúe o titorial. Pode repetir os pasos anteriores e cambiar o contido dos portais por outras táboas compatibles.

Pasos seguintes

Usa o Visual Studio Extensión de código

Consulte tamén

• CLI de Microsoft Power Platform
• Usar a extensión de Visual Studio Code (versión preliminar)