Kontakt

Ansicht
Dokumentation

ADDR_GET_COMPLETE_DB - Lesen des kompletten Adreßobjektes von der Datenbank

ADDR_GET_COMPLETE_DB - Lesen des kompletten Adreßobjektes von der Datenbank

ROGBILLS - Synchronize billing plans   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Der Funktionsbaustein ermittelt zu einer Adreßnummer den aktuellen Datenbankstand sämtliche Adreß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 ADDR1_COMPLETE. Diese besteht aus den Unter-Tabellen

  • ADDR1_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 Adreßnummer

*Übergabestruktur deklarieren
data: addr1_complete type szadr_addr1_complete.

*Variable für Adreßnummer deklarieren
data: addrnumber type ad_addrnum.

*Parameter festlegen
addrnumber = ...

*Daten lesen
call function   'ADDR_GET_COMPLETE_DB'
     exporting  iv_addrnumber     = addrnumber
     importing  es_addr1_complete = addr1_complete
     exceptions parameter_error   = 1
                address_not_exist = 2
                internal_error    = 3.
case sy-subrc.
  ...
endcase.

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

Hinweise

Der Funktionsbaustein liefert im Rückgabeparameter ES_ADDR1_COMPLETE genau denselben Inhalt zurück, den der Funktionsbaustein ADDR_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ßnumme angegeben wird.
  • ADDRESS_NOT_EXIST
    Wird zurückgegeben, wenn zu der angegebenen Adreßnummer keine Daten gefunden worden sind.
  • INTERNAL_ERROR
    Schwerer interner Programmfehler oder Datenschiefstand. Muß immer mit A-Message ausgegeben werden.

Weiterführende Informationen





Parameter

BLK_EXCPT
ES_ADDR1_COMPLETE
IV_ADDRNUMBER
IV_CURRENT_COMM_DATA

Ausnahmen

ADDRESS_BLOCKED
ADDRESS_NOT_EXIST
INTERNAL_ERROR
PARAMETER_ERROR

Funktionsgruppe

SZAE

PERFORM Short Reference   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4867 Date: 20240523 Time: 141733     sap01-206 ( 45 ms )