Biblioteca de componentes

En el artículo visión general para crear componentes, se le presentan los componentes dentro de la aplicación de lienzo. A medida que crea componentes dentro de una aplicación, también puede crear una biblioteca de componentes que se pueden reutilizar. Al crear una biblioteca de componentes, los fabricantes de aplicaciones comparten y actualizan fácilmente uno o más componentes con otros fabricantes.

Las bibliotecas de componentes son contenedores de definiciones de componentes que facilitan:

• Descubrir y buscar componentes.
• Publicar actualizaciones.
• Notificar a los creadores de aplicaciones las actualizaciones de componentes disponibles.

Nota

Las bibliotecas de componentes son la forma recomendada de reutilizar los componentes en las aplicaciones. Cuando se usa una biblioteca de componentes, una aplicación mantiene dependencias en los componentes que usa. El creador de la aplicación recibirá una alerta cuando las actualizaciones de los componentes dependientes estén disponibles. Por lo tanto, todos los nuevos componentes reutilizables se deben crear dentro de las bibliotecas de componentes. Se retirará una característica anterior de Power Apps que permitía importar componentes de una aplicación de lienzo a otra.

Diferencia entre una aplicación y una biblioteca de componentes

Una biblioteca de componentes proporciona un repositorio centralizado y administrado de componentes para su reutilización.

El panel Insertar de la navegación de la izquierda utiliza el valor predeterminado de una pestaña de componentes si crea una biblioteca de componentes. Cuando crea una aplicación, esta vista muestra pantallas en lugar de componentes.

Las pantallas dentro de una biblioteca de componentes están disponibles solo para pruebas. Proporciona a los creadores de la biblioteca una forma de probar rápidamente los componentes creados en una pantalla real y también de validar el comportamiento de actualización a medida que los componentes se mejoran con el tiempo. Para usar los componentes de la biblioteca de componentes, debe crear una aplicación que use la biblioteca de componentes.

Puede obtener una vista previa de los componentes de la biblioteca de componentes utilizando las pantallas dentro de la biblioteca con la opción de reproducción. Cuando selecciona la pestaña del componente, la opción de reproducción se deshabilita. La biblioteca de componentes no aparece si se usa Power Apps Mobile.

Nota

La biblioteca de componentes discutida en este artículo es diferente del Power Apps Component Framework que permite a los desarrolladores y creadores crear componentes de código para aplicaciones basadas en modelos y de lienzo. Para más información, vaya a la sección de Información general sobre Power Apps Component Framework.

Trabajo con la biblioteca de componentes

Puede crear una nueva biblioteca de componentes o editar una biblioteca de componentes existente desde la misma interfaz. Vaya a Power Apps > seleccione Más desde la navegación izquierda > seleccione Descubrir todo > seleccione Bibliotecas de componentes en la sección Mejoras de la aplicación. También puede anclar la opción Bibliotecas de componentes a su interfaz de Power Apps. Más información: Navegación izquierda en Power Apps

Crear una biblioteca de componentes de ejemplo

Los pasos para crear componentes dentro de una biblioteca de componentes son los mismos que para crear componentes dentro de una aplicación. Creará una biblioteca de componentes y luego reutilizará los pasos para crear componentes desde el ejemplo de información general de componentes. Luego usará la biblioteca de componentes para proporcionar los componentes reutilizables en una nueva aplicación.

1. Inicie sesión en Power Apps.

2. Seleccione Bibliotecas de componentes en el panel de navegación izquierdo y luego Nueva biblioteca de componentes. De forma alternativa, seleccione Más desde la navegación izquierda > seleccione Descubrir todo > seleccione Bibliotecas de componentes en la sección Mejoras de la aplicación.

3. Asigne a la biblioteca de componentes el nombre Componentes de menú ; también puede proporcionar un nombre diferente de su elección.

4. Siga los pasos para crear componentes desde el ejemplo de información general de componentes. No tiene que abrir Power Apps Studio ni crear una nueva aplicación en blanco, ya que ya ha creado una nueva biblioteca de componentes. Inicio con paso 2.

   Después de seguir los pasos para crear componentes, siga el siguiente conjunto de pasos también para agregar componentes a una pantalla y los pasos para crear propiedad de salida.

