Administración del ciclo de vida de la aplicación de biblioteca de componentes (ALM)

Una biblioteca de componentes es un tipo especial de aplicación de lienzo que puede contener uno o más componentes de lienzo. Estos componentes de la biblioteca pueden ser utilizados por todas las demás aplicaciones de lienzo en el entorno. Esta capacidad le permite crear componentes compartidos reutilizables en todas las aplicaciones de un entorno, a diferencia de componentes de nivel de aplicación que están restringidos a una aplicación.

Para usar un componente de una biblioteca de componentes, primero debe importar el componente a la aplicación de lienzo. Una vez importado, puede agregar el componente a cualquier pantalla de aplicación. Cualquier actualización en la definición del componente de la biblioteca de componentes le pedirá que revise e incorpore el cambio Bajo demanda o cuando la aplicación esté abierta para editar. Las bibliotecas de componentes y las aplicaciones dependientes también se pueden mover a otro entorno utilizando soluciones de Microsoft Dataverse estándar.

Cuando un componente de una biblioteca de componentes se importa a una aplicación de lienzo, la definición de ese componente se copia en la definición de la aplicación de lienzo. Una vez que se ha importado una definición de componente, la aplicación es "autónoma" en lo que respecta a la definición de ese componente. El creador de la aplicación puede optar por editar el componente y crear instancias locales del componente dentro de la aplicación. En este punto, no hay un vínculo directo a la biblioteca de componentes desde donde se originó el componente. Esta característica de autocontención también se aplica si la aplicación de lienzo luego se migra a un entorno diferente donde la biblioteca de componentes no está presente. Puede continuar creando instancias de la definición del componente importado dentro de las aplicaciones en el entorno de destino, y las aplicaciones aún se pueden publicar y reproducir. En este caso, no se solicitarán ni recibirán nuevas actualizaciones en la aplicación de consumo.

Para mantener la relación entre la aplicación y la biblioteca de componentes, asegúrese de usar la biblioteca de componentes para realizar cualquier cambio en el componente, en lugar de editar el componente dentro de la aplicación que lo consume.

Soporte de soluciones de bibliotecas de componentes y aplicaciones de lienzo

En consonancia con las otras dependencias de objetos de la solución, si una aplicación de lienzo importa un componente de lienzo de una biblioteca de componentes, tendrá una dependencia de esa biblioteca de componentes. Para mover una aplicación al nuevo entorno, deberá empaquetar la biblioteca de componentes dentro de la misma solución o instalarla como requisito previo. La dependencia de la aplicación a la biblioteca de componentes se mantiene en el entorno de destino. En un momento posterior, cuando se importe una biblioteca de componentes con el componente actualizado utilizando una solución en el entorno de destino, las aplicaciones existentes obtendrán las nuevas definiciones de componentes utilizando el flujo de actualización de componentes estándar.

Crear y exportar una biblioteca de componentes en una solución

Puede crear una biblioteca de componentes directamente desde la solución o agregarla a una solución existente.

Cuando una biblioteca de componentes se guarda en un entorno que tiene Dataverse disponible, la biblioteca de componentes se agrega automáticamente a la solución predeterminada. Se genera un nombre lógico exclusivo para la biblioteca de componentes con el prefijo Editor de CDS predeterminado. Este comportamiento es para garantizar que el sistema de la solución sea consciente de su presencia y pueda vincular las dependencias de las aplicaciones que usan el nombre lógico de la biblioteca de componentes.

Las bibliotecas de componentes dentro de una solución también admiten las propiedades gestionadas Permitir personalizaciones que rigen el comportamiento de la biblioteca de componentes en el entorno de destino.

Si desactiva esta configuración y exporta la solución a un entorno de destino, no podrá editar la biblioteca de componentes.

Dependencias de la biblioteca de componentes

Las aplicaciones que usan componentes de la biblioteca de componentes se marcarán como dependientes en la infraestructura de soluciones. Este comportamiento se aplica a todas las aplicaciones que se agregan a cualquier solución de Dataverse en un entorno dado. Todavía puede crear aplicaciones fuera de las soluciones, pero esas aplicaciones no tendrán ninguna dependencia de solución. Posteriormente, puede agregar estas aplicaciones a las soluciones para que formen parte de la solución ALM.

