Erreur de dépendances manquantes lors de l’importation de la solution

Lorsque vous importez une solution dans un environnement cible dans Microsoft Power Apps, vous pouvez rencontrer des erreurs concernant les dépendances manquantes. Cet article vous aide à identifier la cause des erreurs de dépendance manquantes et fournit des solutions de contournement pour les résoudre. Il inclut également les meilleures pratiques pour vous aider à éviter ces erreurs dans les importations futures de solutions.

S’applique à : Power Platform, Solutions

Symptômes des problèmes de dépendance manquants

Lorsque vous essayez d’importer une solution dans Power Apps, vous recevez un message d’erreur semblable au message suivant :

L’importation a échoué en raison de dépendances manquantes.

Dans ce cas, vous ne pouvez pas continuer l’importation de la solution tant que vous n’avez pas résolu les dépendances manquantes.

Cause des erreurs de dépendance manquantes

Des erreurs de dépendance manquantes se produisent lorsqu’une solution référence des applications ou des composants qui existent dans l’environnement source, mais pas dans l’environnement cible. Ces composants peuvent inclure des tables, des colonnes, des formulaires ou d’autres éléments de solution.

Ce problème peut se produire si les applications sont mises à niveau vers leur dernière version (via la maintenance planifiée de Microsoft) dans l’environnement source, mais pas dans l’environnement cible.

Solution de contournement 1 : Résoudre les erreurs de dépendance manquantes

Pour contourner ce problème, effectuez les étapes suivantes :

1. Accédez à la page Dépendances manquantes en sélectionnant le bouton Afficher les dépendances . Cette page répertorie tous les composants manquants et les trie dans les catégories suivantes :

   • Applications
   • Solutions gérées
   • Composants non managés

   Conseil

   Une autre méthode pour rechercher des dépendances de composants consiste à ouvrir le fichier solution, à le développer, puis à ouvrir le fichier solution.xml . Dans ce fichier, recherchez l’élément <MissingDependencies> qui répertorie toutes les dépendances manquantes.

2. Développez chaque section de dépendances et atténuez le problème en fonction du type de dépendances décrit dans les sections suivantes. Une fois les dépendances manquantes restaurées ou mises à jour, réessayez l’importation.

Dépendances manquantes provenant d’une application Dynamics 365

Ce problème se produit si la solution s’appuie sur les composants des applications Dynamics 365 manquantes ou obsolètes dans l’environnement cible. Vous trouverez ces dépendances dans la section Applications de la page Dépendances manquantes . Chaque entrée fournit des détails sur l’application manquante au format suivant :

<solution_name> (<solution_version>) de <application_name>

En regard du nom de l’application, il s’agit d’un bouton Installer ou mettre à jour qui vous redirige vers le Centre d’administration Power Platform.

Pour contourner ce problème, utilisez l’une des méthodes suivantes :

• Si l’application n’est pas installée dans l’environnement cible :

  • Les administrateurs système peuvent utiliser le bouton Installer pour être redirigé vers la page d’installation de l’application dans le Centre d’administration Power Platform. Vous pouvez également accéder directement à la page d’installation de l’application pour installer l’application dans le Centre d’administration Power Platform.
  • Les administrateurs non système peuvent utiliser le bouton Copier le lien Installer pour copier le lien d’installation de l’application et demander à leur administrateur système d’installer l’application.

• Si l’application est installée mais obsolète dans l’environnement cible :

  • Les administrateurs système peuvent utiliser le bouton Mettre à jour pour ouvrir la page de mise à jour de l’application dans le Centre d’administration Power Platform.
  • Les administrateurs non système peuvent utiliser le bouton Copier le lien de mise à jour pour copier le lien de mise à jour de l’application et demander à leur administrateur système de mettre à jour l’application.

Dépendances manquantes provenant d’une application Dynamics 365 tierce

