SAP ADDR_NUMBER_GET Function Module for Take address number for new address (Business Address Services)









ADDR_NUMBER_GET is a standard addr number get SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for Take address number for new address (Business Address Services) processing and below is the pattern details for this FM, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.


See here to view full function module documentation and code listing for addr number get FM, simply by entering the name ADDR_NUMBER_GET into the relevant SAP transaction such as SE37 or SE38.

Function Group: SZA0
Program Name: SAPLSZA0
Main Program: SAPLSZA0
Appliation area: S
Release date: N/A
Mode(Normal, Remote etc): Normal Function Module
Update:



Function ADDR_NUMBER_GET pattern details

In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.
CALL FUNCTION 'ADDR_NUMBER_GET'"Take address number for new address (Business Address Services)
EXPORTING
ADDRESS_HANDLE = "Address Handle (Temporary Key)
* OBJKEY = "
ADDRESS_REFERENCE = "Address reference (fill correctly -> see long text)
* PERSONAL_ADDRESS = ' ' "Indicator: Personal Address (Address Type 2)
* NUMBERRANGE_NUMBER = '01' "Number range from which the number is taken
* E071K_WA = "Prepopulated structure for transport entry
* GENERATE_TRANSPORT_ENTRIES = "Indicator: Generate entries for transport request
* OWNER = 'X' "Indicator: Application object is owner of address
* TABLE_NAME = "
* FIELD_NAME = "

IMPORTING
ADDRESS_NUMBER = "Number taken from the number range
RETURNCODE_NUMBERRANGE = "Return code when taking number

TABLES
* E071K_TAB = "All transport entries that belong to address

EXCEPTIONS
ADDRESS_HANDLE_NOT_EXIST = 1 INTERNAL_ERROR = 2 PARAMETER_ERROR = 3
.



IMPORTING Parameters details for ADDR_NUMBER_GET

ADDRESS_HANDLE - Address Handle (Temporary Key)

Data type: SZAD_FIELD-HANDLE
Optional: No
Call by Reference: No ( called with pass by value option)

OBJKEY -

Data type: ADRCS2-OBJKEY
Optional: Yes
Call by Reference: No ( called with pass by value option)

ADDRESS_REFERENCE - Address reference (fill correctly -> see long text)

Data type: ADDR_REF
Optional: No
Call by Reference: No ( called with pass by value option)

PERSONAL_ADDRESS - Indicator: Personal Address (Address Type 2)

Data type: ADRC-PERS_ADDR
Default: SPACE
Optional: Yes
Call by Reference: No ( called with pass by value option)

NUMBERRANGE_NUMBER - Number range from which the number is taken

Data type: INRI-NRRANGENR
Default: '01'
Optional: Yes
Call by Reference: No ( called with pass by value option)

E071K_WA - Prepopulated structure for transport entry

Data type: E071K
Optional: Yes
Call by Reference: No ( called with pass by value option)

GENERATE_TRANSPORT_ENTRIES - Indicator: Generate entries for transport request

Data type: SZAD_FIELD-FLAG
Optional: Yes
Call by Reference: No ( called with pass by value option)

OWNER - Indicator: Application object is owner of address

Data type: SZAD_FIELD-FLAG
Default: 'X'
Optional: Yes
Call by Reference: No ( called with pass by value option)

TABLE_NAME -

Data type: TSADRV-DDIC_TABLE
Optional: Yes
Call by Reference: No ( called with pass by value option)

FIELD_NAME -

Data type: TSADRV-DDIC_FIELD
Optional: Yes
Call by Reference: No ( called with pass by value option)

EXPORTING Parameters details for ADDR_NUMBER_GET

ADDRESS_NUMBER - Number taken from the number range

Data type: ADRC-ADDRNUMBER
Optional: No
Call by Reference: No ( called with pass by value option)

RETURNCODE_NUMBERRANGE - Return code when taking number

Data type: INRI-RETURNCODE
Optional: No
Call by Reference: No ( called with pass by value option)

TABLES Parameters details for ADDR_NUMBER_GET

E071K_TAB - All transport entries that belong to address

Data type: E071K
Optional: Yes
Call by Reference: No ( called with pass by value option)

