SAP Function ADDR_GET - Read an address without dialog

Parameter Reference Type Length Default Optional Text
ADDRESS_GROUP ADRG-ADDR_GROUP C 4 X Address group (see long text for special handling)
ADDRESS_SELECTION ADDR1_SEL u 159 Specification of an address (see long text)
IV_CURRENT_COMM_DATA AD_COMCURR C 1 SPACE X Indicator: Current Status of Communication Data
READ_SADR_ONLY SZAD_FIELD-FLAG C 1 SPACE X Read in table SADR only
READ_TEXTS SZAD_FIELD-FLAG C 1 SPACE X Flag: Read texts (ADDRESS_TEXT)

Parameter Reference Type Length Text
ADDRESS_ADDITIONAL_INFO AD1_FLAGS u 12 Additional communication data information
ADDRESS_TEXT ADDR1_TEXT u 136 Text for key fields (language = SY-LANGU)
ADDRESS_VALUE ADDR1_VAL u 1430 Return data for an address
RETURNCODE SZAD_FIELD-RETURNCODE C 1 Return code: ' '(ok), 'I'nfo, 'W'arning, 'E'rror
SADR SADR u 699 Return the old address structure

Parameter Reference Length Optional Text
ADDRESS_GROUPS ADAGROUPS 4 X Address groups to which the address is assigned
ERROR_TABLE ADDR_ERROR 288 X Table with errors, warnings, information
VERSIONS ADDR_VERS 9 X Table with international versions

Exception Text
ADDRESS_NOT_EXIST Address does not exist
INTERNAL_ERROR Serious internal error (MESSAGE A...)
PARAMETER_ERROR Incorrect parameter values
VERSION_NOT_EXIST International version of the address does not exist

Functionality
The function module reads all records for the addresses specified inthe structure ADD RESS_SELECTIONand puts them in the return structures ADDRESS_VALUE and SADR.
ADDRESS_ADDITIONAL_INFO returns the communication types for which datais maintained for these addresses.
If the flag READ_TEXTS is set, key field texts (language key,countries, and so on) are also returned in ADDRESS_TEXT.
If an address group with the parameterADDRESS_GROUP is passed, the tableADRSTATUS is checked to see whether the addresses in this address groupare in the Business Address Services tables (ADRC etc.) or still in theold table SADR. If the data is still in SADR, they are read there,otherwise from ADRC. This can change program accesses from SADR toADRC, depending on when the data is moved from SADR to ADRC.
If the flag READ_SADR_ONLY is set, only the old table SADR is read. Thereturn parameters return the old address structure SADR and the newaddress structure ADDRESS_VALUE.

Example
See the examples in the function group documentation.

Notes
The database table SADR is obsolete in the SAP standard from Release4.5. It may still be used in customer solutions. Passing the parametersREAD_SADR_ONLY or ADDRESS_GROUP is therefore only useful in exceptionalcircumstances from 4.5.
SADR can still be used as a structure in programs.

Further information
Documentation of function group SZA0

Description
Entering an address group can trigger special handling: The systemchecks whether the data conversion SADR -> ADRC has already occurredfor the addresses in the corresponding address group.
In any case, both return parameters ADDR1_VAL and SADR are filled.
If an address group whose addresses have already been converted ispassed, ADRC is read and structure SADR is returned filled, in additionto ADDR1_VAL.
If no conversion has occurred, table SADR is read and the SADRstructure is returned; structure ADDR1_DATA from SADR is also filled.

Value range
Valid ADRC address group (CA01 for Customizing addresses)

Default
SPACE

Description
Key entry to specify the address to read.

Value range
In the calling program, normally only the address number is recognizedby a foreign key relationship (for example, plant T001W-ADRNR,purchasing organization TVKO-ADRNR). The address number is to be passedto the parameter ADDRNUMBER.
Addresses created but not yet stored in the local memory can beidentified and read with the parameter ADDRHANDLE.
Only one of the two parameters ADDRNUMBER and ADDRHANDLE has to befilled.
NATION is an indicator for international fonts. It does not normallyneed to be filled. The address that was created as the default isreturned in each case.
The parameter DATE is for time dependency. It is not currentlysupported. The parameter does not show a validity date for which theaddress is to be read. If the parameter is filled with a value otherthan '00000000' (initial value for date field) or '00010101'(currently the only possible database key), an error is returned inERROR_TABLE (return code 'E').

Default
The parameter is not predefined.

976725Countr-dep enhancements for tax determination U.S.A., Mexico
504463VIEW_VBADR: Parameter LANGU_PROP is missing
649651FAQ: Partner - Which notes may be important?
632602VX11N - Address fields are truncated after 35 characters
415524Accounting clerk info in the address
215645Output addresses w address/title in incor language