Une solution peut dépendre uniquement des composants des applications Dynamics 365 internes manquantes ou obsolètes dans l’environnement cible. Dans ce cas, le système peut être en mesure de mettre à jour ou d’installer automatiquement ces composants, et aucune action manuelle n’est nécessaire de la part de l’utilisateur. La page Dépendances manquantes affiche l’option Déployer les dépendances . Si vous sélectionnez cette option, puis sélectionnez le bouton Importer , le système installe ou met à jour les dépendances requises, puis importe la solution. Si la mise à jour ou l’installation d’une application dépendante échoue, l’importation de solution échoue également. Vous pouvez suivre l’état de ces mises à jour ou installations sur la page d’historique des solutions.

Dépendances manquantes provenant d’une autre solution managée

Ce problème se produit lorsque la solution s’appuie sur des composants d’une autre solution managée manquante dans l’environnement cible. Vous trouverez ces dépendances dans la section Solutions managées de la page Dépendances manquantes . Développez la section pour afficher des détails supplémentaires.

Pour contourner ce problème, importez la même version de la solution installée dans l’environnement source dans l’environnement cible.

Dépendances manquantes sur les solutions « Actives »

Ce problème se produit lorsque la solution s’appuie sur des personnalisations non managées à partir de l’environnement source manquant dans l’environnement cible. Vous trouverez ces dépendances dans la section Composants non managés de la page Dépendances manquantes . Le développement de la section fournit des détails supplémentaires.

Pour contourner ce problème, revenez à l’environnement source, incluez les composants manquants, réexportez la solution, puis importez-la dans l’environnement cible.

Solution de contournement 2 : Meilleures pratiques pour éviter les erreurs de dépendance manquantes

Lorsque vous créez une solution dans Power Platform, vous réutilisez souvent les composants existants pour améliorer la cohérence et la vitesse de développement. Il existe quelques éléments clés à prendre en compte pour réutiliser des objets existants entre les environnements.

Disponibilité des composants dans les environnements cibles

Si votre solution a des dépendances sur des composants (tels que des tables, des flux ou des applications) dans l’environnement source, ces composants doivent également exister dans l’environnement cible lorsque vous déployez la solution. Cette exigence s’applique aux déploiements de pipeline et à l’importation manuelle. Si des composants sont manquants dans l’environnement cible, une erreur de dépendance manquante se produit lors de l’importation.

Sélectionner uniquement les composants nécessaires

Pour éviter les problèmes de dépendance, n’incluez pas de tables ou de composants entiers si vous n’avez besoin que d’un sous-ensemble de leurs éléments (par exemple, des colonnes, des vues ou des formulaires spécifiques). L’ajout d’éléments inutiles peut entraîner :

• Complexité accrue de la solution
• Plusieurs couches managées appliquées aux composants
• Conflits potentiels pendant les mises à jour

Au lieu de cela, incluez uniquement les parties du composant que votre solution utilise activement.

Éviter de modifier des composants dans des solutions managées

N’apportez pas de modifications directement aux composants qui font partie d’une solution managée. Ces modifications créent une couche non managée au-dessus du composant managé. Cette couche non managée peut :

• Ignorer les mises à jour de la solution managée source
• Provoquer des incohérences entre les environnements
• Empêcher les modifications (telles que les mises à jour des flux Power Automate ou des configurations de table) d’être reflétées correctement après le déploiement

Appliquez toujours des modifications dans une solution non managée ou étendez les fonctionnalités à l’aide de la couche de solution. Pour plus d’informations sur la couche de solution, consultez Couches de solution.

Éviter les dépendances sur les applications déconseillées

Évitez de prendre des dépendances sur les applications déconseillées. Les applications déconseillées ne sont plus disponibles pour l’installation ou la mise à jour. Vous trouverez ces dépendances dans la section Applications déconseillées de la page Dépendances manquantes . Le développement de la section fournit des détails supplémentaires.

Supprimez les dépendances entre les composants de solution et les applications déconseillées avant d’importer votre solution.

Contenu connexe

• Organiser vos solutions
• Mise en application du vérificateur de solution