Componentes de código para aplicaciones de lienzo

Los desarrolladores profesionales pueden usar Power Apps component framework para crear componentes de código que se pueden usar en sus aplicaciones de lienzo. Más información: Información general de Power Apps component framework

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

Consideraciones de seguridad

Advertencia

Los componentes de código contienen código que puede no ser generado por Microsoft y potencialmente pueden acceder a tokens de seguridad y datos cuando se procesan en Power Apps Studio. Al agregar componentes de código a una aplicación de lienzo, asegúrese de que las soluciones de componentes de código provengan de una fuente confiable. Esta vulnerabilidad no existe cuando se reproduce la aplicación de lienzo.

Cuando abre una aplicación de lienzo en Power Apps Studio que contiene componentes de código, aparece un mensaje de advertencia sobre código potencialmente inseguro. Los componentes de código en el entorno de Power Apps Studio tienen acceso a tokens de seguridad y, por lo tanto, solo se deben abrir los componentes de las fuentes confiables. 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 editor Default se muestra cuando importa componentes de código usando una solución no administrada o cuando ha usado pac pcf push para instalar su componente de código.

Advertencia de seguridad.

Requisitos previos

  • Se necesita una licencia de Power Apps. Más información: Licencia de Power Apps component framework
  • Se requieren privilegios de administrador del sistema para habilitar la característica de Power Apps component framework en el entorno.

Habilite 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 función 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 Configuración. y luego seleccione Centro de administración.

    Configuración y 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 funciones disponibles, active Power Apps component framework para aplicaciones de lienzo y luego seleccione Guardar.

    Habilitar Power Apps component framework.

Implementar componente de código

Después de habilitar la característica 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, vaya a Cree su primer componente de código.

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 que el archivo .zip de la solución que contiene los componentes del código ya estén importados dentro de Microsoft Dataverse antes de continuar con el siguiente paso.

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

    Insertar componentes.

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

    Importar un componente.

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

    Agrega un componente.

    Nota

    También puede agregar componentes seleccionando Insertar > Personalizado > Importar componente. Esta opción se eliminará en una versión futura, por lo que sugerimos utilizar el flujo descrito anteriormente.

En la pestaña Propiedades, notará que se muestran las propiedades del componente de código.

Panel de propiedades del componente de código predeterminado.

Nota

Los componentes de código existentes se pueden volver a importar actualizando la versión del manifiesto del componente de código si desea que las propiedades estén disponibles en la pestaña Propiedades predeterminada. Como antes, las propiedades seguirán estando disponibles en el panel de 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 luego seleccione la pantalla donde agregó el componente de código.

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

    Eliminar un componente de código.

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

Actualizar componentes de código existentes

Cada vez que actualice los componentes de código y desee ver los cambios en tiempo de ejecución, debe cambiar la propiedad version en el archivo de manifiesto. Le recomendamos que cambie la versión del componente cada vez que realice cambios.

Nota

Los componentes de código existentes solo se actualizan cuando la aplicación se cierra o vuelve a abrirse en Power Apps Studio. 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 actualizará los componentes. Publique primero todas las personalizaciones en la solución actualizada; de lo contrario, no aparecerán las actualizaciones realizadas en el componente de código.

Consulte también

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

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).