Componentes de código para aplicaciones de lienzo

Los desarrolladores profesionales pueden usar el marco de componentes de Power Apps para crear componentes de código que pueden usar en sus aplicaciones de lienzo. Para más información, consulte Introducción al marco de componentes de Power Apps.

Los creadores de aplicaciones pueden usar Power Apps component framework para crear, importar y agregar componentes de código a las aplicaciones de lienzo mediante Microsoft Power Platform CLI. Es posible que algunas API no estén disponibles en las aplicaciones de lienzo. Compruebe cada API para determinar dónde está disponible.

Consideraciones de seguridad

Advertencia

Los componentes de código contienen código que Microsoft no ha generado y pueden potencialmente acceder a los tokens y datos de seguridad cuando se representan en Power Apps Studio. Al agregar componentes de código a una aplicación basada en lienzo, asegúrese de obtener las soluciones de estos componentes de un origen de confianza. Esta vulnerabilidad no existe cuando se reproduce la aplicación de lienzo.

Cuando abre una aplicación de lienzo que contiene componentes de código en Power Apps Studio, aparece un mensaje de advertencia sobre código potencialmente inseguro. Los componentes de código del entorno de Power Apps Studio tienen acceso a tokens de seguridad, por lo que solo se abren componentes de orígenes de confianza. Los administradores y los personalizadores del sistema deben revisar y validar todos los componentes del código antes de importar esos componentes en un entorno y ponerlos a disposición de los fabricantes para que los utilicen en sus aplicaciones. El Default publicador aparece al importar componentes de código mediante una solución no administrada o cuando se usa pac pcf push para instalar el componente de código.

Requisitos previos

• Se necesita una licencia de Power Apps. Para más información, consulte el marco de componentes de Power Apps: licencia.
• Se requieren privilegios de administrador del sistema para habilitar la característica Power Apps component framework en el entorno.

Habilitar la característica Power Apps component framework

Para agregar componentes de código a una aplicación, debe habilitar la característica Power Apps component framework en cada entorno donde desea usarla. Por defecto, la característica de componente de Power Apps está habilitada para aplicaciones basadas en modelos. Para permitir a un entorno que use componentes de código en sus aplicaciones:

1. Inicie sesión en Power Apps.

2. Seleccione Configuración y, a continuación, seleccione Centro de administración.

   

3. Seleccione la pestaña Entornos en el panel izquierdo y seleccione el entorno donde desea habilitar esta función y luego seleccione Ajustes.

4. Expanda Producto y seleccione Caracteristicas.

5. En la lista de características disponibles, active Power Apps component framework para aplicaciones de lienzo y luego seleccione Guardar.

   

Implementar componente de código

Después de habilitar la característica de Power Apps component framework en el entorno, puede empezar a implementar la lógica para los componentes de código. Para ver un tutorial paso a paso, consulte Creación del primer componente de código.

Compruebe las limitaciones de los componentes de código en las aplicaciones de lienzo antes de iniciar la implementación.

Agregar componentes a una aplicación de lienzo

1. Vaya a Power Apps Studio.

2. Cree una nueva aplicación de lienzo o edite una aplicación existente a la que desee agregar el componente de código.

   Importante

   Asegúrese de importar la solución .zip archivo que contiene los componentes de código en Microsoft Dataverse.

3. En el panel izquierdo, seleccione Agregar (+) y luego, Obtener más componentes.

   

4. Seleccione la pestaña Código, seleccione un componente de la lista y luego seleccione Importar.

   

5. En el panel izquierdo seleccione +, expanda Componentes de código y después seleccione el componente que quiera agregar a la aplicación.

   

   Nota

   También puede agregar componentes seleccionando Insertar>Personalizado>Importar componente. Esta opción está en desuso y se quitará en una versión futura, por lo que use el flujo descrito anteriormente.

En la pestaña Propiedades , verá las propiedades del componente de código.

Nota

Para volver a importar los componentes de código existentes y hacer que las propiedades estén disponibles en la pestaña Propiedades predeterminadas, actualice la versión del manifiesto del componente de código. Las propiedades permanecen disponibles en la pestaña Propiedades avanzadas .

Elimine un componente de código de una aplicación de lienzo

1. Abra la aplicación donde agregó el componente de código.

2. En el panel izquierdo, seleccione Vista de árbol y, a continuación, seleccione la pantalla donde agregó el componente de código.

3. Junto al componente, seleccione Más (...) y luego seleccione Eliminar.

   

4. Guarde la aplicación para ver los cambios.

Actualizar componentes de código existentes

Para ver los cambios en tiempo de ejecución después de actualizar los componentes de código, cambie la version propiedad en el archivo de manifiesto. Cambie la versión del componente cada vez que realice cambios.

Nota

Power Apps Studio actualiza los componentes de código existentes solo cuando se cierra o vuelve a abrir la aplicación. Cuando vuelva a abrir la aplicación, le pedirá que actualice los componentes de código. Simplemente eliminar o agregar componentes de código a la aplicación no actualiza los componentes. Publique primero todas las personalizaciones de la solución actualizada; de lo contrario, no aparecen las actualizaciones realizadas en el componente de código.

Vea también

Información general de Power Apps component framework
Crear el primer componente de código
Más información sobre Power Apps component framework