5. Después de completar la creación y prueba de componentes, guarde la biblioteca de componentes seleccionando el menú Archivo y luego Guardar.

   También tiene una opción para guardar una nota de versión. Una nota de versión es útil para recuperar versiones de una biblioteca de componentes y para actualizar los componentes utilizados en las aplicaciones de esta biblioteca de componentes.

   

   Sugerencia

   Una nota de versión es útil al revisar las versiones de una biblioteca de componentes y para que los creadores de aplicaciones usen su biblioteca de componentes para revisar los cambios y actualizar las aplicaciones que consumen estos componentes según sea necesario. Vaya a actualizar una biblioteca de componentes para ver más detalles.

6. Se puede publicar una biblioteca de componentes guardada. Solo las actualizaciones de la biblioteca de componentes publicadas están disponibles para las aplicaciones que consumen una biblioteca de componentes. Seleccione Publicar para publicar la versión de la biblioteca de componentes:

   

Personalización de componentes de biblioteca

Al crear un componente dentro de una biblioteca de componentes, tiene la opción de permitir que el componente se personalice cuando lo utilicen aplicaciones que usen los componentes de la biblioteca. Esta opción se encuentra Activada de forma predeterminada. Cambie esta configuración a Desactivada para quitar la capacidad de personalizar el componente mientras se usa en otras aplicaciones.

Cuando agrega un componente que permite la personalización, verá una opción para editar este componente para una personalización adicional. La aplicación realiza una copia local y puede realizar cambios en la copia del componente local. La asociación con la biblioteca de componentes se quita una vez que se edita el componente.

La selección de Editar componente le solicita que copie el componente localmente para personalizarlo.

Sin embargo, cuando no permite que los componentes se personalicen, las aplicaciones consumidoras no mostrarán la opción de editar el componente.

En este caso, la única forma de editar el componente es editar la biblioteca de componentes donde está almacenado.

Importar desde una biblioteca de componentes

Después de crear y publicar una biblioteca de componentes, las aplicaciones pueden consumir los componentes de esta biblioteca de componentes importando la biblioteca. Usted también puede compartir una biblioteca de componentes.

Para importar desde una biblioteca de componentes, edite una aplicación existente o cree una nueva aplicación. Después de que se abra la aplicación en el estudio de aplicaciones de lienzo, seleccione Insertar o + en el panel de navegación izquierdo. Luego seleccione Obtener más componentes para enumerar las bibliotecas de componentes disponibles en el entorno actual:

Verá la lista de bibliotecas de componentes disponibles en el entorno actual en el lado derecho de la pantalla. Seleccione un componente individual de una biblioteca de componentes. O use Seleccionar todo para importar todos los componentes de la biblioteca a la vez:

Nota

Si un creador no ve la biblioteca de componentes en la sección de importación, asegúrese de que la biblioteca de componentes se comparta con el creador. Para obtener más detalles, vaya a permisos de biblioteca de componentes.

Tenga en cuenta que puede seleccionar e importar más de un componente y en diferentes bibliotecas de componentes.

Los componentes disponibles dentro de la aplicación se enumeran en la categoría Personalizado en una lista de componentes en el panel Insertar. Los componentes disponibles de las bibliotecas de componentes importadas se enumeran en la categoría Componentes de la biblioteca:

Actualizar una biblioteca de componentes

Puede modificar una biblioteca de componentes existente y guardar los cambios con otras notas de versión. Sin embargo, la versión actualizada de la biblioteca de componentes debe publicarse para su uso en aplicaciones existentes que utilicen la biblioteca de componentes. Los pasos anteriores del ejemplo de biblioteca de componentes explican cómo publicar una biblioteca de componentes después de guardarla.

Hay dos formas en que las aplicaciones que utilizan los componentes de la biblioteca pueden obtener los últimos cambios.

Método 1: notificación de actualización de componentes al editar la aplicación

Los fabricantes de otras aplicaciones reciben notificaciones de los componentes actualizados disponibles. La notificación aparece cuando los creadores editan las aplicaciones en el estudio de aplicaciones de lienzo. Pueden elegir actualizar los componentes:

Seleccione Revisar y verá la opción de actualizar el componente:

Observe que la nota de versión que agregó al publicar la versión de la biblioteca de componentes aparece aquí.

Seleccione Actualizar para actualizar los componentes.

Método 2: comprobación proactiva de actualizaciones

