Ansicht
Dokumentation

ADDR_CAM1_MAINTAIN_COMPLETE - Verarbeitung des komplexen Adreßobjektes (Typ 1)

Fill RESBD Structure from EBP Component Structure   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Baustein dient dazu, Kommunikationsdaten ohne postalische Adresse ohne Dialog zu pflegen. Dabei werden die Adreßdaten in das lokale Gedächtnis der Funktionsgruppe SZAE geschrieben.
Der Funktionsbaustein zieht aber keine Adressnummer und schreibt die Daten auch nicht auf die Datenbank. Dazu müssen weitere Funktionsbausteine aufgerufen werden (s.u.).

Beim Aufruf muß die komplexe Übergabestruktur ADDR1_COMPLETE mit den Kommunikationsdaten, den Bemerkungen zu Kommunikationsdaten sowie einer Adreßnummer oder einem Adreßhandle zur Identifikation der Adresse gefüllt sein.

Obligatorisch ist die Angabe des Verarbeitungskennzeichens UPDATE_FLAG ('I'nsert oder 'U'pdate).
Das Kennzeichen SUBSTITUTE_ALL_COMM_DATA dient dazu, alle schon vorhandenen Einträge zu den Kommunikationsarten durch die beim Aufruf übergebenen Daten zu ersetzen und ist optional.
Dabei werden alle Einträge der Kommunikationstabellen (Telefon, Fax, etc.) - ohne Berücksichtigung des Feldes UPDATEFLAG im jeweiligen Tabelleneintrag - übernommen. Der Default für den Parameter SUBSTITUTE_ALL_COMM_DATA ist SPACE.

Der optionale Parameter CHECK_ADDRESS stößt eine inhaltliche Prüfung der übergebenen Adreßdaten an und ist standardmäßig gesetzt.
Der Rückgabeparameter RETURNCODE und die Tabelle ERROR_TABLE enthalten nach der Abarbeitung alle Informationen über die Prüfung der Daten.
Im Fall RETURNCODE = 'E' hat die inhaltliche Prüfung der Adresse einen Fehler ergeben. Das bedeutet, daß der Funktionsbaustein die Adresse nicht angelegt bzw. geändert hat.

Deshalb muss der Parameter RETURNCODE unbedingt abgefragt und behandelt werden. Beachten Sie dazu die Parameterdokumentation.

Hinweise

Das Nummernziehen, also der Aufruf des Bausteins ADDR_NUMBER_GET, muß vom Anwendungsprogramm separat durchgeführt werden.
Um die Daten aus dem lokalen Gedächtnis auf die Datenbank zu schreiben, muss am Ende der Verarbeitung der Funktionsbaustein ADDR_MEMORY_SAVE (oder ADDR_SINGLE_SAVE) aufgerufen werden.
Mehr dazu in der Dokumentation zu den Business Address Services in der SAP-Bibliothek unter dem Pfad Basis - Services - Adressverwaltung (BC-SRV-ADR).

Ausnahmen

• PARAMETER_ERROR
  Mindestens einer der folgenden Fälle liegt vor:
  - Die komplexe Übergabestruktur ADDR1_COMPLETE ist nicht gefüllt
  - Sowohl Adreßnummer als auch Adreßhandle oder keines von beiden
  wurde in der komplexen Übergabestruktur gesetzt
  - Das UPDATE_FLAG hat einen anderen Wert als 'I' oder 'U'
  - Das UPDATE_FLAG hat den Wert 'I', aber das Adreßhandle in
  ADDR1_COMPLETE ist gleich ' '.

• ADDRESS_NOT_EXIST
  Wird im Fall UPDATE_FLAG = 'U' ausgelöst, falls zu der angegebenen Adreßnummmer bzw. zu dem Adreßhandle keine Adresse existiert.

• HANDLE_EXIST
  Wird zurückgegeben, wenn bei UPDATEFLAG = 'I' das verwendete Adreßhandle schon in Gebrauch ist.

Weiterführende Informationen

Dokumentation zur zentralen Adressverwaltung

Parameter

ADDR_CAM1_COMPLETE
ADDR_CAM1_COMPLETE_OUT
BLK_EXCPT
CHECK_ADDRESS
CONSIDER_CONSNUMBER_FOR_INSERT
ERROR_TABLE
IV_TIME_DEPENDENCE
RETURNCODE
SUBSTITUTE_ALL_COMM_DATA
UPDATEFLAG

Ausnahmen

ADDRESS_BLOCKED
ADDRESS_NOT_EXIST
HANDLE_EXIST
INTERNAL_ERROR
PARAMETER_ERROR

Funktionsgruppe

SZA10

Fill RESBD Structure from EBP Component Structure   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4589 Date: 20240523 Time: 122535     sap01-206 ( 94 ms )