Adressautovervollständigung, E-Mail-/Telefonvalidierung, Firmenvorschläge (B2B) und Namensvalidierung rufen alle DQE-Webservices über Dynamics Custom APIs auf. Wenn etwas falsch konfiguriert ist, zeigen diese Funktionen in der Regel keine Fehlermeldung im Formular an — sie liefern einfach keine Vorschläge mehr, als wäre nichts geschehen. Dieser Artikel erklärt die häufigsten tatsächlichen Ursachen und wo Sie den genauen Grund finden.
Häufige Symptome
- Beim Tippen in ein Adressfeld erscheinen keine Adressvorschläge.
- Der RNVP-Adressabgleich erscheint beim Speichern eines Datensatzes nicht, oder überspringt stillschweigend einen Adressblock.
- Telefon-, E-Mail-, Firmen- oder Namensabfragen liefern nie ein Ergebnis.
- Im Formular selbst wird nichts angezeigt, das den Grund erklärt — kein Banner, keine Fehlerbenachrichtigung.
Warum im Formular nichts angezeigt wird
Diese Funktionen sind so konzipiert, dass sie stillschweigend fehlschlagen: Wenn der zugrunde liegende Custom-API-Aufruf einen Fehler zurückgibt, verwirft das PCF-Steuerelement oder der Adressvalidierungsdialog diesen einfach und zeigt keine Vorschläge an, anstatt den Benutzer mit einem Fehler-Popup zu unterbrechen. Der eigentliche Grund wird stattdessen an zwei Stellen festgehalten:
- Das Plug-in Trace Log der Umgebung — immer, für jedes Feld (Adresse, E-Mail, Telefon, Name, Firma).
- Die Browser-Konsole (F12 → Console) — zusätzlich, speziell für den beim Speichern angezeigten Adressabgleich.
Das Plug-in Trace Log aktivieren und auslesen
- Öffnen Sie das Power Platform admin center, gehen Sie zu Manage → Environments und wählen Sie die Zielumgebung aus.
- Klicken Sie auf Settings → Resources → All legacy settings, um den klassischen Settings-Bereich zu öffnen.
- Falls die Protokollierung noch nicht aktiviert ist, gehen Sie zu Settings → Administration → System Settings, öffnen Sie die Registerkarte Customization, und setzen Sie Enable logging to plug-in trace log auf Exception oder All.
- Reproduzieren Sie das Problem (tippen Sie in das Feld, oder speichern Sie den Datensatz), gehen Sie dann zu Settings → Customization → Plug-in Trace Log und öffnen Sie den neuesten Eintrag für die getestete DQE Custom API. Die Meldung enthält eine der unten stehenden genauen Nachrichten.
Hinweis: der genaue Wortlaut im Trace Log hängt von der Dynamics-Oberflächensprache des Benutzers ab, der die Aktion ausgelöst hat. DQE verfügt nur über Übersetzungen für Englisch, Französisch und Spanisch. In jeder anderen Oberflächensprache (einschließlich Deutsch) wird jeder dieser Fehler mit demselben generischen Ausweichtext protokolliert, anstatt mit der unten stehenden spezifischen Meldung — wechseln Sie in diesem Fall vorübergehend Ihre persönliche Sprache auf Englisch, Französisch oder Spanisch (Settings → Personalization Settings → Languages), um zu sehen, um welche es sich tatsächlich handelt, oder testen Sie die Ursachen in der folgenden Tabelle einzeln durch.
Was jede Meldung bedeutet
DQE übersetzt diese Meldungen nicht ins Deutsche (siehe Hinweis oben) — die folgende Tabelle zeigt daher den englischen Text, den Sie nach dem Sprachwechsel sehen.
| Meldung, die Sie im Trace Log finden | Was es bedeutet | Wo Sie es beheben |
|---|---|---|
| "The 'DQE Setup DataQ' record could not be found. Please create it to proceed with the operation." | In dieser Umgebung existiert noch kein DQE DataQ Settings-Datensatz (die Meldung verwendet einen älteren internen Namen, "DQE Setup DataQ" — gemeint ist derselbe Datensatz). | Füllen Sie DQE DataQ Settings wie in DQE One Package Setup §2 beschrieben aus. |
| "The license is missing from the 'DQE Setup DataQ' configuration. Please provide it to proceed." | Der DataQ-Settings-Datensatz existiert, aber sein Feld DQE Licence ist leer. | DQE DataQ Settings → General → DQE Licence (Package Setup §2.2). |
| "Invalid license. Please check your license key." | Ein Lizenzschlüssel ist eingetragen, wurde aber vom DQE-Lizenzserver abgelehnt — meist ein falscher, abgelaufener oder falsch eingegebener Schlüssel, oder eine Org-ID, für die der Schlüssel nicht autorisiert ist. | Vergleichen Sie den Schlüssel mit dem von Ihrem DQE-Projektleiter bereitgestellten; kontaktieren Sie ihn, falls es weiterhin fehlschlägt. |
| "Missing DQE Address API URL" | Das Feld Adresse de l'API DQE in DataQ Settings ist leer. | DQE DataQ Settings → General → Adresse de l'API DQE (Package Setup §2.3). |
| "ISO3 Country is missing" | DQE konnte für den Datensatz keinen ISO3-Ländercode ermitteln — siehe unten. | Siehe Land wird nicht aufgelöst unten. |
Land wird nicht aufgelöst ("ISO3 Country is missing")
Bevor DQE den Webservice aufruft, löst es zunächst einen ISO3-Ländercode für den Datensatz auf: Es prüft zuerst das eigene Länderfeld des Datensatzes (über die DQE-Ländertabelle), und falls das nicht gelingt, greift es auf das Feld Address Default Country in DataQ Settings zurück. Der Fehler erscheint nur, wenn beide Auflösungen fehlschlagen. Prüfen Sie in dieser Reihenfolge:
- Ob das eigene Länderfeld des Datensatzes einen Wert hat und dieser Wert mit einem gültigen ISO3-Code in der DQE-Ländertabelle vorhanden ist.
- Falls das Länderfeld des Datensatzes leer oder nicht zugeordnet ist, ob DQE DataQ Settings → Address Default Country auf einen gültigen Wert gesetzt ist.
Wann der DQE-Support zu kontaktieren ist
Falls das Plug-in Trace Log keine der obigen Meldungen zeigt, oder eine generische Meldung "An error occurred during plugin execution" anzeigt, liegt die Ursache außerhalb der eigenen Konfigurationsprüfungen von DQE (zum Beispiel ein Netzwerk- oder serverseitiges DQE-Problem). Teilen Sie den genauen Trace-Log-Eintrag Ihrem DQE-Projektleiter mit.
Verwandte Artikel
- DQE One Package Setup on PowerApps / Dynamics
- Configure address, email, phone, name and B2B validation in Dynamics
Verknüpfung mit