Ansicht
Dokumentation

ADDR_PERS_COMP_GET_COMPLETE - Lesen des kompletten Adreßobjektes (3) (inkl. alle Kommunikationstabellen)

TXBHW - Original Tax Base Amount in Local Currency   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein ermittelt zu einer Adreßnummer (einem Adreßhandle) und einer Personennummer (einem Personenhandle) die entsprechenden Ansprechpartnerdaten, inklusive aller zugehörigen Kommunikationsarten und den Bemerkungen dazu.
(Die Firmenadreßdaten werden nicht gelesen; dazu siehe
Funktionsbaustein ADDR_GET_COMPLETE.)

Die z.Zt. zulässigen Kommunikationsarten sind in Tabelle TSAC(T) definiert.

Dies sind momentan die folgenden Kommunikationsarten (-Tabellen):

• TEL (ADTEL) Telefonnummern

• FAX (ADFAX) Faxnummern

• TTX (ADTTX) Teletexnummern

• TLX (ADTLX) Telexnummern

• INT (ADSMTP) Internet-Adressen

• RML (ADRML) Remote-Mail-Adressen

• X40 (ADX400) X.400-Adressen

• RFC (ADRFC) RFC-Destinationen

• PRT (ADPRT) (lokale) Druckeradresse

• SSF (ADSSF) Secure Store and Forward

• URI (ADURI) Universal Resource Identifier (URL, FTP, etc.)

• PAG (ADPAG) Pager-Dienste

Die Kommunikationsart 'SMTP' ist gleichbedeutend mit 'INT', 'X400' ist gleichbedeutend mit 'X40'.

Zurückgegeben werden alle Daten in der komplexen Struktur ADDR3_COMPLETE. Diese besteht aus den Unter-Tabellen
ADDR3_TAB (Übergabestruktur für Ansprechpartner)
ADTEL_TAB, ADFAX_TAB, ... (Kommunikationsarten-Tabellen)
ADRCT_TAB (Bemerkungen zu den Kommunikationsarten)

Beispiel

Lesen aller Daten zu einer Ansprechpartneradresse

*Übergabestruktur deklarieren
data: addr3_complete type szadr_addr3_complete.

*Variable für Adreßnummer und Personennummmer deklarieren
data: addrnumber like addr3_sel-addrnumber,
      persnumber like addr3_sel-persnumber.

*Parameter festlegen
addrnumber = ...
persnumber = ...

*Daten lesen
call function   'ADDR_PERS_COMP_GET_COMPLETE'
     exporting  addrnumber        = addrnumber
                persnumber        = persnumber
     importing  addr3_complete    = addr3_complete
     exceptions parameter_error   = 1
                address_not_exist = 2
                person_not_exist  = 3
                internal_error    = 4.
case sy-subrc.
  ...
endcase.

*Durch LOOPen über die einzelnen Tabellen in ADDR3_COMPLETE
*kann man nun auf die gelesenen Daten zugreifen und sie verarbeiten.
*Dabei sollte man beachten, daß die Untertabelle ADDR3_TAB die
*Typstruktur SZADR_ADDR3_LINE besitzt, und somit die einzelnen Felder
*mit ADDR3_COMPLETE-DATA- angesprochen werden müssen.

Hinweise

Innerhalb des Bausteins werden die Funktionsbausteine ADDR_PERS_COMP_COMM_GET, ADDR_PERS_COMP_GET und ADDR_PERS_COMP_REMARKS_GET aufgerufen, um auf die einzelnen Datenbanktabellen zuzugreifen.

Ausnahmen

• PARAMETER_ERROR
  Wird erzeugt, falls sowohl Adreßnummer, als auch Adreßhandle oder keines von beiden, bzw. sowohl Personennummer, als auch Personenhandle oder keines von beiden angegeben wird.

• ADDRESS_NOT_EXIST
  Wird zurückgegeben, wenn zu der angegebenen Adreßnummer, bzw. dem Adreßhandle, keine Daten gefunden worden sind.

• PERSON_NOT_EXIST
  Wird zurückgegeben, falls zwar die Firma, aber nicht die Personennummer, bzw. das Personenhandle existiert.

• INTERNAL_ERROR
  Schwerer interner Programmfehler oder Datenschiefstand. Muß immer mit A-Message ausgegeben werden.

Weiterführende Informationen

Parameter

ADDR3_COMPLETE
ADDRHANDLE
ADDRNUMBER
ARCHIVE_HANDLE
BLK_EXCPT
IV_CURRENT_COMM_DATA
PERSHANDLE
PERSNUMBER

Ausnahmen

ADDRESS_NOT_EXIST
CONTACT_PERSON_BLOCKED
INTERNAL_ERROR
PARAMETER_ERROR
PERSON_NOT_EXIST
WRONG_ACCESS_TO_ARCHIVE

Funktionsgruppe

SZAE

rdisp/max_wprun_time - Maximum work process run time   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5529 Date: 20240523 Time: 144233     sap01-206 ( 49 ms )