Compatibilidad de portales para Microsoft Power Platform CLI

Microsoft Power Platform CLI (interfaz de la línea de comandos) es una interfaz de línea de comandos para desarrolladores simple y única que permite a los desarrolladores y creadores de aplicaciones crear componentes de código.

Los útiles de Microsoft Power Platform CLI son el primer paso hacia un sistema de administración del ciclo de vida de la aplicación (ALM) completo donde los desarrolladores de la empresa y los ISV pueden crear, compilar, depurar y publicar sus extensiones y personalizaciones de forma rápida y eficiente. Para obtener más información consulte ¿Qué es Microsoft Power Platform CLI?

Con esta característica, los portales de Microsoft Power Apps son compatibles con Microsoft Power Platform CLI para habilitar CI/CD (Integración continua/Implementación continua) de la configuración del portal. Ahora puede registrar la configuración del portal para controlar el origen y mover la configuración del portal a cualquier entorno utilizando Microsoft Power Platform CLI.

¿Por qué usar Microsoft Power Platform CLI para el desarrollo de portales?

Con compatibilidad de portales para Microsoft Power Platform CLI, ahora puede usar la capacidad similar a fuera de línea para la personalización de portales realizando cambios en el contenido de los portales. Y una vez que se guarden todas las personalizaciones o cambios, cárguelos en el portal. Cuando descarga contenido de portales usando Microsoft Power Platform CLI, el contenido está estructurado en formatos YAML y HTML, lo que facilita la personalización y permite una experiencia de desarrollo profesional.

Aquí hay una lista de características y capacidades de las que se benefician los portales con la compatibilidad para Microsoft Power Platform CLI:

Facilidad de uso

• Soporte para descargar / cargar datos del portal hacia / desde el sistema de archivos local

• Crear sobre una herramienta existente de Microsoft Power Platform CLI.

Administración del ciclo de vida de la aplicación (ALM)

• Seguimiento de cambios en la configuración del portal dentro de una organización

• Mueva archivos de configuración entre organizaciones o inquilinos

Soporte para empresas y desarrolladores profesionales

• Ayuda a integrarse sin problemas con cualquier herramienta de control de código fuente, como "git"

• Configure fácilmente canalizaciones de CI/CD

Instalar Microsoft Power Platform CLI

Para obtener instrucciones paso a paso, consulte Instalar en Microsoft Power Platform CLI.

Tablas compatibles

La compatibilidad de portales para Microsoft Power Platform CLI se limita a las tablas que se enumeran a continuación.

Instalar y verificar Microsoft Power Platform CLI para portales

Para aprender a instalar Microsoft Power Platform CLI, vaya a Instalar en Microsoft Power Platform CLI.

Después de instalar Microsoft Power Platform CLI, abra una entrada de comando y ejecute pac para verificar que la salida contiene "paportal", el comando para portales de Power Apps.

Comandos de Microsoft Power Platform CLI para portales

El comando de Microsoft Power Platform CLI para portales es "paportal".

En las siguientes secciones se proporcionan detalles adicionales sobre las diferentes propiedades del comando "paportal".

Parámetros

Usar perfil de implementación

El conmutador deploymentProfile le permite definir un conjunto de variables para el entorno en formato YAML. Por ejemplo, puede tener diferentes perfiles de implementación (como dev, test, prod) que tienen diferentes detalles de esquema definidos en el perfil.

Si está creando un perfil de prueba, puede crear un archivo en deployment-profiles con el nombre "test.deployment.yml" (es decir, <profileTag>.deployment.yml). Y puede ejecutar el comando con la etiqueta (<profileTag>) para usar este perfil:

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

En este archivo, puede tener el nombre de la tabla (entidad) con el ID de la tabla, la lista de atributos y los valores que desea anular mientras carga la configuración del portal usando el parámetro deploymentProfile.

Además, puede utilizar la variable OS para acceder a las variables de entorno del sistema operativo.

A continuación, se muestra un ejemplo de este archivo YAML de perfil "test.deployment.yml" que tiene detalles de esquema únicos:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Archivos de manifiesto

Cuando descarga el contenido del sitio web usando el comando CLI pac paportal download, junto con la descarga del contenido del sitio, también generará dos archivos de manifiesto;

• Archivo de manifiesto del entorno (org-url-manifest.yml)
• Eliminar archivo de manifiesto de seguimiento (manifest.yml)

Archivo de manifiesto del entorno (org-url-manifest.yml)

El archivo de manifiesto del entorno se genera cada vez que se ejecuta el comando pac paportal download.

Después de cada descarga, la herramienta PAC CLI lee el archivo de manifiesto del entorno existente y actualiza las entradas eliminadas en el entorno, o crea el archivo de manifiesto del entorno si no existe.

Cuando ejecuta el comando pac paportal upload para cargar el contenido del sitio web del portal. Lee el archivo de manifiesto del entorno e identifica los cambios realizados desde la última descarga y solo carga el contenido actualizado. Esto ayuda a optimizar el proceso de carga, ya que solo se carga el contenido actualizado del sitio web, en lugar de cargar todo el contenido en cada comando de carga.

El archivo de manifiesto del entorno será de solo lectura cuando se conecte al mismo entorno (la URL del entorno coincide con el nombre del archivo), para evitar cambios accidentales.

Eliminar archivo de manifiesto de seguimiento (manifest.yml)

Este archivo se utiliza para realizar un seguimiento de los registros eliminados del entorno.

Cuando el contenido del sitio web se descarga con el comando pac paportal download, este agregará los registros eliminados del archivo de manifiesto del entorno (org-url-manifest.yml) al archivo manifest.yml. Entonces, cuando carga el contenido del sitio web usando el comando pac paportal upload eliminará los archivos del entorno (incluso en un entorno diferente). Este archivo no se elimina y se usa independientemente del entorno al que esté conectado.

Utilizar la extensión de Visual Studio Code

También puede usar la extensión VS Code Extensión VS Code de Power Platform para aprovechar el lenguaje Liquid integrado de IntelliSense, la asistencia para completar el código, las sugerencias e interactuar con Microsoft Power Platform CLI usando el terminal integrado de VS Code. Más información: Utilizar la extensión de Visual Studio Code (versión preliminar)

Consideraciones adicionales

• Se informa de un error si la ruta de su archivo excede la limitación de longitud máxima de la ruta. Más información: Limitación de la longitud máxima de la ruta en Windows
• Para registros duplicados, como un nombre de página web duplicado, Microsoft Power Platform CLI crea dos carpetas diferentes—una con el nombre de la página web y otra con el mismo nombre prefijado con un código hash. Por ejemplo, "My-page" y "My-page-hash-code".

Pasos siguientes

Tutorial: uso de Microsoft Power Platform CLI con portales

Consultar también

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