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

Une bibliothèque de composants est un type spécial d’application canevas qui peut contenir un ou plusieurs composants canevas. Ces composants de bibliothèque peuvent ensuite être utilisés par toutes les autres applications canevas de 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 d’une bibliothèque de composants, vous devez d’abord importer le composant dans l’application canevas. Une fois importé, vous pouvez ensuite ajouter le composant à n’importe quel écran d’application. Toute mise à jour de la définition de composant à partir de la bibliothèque de composants vous invitera à examiner et à intégrer la modification à la demande ou quand 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 des solutions Microsoft Dataverse standard.

Quand 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 de l’application peut choisir de modifier le composant, et créez des instances locales du composant dans l’application. À ce stade, il n’y a pas de lien direct vers la bibliothèque de composants d’où provient le composant. Cette caractéristique d’autonomie s’applique également si l’application canevas est ensuite migrée vers un environnement différent 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 ne sera demandée ou reçue dans l’application consommatrice dans ce cas.

Afin de 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

Conformément aux autres dépendances d’objet de solution, si une application canevas importe un composant 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 soit empaqueter la bibliothèque de composants dans la même solution, soit l’installer en tant que condition préalable. La dépendance entre l’application et la bibliothèque de composants est conservée dans l’environnement cible. Ultérieurement, quand 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 obtiendront les nouvelles définitions de composants à l’aide du flux de mise à jour des composants habituel.

Créer et exporter 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.

Quand 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 permet de 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 propriétés gérées Allow customizations 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 vers un environnement cible, vous ne pourrez pas modifier la bibliothèque de composants.

Dépendances de la bibliothèque de composants

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

Si vous importez une solution qui n’a qu’une application qui utilise un composant d’une bibliothèque de composants, mais exclut la bibliothèque de composants, vous verrez le message suivant :

"L’importation a échoué en raison de dépendances manquantes pour <app name>".

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

Quand la bibliothèque est mise à jour et qu’une nouvelle version de composant est importée via les solutions, l’application reçoit une notification et reçoit les mises à jour quand l’application est ouverte pour modification.

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

Recommandations et résolution des problèmes

• Limitez le nombre de composants dans 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 qu’elles contiennent augmentera probablement avec le temps. Cette approche réduira également la charge utile de la solution à mesure que les applications sont déplacées dans l’environnement.

• Il y a un délai entre le moment où la bibliothèque de composants est publiée et celui où elle est disponible pour l’application, et cela peut prendre jusqu’à 5 minutes.

• Si l’application ne peut pas recevoir la mise à jour du composant de bibliothèque dans l’environnement cible où la solution est installée, vérifiez en utilisant les 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 gérées, consultez Supprimer une couche non gérée.
  • Déterminez le nom logique de la bibliothèque de composants à partir de la vue de la 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 Dossier > 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 devriez voir un nom logique de bibliothèque correspondant.
  • Si vous utilisez la solution, vérifiez que l’application canevas a correctement identifié les bibliothèques de composants comme dépendances des solutions. Si la solution n’identifie pas correctement les bibliothèques de composants en tant que dépendances de la 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, contactez le fournisseur de solutions pour résoudre le problème.
  • Si vous êtes l’éditeur de solutions, vérifiez que les bibliothèques de composants sont enregistrées avec le nom logique de la bibliothèque dans la solution et qu’il est identique à celui référencé 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 celle disponible dans la dernière version de la bibliothèque de composants. Les applications et la bibliothèque sont considérées comme synchronisées lorsqu’elles sont déplacées vers un environnement cible pour la première fois ; et par conséquent, aucune mise à jour ne vous est demandée lors de la modification de l’application.

Voir aussi

• Composants de 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
• Power Apps component framework
• Ajouter des composants canevas à une page personnalisée dans une application pilotée par modèle