pac canvas

Funcionamiento con archivos .msapp de Power Apps.

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Important

  • Los pack comandos y unpack están en desuso.
  • Para controlar el código fuente de la aplicación de lienzo, use la integración de Git de Power Platform.
  • El comando create está generalmente disponible.

Commands

Command Description
pac canvas create Generar una aplicación de lienzo a partir de un conector personalizado
pac canvas download Descargar la aplicación de lienzo como un archivo .msapp
pac canvas list Lista de aplicaciones de lienzo
pac canvas pack (Versión preliminar) Empaquetar los orígenes en un archivo msapp
pac canvas unpack (Versión preliminar) Extraer los orígenes de un archivo msapp

pac canvas create

Generar una aplicación de lienzo a partir de un conector personalizado

Este comando generará una aplicación de lienzo .msapp basada en la definición OpenAPI de un conector personalizado ya existente. La aplicación contendrá pantallas, diseño de control y código Power Fx generado en función de cómo se definen las acciones del conector personalizado, con una apariencia predefinida. La aplicación se puede utilizar para ejercer directamente las acciones definidas en el conector personalizado.

Los creadores pueden importar .msappgenerados en Power Apps Studio para reproducir la aplicación, o para editar y realizar más personalizaciones. Importar la aplicación generada a Power Apps Studio navegando hacia Archivo>Abrir>Explorar dentro de Studio.

Examples

Los siguientes ejemplos muestran el uso del comando pac canvas create.

Cree una aplicación de lienzo basada en una definición de API abierta por nombre

Este ejemplo crea una aplicación de lienzo (como un archivo *.msapp) basada en una definición de API abierta mediante el uso de nombre del conector.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

Cree una aplicación de lienzo basada en una definición de API abierta por Id.

Este ejemplo crea una aplicación de lienzo (como un archivo *.msapp) basada en una definición de API abierta mediante el uso del Id. del conector.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

Se requiere connector-display-name o connector-id.

Parámetros necesarios para canvas create

--msapp

Ruta de acceso al archivo .msapp que se generará

Parámetros opcionales para canvas create

--connector-display-name

Nombre para mostrar del conector desde el que se generará la Power App.

--connector-id

Id. del conector desde el que se generará la Power App.

--environment

El ID de entorno o URL de destino. El valor predeterminado es el entorno de su perfil de autenticación de Dataverse actualmente activo.

Remarks

Consideraciones y limitaciones:

  • El conector personalizado al que se hace referencia con los parámetros connector-display-name o connector-id debe ser parte de una Solución.
  • Después de importar la aplicación a Studio, no habrá ninguna asociación con el conector personalizado. El fabricante debe agregar manualmente una referencia al conector personalizado a partir del cual se generó la aplicación antes de poder reproducirla. Vea Agregar conexiones de datos a aplicaciones de lienzo para los pasos. Hasta que se haga esto, es posible que vea errores de fórmula en la aplicación que se resolverán una vez que se agregue la referencia del conector. El nombre del conector personalizado que agregue a la aplicación debe coincidir con el nombre del conector personalizado al que se hace referencia en el comando canvas create.
  • La aplicación contendrá una pantalla para cada acción POST y GET que define el conector.
    • Otros verbos disponibles en conectores personalizados no están admitidos.
  • Los controles representados en la pantalla de cada acción se generan dinámicamente en función de cómo se definen los tipos de entrada y salida de cada acción. Ciertos tipos de entrada y salida definidos en el conector personalizado no son compatibles con canvas create. El comando generará advertencias en la consola cuando se encuentren. Specific cases:
    • Las matrices de objetos y las matrices de matrices no se admiten como entradas
    • Los controles no se generan para objetos o matrices anidadas más allá de una profundidad de 20
    • Los tipos de "archivo" y "formato binario" no se admiten para entrada o salida.

pac canvas download

Descargar la aplicación de lienzo como un archivo .msapp

Parámetros necesarios para canvas download

--name -n

Nombre exacto, nombre parcial o id. de aplicación de la aplicación de lienzo

Parámetros opcionales para canvas download

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--extract-to-directory -d

Nombre del directorio en el que se va a extraer la aplicación de lienzo

--file-name -f

Nombre de archivo (normalmente con extensión .msapp). Si no se proporciona, el archivo se guarda en el directorio actual con 'appname'.msapp

--overwrite -o

Permitir la sobrescritura del archivo

Este parámetro no requiere ningún valor. Es un modificador.

pac canvas list

Lista de aplicaciones de lienzo

Parámetros opcionales para canvas list

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

pac canvas pack

(Versión preliminar) Empaquetar los orígenes en un archivo msapp

Example

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

Parámetros necesarios para canvas pack

--sources

Directorio de los orígenes que se va a empaquetar

Parámetros opcionales para canvas pack

--disable-load-from-yaml

Cuando se especifica, desactiva la carga de la aplicación empaquetada desde archivos *.pa.yaml en el directorio 'Src'. Solo soportado con el diseño 'SourceCode'.

