Adressenparameter

Für Adressenparameter in BAPIs sind bestimmte Referenzstrukturen definiert. Diese Strukturen sollten Sie für die Verwendung in Ihrem BAPI kopieren, insbesondere dann, wenn der zugrundeliegende Objekttyp die zentrale Adressverwaltung (ZAV) benutzt.

Verwenden Sie eine der folgenden Strukturen als Kopiervorlage, um in einem BAPI auf Adressen zu referenzieren:

Referenzstruktur	Verwendung
BAPIADDR1	Adressen von Firmen und Organisationen
BAPIADDR2	Persönliche Adressen, d.h. Adressen von natürlichen Personen
BAPIADDR3	Adressen von Ansprechpartnern innerhalb einer Organisation
BAPIADDR1X	Change-Referenzstruktur für Adressen von Firmen und Organisationen
BAPIADDR2X	Change-Referenzstruktur für persönliche Adressen, d.h. Adressen von natürlichen Personen
BAPIADDR3X	Change-Referenzstruktur für Adressen von Ansprechpartnern innerhalb einer Organisation

Beachten Sie bei der Verwendung dieser Referenzstrukturen:

Alle Felder der Referenzstrukturen beziehen sich auf die zentrale Adressverwaltung (ZAV). Verwenden Sie nur die Felder, die in Ihrem Anwendungskontext auch verarbeitet werden können. Wenn die ZAV bereits eingebunden ist, sind alle Felder relevant.
Entgegen den allgemeinen Richtlinien werden für einige codierte Namensbestandteile nicht die internen Datenbankschlüssel, sondern textuelle Darstellungen, z.B. CHAR 20 oder CHAR 30, als Felder in diese Strukturen aufgenommen.

Hierbei handelt es sich um folgende Felder:

Anredetext (Felder TITLE_P, TITLE und FORMOFADDRESS)
Akademische Titel (Felder TITLE_ACA1 und TITLE_ACA2)
Vorsatzworte zum Namen, z.B. "von", "van der" (Felder PREFIX1 und PREFIX2)
Namenszusatz, z.B. Adelstitel (Feld TITLE_SPPL)
Es kann nicht erwartet werden, dass ein aufrufendes Programm in diesen Fällen die internen Datenbankschlüssel in die externe, lesbare Form konvertiert und umgekehrt. Hierfür können Sie folgende Funktionsbausteine einsetzen, die diese Strukturen entsprechend füllen bzw. die Strukturen bei Änderungen entgegennehmen und intern die richtigen Schlüssel zuordnen:

Funktionsbaustein	Bedeutung
ADDR_CONVERT_FROM_BAPIADDR1	Konvertiert die Feldformate der Struktur von der externen in die interne Form.
ADDR_CONVERT_TO_BAPIADDR1	Konvertiert die Feldformate der Struktur von der internen in die externe Form.
ADDR_CONVERT_FROM_BAPIADDR2	Konvertiert die Feldformate der Struktur vom externen in die interne Form.
ADDR_CONVERT_TO_BAPIADDR2	Konvertiert die Feldformate der Struktur von der internen in die externe Form.
ADDR_CONVERT_FROM_BAPIADDR3	Konvertiert die Feldformate der Struktur von der externen in die interne Form.
ADDR_CONVERT_TO_BAPIADDR3	Konvertiert die Feldformate der Struktur von der internen in die externe Form.

Bei Feldverlängerungen in der ZAV bleibt das entsprechende Feld in der BAPI-Referenzstruktur in Typ und Länge identisch bestehen. Diesem Feld wird ein neues Datenelement zugeordnet, das in Beschreibung und/oder Kurztext als "veraltet" zu erkennen ist. Das veraltete Feld wird jedoch in den obengenannten Konvertierungsbausteinen weiterhin berücksichtigt.
Für die neue Feldlänge wird ein neues Feld mit anderer Bezeichnung am Ende der Struktur angehängt. Gegenwärtig betrifft dies folgende Felder:

Existierendes Feld	Länge	Neues Feld	Länge	In Struktur
FORMOFADDR	Char 20	TITLE	Char 30	BAPIADDR1
BUILDING	Char 10	BUILD_LONG	Char 20	BAPIADDR1, BAPIADDR2, BAPIADDR3
STREET	Char 40	STREET_LNG	Char 60	BAPIADDR1

Verwenden Sie vorzugsweise die neuen, längeren Felder.

Bei der Verwendung der Bezugsstruktur BAPIADDR3 ist zu beachten, dass auf alle Felder der Firmenadresse (Prüftabelle ADRC) nur lesende Zugriffe möglich sind. Änderungen an diesen Feldern müssen durch einen Zugriff über die Bezugsstruktur BAPIADDR1 erfolgen.