pac canvas

  • Artículo

Se utilizan archivos .msapp de Power Apps

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

Importante

  • Los comandos pack y unpack están en vista previa pública.
  • Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.
  • El comando create está generalmente disponible.

Comandos

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.

Ejemplos

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 requeridos 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.

Comentarios

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. Casos específicos:
    • 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

Ejemplo

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

Parámetros requeridos para canvas pack

--msapp

Ruta de acceso al archivo .msapp

--sources

Directorio de los orígenes que se va a empaquetar

Comentarios

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

Ejemplo

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

pac canvas unpack --msapp HelloWorld.msapp

Desempaqueta en el directorio HelloWorld_src predeterminado.

Parámetros requeridos para canvas unpack

--msapp

Ruta de acceso al archivo .msapp

Parámetros opcionales para canvas unpack

--sources

Directorio de los orígenes que se va a desempaquetar

Comentarios

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.

Estructura de carpetas

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

  • \ src: archivos de control y componentes. Este contiene las fuentes.
    • *.fx.yaml: las fórmulas extraídas del archivo control.json.

      Nota

      Este es el lugar para editar sus fórmulas.

    • CanvasManifest.json: un archivo de manifiesto que contiene la información normalmente presente en el encabezado, las propiedades y publishInfo.
    • *.json: el archivo control.json sin procesar.
    • \EditorState*.editorstate.json: información almacenada en caché para que la utilice Power Apps Studio.
  • \DataSources: todas las fuentes de datos utilizadas por la aplicación.
  • \Connections: instancias de conexión guardadas con la aplicación y utilizadas al recargar en Power Apps Studio.
  • \Assets: archivos multimedia incrustados en la aplicación.
  • \pkgs: 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.
  • \other: todos los archivos misceláneos necesarios para recrear .msapp.
    • entropy.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.

Formato de archivo

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

Código abierto

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.

Consulte también

Grupos de comandos de Microsoft Power Platform CLI
Microsoft Power PlatformVisión general del CLI