Ansicht
Dokumentation

ADDR_GET_COMPLETE - Read the complete address object (incl. all communication tables)

ADDR_GET_COMPLETE - Read the complete address object (incl. all communication tables)

General Data in Customer Master   ROGBILLS - Synchronize billing plans  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

The function module gets all addresses for an address number or address handle, including all their communication types and notes about the address or communication type.

The currently valid communication types are defined in the table TSAC(T).

These are currently (tables):

  • TEL (ADTEL) Telephone numbers
  • FAX (ADFAX) Fax numbers
  • TTX (ADTTX) Teletex numbers
  • TLX (ADTLX) Telex numbers
  • INT (ADSMTP) Internet addresses
  • RML (ADRML) Remote mail addresses
  • X40 (ADX400) X.400 addresses
  • RFC (ADRFC) RFC destinations
  • PRT (ADPRT) (local) printer addresses
  • SSF (ADSSF) Secure Store and Forward
  • URI (ADURI) Universal Resource Identifier (URL, FTP, etc.)
  • PAG (ADPAG) Pager services

The communication type 'SMTP' has the same meaning as 'INT', 'X400' has the same meaning as 'X40'.

The data is returned in the complex structure ADDR1_COMPLETE which comprises the subtables

  • ADDR1_TAB (address transfer structure)
  • ADTEL_TAB, ADFAX_TAB, ... (communication type table)
  • ADRCT_TAB (communication type notes)
  • ADRT_TAB (address notes)

Example

Read all data for an address number

* Declare transfer structure
data: addr1_complete type szadr_addr1_complete.

* Declare address number variable
data: addrnumber like addr1_sel-addrnumber.

* Specify parameters
addrnumber = ...

* Read data
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.

* You can access and process the data read by LOOPing over the tables
* in ADDR1_COMPLETE.
* The subtable ADDR1_TAB has the type structure SZADR_ADDR1_LINE,
* so you must access the fields with ADDR1_COMPLETE-DATA-.

Notes

The module calls the function modules ADDR_COMM_GET, ADDR_GET and ADDR_REMARKS_GET to access the database tables.

Exceptions

  • PARAMETER_ERROR
    Raised if both address number and address handle or neither of them is passed.
  • ADDRESS_NOT_EXIST
    Returned if no data is found for the specified address number or address handle.
  • INTERNAL_ERROR
    Severe internal program error or data inconsistency. Is always an A message.

Further information





Parameters

ADDR1_COMPLETE
ADDRHANDLE
ADDRNUMBER
ARCHIVE_HANDLE
BLK_EXCPT
IV_CURRENT_COMM_DATA

Exceptions

ADDRESS_BLOCKED
ADDRESS_NOT_EXIST
INTERNAL_ERROR
PARAMETER_ERROR
WRONG_ACCESS_TO_ARCHIVE

Function Group

SZAE

Vendor Master (General Section)   General Material Data  
This documentation is copyright by SAP AG.

Length: 4232 Date: 20240523 Time: 091532     sap01-206 ( 40 ms )