Ansicht
Dokumentation

/ISDFPS/BAPI_ADDRESSORG_SAVEAD - BAPI zur Eingangsverteilung von Organisationsadressen

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   General Data in Customer Master  
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 enthaltenen Daten werden an den Baustein BAPI_ADDRESSORG_SAVEREPLICA weitergegeben. Der Objekttyp OBJ_TYPE, der Objektschlü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ür das 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 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.

In die Übergabestrukturen BAPIADTEL, BAPIADFAX, ... , BAPIADPAG für die Kommunikationsdaten und 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 Verarbeitung die 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 Telefonnummer gefüllt. Wichtiger ist, daß auch die verwendeten laufenden Nummern der Kommunikationsadressen zurü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 der entsprechenden 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

Vendor Master (General Section)   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 9858 Date: 20240419 Time: 125906     sap01-206 ( 89 ms )