Ansicht
Dokumentation

ADDR_PERSONAL_GET_COMPLETE_DB - Lesen des kompletten Adreßobjektes (2) (inkl. alle Kommunikationstabellen)

Fill RESBD Structure from EBP Component Structure   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein ermittelt zu einer Adreßnummer und einer Personennummmer den aktuellen Datenbankstand sämtlicher Personenadreßdaten, inklusive aller zugehörigen Kommunikationsarten und Bemerkungen zur Adresse/ zu den Kommunikationsarten.

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 ADDR2_COMPLETE. Diese besteht aus den Unter-Tabellen

• ADDR2_TAB (Übergabestruktur für die Adresse)

• ADTEL_TAB, ADFAX_TAB, ... (Kommunikationsarten-Tabellen)

• ADRCT_TAB (Bemerkungen zu den Kommunikationsarten)

• ADRT_TAB (Bemerkungen zur Adresse)

Beispiel

Lesen aller Daten zu einer Personenadresse

*Übergabestruktur deklarieren
data: addr2_complete type szadr_addr2_complete.

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

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

*Daten lesen
call function   'ADDR_PERSONAL_GET_COMPLET_DB'
     exporting  iv_addrnumber     = addrnumber
                iv_persnumber     = persnumber
     importing  es_addr2_complete = addr2_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 ADDR2_COMPLETE
*kann man nun auf die gelesenen Daten zugreifen und sie verarbeiten.
*Dabei sollte man beachten, daß die Untertabelle ADDR2_TAB die
*Typstruktur SZADR_ADDR2_LINE besitzt, und somit die einzelnen Felder
*mit ADDR2_COMPLETE-DATA- angesprochen werden müssen.

Hinweise

Der Funktionsbaustein liefert im Rückgabeparameter ES_ADDR2_COMPLETE genau denselben Inhalt zurück, den der Funktionsbaustein ADDR_PERSONAL_GET_COMPLETE liefern würde, wenn er zu Beginn einer Transaktion vor jeglichem anderen Lese- oder Schreibzugriff auf die Adresse aufgerufen worden wäre.

Innerhalb des Bausteins werden die Funktionsbausteine der Funktionsgruppe SZA13 aufgerufen, um auf die einzelnen Datenbanktabellen zuzugreifen.

Ausnahmen

• PARAMETER_ERROR
  Wird erzeugt, falls keine Adreßnummer oder keine Personennummer angegeben wird.

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

• PERSON_NOT_EXIST
  Wird zurückgegeben, falls zu der angegebenen Personennummer keine Einträge gefunden worden sind.

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

Weiterführende Informationen

Parameter

BLK_EXCPT
ES_ADDR2_COMPLETE
IV_ADDRNUMBER
IV_CURRENT_COMM_DATA
IV_PERSNUMBER

Ausnahmen

ADDRESS_NOT_EXIST
INTERNAL_ERROR
PARAMETER_ERROR
PERSON_BLOCKED
PERSON_NOT_EXIST

Funktionsgruppe

SZAE

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5566 Date: 20240523 Time: 125325     sap01-206 ( 54 ms )