Gestion du cycle de vie des applications de bibliothèque de composants (ALM)

Une bibliothèque de composants est un type spécial d’application canevas qui peut contenir un ou plusieurs composants de canevas. Ces composants de bibliothèque peuvent ensuite être utilisés par toutes les autres applications de canevas dans l’environnement. Cette fonctionnalité vous permet de créer des composants partagés réutilisables dans toutes les applications d’un environnement, contrairement aux composants au niveau de l’application qui sont limités à une seule application.

Pour utiliser un composant à partir d’une bibliothèque de composants, vous devez d’abord importer le composant dans l’application canevas. Une fois importé, vous pouvez ajouter le composant à n’importe quel écran d’application. Toutes les mises à jour de la définition du composant à partir de la bibliothèque de composants vous invitent à passer en revue et à incorporer la modification à la demande ou lorsque l’application est ouverte pour modification. Les bibliothèques de composants et les applications dépendantes peuvent également être déplacées vers un autre environnement à l’aide de solutions Microsoft Dataverse standard.

Lorsqu’un composant d’une bibliothèque de composants est importé dans une application canevas, la définition de ce composant est copiée dans la définition de l’application canevas. Une fois qu’une définition de composant a été importée, l’application est « autonome » en ce qui concerne cette définition de composant. Le créateur d’application peut choisir de modifier le composant et de créer des instances locales du composant dans l’application. À ce stade, il n’existe aucun lien direct vers la bibliothèque de composants à partir de laquelle le composant provient. Cette caractéristique d’auto-confinement s’applique également si l’application canevas est ensuite migrée vers un autre environnement où la bibliothèque de composants n’est pas présente. Vous pouvez continuer à créer des instances de la définition de composant importée dans les applications de l’environnement cible, et les applications peuvent toujours être publiées et lues. Aucune nouvelle mise à jour n’est envoyée ou reçue dans l’application consommatrice dans ce cas.

Pour maintenir la relation entre l’application et la bibliothèque de composants, veillez à utiliser la bibliothèque de composants pour apporter des modifications au composant, au lieu de modifier le composant dans l’application consommatrice.

Prise en charge des applications canevas et des bibliothèques de composants

Compatible avec les autres dépendances d’objet solution, si une application canevas importe un composant de canevas à partir d’une bibliothèque de composants, elle aura une dépendance sur cette bibliothèque de composants. Pour déplacer une application vers le nouvel environnement, vous devez empaqueter la bibliothèque de composants à l’intérieur de la même solution ou l’installer en tant que prérequis. La dépendance d’application à la bibliothèque de composants est conservée dans l’environnement cible. À un stade ultérieur, lorsqu’une bibliothèque de composants avec le composant mis à jour est importée à l’aide d’une solution dans l’environnement cible, les applications existantes obtiennent les nouvelles définitions de composants à l’aide du flux de mise à jour de composant standard.

Création et exportation d’une bibliothèque de composants dans une solution

Vous pouvez créer une bibliothèque de composants directement à partir de la solution ou l’ajouter à une solution existante.

Lorsqu’une bibliothèque de composants est enregistrée dans un environnement avec Dataverse disponible, la bibliothèque de composants est automatiquement ajoutée à la solution par défaut. Un nom logique unique est généré pour la bibliothèque de composants avec le préfixe éditeur CDS par défaut. Ce comportement consiste à s’assurer que le système de solution est conscient de sa présence et peut lier les dépendances des applications qui utilisent le nom logique de la bibliothèque de composants.

Les bibliothèques de composants à l’intérieur d’une solution prennent également en charge les personnalisations gérées qui régissent le comportement de la bibliothèque de composants dans l’environnement cible.

Si vous désactivez ce paramètre et exportez la solution dans un environnement cible, vous ne pourrez pas modifier la bibliothèque de composants.

Dépendances de bibliothèque de composants

Les applications qui utilisent des composants de la bibliothèque de composants sont marquées comme dépendantes dans l’infrastructure des solutions. Ce comportement s’applique à toutes les applications ajoutées à n’importe quelle solution Dataverse dans un environnement donné. Vous pouvez toujours créer des applications en dehors des solutions, mais ces applications n’ont aucune dépendance de solution. Vous pouvez ajouter ultérieurement ces applications à des solutions pour les faire partie de la solution ALM.

