Ansicht
Dokumentation
ADDR_GET_COMPLETE - Lesen des kompletten Adreßobjektes (inkl. alle Kommunikationstabellen)
CPI1466 during Backup CPI1466 during BackupDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Der Funktionsbaustein ermittelt zu einer Adreßnummer, oder alternativ zu einem Adreßhandle, 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 like addr1_sel-addrnumber.
*Parameter festlegen
addrnumber = ...
*Daten lesen
call function 'ADDR_GET_COMPLETE'
exporting addrnumber = addrnumber
importing 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-
Hinweise
Innerhalb des Bausteins werden die Funktionsbausteine ADDR_COMM_GET, ADDR_GET und ADDR_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 angegeben wird.
- ADDRESS_NOT_EXIST
Wird zurückgegeben, wenn zu der angegebenen Adreßnummer, bzw. dem Adreßhandle, keine Daten gefunden worden sind.
- INTERNAL_ERROR
Schwerer interner Programmfehler oder Datenschiefstand. Muß immer mit A-Message ausgegeben werden.
Weiterführende Informationen
Parameter
ADDR1_COMPLETEADDRHANDLE
ADDRNUMBER
ARCHIVE_HANDLE
BLK_EXCPT
IV_CURRENT_COMM_DATA
Ausnahmen
ADDRESS_BLOCKEDADDRESS_NOT_EXIST
INTERNAL_ERROR
PARAMETER_ERROR
WRONG_ACCESS_TO_ARCHIVE
Funktionsgruppe
SZAEAddresses (Business Address Services) rdisp/max_wprun_time - Maximum work process run time
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 4776 Date: 20240523 Time: 150915 sap01-206 ( 44 ms )