Este parámetro no requiere ningún valor. Es un modificador.

--layout

El diseño a usar para el directorio de fuentes. Nota: El diseño 'experimental' está obsoleto y será eliminado en una versión futura. Utiliza el diseño 'SourceCode' para el diseño más reciente soportado.

Utilice uno de estos valores:

  • Experimental
  • SourceCode

--msapp

Ruta de acceso al archivo .msapp

--overwrite

Permitir la sobrescritura del archivo

Este parámetro no requiere ningún valor. Es un modificador.

Remarks

Crea un archivo .msapp a partir de los archivos fuente previamente descomprimidos. El resultado se puede abrir en Power Apps Studio navegando a Archivo>Abrir>Navegar.

Tras desempaquetarlos, los archivos de origen se pueden editar y administrar con herramientas externas, como Visual Studio Code y GitHub.

pac canvas unpack

(Versión preliminar) Extraer los orígenes de un archivo msapp

Example

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

Desempaqueta en el directorio HelloWorld_src predeterminado.

Parámetros necesarios para canvas unpack

--msapp

Ruta de acceso al archivo .msapp

Parámetros opcionales para canvas unpack

--layout

El diseño a usar para el directorio de fuentes. Nota: El diseño 'experimental' está obsoleto y será eliminado en una versión futura. Utiliza el diseño 'SourceCode' para el diseño más reciente soportado.

Utilice uno de estos valores:

  • Experimental
  • SourceCode

--overwrite

Permitir la sobrescritura del archivo

Este parámetro no requiere ningún valor. Es un modificador.

--sources

Directorio de los orígenes que se va a desempaquetar

Remarks

Desempaqueta el archivo de origen .msapp.

Descargue el archivo .msapp de Power Apps Studio navegando a Archivo>Guardar como>Este computador.

Si el parámetro sources no se especifica, se usa un directorio con el mismo nombre y ubicación que el archivo .msapp con el sufijo _src.

Folder structure

Las propiedades Unpack y pack usan la siguiente estructura de carpetas:

  • \fuente - Archivos de control y componentes. Este contiene las fuentes.
    • *.fx.yaml - Las fórmulas extraídas de la control.json archivo.

      Note

      Este es el lugar para editar sus fórmulas.

    • Manifiesto de lienzo.json - Un archivo de manifiesto que contiene la información normalmente presente en el encabezado, las propiedades y publishInfo.
    • *.json - La cruda control.json archivo.
    • \EditorState*.editorstate.json - Información almacenada en caché para Power Apps Studio Para utilizar.
  • \Fuentes de datos - Todas las fuentes de datos utilizadas por la aplicación.
  • \Conexiones - Instancias de conexión guardadas con la aplicación y utilizadas al volver a cargar en Power Apps Studio.
  • \Assets: archivos multimedia que están incrustados en la aplicación.
  • \paquetes - Una copia descargada de referencias externas, como plantillas, archivos de definición de API y bibliotecas de componentes. Estos son similares a las referencias NuGet/NPM.
  • \otro - Todos los archivos diversos necesarios para recrear el .msapp.
    • entropía.json - Los elementos volátiles (como las marcas de tiempo) se extraen a este archivo. Esto ayuda a reducir las diferencias ruidosas en otros archivos al tiempo que garantiza que aún podamos realizar el viaje de ida y vuelta.
    • Contiene otros archivos de la msapp, como lo que está en \referencias.

File format

Los archivos .fx.yaml utilizan un subconjunto de YAML. Al igual que en Excel, todas las expresiones deben comenzar con un signo igual =. Más información: Gramática de fórmulas YAML Power Fx

Fusión de cambios con Power Apps Studio

Al fusionar cambios, se realizan en dos sesiones de Power Apps Studio diferentes:

  • Asegúrese de que todos los nombres de los controles sean únicos. Por ejemplo, insertar un botón en dos sesiones diferentes puede resultar en dos controles Button1. Recomendamos que asigne un nombre a los controles poco después de crearlos. La herramienta no acepta dos controles con el mismo nombre.
  • Para estos archivos, combínelos como lo hace normalmente:
    • \src*.fx.yaml
  • Si hay conflictos o errores, puede eliminar estos archivos:
    • \src\editorstate*.json: estos archivos contienen información opcional en Power Apps Studio.
    • \other\entropy.json
  • Para cualquier conflicto en estos archivos, está bien aceptar la última versión:
    • \checksum.json
  • Si hay algún conflicto de fusión bajo estas rutas, no es seguro fusionar. Háganos saber si esto sucede con frecuencia y trabajaremos en la reestructuración del formato de archivo para evitar conflictos.
    • \Connections*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open source

Los comandos de lienzo de Microsoft Power Platform CLI son de código abierto. Discuta las mejoras, plantee problemas y acceda al código desde el repositorio de herramientas de lenguaje de Power Apps.

See also

Grupos de comandos de la CLI de Microsoft Power Platform
Visión general del CLI de Microsoft Power Platform

  • Last updated on