SAP Function Modules

comments icon Comments

ADDR_DIALOG SAP Function module - Dialog maintenance of addresses







ADDR_DIALOG is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name ADDR_DIALOG into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: SZA1
Released Date: 13.03.2000
Processing type: Normal fucntion module
Normal function module settings


Pattern for FM ADDR_DIALOG - ADDR DIALOG 





CALL FUNCTION 'ADDR_DIALOG' "Dialog maintenance of addresses
* EXPORTING
*   check_address = 'X'         " szad_field-flag  Flag: Check address contents
*   suppress_taxjurcode_check = SPACE  " szad_field-flag  Kz.: "Tax Jurisdiction Code" field not handled
*   iv_time_dependent_comm_data = SPACE  " ad_timedep  Indicator: Time Validity for Communication Data
  IMPORTING
    ok_code =                   " sy-ucomm      OK_CODE passed for calling program
  TABLES
    number_handle_tab =         " addr1_dia     Transfer table of addresses to be processed
*   values =                    " addr1_data    Return table with maintained address data
  EXCEPTIONS
    ADDRESS_NOT_EXIST = 1       "               Address does not exist or is invalid
    GROUP_NOT_VALID = 2         "               Address group does not exist or is invalid
    PARAMETER_ERROR = 3         "               Incorrect parameter values
    INTERNAL_ERROR = 4          "               Serious internal error (MESSAGE A...)
    .  "  ADDR_DIALOG

ABAP code example for Function Module ADDR_DIALOG





The ABAP code below is a full code listing to execute function module ADDR_DIALOG including all data declarations. The code uses 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 original method of declaring data variables up front. 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).

DATA:
ld_ok_code    TYPE SY-UCOMM
,
it_number_handle_tab    TYPE STANDARD TABLE OF ADDR1_DIA,"TABLES PARAM
wa_number_handle_tab  LIKE LINE OF it_number_handle_tab
,
it_values    TYPE STANDARD TABLE OF ADDR1_DATA,"TABLES PARAM
wa_values  LIKE LINE OF it_values
.





DATA(ld_check_address) = some text here


DATA(ld_suppress_taxjurcode_check) = some text here

DATA(ld_iv_time_dependent_comm_data) = 'Check type of data required'.
 

"populate fields of struture and append to itab
append wa_number_handle_tab to it_number_handle_tab.
 

"populate fields of struture and append to itab
append wa_values to it_values.
.

CALL FUNCTION 'ADDR_DIALOG'
* EXPORTING
*   check_address =              ld_check_address
*   suppress_taxjurcode_check =    ld_suppress_taxjurcode_check
*   iv_time_dependent_comm_data =    ld_iv_time_dependent_comm_data
  IMPORTING
    ok_code =                    ld_ok_code
  TABLES
    number_handle_tab =          it_number_handle_tab
*   values =                     it_values
  EXCEPTIONS
    ADDRESS_NOT_EXIST =          1
    GROUP_NOT_VALID =            2
    PARAMETER_ERROR =            3
    INTERNAL_ERROR =             4
    .  "  ADDR_DIALOG

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 3. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 4. "Exception
  "Add code for exception here
ENDIF.







ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:


ld_ok_code  TYPE SY-UCOMM ,
ld_check_address  TYPE SZAD_FIELD-FLAG ,
it_number_handle_tab  TYPE STANDARD TABLE OF ADDR1_DIA ,
wa_number_handle_tab  LIKE LINE OF it_number_handle_tab,
ld_suppress_taxjurcode_check  TYPE SZAD_FIELD-FLAG ,
it_values  TYPE STANDARD TABLE OF ADDR1_DATA ,
wa_values  LIKE LINE OF it_values,
ld_iv_time_dependent_comm_data  TYPE AD_TIMEDEP .





ld_check_address = some text here 

"populate fields of struture and append to itab
append wa_number_handle_tab to it_number_handle_tab.

ld_suppress_taxjurcode_check = some text here 

"populate fields of struture and append to itab
append wa_values to it_values.
ld_iv_time_dependent_comm_data = 'Check type of data required'.

SAP Documentation for FM ADDR_DIALOG


Function group docu for the function groups SZA1 and SZA0.
...See here for full SAP fm documentation

Contribute (Add Comments)

Please help keep this info upto date and use the comments section below to add useful hints, tips and information specific to this SAP function. This will then be available for you and other users to easily find by simply searching on the object name ADDR_DIALOG or its description.


   
 

ADDR_DIALOG - Dialog maintenance of addresses
ADDR_DETERMINE_INTERVALS - 
ADDR_DEQUEUE - Unlocking addresses (Business Address Services)
ADDR_DELETE_REGSTRUC_LINKS - 
ADDR_DELETE - Deletion of an address without dialog
ADDR_DEFAULT_SENDER_COUNTRY -