/ISDFPS/BAPI_ADDRESSORG_SAVEAD - BAPI zur Eingangsverteilung von Organisationsadressen

TXBHW - Original Tax Base Amount in Local Currency   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Anhand des angegebenen Objekttyps und des Objektschlüssels wird die
zugehörige Organisationsadresse bestimmt und mit den angegebenen
aktuellen Adreß- und Kommunikationsdaten überschrieben.
Üblicherweise wird dieser Baustein aus der ALE-Schicht heraus vom
Funktionsbaustein IDOC_INPUT_ADRMAS aufgerufen.

Beispiel

* Replizierung einer Organisationsadresse: aktueller Stand im
* System AB1 soll nach System AB2 verteilt werden

Im System AB1 wird nach dem Aufruf von Funktionsbaustein MASTERIDOC_CREATE_REQ_ADRMAS ein IDOC in der ALE-Schicht mittels Baustein ALE_ADDRESSORG_SAVEREPLICA erzeugt und verteilt.
Das im System AB2 ankommende IDOC wird vom Baustein IDOC_INPUT_ADRMAS ausgelesen, und die darin enthaltenenDaten werden an den Baustein BAPI_ADDRESSORG_SAVEREPLICA weitergegeben. Der Objekttyp OBJ_TYPE, derObjektschlüssel OBJ_ID, die Erweiterung zum Objektschlüssel OBJ_ID_EXT und der Kontext CONTEXT sind die gleichen wie im Ausgangssystem.
Bei einer Kundenadresse (Hauptadresse des Kunden) beispielsweise sind die Werte wie folgt zu belegen:
Objekttyp: 'KNA1'
Objektschlüssel:
(Extension leer): ' '
Kontext: '0001'
Der Aufruf dieses Bausteins sieht dann folgendermaßen aus:

DATA: bapiad1vl  like bapiad1vl occurs 0,
      bapiadtel  like bapiadtel occurs0,
               ...
      bapicomrem like bapicomrem occurs 0,
      return like bapiret2,
      addrnumber like adrc-addrnumber.

CALL FUNCTION 'BAPI_ADDRESSORG_SAVEREPLICA'
     EXPORTING
         obj_type           = 'KNA1'
          obj_id             = '4712'
          OBJ_ID_EXT         = ' '
          CONTEXT            = '0001'
     IMPORTING
          RETURN             = return
          ADDRESS_NUMBER     = addrnumber
     tables
          bapiad1vl          = bapiad1vl
          BAPIADTEL          = bapiadtel
          BAPIADFAX          = bapiadfax
          BAPIADTTX          = bapiadttx
          BAPIADTLX          = bapiadtlx
          BAPIADSMTP         = bapiadsmtp
          BAPIADRML          = bapiadrml
          BAPIADX400         = bapiadx400
          BAPIADRFC          = bapiadrfc
          BAPIADPRT          = bapiadprt
          BAPIADSSF          = bapiadssf
          BAPIADURI          = bapiaduri
          BAPIADPAG          = bapiadpag
          BAPIAD_REM         = bapiadrem
          BAPICOMREM         = bapicomrem.
IF NOT RETURN IS INITIAL.
  ...
ENDIF.

Im System AB2 sind die Daten zur Adreßnummer ADDRNUMBER jetzt aktualisiert vorhanden.

Hinweise

Fehler bzw. Meldungen können aus der Rückgabestruktur RETURN gelesen werden.
Die fürdas Zielsystem gültige Adreßnummer der Organisationsadresse wird im Parameter ADDRESS_NUMBER zurückgegeben.

Um mit diesem Funktionsbaustein arbeiten zu können, muß das System wissen, wie es dieZuordnung 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 derName 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 Funktionsbausteineine Meldung in der Fehlertabelle RETURN zurück und die Adresse des BOR-Objektes kann nicht weiter verarbeitet werden.

In die Übergabestrukturen BAPIADTEL, BAPIADFAX, ... , BAPIADPAG für die Kommunikationsdatenund BAPICOMREM für die Bemerkungen dazu wird das Ergebnis der Verarbeitung zurückgestellt, sofern nicht ein Ausnahmefehler ('E') während der BAPI-Verarbeitung aufgetreten ist.
Das heißt, konnte eine Kommunikationsadresse verarbeitet werden, stehen in BAPIAD* nach der Verarbeitungdie Daten so, wie sie dann auf der Datenbank vorhanden sind bzw. nach einem anschließenden COMMIT auf der Datenbank stehen würden.
Bei einer Telefonnummer wird zum Beispiel das Feld 'TEL_NO' für die vollständige Telefonnummergefüllt. Wichtiger ist, daß auch die verwendeten laufenden Nummern der Kommunikationsadressenzurückgegeben werden. Dies spielt insbesondere eine Rolle bei Kommunikationsadressen, die neu eingefügt wurden.
Konnte eine Kommunikationsadresse oder eine Bemerkung dazu nicht verarbeitet werden, so wird in derentsprechenden Zeile der zugehörigen BAPIAD*-Struktur das Fehlerkennzeichen 'ERRORFLAG' auf 'X' gesetzt und die laufende Nummer 'CONSNUMBER' erhält den Wert '000'.

Parameter

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

Ausnahmen

Funktionsgruppe

FPS/SAPLADUPS

General Data in Customer Master   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.


Length: 10188 Date: 20120527 Time: 060402     triton ( 171 ms )