Compartir a través de

Tutorial: uso de Microsoft Power Platform CLI con portales

  • Artículo

Nota

A partir del 12 de octubre de 2022, los portales de Power Apps son Power Pages. Más información: Microsoft Power Pages ya está disponible para el público en general (blog)
Pronto migraremos y fusionaremos la documentación de los portales de Power Apps con la documentación de Power Pages.

En este ejemplo de tutorial, verá cómo comenar con Microsoft Power Platform CLI para actualizar la configuración de portales de muestra.

Nota

  • También puede usar Power Platform CLI con Power Pages. Más información: Qué es Power Pages
  • Este tutorial se centra en los comandos de Microsoft Power Platform CLI para el uso de portales de Power Apps. Para obtener más información sobre los comandos utilizados en Power Platform CLI, lea comandos comunes.

Descargar e instalar Visual Studio Code

Para conectarse a los portales de Power Apps y utilizar los comandos de Microsoft Power Platform CLI, utilice Visual Studio Code y el terminal integrado. El terminal integrado facilita la conexión al entorno Dataverse y para descargar, cambiar y cargar la configuración de los portales. También puede usar Windows PowerShell.

Paso 1. Autenticar

Antes de conectarse, enumerar, descargar o cargar cualquier cambio para un portal de Power Apps, debe autenticarse primero en el entorno de Dataverse. Para obtener más información sobre la autenticación mediante Microsoft Power Platform CLI, vaya a pac auth.

Para autenticarse, abra Windows PowerShell y ejecute el comando pac auth create utilizando el URL del entorno de Dataverse:

pac auth create -u [Dataverse URL]

Ejemplo

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

Siga las indicaciones de autenticación para iniciar sesión en el entorno.

Ejemplo de cómo autenticarse en un entorno de Dataverse usando Microsoft Power Platform CLI.

Paso 2. Lista de las portales disponibles

Use el comando pac paportal list para listar los portales Power Apps disponibles en el entorno Dataverse al que se conectó en el paso anterior.

pac paportal list

Ejemplo de lista de portales.

Paso 3. Descargar contenido de portales

Descargue el contenido del sitio web del portal desde el entorno de Dataverse conectado usando e comando pac paportal download.

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

Ejemplo

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

Para el parámetro id., utilice el WebSiteId recuperado del resultado del paso anterior.

Ejemplo de descarga de contenido de portales.

Paso 4. Cambiar el contenido de los portales

Cambie la configuración usando Visual Studio Code y guarde sus cambios.

Nota

Asegúrese de actualizar solo las tablas compatibles para su uso con Power Platform CLI. Para obtener más información, consulte Tablas admitidas.

Por ejemplo, la página del portal predeterminada muestra un texto como este:

Ejemplo de texto de la página de portales

Este texto es visible desde la página web html:

Visual Studio Code con texto resaltado para cambiar.

Puede modificar este texto y guardar los cambios:

Texto actualizado usando Visual Studio Code.

Sugerencia

Puede cambiar la ubicación de la ruta de la carpeta en PowerShell o el terminal integrado a la ubicación descargada e introducir "code". para abrir la carpeta directamente en Visual Studio Code.

Paso 5. Cargar los cambios

Nota

  • Si está cargando a varios entornos, consulte cargar los cambios usando el perfil de implementación para aprender a cargar cambios usando el perfil de implementación.
  • Asegúrese de que el tamaño máximo de archivo adjunto del entorno de destino esté establecido en el mismo tamaño o en un tamaño superior al de su entorno de origen.
  • El tamaño máximo de los archivos está determinado por el valor de configuración tamaño máximo de archivo en el cuatro de diálogo de configuración del sistema de entorno pestaña de correo electrónico de configuración del sistema.

Después de realizar los cambios necesarios, cárguelos usando el comando pac paportal upload:

pac paportal upload --path [Folder-location]

Ejemplo

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

Iniciando carga.

Nota

Asegúrese de que la ruta del contenido de los portales que introdujo sea correcta. De forma predeterminada, se crea una carpeta con el nombre del portal (nombre descriptivo) con el contenido de los portales descargados. Por ejemplo, si el nombre descriptivo del portal es portal personalizado, la ruta para el comando anterior (--path) debe ser C:\pac-portals\downloads\portal personalizado.

La carga solo ocurre para el contenido que se ha cambiado. En este ejemplo, dado que el cambio se realiza en una página web, el contenido se carga solo para la tabla adx_webpage.

Carga completa solo para contenido modificado.

Cargar los cambios usando el perfil de implementación

Cuando trabaje con varios entornos diferentes, puede considerar el uso de perfiles de implementación para asegurarse de que los cambios se carguen en el entorno correcto mediante el perfil de implementación.

  1. Cree una carpeta llamada perfiles de implementación dentro de la carpeta que contiene el contenido del portal. Por ejemplo, si el contenido del portal descargado está dentro del "portal de inicio", la carpeta de perfiles de implementación debe estar dentro de esta carpeta.

    Carpeta para perfiles de implementación

  2. Dentro de la carpeta de perfiles de implementación, cree un archivo YAML de implementación que contenga los cambios específicos del entorno. Por ejemplo, el entorno de desarrollo se puede llamar "dev.deployment.yml".

    Perfiles de implementación YAML para desarrollo

  3. Edite el archivo YAML de implementación usando Visual Studio Code con el siguiente formato:

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

    Por ejemplo, el siguiente código YAML de muestra actualiza el valor de "Sufijo de título del explorador" de "Portal personalizado" predeterminado a "Portal personalizado (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. Para cargar los cambios en un entorno diferente usando un archivo YAML de perfil de implementación, autentique primero a la organización de destino.

  5. Después de autenticarse y conectarse al entorno correcto, use el comando pac paportal upload para cargar el contenido:

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

    Nota

    En el ejemplo anterior, el nombre del perfil de implementación utilizado era "dev" después de seguir los pasos anteriores para crear un perfil de implementación de desarrollo. Cambie el nombre de "dev" a cualquier otro (como QA para "qa.deployment.yml" o Test para "test.deployment.yml") si ha utilizado un nombre de archivo diferente para su archivo YAML de implementación.

Paso 6. Confirmar los cambios

Para confirmar los cambios realizados en la página web del portal:

  1. Borre el caché del lado del servidor o use Configuración de sincronización mediante el uso de Studio para portales de Power Apps.

  2. Vaya a la página web del portal para ver el cambio.

    Ver contenido actualizado de la página.

  3. Si ha usado el ejemplo de perfil de implementación explicado anteriormente, el fragmento de código YAML actualizará el valor como se muestra a continuación.

    Sufijo de título del explorador de la aplicación de administración de portales

    El Sufijo de título del explorador actualizado a través del cambio anterior muestra el cambio cuando abre el portal en un explorador:

    Cambio del explorador

Así concluye el tutorial. Puede repetir los pasos anteriores y cambiar el contenido de los portales por otras tablas compatibles.

Pasos siguientes

Utilizar la extensión de Visual Studio Code

Consulte también