Este método consiste en comprobar la actualización de la aplicación de forma proactiva mientras se trabaja en la aplicación en Studio.

Para realizar esta comprobación, seleccione Insertar panel de componentes en el lado izquierdo y luego seleccione ... (puntos suspensivos) junto al botón de búsqueda. Y después seleccione Comprobar actualizaciones.

Si hay actualizaciones en los componentes utilizados de la biblioteca, el fabricante recibirá el mensaje para revisar y obtener los últimos cambios. Tras la revisión y actualización, la aplicación se actualiza con los últimos componentes.

La siguiente animación muestra el proceso para obtener los últimos componentes.

Actualización de un componente desde una biblioteca de componentes en una aplicación de consumo

Si importa un componente desde una biblioteca de componentes, no puede editarlo dentro de la aplicación que lo usa. Si selecciona Editar componente, verá una opción para crear una copia del componente dentro de la aplicación actual para que pueda realizar cambios:

Si selecciona Crear una copia, el componente se copia en la aplicación local. La copia local del componente aparece en la categoría Personalizado en el panel Insertar. Esta copia local del componente no recibirá actualizaciones si posteriormente se publica una nueva versión de la biblioteca de componentes de origen.

Nota

Las instancias en uso de los componentes de la biblioteca de componentes no se verán afectadas después de crear una copia local de un componente y permanecerán vinculadas a la definición de la biblioteca de componentes. Solo las instancias de los componentes copiados localmente (desde la categoría Personalizada) se consideran los componentes de la aplicación local.

Eliminar una biblioteca de componentes

Si una aplicación de lienzo hace referencia a una biblioteca de componentes, no se puede eliminar. Esto es cierto para Power Platform y entornos que no sean de Power Platform. Elimine el componente de la aplicación antes de eliminar la biblioteca. Puede encontrar información sobre las aplicaciones que usan la biblioteca de componentes en la vista de dependencias de la solución o en el mensaje que se muestra cuando intenta eliminar la biblioteca.

Permisos de biblioteca de componentes

La opción de compartir una biblioteca de componentes funciona de la misma manera que se comparte una aplicación de lienzo. Cuando comparte una biblioteca de componentes, permite que otros reutilicen la biblioteca de componentes. Una vez compartida, otros pueden editar la biblioteca de componentes e importar componentes de la biblioteca de componentes compartidos para crear y editar aplicaciones. Si se comparte como copropietario, un usuario puede usar, editar y compartir una biblioteca de componentes pero no eliminar ni cambiar el propietario.

Consideraciones adicionales al compartir bibliotecas de componentes a grupos de seguridad:

• No puede compartir la interfaz de usuario al compartir bibliotecas de componentes creadas como parte de una solución. En su lugar, utilice el cmdlet Set-PowerAppRoleAssignment con el nivel de permiso CanEdit para compartir las bibliotecas de componentes con el grupo de seguridad seleccionado.
• Las bibliotecas de componentes creadas en un entorno de Power Platform sin una base de datos de Dataverse y compartidas como Copropietario otorgan automáticamente el permiso CanEdit al grupo de seguridad seleccionado.

Limitaciones conocidas

• Las limitaciones conocidas aplicables a los componentes también se aplica a bibliotecas de componentes.

• No puede importar componentes de una biblioteca de componentes guardada localmente. Es posible guardar una biblioteca de componentes usando Archivo > Guardar como > Este ordenador. Pero si intenta importar dicha biblioteca de componentes guardada, verá el siguiente mensaje de error:

  

• Si importa una aplicación y una biblioteca de componentes en un entorno por primera vez, asegúrese de que la aplicación use la última versión del componente incluido con la biblioteca de componentes. De lo contrario, la aplicación no recibirá actualizaciones después de la importación. La aplicación reconocerá y solicitará la versión actualizada en las importaciones posteriores de la biblioteca de componentes al mismo entorno.

• Los componentes de código no se admiten dentro de las bibliotecas de componentes.

Consulte también

• Componentes de lienzo
• Administración del ciclo de vida de la aplicación de biblioteca de componentes (ALM)
• Asignar campos de entrada de un componente
• Agregar elementos multimedia a un componente
• Fórmulas de comportamiento para componentes
• Power Apps component framework
• Agregar componentes de lienzo a una página personalizada en una aplicación basada en modelos

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