Funktionsweise der Adressprüfung
Diese Seite beschreibt, wann 365 business Address Validation eine Adresse automatisch prüft und wie sich Sitzungen mit und ohne Oberfläche unterscheiden.
Diese Grundlagen helfen Ihnen, das Verhalten der automatischen Prüfung in Microsoft Dynamics 365 Business Central richtig einzuschätzen, bevor Sie die Einrichtung anpassen.
Auslöser: nur beim Ändern eines Datensatzes
Die automatische Adressprüfung läuft ausschließlich, wenn ein bereits bestehender Datensatz geändert wird und sich dabei mindestens eines der überwachten Adressfelder geändert hat. Beim Einfügen eines neuen Datensatzes findet keine automatische Prüfung statt, auch dann nicht, wenn die neue Adresse bereits vollständig ist.
Gilt für Kontakt, Debitor, Kreditor, Mitarbeiter, Ressource, Alternative Adresse, Auftragsadresse, Lief.-an-Adresse sowie für Verkaufs- und Einkaufsbelege, jeweils abhängig vom passenden Schalter in der Einrichtung für Adressvalidierung.
Geprüfte Felder je Datensatz
Bei Kontakt, Debitor, Kreditor, Mitarbeiter, Ressource, Alternative Adresse, Auftragsadresse und Lief.-an-Adresse vergleicht die automatische Prüfung diese Felder mit dem vorherigen Wert:
- Adresse
- Adresse 2
- Postleitzahl
- Ort
- Region
- Land/Region-Code
Bei Verkaufsbelegen werden die drei Adressgruppen Verk.-an, Lief.-an und Rech.-an getrennt voneinander geprüft, bei Einkaufsbelegen die Gruppen Eink.-von, Lief.-an und Rech.-an. Nur die Adressgruppe, deren Felder sich geändert haben, löst eine Prüfung aus.
Pflichtfelder: Adresse und Ort oder Postleitzahl
Damit eine Prüfung überhaupt stattfinden kann, muss das Feld Adresse gefüllt sein, und zusätzlich entweder Ort oder Postleitzahl. Fehlt eines dieser Pflichtfelder, behandelt 365 business Address Validation den Datensatz wie einen neuen Datensatz und führt keine Prüfung durch.
Sitzungen mit und ohne Benutzeroberfläche
Ob die automatische Prüfung in einer Sitzung läuft, hängt zunächst vom Einrichtungsfeld Anwendungsbereich für Adressvalidierung ab (siehe Address Validation Scope unten). Innerhalb einer zulässigen Sitzung unterscheidet sich das Verhalten danach, ob eine Benutzeroberfläche vorhanden ist:
| Sitzung | Mehrere Treffer | Änderungsvorschlag bestätigen | Fehler des Prüfdienstes |
|---|---|---|---|
| Mit Benutzeroberfläche (interaktive Client-Sitzung) | Seite Adressvalidierungs-Ergebnisse zeigt alle Treffer zur Auswahl | Seite Adressdatenvergleich zeigt Original und Vorschlag, sofern Adressenüberprüfung aktiviert ist | Rückfrage, ob der Datensatz ohne Prüfung gespeichert werden soll |
| Ohne Benutzeroberfläche (API, Web Service, Hintergrundsitzung) | Der erste vom Dienst gelieferte Treffer wird ohne Rückfrage übernommen | Entfällt, der Vorschlag wird ohne Rückfrage angewendet | Speichern schlägt mit Fehler fehl |
Diese Unterscheidung trifft 365 business Address Validation anhand der Eigenschaft GuiAllowed der laufenden Sitzung. Für API- und Web-Service-Aufrufe sowie Hintergrundsitzungen über die Aufgabenwarteschlange ist diese Eigenschaft nicht gesetzt, für Sitzungen im Web-Client und in anderen interaktiven Clients ist sie gesetzt.
Rückfrage bei einem Fehler mit Benutzeroberfläche
Lehnen Sie die Rückfrage ab, erscheint die Fehlermeldung des Prüfdienstes, und das Speichern wird abgebrochen. Bestätigen Sie die Rückfrage, speichert 365 business Address Validation den Datensatz ohne Prüfung und ohne weitere Fehlermeldung.
Einkaufsbelege: Fehler des Prüfdienstes bleiben unsichtbar
Für Einkaufsbelege gilt eine Ausnahme von der Tabelle oben: Ein fehlgeschlagener Aufruf des Prüfdienstes wird dort weder gemeldet noch blockiert er das Speichern, unabhängig davon, ob eine Benutzeroberfläche vorhanden ist.
Keine Lizenz oder keine Berechtigung
Ist die Adressprüfung nicht lizenziert oder schlägt die Autorisierung beim Prüfdienst fehl, speichert 365 business Address Validation den Datensatz in jeder Sitzungsart ohne Prüfung, ohne Rückfrage und ohne Fehlermeldung.
Address Validation Scope
Das Feld Anwendungsbereich für Adressvalidierung in der Einrichtung für Adressvalidierung grenzt die automatische Prüfung zusätzlich auf eine Art von Sitzung ein:
| Option | Automatische Prüfung läuft |
|---|---|
| Alle | in jeder Sitzung, mit und ohne Benutzeroberfläche |
| Nur für Client-Sitzungen mit Benutzeroberfläche aktiviert | nur in interaktiven Sitzungen |
| Nur für Sitzungen ohne Benutzeroberfläche aktiviert | nur bei API-, Web-Service- und Hintergrundsitzungen |
Synchroner Ablauf
Die automatische Prüfung läuft synchron innerhalb des Speichervorgangs: 365 business Address Validation ruft den Prüfdienst auf, wertet die Antwort aus und wendet das Ergebnis an, bevor der Datensatz gespeichert wird. Für die Dauer des Aufrufs ist die Sitzung blockiert.
Bekannte Adressen ohne Dienstaufruf
Liegt die Adresse bereits mit dem Status Validiert oder Manuell geprüft im Adressverzeichnis vor, übernimmt 365 business Address Validation das gespeicherte Ergebnis, ohne den Prüfdienst erneut aufzurufen. Das gilt unabhängig davon, ob eine Benutzeroberfläche vorhanden ist.
Übernahme auf Lief.-an und Rech.-an
Stimmen auf einem Verkaufsbeleg die Adressen Lief.-an beziehungsweise Rech.-an mit der Adresse Verk.-an überein, werden sie nicht gesondert geprüft. Stattdessen übernimmt 365 business Address Validation das geprüfte Ergebnis der Verk.-an-Adresse unverändert in die jeweils andere Adresse. Weichen die Adressen voneinander ab, prüft 365 business Address Validation jede Adressgruppe einzeln.
Auf einem Einkaufsbeleg gilt dieselbe Übernahme. Ist Lief.-an noch auf ihrer Vorgabeadresse, wird sie nicht gesondert geprüft; 365 business Address Validation übernimmt das geprüfte Ergebnis der Eink.-von-Adresse unverändert. Für Zahlung-an gilt dieselbe Regel wie für Rech.-an im Verkauf: Sie wird nur dann unverändert übernommen, wenn sie der Eink.-von-Adresse entspricht. Weicht sie ab, prüft 365 business Address Validation die Zahlung-an-Adresse einzeln.