Si importa una solución que solo tiene una aplicación que usa un componente de una biblioteca de componentes, pero excluye la biblioteca de componentes, verá el siguiente mensaje:

"Error en la importación debido a que faltan dependencias para <app name>".

En este caso, puede optar por instalar primero la solución de biblioteca de componentes o agrupar la biblioteca de componentes con la solución que contiene la aplicación de lienzo. Cualquiera de los pasos garantizaría que la aplicación tenga la dependencia creada en el entorno de destino.

Cuando la biblioteca se actualice y se importe una versión de componente más reciente a través de las soluciones, la aplicación recibirá una notificación y recibirá las actualizaciones cuando la aplicación esté abierta para editar.

Las dependencias se calculan en función del último estado publicado de una aplicación. Si restaura una versión anterior de la aplicación que no usa un componente de biblioteca, la dependencia se eliminará de la aplicación y la solución. Importar un componente a una aplicación desde una biblioteca de componentes sin usarlo también crea una dependencia, ya que el componente de biblioteca no utilizado permanece disponible dentro de la aplicación para un uso futuro.

Prácticas recomendadas y resolución de problemas

• Limite la cantidad de componentes en una biblioteca a 20 para obtener un rendimiento óptimo. Planifique y cree múltiples bibliotecas de componentes con anticipación, ya que es probable que la cantidad de componentes en ellas crezca con el tiempo. Este enfoque también reducirá la carga útil de la solución a medida que las aplicaciones se muevan por el entorno.

• Hay un retraso desde que se publica la biblioteca de componentes hasta que está disponible para la aplicación y puede demorar hasta 5 minutos.

• Si la aplicación no puede recibir la actualización del componente de la biblioteca en el entorno de destino donde está instalada la solución, verifique con las siguientes acciones:

  • Los cambios realizados en una biblioteca de componentes en un entorno de destino residen en la capa superior de un componente. Posteriormente, estas personalizaciones definen el comportamiento en tiempo de ejecución del componente. Para eliminar estas personalizaciones no administradas, consulte Eliminar una capa no administrada.
  • Determine el nombre lógico de la biblioteca de componentes desde la vista de soluciones. Use la solución predeterminada si la biblioteca no se agrega explícitamente a la solución.
  • Descargue la aplicación usando el componente de la biblioteca al ordenador usando Archivo > Guardar como > Este ordenador. Cambie el nombre del archivo descargado para que tenga una extensión .zip y descomprima el paquete. Abre el archivo Properties.json y luego busque la palabra clave "LibraryDependencies". Debería ver un nombre lógico de biblioteca coincidente.
  • Si está consumiendo la solución, verifique que la aplicación de lienzo haya identificado correctamente las bibliotecas de componentes como dependencias de solución. Si la solución no identifica correctamente las bibliotecas de componentes como dependencias de la solución, eso significa que la dependencia de la aplicación al vínculo de la biblioteca de componentes no se ha creado correctamente. En ese caso, consulte con el proveedor de la solución para resolver el problema.
  • Si es el editor de soluciones, verifique que las bibliotecas de componentes se guarden con el nombre lógico de la biblioteca en la solución y que sea el mismo al que se hace referencia en el paquete .msapp de la biblioteca de componentes.

• La exportación de soluciones siempre exporta la última versión de la biblioteca de componentes. Por lo tanto, actualice siempre las aplicaciones con la última versión del componente antes de exportarlas a través de soluciones. Esta acción garantiza que las aplicaciones tengan la misma versión de componente disponible en la última versión de la biblioteca de componentes. Se considera que las aplicaciones y la biblioteca están sincronizadas entre sí cuando se mueven a un entorno de destino por primera vez; y, por lo tanto, no se le solicita que haya ninguna actualización disponible al editar la aplicación.

Consulte también

• Componentes de lienzo
• Biblioteca de componentes
• 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