L'autocomplétion d'adresse, la validation email/téléphone, les suggestions d'entreprise (B2B) et la validation de nom appellent toutes des webservices DQE via les Custom API Dynamics. Lorsque quelque chose est mal configuré, ces fonctionnalités n'affichent généralement pas de message d'erreur sur le formulaire — elles arrêtent simplement de renvoyer des suggestions, comme si de rien n'était. Cet article explique les causes réelles les plus fréquentes et où trouver la raison exacte.
Symptômes courants
- Aucune suggestion d'adresse n'apparaît pendant la saisie dans un champ adresse.
- La comparaison de validation d'adresse RNVP n'apparaît pas à l'enregistrement, ou ignore silencieusement un bloc d'adresse.
- Les recherches téléphone, email, entreprise ou nom ne renvoient jamais aucun résultat.
- Rien ne s'affiche sur le formulaire lui-même pour expliquer pourquoi — pas de bandeau, pas de notification d'erreur.
Pourquoi rien ne s'affiche sur le formulaire
Ces fonctionnalités sont conçues pour échouer silencieusement : si l'appel Custom API sous-jacent renvoie une erreur, le contrôle PCF ou la boîte de dialogue de validation d'adresse l'ignore simplement et n'affiche aucune suggestion, plutôt que d'interrompre l'utilisateur avec une fenêtre d'erreur. La vraie raison est écrite à deux endroits à la place :
- Le Plug-in Trace Log de l'environnement — toujours, pour chaque champ (adresse, email, téléphone, nom, entreprise).
- La console du navigateur (F12 → Console) — en plus, spécifiquement pour la comparaison de validation d'adresse affichée à l'enregistrement.
Activer et consulter le Plug-in Trace Log
- Ouvrez le Power Platform admin center, allez dans Manage → Environments, et sélectionnez l'environnement cible.
- Cliquez sur Settings → Resources → All legacy settings pour ouvrir l'ancienne interface Settings.
- Si la journalisation n'est pas encore activée, allez dans Settings → Administration → System Settings, ouvrez l'onglet Customization, et positionnez Enable logging to plug-in trace log sur Exception ou All.
- Reproduisez le problème (saisissez dans le champ, ou enregistrez la fiche), puis allez dans Settings → Customization → Plug-in Trace Log et ouvrez l'entrée la plus récente pour la Custom API DQE testée. Le message contiendra l'un des messages exacts ci-dessous.
Remarque : le libellé exact dans le trace log dépend de la langue d'interface Dynamics de l'utilisateur ayant déclenché l'action. DQE ne dispose de traductions que pour l'anglais, le français et l'espagnol. Dans toute autre langue d'interface (y compris l'allemand), chacune de ces erreurs est journalisée avec le même texte générique de repli au lieu du message spécifique ci-dessous — dans ce cas, basculez temporairement votre langue personnelle sur anglais, français ou espagnol (Settings → Personalization Settings → Languages) pour voir de quel message il s'agit réellement, ou testez les causes du tableau ci-dessous une par une.
Ce que signifie chaque message
| Message trouvé dans le trace log | Ce que cela signifie | Où le corriger |
|---|---|---|
| « L'enregistrement "DQE Paramétrages DataQ" est introuvable. Veuillez le créer pour poursuivre l'opération. » | Aucun enregistrement DQE DataQ Settings n'existe encore dans cet environnement (le message utilise un ancien nom interne, "DQE Paramétrages DataQ" — il s'agit du même enregistrement). | Complétez DQE DataQ Settings comme décrit dans DQE One Package Setup §2. |
| « La licence est absente dans le paramétrage \"DQE Paramétrages DataQ\". Veuillez la renseigner pour poursuivre. » (les antislashs autour des guillemets sont bien réels — un bug d'échappement dans le produit, pas une erreur de frappe dans cet article) | L'enregistrement DataQ Settings existe, mais son champ DQE Licence est vide. | DQE DataQ Settings → General → DQE Licence (Package Setup §2.2). |
| « Licence invalide. Veuillez vérifier votre clé de licence. » | Une clé de licence est renseignée, mais le serveur de licence DQE l'a rejetée — généralement une clé erronée, expirée ou mal saisie, ou un Org ID pour lequel la clé n'est pas autorisée. | Vérifiez la clé auprès de celle fournie par votre chef de projet DQE ; contactez-le si cela persiste. |
| « URL de l'API DQE Address manquante » | Le champ Adresse de l'API DQE dans DataQ Settings est vide. | DQE DataQ Settings → General → Adresse de l'API DQE (Package Setup §2.3). |
| « Le code pays ISO3 est manquant » | DQE n'a pas pu résoudre de code pays ISO3 pour la fiche — voir ci-dessous. | Voir Résolution du pays ci-dessous. |
Résolution du pays (« Le code pays ISO3 est manquant »)
Avant d'appeler le webservice DQE, DQE résout d'abord un code pays ISO3 pour la fiche : il regarde d'abord le champ pays propre à la fiche (via la table pays DQE), et si cela ne se résout pas, il se rabat sur le champ Address Default Country configuré dans DataQ Settings. L'erreur n'apparaît que lorsque les deux résolutions échouent. Vérifiez, dans cet ordre :
- Le champ pays propre à la fiche a une valeur, et cette valeur existe dans la table pays DQE avec un code ISO3 valide.
- Si le champ pays de la fiche est vide ou non mappé, que DQE DataQ Settings → Address Default Country est positionné sur une valeur valide.
Quand contacter le support DQE
Si le Plug-in Trace Log n'affiche aucun des messages ci-dessus, ou affiche un message générique « Une erreur est survenue lors de l'exécution du plugin », la cause est extérieure aux vérifications de configuration propres à DQE (par exemple, un problème réseau ou côté serveur DQE). Partagez l'entrée exacte du trace log avec votre chef de projet DQE.
Articles liés
- DQE One Package Setup on PowerApps / Dynamics
- Configure address, email, phone, name and B2B validation in Dynamics
Associé à