EXCEPTIONS details

ADDRESS_HANDLE_NOT_EXIST - Transferred address handle does not exist

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

INTERNAL_ERROR - Serious internal error (MESSAGE A...)

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

PARAMETER_ERROR - Incorrect parameter values

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

Copy and paste ABAP code example for ADDR_NUMBER_GET Function Module

The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the newer method of declaring data variables on the fly. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8), which i why i have stuck to the origianl for this example.

DATA:
lt_e071k_tab  TYPE STANDARD TABLE OF E071K, "   
lv_address_handle  TYPE SZAD_FIELD-HANDLE, "   
lv_address_number  TYPE ADRC-ADDRNUMBER, "   
lv_address_handle_not_exist  TYPE ADRC, "   
lv_objkey  TYPE ADRCS2-OBJKEY, "   
lv_internal_error  TYPE ADRCS2, "   
lv_address_reference  TYPE ADDR_REF, "   
lv_returncode_numberrange  TYPE INRI-RETURNCODE, "   
lv_parameter_error  TYPE INRI, "   
lv_personal_address  TYPE ADRC-PERS_ADDR, "   SPACE
lv_numberrange_number  TYPE INRI-NRRANGENR, "   '01'
lv_e071k_wa  TYPE E071K, "   
lv_generate_transport_entries  TYPE SZAD_FIELD-FLAG, "   
lv_owner  TYPE SZAD_FIELD-FLAG, "   'X'
lv_table_name  TYPE TSADRV-DDIC_TABLE, "   
lv_field_name  TYPE TSADRV-DDIC_FIELD. "   

  CALL FUNCTION 'ADDR_NUMBER_GET'  "Take address number for new address (Business Address Services)
    EXPORTING
         ADDRESS_HANDLE = lv_address_handle
         OBJKEY = lv_objkey
         ADDRESS_REFERENCE = lv_address_reference
         PERSONAL_ADDRESS = lv_personal_address
         NUMBERRANGE_NUMBER = lv_numberrange_number
         E071K_WA = lv_e071k_wa
         GENERATE_TRANSPORT_ENTRIES = lv_generate_transport_entries
         OWNER = lv_owner
         TABLE_NAME = lv_table_name
         FIELD_NAME = lv_field_name
    IMPORTING
         ADDRESS_NUMBER = lv_address_number
         RETURNCODE_NUMBERRANGE = lv_returncode_numberrange
    TABLES
         E071K_TAB = lt_e071k_tab
    EXCEPTIONS
        ADDRESS_HANDLE_NOT_EXIST = 1
        INTERNAL_ERROR = 2
        PARAMETER_ERROR = 3
. " ADDR_NUMBER_GET




ABAP code using 7.40 inline data declarations to call FM ADDR_NUMBER_GET

The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.

 
"SELECT single HANDLE FROM SZAD_FIELD INTO @DATA(ld_address_handle).
 
"SELECT single ADDRNUMBER FROM ADRC INTO @DATA(ld_address_number).
 
 
"SELECT single OBJKEY FROM ADRCS2 INTO @DATA(ld_objkey).
 
 
 
"SELECT single RETURNCODE FROM INRI INTO @DATA(ld_returncode_numberrange).
 
 
"SELECT single PERS_ADDR FROM ADRC INTO @DATA(ld_personal_address).
DATA(ld_personal_address) = ' '.
 
"SELECT single NRRANGENR FROM INRI INTO @DATA(ld_numberrange_number).
DATA(ld_numberrange_number) = '01'.
 
 
"SELECT single FLAG FROM SZAD_FIELD INTO @DATA(ld_generate_transport_entries).
 
"SELECT single FLAG FROM SZAD_FIELD INTO @DATA(ld_owner).
DATA(ld_owner) = 'X'.
 
"SELECT single DDIC_TABLE FROM TSADRV INTO @DATA(ld_table_name).
 
"SELECT single DDIC_FIELD FROM TSADRV INTO @DATA(ld_field_name).
 


Search for further information about these or an SAP related objects



Comments on this SAP object

What made you want to lookup this SAP object? Please tell us what you were looking for and anything you would like to be included on this page!