Si vous importez une solution qui possède uniquement une application qui utilise un composant d’une bibliothèque de composants, mais exclut la bibliothèque de composants, le message suivant s’affiche :

« L’importation a échoué en raison de dépendances manquantes pour <le nom> de l’application ».

Dans ce cas, vous pouvez d’abord installer la solution de bibliothèque de composants ou regrouper la bibliothèque de composants avec la solution qui contient l’application canevas. L’une des étapes garantit que l’application aura la dépendance créée dans l’environnement cible.

Lorsque la bibliothèque est mise à jour et qu’une version plus récente du composant est importée via les solutions, l’application reçoit une notification et reçoit les mises à jour lorsque l’application est ouverte pour modification.

Les dépendances sont calculées en fonction de l’état publié le plus récent d’une application. Si vous restaurez une version antérieure de l’application qui n’utilise pas de composant de bibliothèque, la dépendance est supprimée de l’application et la solution. L’importation d’un composant dans une application à partir d’une bibliothèque de composants sans réellement l’utiliser crée également une dépendance, car le composant de bibliothèque inutilisé reste disponible dans l’application pour une utilisation ultérieure.

Meilleures pratiques et résolution des problèmes

• Limitez le nombre de composants d’une bibliothèque à 20 pour obtenir des performances optimales. Planifiez et créez plusieurs bibliothèques de composants à l’avance, car le nombre de composants dans ceux-ci augmentera probablement au fil du temps. Cette approche réduit également la charge utile de la solution à mesure que les applications sont déplacées dans l’environnement.

• Un délai existe entre la publication de la bibliothèque de composants et sa disponibilité pour l'application, pouvant durer jusqu'à 5 minutes.

• Si l’application n’est pas en mesure de recevoir la mise à jour du composant de bibliothèque dans l’environnement cible où la solution est installée, vérifiez à l’aide des actions ci-dessous :

  • Les modifications apportées à une bibliothèque de composants dans un environnement cible résident dans la couche supérieure d’un composant. Par la suite, ces personnalisations définissent le comportement d’exécution du composant. Pour supprimer ces personnalisations non managées, consultez Supprimer une couche non managée.
  • Déterminez le nom logique de la bibliothèque de composants à partir de la vue solution. Utilisez la solution par défaut si la bibliothèque n’est pas explicitement ajoutée à la solution.
  • Téléchargez l’application à l’aide du composant de bibliothèque sur l’ordinateur local à l’aide de Fichier>Enregistrer sous>Cet ordinateur. Renommez le fichier téléchargé pour avoir une extension .zip et décompressez le package. Ouvrez le fichier Properties.json , puis recherchez le mot clé « LibraryDependencies ». Vous devez voir un nom logique de bibliothèque correspondant.
  • Si vous consommez la solution, vérifiez que l’application canevas a correctement identifié les bibliothèques de composants en tant que dépendances de solution. Si la solution n’identifie pas correctement les bibliothèques de composants en tant que dépendances de solution, cela signifie que la dépendance de l’application au lien de la bibliothèque de composants n’a pas été créée correctement. Dans ce cas, vérifiez auprès du fournisseur de solutions pour résoudre le problème.
  • Si vous êtes l’éditeur de solution, vérifiez que les bibliothèques de composants sont enregistrées avec le nom logique de la bibliothèque dans la solution, et qu’elles sont identiques à celles référencées dans le package .msapp de la bibliothèque de composants.

• L’exportation de solution exporte toujours la dernière version de la bibliothèque de composants. Par conséquent, mettez toujours à jour les applications avec la dernière version du composant avant de les exporter via des solutions. Cette action garantit que les applications ont la même version de composant que disponible dans la dernière version de la bibliothèque de composants. Les applications et les bibliothèques sont considérées comme étant synchronisées entre elles lorsqu'elles sont déplacées pour la première fois vers un environnement cible ; par conséquent, vous ne recevez pas de notification indiquant qu'une mise à jour est disponible lorsque vous modifiez l'application.

Voir aussi

• Composants canevas
• Bibliothèque de composants
• Mapper les champs d’entrée d’un composant
• Ajouter un élément multimédia à un composant
• Formules de comportement pour les composants
• Infrastructure de composants Power Apps
• Ajouter des composants canevas à une page personnalisée dans une application pilotée par modèle