Ver los archivos de código fuente de las aplicaciones canvas

Utilice el código fuente de aplicación de lienzo para revisar los cambios realizados por los creadores en Power Apps Studio. El código YAML de la aplicación de lienzo generado es de solo lectura y no debe modificarse. Cualquier cambio en el archivo se ignora y puede perderse.

• El esquema YAML está en desarrollo activo y es posible que el contenido esté incompleto.
• El esquema estático actual para los archivos *.pa.yaml está disponible aquí.

Power Fx y YAML son los lenguajes utilizados para Power Apps el código fuente. YAML es valorado por su formato legible por humanos y se beneficia de una amplia gama de editores, herramientas y bibliotecas para su manipulación.

Acceso a los archivos de código fuente

Tiene acceso a los archivos de código fuente si usa la integración Git de Dataverse, lo que elimina la necesidad de archivos .msapp.

El Power Apps Studio crea el código fuente de las aplicaciones canvas, que se almacena como archivos *.pa.yaml dentro del archivo .msapp. El archivo .msapp es un archivo binario que contiene una colección de archivos, incluido el código fuente.

Propina

Para utilizar eficazmente la administración del ciclo de vida de las aplicaciones (ALM), se recomienda utilizar soluciones. El paquete de aplicaciones Canvas no es compatible con ALM y sólo debe utilizarse para las capacidades básicas de importación y exportación cuando Dataverse no está disponible.

También puede obtener los archivos de código fuente del archivo .msapp o mediante la CLI de Power Platform.

Los archivos *.pa.yaml se pueden encontrar en la carpeta \Src del archivo msapp extraído.

Importante

Solo los archivos ubicados en el directorio \Src del msapp extraído están destinados a su uso con control de código fuente. Los archivos JSON en el .msapp no deben usarse como código fuente porque no son estables entre ciclos de guardado y carga.

Descargar y extraer los archivos pa.yaml mediante la CLI de Power Platform

Conéctese a su entorno mediante la CLI Power Platform y luego use los siguientes comandos:

1. Para enumerar las aplicaciones de lienzo en su entorno actual, utilice el comando: pac canvas list.
2. Para extraer los archivos de código fuente, utilice el comando: pac canvas download con el parámetro -d.

Extraer archivos de código fuente de un archivo .msapp

Para extraer archivos de código fuente de un archivo .msapp, tiene dos opciones:

1. Descomprima manualmente el archivo .msapp.
2. Alternativamente, puede utilizar el siguiente comando:

 Expand-Archive -Path "C:\path\to\yourFile.msapp" -DestinationPath "C:\path\to\destination"

Estructura de archivos para un archivo .msapp

En el caso de los archivos .msapp antiguos sin la carpeta \src, siga estos pasos para generar archivos de código fuente:

1. Importe, vuelva a guardar y descargue el nuevo .msapp en Power Apps Studio.
2. Después de eso, puede proceder a extraer los archivos de código fuente.

En la carpeta \src, busque los siguientes archivos y carpetas:

• App.pa.yaml: representa la aplicación.
• [nombre en pantalla].pa.yaml: Un archivo para cada pantalla, que representa la pantalla.
• \Component: una carpeta que contiene un archivo para cada componente, representado como [component Name].pa.yaml.

Solo los archivos *.pa.yaml de la carpeta \src se pueden usar como código fuente. No se debe usar ningún otro archivo como código fuente.

Versiones del esquema YAML de Power Apps

En la actualidad existen tres versiones de esquemas de código fuente de Power Apps:

Nombre del formato	Extensión de archivo	Description
Experimental	*.fx.yaml	Versión utilizada por el control de versiones experimental Git de Power Apps y pac canvas unpack, ya no está en desarrollo.
Vista previa	-	La versión utilizada por la vista de código, copiar código y pegar código. No hay información de versión en este esquema, por lo que no es adecuado para el control de versiones. Cuando vista de código está generalmente disponible (GA), cambia al formato de vista previa del código fuente.
Código fuente	Archivos *.pa.yaml	Incluye mejoras y detalles de la versión para el control de código fuente y está en desarrollo activo.

Formato experimental (*.fx.yaml)

Este esquema describe un formato experimental utilizado por la Power Platform CLI para procesar y convertir aplicaciones lienzo a un formato de código fuente. Este formato ya no se desarrolla activamente.

No puede convertir directamente archivos *.fx.yaml a los nuevos formatos. Para convertir aplicaciones más antiguas, empaquete el aplicación de lienzo como un archivo .msapp e impórtelo en Power Apps Studio.

Previsualizar

Esta versión es utilizada por Vista de código durante el periodo de versión preliminar. Está diseñada para crear aplicaciones de lienzo en Power Apps Studio, lo que le permite copiar y pegar controles fácilmente. En esta versión, el código fuente se utiliza en Power Apps Studio en lugar de convertirse, como en el formato experimental.

El formato durante la versión preliminar era temporal y ya no se usa. Puede pegar código desde el formato de versión preliminar.

Estos son los cambios realizados con respecto al formato experimental:

1. Eliminación de propiedades ZIndex: se elimina la propiedad ZIndex. En su lugar, una pantalla se representa como una matriz de controles. El orden de los controles determina su orden de apilamiento. Los controles normales se ordenan en orden ascendente, mientras que los controles de respuesta se ordenan en orden descendente.
2. Reemplazo de la representación de objetos JSON: la sintaxis "As" ya no se usa para definir el tipo de control. En su lugar, el lado izquierdo del identificador de nombre del control sigue siendo único. Solo se serializan las propiedades que difieren de los valores predeterminados. Dos nuevas propiedades definen el tipo de control y los valores predeterminados:

• Control: representa el tipo de control en YAML.
• Variante: identifica una variante de un tipo de control que puede alterar los valores de propiedad predeterminados, agregar o quitar propiedades, o modificar el comportamiento o el diseño del control.

Estas propiedades se usan para crear instancias de controles y no aceptan expresiones Power Fx.

Código fuente (*.pa.yaml)

Importante

• El código fuente YAML para las aplicaciones de lienzo se está desarrollando activamente. El contenido puede estar incompleto y sujeto a cambios.
• Los archivos .pa.yaml son de solo lectura y solo deben utilizarse para revisar los cambios realizados en Power Apps Studio. Estos archivos no se utilizan cuando se carga una aplicación.
• No se admite la edición externa, la combinación ni la resolución de conflictos.

Este esquema está diseñado para fines de control de código fuente y permite el uso de un solo archivo YAML.

Las actualizaciones del formato anterior incluyen:

1. Agrupación de elementos de nodo de nivel superior:
   • Las palabras clave de nivel superior "App" y "Screens" son ejemplos de cómo se agrupan ahora los elementos en un nodo de nivel superior.
2. Especificación de la versión de control:
   • Ahora puede especificar la versión de un control utilizando la palabra clave de control seguida del operador @. Si no se especifica ninguna versión, se utiliza la versión más reciente del control. La versión se utiliza para deserializar las propiedades del código fuente. La versión en tiempo de ejecución del control está definida por la versión de creación.
3. Nombres simplificados de las variantes:
   • No todos los controles requieren una variante.
4. ZIndex coherente para todos los controles:
   • Ahora, todos los controles usan un orden ascendente para determinar el valor ZIndex, a partir de 1. Este comportamiento se ajusta a la especificación 2 de CSS.