Ansicht
Dokumentation

BAPI_ADDRESSPERS_GETDETAIL - BAPI zum Lesen von Personenadressen

CPI1466 during Backup   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Anhand des angegebenen Objekttyps und des Objektschlüssels werden die Adreßdaten der zugehörigen Personenadresse bestimmt.
Die im aktuellen System verwendete Adreßnummer und die Personennummer werden ebenfalls zurückgegeben.

Beispiel

* Lesen einer Personenadresse:
  DATA: objtype LIKE bapi4002_1-objtype,
        obj_id LIKE bapi4002_1-objkey,
        obj_id_ext LIKE bapi4002_1-extension,
        context LIKE bapi4002_1-context,
        address_number LIKE adrc-addrnumber,
        person_number LIKE adrp-persnumber,
        bapiad2vl LIKE bapiad2vl OCCURS 0,
        bapiadtel LIKE bapiadtel OCCURS 0,
        bapiadfax LIKE bapiadfax OCCURS 0,
        ...
        bapicomrem LIKE bapicomrem OCCURS 0,
        return LIKE bapiret2 OCCURS 0.

* Bei der Zuweisung des Objekttyps und des Objektschlüssels der
* Privatadresse eines Kundenansprechpartners sind
* folgende Werte zu wählen
  objtype    = 'BUS1006001'
  obj_id     =
  obj_id_ext = ' '
  context    = '0004'

* Aufruf des GetDetail-Bausteins
  CALL FUNCTION 'BAPI_ADDRESSPERS_GETDETAIL'
     EXPORTING
          obj_type      = objtype
          obj_id        = obj_id
          obj_id_ext    = obj_id_ext
          context       = context
     IMPORTING
         address_number = address_number
         person_number  = person_number
     TABLES
         bapiad2vl      = bapiad2vl
         bapiadtel      = bapiadtel
         ...
         bapicomrem     = bapicomrem
         return         = return.

* Die Adreßdaten können nun aus den Tabellen BAPIAD2VL, ..., BAPICOMREM
* entnommen werden.
* Die Tabelle RETURN enthält alle bei der Verarbeitung aufgetretenen
* Fehler und Warnungen. Die Adreßnummer und die Personennnummer
* stehen in den Feldern ADDRESS_NUMBER bzw. PERSON_NUMBER.

Hinweise

Die Reihenfolge der Kommunikationsdaten in den einzelnen Tabellen
orientiert sich an den laufenden Nummern der Daten im angesprochenen
System. Das gleiche gilt für die Bemerkungen zur Kommunikation.
Die Adreßnummer der zum Objekttyp und zum Objektschlüssel zugehörigen Personenadresse wird im Export-Parameter ADDRESS_NUMBER zurückgegeben, die Personennummer im Feld PERSON_NUMBER.
Bei der Verarbeitung aufgetretene Warnungen und Fehler können in der Tabelle RETURN nachgelesen werden.

Um mit diesem Funktionsbaustein arbeiten zu können, muß das System wissen, wie es die Zuordnung zwischen dem zu verarbeitenden BOR-Objekttyp und den Referenzen auf die abgelegte zugehörige Adresse ermitteln soll.
Dazu muß Tabelle TSADOBJ zum BOR-Objekttyp die Namen der Anwendungstabellen und Felder enthalten, in denen die Adreßreferenzen abgelegt sind. Außerdem muß in Tabelle TSADRV der Name des Callback-Funktionsbausteins vermerkt sein, mit welchem diese Adreßreferenzen ausgelesen werden können.
Sind die entsprechenden Tabelleneinträge in TSADOBJ und TSADRV nicht vorhanden, so gibt der Funktionsbaustein eine Meldung in der Fehlertabelle RETURN zurück und die Adresse des BOR-Objektes kann nicht weiter verarbeitet werden.

Parameter

ADDRESS_NUMBER
BAPIAD2VL
BAPIADFAX
BAPIADPAG
BAPIADPRT
BAPIADRFC
BAPIADRML
BAPIADSMTP
BAPIADSSF
BAPIADTEL
BAPIADTLX
BAPIADTTX
BAPIADURI
BAPIADUSE
BAPIADX400
BAPIAD_REM
BAPICOMREM
CONTEXT
IV_CURRENT_COMM_DATA
OBJ_ID
OBJ_ID_EXT
OBJ_TYPE
PERSON_NUMBER
RETURN

Ausnahmen

Funktionsgruppe

SZAL

ABAP Short Reference   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5476 Date: 20240523 Time: 105616     sap01-206 ( 57 ms )