Business Add-In ADDRESS_CHECK
Dieses Business Add-In ist dafür vorgesehen, detaillierte Prüfungen der Adresse durchzuführen. Dabei können Adressdaten geändert oder ergänzt werden.
Hinweis
Die Technologie von SAP NetWeaver lässt für Add-Ins, bei denen Daten geändert werden, keine Mehrfachnutzung (d.h. mehrere Implementierungen) zu, wie es z.B. beim Business Add-In ADDRESS_UPDATE möglich ist.
Das Business Add-In ADDRESS_CHECK ist filterabhängig, d.h. es kann pro Filterwert eine aktive Implementierung geben. Als Filtertyp dient der ISO-Code des Landes.
Im Gegensatz zum Länderschlüssel, der vom Kunden festgelegt wird und vom ausgelieferten SAP-Default abweichen kann, ist der ISO-Code des Landes eindeutig. Deshalb kann auf diesen Schlüssel programmiert werden. Durch diese Filterung können Sie z.B. in einem global genutzten System für verschiedene Länder unterschiedliche Partnerprodukte gleichzeitig nutzen.
Die ISO-Codes werden von SAP als Vorschlag in der Ländertabelle ausgeliefert. Sie benötigen richtig gepflegte ISO-Codes für unterschiedliche Prüfungen im System, unter anderem auch hier. Weitere Informationen zu den ISO-Codes finden Sie in der SAP-Bibliothek in der Komponente Änderungen des SAP-Standards (BC)
—> Business Add-Ins
—> Filterabhängige Business Add-Ins.
Hinweis
Unterschiedliche Implementierungen für Adressen eines Landes lassen sich nicht direkt durch die Filterung abdecken. Es lässt sich aber dadurch abbilden, dass Sie selbst eine Business Add-In-Implementierung für das entsprechende Land erstellen, die als Hülle für mehrere Anbieter dient und nur eine Dispatchingfunktion enthält.
Methode ADDRESS_POSTAL_CHECK
Dies ist eine Methode zur postalischen Prüfung und Validierung der Adressdaten. Die Methode ist eine Instanzmethode.
Methode IS_ACTIVE_FOR_COUNTRY
Dies ist die Methode, um festzustellen, ob für ein Land eine weitergehende postalische Prüfung durch das BAdI implementiert ist. Die Methode ist eine statische Methode (Klassenmethode).
Einbindung des Business Add-Ins ADDRESS_CHECK in die Adressprüfungen im SAP-System
Zur inhaltlichen Prüfung einer Adresse in den Business Address Services dient der Funktionsbaustein ADDR_CHECK. Dieser Funktionsbaustein wird unabhängig vom Kontext (Dialog, Batch-Input, Direct-Input, BAPI, Funktionsbaustein ohne Dialog) aufgerufen, wenn eine Adresse in den Business Address Services angelegt oder geändert wird.
Hinweis
Die Entkopplung der semantischen Prüfungen vom Dialog stellt sicher, dass in allen Programmkonstellationen dieselben Prüfungen durchgeführt werden.
Innerhalb des Funktionsbausteins ADDR_CHECK werden nacheinander eine Reihe von Konsistenzprüfungen durchgeführt. Eine zentrale Stellung hat der eingebettete Aufruf des Funktionsbausteins ADDR_REGIONAL_DATA_CHECK, in dem alle Prüfungen auf postalische Korrektheit gebündelt sind.
Hinweis
Pro Land wird normalerweise höchstens eine dieser drei Prüfungen aktiviert. Es ist aber möglich, dass für ein Land auch mehrere Prüfungen aktiv sind und nacheinander durchlaufen werden.
Die Prüfungen werden in folgender Reihenfolge aufgerufen:
Kundenerweiterung SZRS0003 (SMOD/CMOD), sofern diese Kundenerweiterung in einem CMOD-Projekt aktiviert wurde. Diese Erweiterung ist ab Release 4.5 verfügbar.
Methode ADDRESS_POSTAL_CHECK des Business Add-In ADDRESS_CHECK, wenn es dazu eine aktive Implementierung gibt.
Prüfungen der SAP-Regionalstruktur mit Hilfe der SAP-Prüftabellen, falls die Ortsdatei für das aktuelle Land aktiviert wurde.
In allen drei Prüfungen wird die Struktur ADRC_STRUC übergeben und ihr Inhalt kann verändert werden. Weitere Informationen finden Sie im Abschnitt Referenzstruktur ADRC_STRUC.
Im Ablauf des Funktionsbausteins ADDR_CHECK wird vor und nach dem Aufruf des Funktionsbausteins ADDR_REGIONAL_DATA_CHECK der Funktionsbaustein ADDR_POSTAL_CODE_CHECK aufgerufen. Dieser Funktionsbaustein führt eine Reihe von Prüfungen durch, z.B. Prüfungen der Länge und des Formats der Postleitzahl. Die Regeln für diese Prüfungen werden im Customizing bei den Ländereinstellungen festgelegt.
Der Aufruf von ADDR_POSTAL_CODE_CHECK vor dem Funktionsbaustein ADDR_REGIONAL_DATA_CHECK dient dazu, eine Mindestkonsistenz der Adresse sicherzustellen, bevor feinere Prüfungen stattfinden.
Der Aufruf von ADDR_POSTAL_CODE_CHECK nach dem Funktionsbaustein ADDR_REGIONAL_DATA_CHECK dient dazu, eventuelle Fehler in den geänderten Daten auszuschließen, die durch falsche oder unvollständige Referenzdaten oder Fehler in Partner- oder Kundenimplementierungen zustande kommen können. Dadurch werden auch Entwicklung und Test solcher Lösungen unterstützt.
Hinweis
Diese Prüfungen wurden schon in früheren Releases (vor Einführung der Prüfungen gegen die SAP-Regionalstruktur) durchgeführt und werden weiterhin als Mindestprüfungen durchlaufen, auch wenn keine zusätzlichen Prüfungen mittels SAP-Regionalstruktur, Partner- oder Kundenlösung aktiv sind.