Ansicht
Dokumentation

ADDR_COPY_COMPLETE - Kopieren des kompletten Adreßobjektes (Typ 1)

Addresses (Business Address Services)   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Aus den Daten einer schon bestehenden Adresse wird eine neue Adresse angelegt. Für die alte Adresse muß entweder ein gültiges Adreßhandle oder eine gültige Adreßnummer angegeben werden. Außerdem wird für die neu anzulegende Adresse ein gültiges Adreßhandle, sowie eine gültige Adreßgruppe benötigt. Optional kann man durch Setzen des Flags 'GET_NUMBER' auf 'X' das Ziehen einer neuen Adreßnummer erzwingen. Nach erfolgreicher Kopie wird der Rückgabeparameter 'ADDR1_COMPLETE' vom Typ SZADR_ADDR1_COMPLETE mit den aktuellen Adreßdaten gefüllt.
Zusätzliche Informationen über den Verarbeitungsvorgang werden als Flag im Rückgabeparameter 'RETURNCODE' hinterlegt.
Dementsprechend wird die Tabelle 'ERROR_TABLE' mit Langtexten gefüllt.
Erfolgt ein Nummernziehen, so wird zusätzlich 'RETURNCODE-NUMBERRANGE'
auf die gleiche Art wie 'RETURNCODE' mit Werten belegt.

Beispiel

CALL FUNCTION 'ADDR_COPY_COMPLETE'
  EXPORTING
        old_address_number     = old_address_number
        address_handle         = address_handle
        address_group          = address_group
  IMPORTING
        addr1_complete         = addr1_complete
        returncode             = returncode
  TABLES
        error_table            = error_table
  EXCEPTIONS
        parameter_error        = 1
        old_address_not_exist  = 2
        address_handle_exist   = 3
        internal_error         = 4
        others                 = 5.

Ist 'old_address_number' die Nummer einer schon angelegten Adresse, 'address_handle' ein aktuelles Handle und 'address_group' eine gültige Adreßgruppe, so wird 'addr1_complete' mit den Werten zur Adreßnummer 'old_address_handle' gefüllt; die Rückgabe 'returncode' wird auf 'SPACE' gesetzt. Nach dem Aufruf läßt sich mit dem angegebenen Adreß-Handle eine neue Nummer für die gelesenen Daten ziehen.

Hinweise

Wird das Flag 'GET_NUMBER' gesetzt, so muß 'ADDRESS_REFERENCE' angegeben werden und 'NUMBER_RANGE' benötigt einen der Werte '01' oder '10', ansonsten wird mit Parameter_Error geantwortet. Parameter_Error wird ebenfalls zurückgegeben, falls kein neues Adreßhandle oder keine Adreßgruppe angegeben wird, oder falls sowohl ein Wert für eine alte Adreßnummer, als auch für ein altes Adreßhandle gesetzt wird.

Weiterführende Informationen

Parameter

ADDR1_COMPLETE
ADDRESS_GROUP
ADDRESS_HANDLE
ADDRESS_REFERENCE
BLK_EXCPT
CHECK_ADDRESS
ERROR_TABLE
GET_NUMBER
NUMBERRANGE_NUMBER
OLD_ADDRESS_HANDLE
OLD_ADDRESS_NUMBER
OWNER
RETURNCODE
RETURNCODE_NUMBERRANGE

Ausnahmen

ADDRESS_BLOCKED
ADDRESS_HANDLE_EXIST
INTERNAL_ERROR
OLD_ADDRESS_NOT_EXIST
PARAMETER_ERROR

Funktionsgruppe

SZAE

Addresses (Business Address Services)   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4633 Date: 20240523 Time: 133314     sap01-206 ( 73 ms )