Partager via

Résoudre les problèmes d'ajout d'une source de données (preview)

Cet article fournit des étapes de résolution des problèmes lorsque la commande pac code add-data-source échoue dans le CLI (Interface de ligne de commande Power Apps).

Symptômes

Les défaillances se produisent généralement parce que quelque chose sur votre ordinateur ou réseau bloque la connexion ou interrompt l’authentification.

Symptôme Exemple de message
Échec de la récupération Fetch Failed (aucune pile supplémentaire)
Délai d’expiration/ erreurs réseau ETIMEDOUT, ENOTFOUNDECONNRESET
Incompatibilité de l’environnement Source de données introuvable/ schéma inattendu

Prerequisites

  1. Vérifiez que l’interface CLI Power Platform la plus récente est installée. Mettez-la à jour si vous n’êtes pas sûr.
  2. Vérifiez que vous êtes authentifié dans l’environnement approprié. Utilisez pac auth create et pac auth list commandes.
  3. Vérifiez que votre réseau autorise les appels HTTPS sortants vers les points de terminaison Power Platform.

Étapes de dépannage

Pour diagnostiquer la cause racine, procédez comme suit :

Étape 1 : Valider la configuration

Ouvrez power.config.json le fichier et confirmez :

  • environmentId correspond à l’environnement que vous envisagez de cibler.
  • region est défini sur prod, sauf si vous ciblez intentionnellement une autre région. Ajoutez-la si elle est manquante.

Étape 2 : Contexte de l’environnement de vérification croisée

Exécutez la commande pac env who.

Comparez le Environment ID résultat dans la sortie avec la environmentId valeur dans power.config.json.

Exemple de sortie (annotée) :

Connected as user@domain.com
Organization Information
  Org ID:                     00aa00aa-bb11-cc22-dd33-44ee44ee44ee
  Unique Name:                unq2889ab2be728ef118406000d3a33f
  Friendly Name:              User Name
  Org URL:                    https://myorg.crm.dynamics.com/
  User Email:                 user@domain.com
  User ID:                    aaaaaaaa-bbbb-cccc-1111-222222222222
  Environment ID:             aaaabbbb-0000-cccc-1111-dddd2222eeee  <-- Ensure this matches

Exemple d’extrait de code correspondant power.config.json :

{
  "environmentId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "region": "prod"
}

Étape 3 : Réexécuter la commande

Réexécutez la commande pac code add-data-source. Par exemple:

pac code add-data-source -a dataverse -t account

Recherchez les codes d’état HTTP ou les messages d’erreur dans la sortie.

Étape 4 : Validation du réseau et de la sécurité

En cas d’échec :

Vérifier la connectivité du navigateur

Cette étape permet de confirmer que votre compte d’utilisateur dispose des autorisations appropriées et que la source de données est accessible à partir de votre ordinateur.

  1. Ouvrez un navigateur web sur le même ordinateur que celui sur lequel vous utilisez l’interface CLI PAC.
  2. Accédez directement à la source de données que vous essayez d’ajouter. Par exemple, le site SharePoint ou l’URL de l’environnement Dataverse.
  3. Connectez-vous avec les mêmes informations d’identification que celles que vous avez utilisées pour vous authentifier auprès de la commande pac CLI pac auth create
  4. Si vous ne pouvez pas accéder à la ressource, un problème d’autorisations avec votre compte d’utilisateur est la cause racine probable.
  5. Si vous pouvez y accéder, accédez à Analyser le trafic réseau.

Analyser le trafic réseau

Il s’agit du moyen le plus efficace d’afficher les données de communication réseau brutes entre l’interface CLI PAC et le point de terminaison de la source de données.

  1. Téléchargez et installez Fiddler Classic. Fiddler est un outil permettant de surveiller le trafic réseau.

  2. Démarrez Fiddler et assurez-vous qu’il capture le trafic. Accédez à Fichier>Capture Traffic.

  3. Dans une invite de commandes, exécutez la commande défaillante pac code add-data-source .

  4. Dans la liste des sessions Fiddler, recherchez les demandes adressées à votre point de terminaison de source de données. Par exemple : yourorg.crm.dynamics.com ou yourtenant.sharepoint.com.

  5. Analysez les informations de réponse :

    • Un code d’état 200 indique la réussite.
    • Un 401 code d’état (non autorisé) ou 403 (interdit) pointe vers un problème d’authentification ou d’autorisation.
    • D’autres codes d’erreur ou un manque complet de réponse peuvent indiquer qu’un pare-feu ou un proxy bloque la requête.

Étape 5 : Effacer/réinitialiser le contexte d’authentification

Si une incompatibilité est détectée, vous devez effacer ou réinitialiser le contexte d’authentification à l’aide des commandes PAC CLI suivantes.

pac auth list
pac auth select --index <n>
pac env who

Si elle est incorrecte, ré-authentifiez :

pac auth create --environment <yourEnvironmentId>

Données d’escalade

Avant de contacter le support technique pour émettre un problème, collectez les données suivantes.

Fournissez :

  • Version CLI. Utiliser la pac --version commande
  • Système d’exploitation et interpréteur de commandes (Windows cmd / PowerShell / WSL)
  • Commande complète utilisée
  • Extrait de sortie de débogage assaini
  • power.config.json après avoir rédigé des clés secrètes
  • Last updated on