Compatibilidad de portales para Microsoft Power Platform CLI

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.

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.

Nota

Esta función generalmente está disponible a partir de Power Platform CLI versión 1.9.8. Para obtener información sobre cómo instalar la última versión, consulte Instalar 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.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (solo descarga)

adx_websitelanguage

adx_webtemplate

anotación

Importante

  • Las tablas personalizadas y las tablas específicas de la plantilla del portal (como blog, comunidad o portal de ideas) no son compatibles con la personalización mediante Microsoft Power Platform CLI.
  • Los archivos adjuntos de imágenes a los registros de anuncios (adx_ad) no se descargan mediante la CLI de Power Platform. Como solución temporal, utilice el campo URL de imagen o agregue una referencia HTML en el campo Copiar a un registro de archivo web que contenga un archivo de imagen.

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.

Confirmar el comando paportal en Microsoft Power Platform CLI.

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

Nombre de la propiedad Description Ejemplo
list Enumera todos los sitios web del portal del entorno actual de Dataverse. pac paportal list
download Descargar contenido del sitio web del portal del entorno actual de Dataverse. Tiene los siguientes parámetros:
- path: ruta de acceso en la que se descargará el contenido del sitio web (alias: -p)
- webSiteId: id. del sitio web del portal para descargar (alias: -id)
- overwrite: (opcional) true: para sobrescribir el contenido existente, false: para fallar si la carpeta ya tiene contenido de sitio web (alias: -o)
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
upload Cargar contenido del sitio web del portal al entorno actual de Dataverse. Tiene el siguiente parámetro:
- path: ruta de acceso en la que se guarda el contenido del sitio web (alias: -p)
-deploymentProfile: cargue los datos del portal con los detalles del entorno definidos a través de variables de perfil en el archivo deployment-profiles/[profile-name].deployment.yaml
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"
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

Nota

Para obtener información sobre todos los comandos utilizados en CLI además de los portales, vaya a Comandos comunes en Microsoft Power Platform CLI.

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.

Nota

Para eliminar los registros de contenido del sitio en un entorno y también eliminar los mismos registros de contenido en otro entorno utilizando PAC CLI, deberá ejecutar el comando pac paportal download antes y después de la eliminación del contenido del registro del sitio web. El manifest.yml rastreará estos cambios y eliminará los registros correspondientes en el entorno de destino cuando se ejecuta el comando pac paportal upload.

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