SAP Function Modules

comments icon Comments

SDCAS_ADDRESS_LIST_CREATE SAP Function module - Create address list







SDCAS_ADDRESS_LIST_CREATE 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 SDCAS_ADDRESS_LIST_CREATE into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: V43M
Released Date: Not Released
Processing type: Normal fucntion module
Normal function module settings


Pattern for FM SDCAS_ADDRESS_LIST_CREATE - SDCAS ADDRESS LIST CREATE 





CALL FUNCTION 'SDCAS_ADDRESS_LIST_CREATE' "Create address list
  EXPORTING
    fi_vbeln =                  " sadlstwu-objid  Document number
*   fi_objtype = 'BUS1051'      " sadlstwu-objtype  Document object type
*   fi_listnr =                 " sadlstadm-listnr  Number of address list
*   fi_version =                " sadlstadm-version  Version number of address list
*   fi_listnr_number_range =    " inri-nrrangenr  Number range number
*   fi_ernam =                  " sadlstadm-ernam  Address list will be created by?
*   fi_selreport =              " sadlstadm-ktare  Selection report for addresses
*   fi_selvariant =             " sadlstadm-ktava  Selection variant for addresses
*   fi_address_vtext =          " sadlstadm-vtext  Description of address list
*   fi_address_customer =       " xfeld         Customer addresses
*   fi_abtnr =                  " knvk-abtnr
*   fi_address_partner_privat =   " xfeld       Home addresses of contact persons
*   fi_address_partner_office =   " xfeld       Company addresses of contact persons
*   fi_sortfield1 =             " sadlstsort-fieldname  Sort field 1
*   fi_sortorder1 =             " sadlstsort-sortorder  Sort order for sort field 1
*   fi_sortfield2 =             " sadlstsort-fieldname  Sort field 2
*   fi_sortorder2 =             " sadlstsort-sortorder  Sort order for sort field 2
*   fi_sortfield3 =             " sadlstsort-fieldname  Sort field 3
*   fi_sortorder3 =             " sadlstsort-sortorder  Sort order for sort field 3
*   fi_blocksize = '100'        " sadlstiad-blksize  Interval size
  IMPORTING
    fe_listnr =                 " sadlstadm-listnr  Number of address list
    fe_version =                " sadlstadm-version  Address list version
* TABLES
*   ft_parnr =                  " sdcas_parnr   Table containing contact person numbers
*   ft_kunnr =                  " sdcas_kunnr   Table containing customer numbers
*   ft_kna1 =                   " kna1          Table containing KNA1 sets
*   ft_knvk =                   " knvk          Table containing KNVK sets
  EXCEPTIONS
    NO_DOCUMENT_NUMBER = 1      "               Corresponding document is missing
    NO_PERSONS = 2              "               No addresses available
    NO_ADDRESSTYPE = 3          "               No address type available
    VERSION_ALREADY_EXIST = 4   "               Address version already existing
    ERROR_GETTING_LIST_NUMBER = 5  "            Error reading list number
    WRONG_LIST_NUMBER = 6       "               List number entered does not correspond to list number for document
    .  "  SDCAS_ADDRESS_LIST_CREATE

ABAP code example for Function Module SDCAS_ADDRESS_LIST_CREATE





The ABAP code below is a full code listing to execute function module SDCAS_ADDRESS_LIST_CREATE 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_fe_listnr    TYPE SADLSTADM-LISTNR
,
ld_fe_version    TYPE SADLSTADM-VERSION
,
it_ft_parnr    TYPE STANDARD TABLE OF SDCAS_PARNR,"TABLES PARAM
wa_ft_parnr  LIKE LINE OF it_ft_parnr
,
it_ft_kunnr    TYPE STANDARD TABLE OF SDCAS_KUNNR,"TABLES PARAM
wa_ft_kunnr  LIKE LINE OF it_ft_kunnr
,
it_ft_kna1    TYPE STANDARD TABLE OF KNA1,"TABLES PARAM
wa_ft_kna1  LIKE LINE OF it_ft_kna1
,
it_ft_knvk    TYPE STANDARD TABLE OF KNVK,"TABLES PARAM
wa_ft_knvk  LIKE LINE OF it_ft_knvk
.



 

SELECT single OBJID 
  FROM SADLSTWU 
  INTO @DATA(ld_fi_vbeln).

 

SELECT single OBJTYPE 
  FROM SADLSTWU 
  INTO @DATA(ld_fi_objtype).

 

SELECT single LISTNR 
  FROM SADLSTADM 
  INTO @DATA(ld_fi_listnr).

 

SELECT single VERSION 
  FROM SADLSTADM 
  INTO @DATA(ld_fi_version).



DATA(ld_fi_listnr_number_range) = some text here
 

SELECT single ERNAM 
  FROM SADLSTADM 
  INTO @DATA(ld_fi_ernam).

 

SELECT single KTARE 
  FROM SADLSTADM 
  INTO @DATA(ld_fi_selreport).

 

SELECT single KTAVA 
  FROM SADLSTADM 
  INTO @DATA(ld_fi_selvariant).

 

SELECT single VTEXT 
  FROM SADLSTADM 
  INTO @DATA(ld_fi_address_vtext).


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

SELECT single ABTNR 
  FROM KNVK 
  INTO @DATA(ld_fi_abtnr).


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

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

SELECT single FIELDNAME 
  FROM SADLSTSORT 
  INTO @DATA(ld_fi_sortfield1).

 

SELECT single SORTORDER 
  FROM SADLSTSORT 
  INTO @DATA(ld_fi_sortorder1).

 

SELECT single FIELDNAME 
  FROM SADLSTSORT 
  INTO @DATA(ld_fi_sortfield2).

 

SELECT single SORTORDER 
  FROM SADLSTSORT 
  INTO @DATA(ld_fi_sortorder2).

 

SELECT single FIELDNAME 
  FROM SADLSTSORT 
  INTO @DATA(ld_fi_sortfield3).

 

SELECT single SORTORDER 
  FROM SADLSTSORT 
  INTO @DATA(ld_fi_sortorder3).

 

SELECT single BLKSIZE 
  FROM SADLSTIAD 
  INTO @DATA(ld_fi_blocksize).

 

"populate fields of struture and append to itab
append wa_ft_parnr to it_ft_parnr.
 

"populate fields of struture and append to itab
append wa_ft_kunnr to it_ft_kunnr.
 

"populate fields of struture and append to itab
append wa_ft_kna1 to it_ft_kna1.
 

"populate fields of struture and append to itab
append wa_ft_knvk to it_ft_knvk.
.

CALL FUNCTION 'SDCAS_ADDRESS_LIST_CREATE'
  EXPORTING
    fi_vbeln =                   ld_fi_vbeln
*   fi_objtype =                 ld_fi_objtype
*   fi_listnr =                  ld_fi_listnr
*   fi_version =                 ld_fi_version
*   fi_listnr_number_range =     ld_fi_listnr_number_range
*   fi_ernam =                   ld_fi_ernam
*   fi_selreport =               ld_fi_selreport
*   fi_selvariant =              ld_fi_selvariant
*   fi_address_vtext =           ld_fi_address_vtext
*   fi_address_customer =        ld_fi_address_customer
*   fi_abtnr =                   ld_fi_abtnr
*   fi_address_partner_privat =    ld_fi_address_partner_privat
*   fi_address_partner_office =    ld_fi_address_partner_office
*   fi_sortfield1 =              ld_fi_sortfield1
*   fi_sortorder1 =              ld_fi_sortorder1
*   fi_sortfield2 =              ld_fi_sortfield2
*   fi_sortorder2 =              ld_fi_sortorder2
*   fi_sortfield3 =              ld_fi_sortfield3
*   fi_sortorder3 =              ld_fi_sortorder3
*   fi_blocksize =               ld_fi_blocksize
  IMPORTING
    fe_listnr =                  ld_fe_listnr
    fe_version =                 ld_fe_version
* TABLES
*   ft_parnr =                   it_ft_parnr
*   ft_kunnr =                   it_ft_kunnr
*   ft_kna1 =                    it_ft_kna1
*   ft_knvk =                    it_ft_knvk
  EXCEPTIONS
    NO_DOCUMENT_NUMBER =         1
    NO_PERSONS =                 2
    NO_ADDRESSTYPE =             3
    VERSION_ALREADY_EXIST =      4
    ERROR_GETTING_LIST_NUMBER =    5
    WRONG_LIST_NUMBER =          6
    .  "  SDCAS_ADDRESS_LIST_CREATE

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
ELSEIF SY-SUBRC EQ 5. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 6. "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_fe_listnr  TYPE SADLSTADM-LISTNR ,
ld_fi_vbeln  TYPE SADLSTWU-OBJID ,
it_ft_parnr  TYPE STANDARD TABLE OF SDCAS_PARNR ,
wa_ft_parnr  LIKE LINE OF it_ft_parnr,
ld_fe_version  TYPE SADLSTADM-VERSION ,
ld_fi_objtype  TYPE SADLSTWU-OBJTYPE ,
it_ft_kunnr  TYPE STANDARD TABLE OF SDCAS_KUNNR ,
wa_ft_kunnr  LIKE LINE OF it_ft_kunnr,
ld_fi_listnr  TYPE SADLSTADM-LISTNR ,
it_ft_kna1  TYPE STANDARD TABLE OF KNA1 ,
wa_ft_kna1  LIKE LINE OF it_ft_kna1,
ld_fi_version  TYPE SADLSTADM-VERSION ,
it_ft_knvk  TYPE STANDARD TABLE OF KNVK ,
wa_ft_knvk  LIKE LINE OF it_ft_knvk,
ld_fi_listnr_number_range  TYPE INRI-NRRANGENR ,
ld_fi_ernam  TYPE SADLSTADM-ERNAM ,
ld_fi_selreport  TYPE SADLSTADM-KTARE ,
ld_fi_selvariant  TYPE SADLSTADM-KTAVA ,
ld_fi_address_vtext  TYPE SADLSTADM-VTEXT ,
ld_fi_address_customer  TYPE XFELD ,
ld_fi_abtnr  TYPE KNVK-ABTNR ,
ld_fi_address_partner_privat  TYPE XFELD ,
ld_fi_address_partner_office  TYPE XFELD ,
ld_fi_sortfield1  TYPE SADLSTSORT-FIELDNAME ,
ld_fi_sortorder1  TYPE SADLSTSORT-SORTORDER ,
ld_fi_sortfield2  TYPE SADLSTSORT-FIELDNAME ,
ld_fi_sortorder2  TYPE SADLSTSORT-SORTORDER ,
ld_fi_sortfield3  TYPE SADLSTSORT-FIELDNAME ,
ld_fi_sortorder3  TYPE SADLSTSORT-SORTORDER ,
ld_fi_blocksize  TYPE SADLSTIAD-BLKSIZE .





SELECT single OBJID 
  FROM SADLSTWU 
  INTO ld_fi_vbeln.
 

"populate fields of struture and append to itab
append wa_ft_parnr to it_ft_parnr.

SELECT single OBJTYPE 
  FROM SADLSTWU 
  INTO ld_fi_objtype.
 

"populate fields of struture and append to itab
append wa_ft_kunnr to it_ft_kunnr.

SELECT single LISTNR 
  FROM SADLSTADM 
  INTO ld_fi_listnr.
 

"populate fields of struture and append to itab
append wa_ft_kna1 to it_ft_kna1.

SELECT single VERSION 
  FROM SADLSTADM 
  INTO ld_fi_version.
 

"populate fields of struture and append to itab
append wa_ft_knvk to it_ft_knvk.

ld_fi_listnr_number_range = some text here

SELECT single ERNAM 
  FROM SADLSTADM 
  INTO ld_fi_ernam.


SELECT single KTARE 
  FROM SADLSTADM 
  INTO ld_fi_selreport.


SELECT single KTAVA 
  FROM SADLSTADM 
  INTO ld_fi_selvariant.


SELECT single VTEXT 
  FROM SADLSTADM 
  INTO ld_fi_address_vtext.

ld_fi_address_customer = 'Check type of data required'.

SELECT single ABTNR 
  FROM KNVK 
  INTO ld_fi_abtnr.

ld_fi_address_partner_privat = 'Check type of data required'.
ld_fi_address_partner_office = 'Check type of data required'.

SELECT single FIELDNAME 
  FROM SADLSTSORT 
  INTO ld_fi_sortfield1.


SELECT single SORTORDER 
  FROM SADLSTSORT 
  INTO ld_fi_sortorder1.


SELECT single FIELDNAME 
  FROM SADLSTSORT 
  INTO ld_fi_sortfield2.


SELECT single SORTORDER 
  FROM SADLSTSORT 
  INTO ld_fi_sortorder2.


SELECT single FIELDNAME 
  FROM SADLSTSORT 
  INTO ld_fi_sortfield3.


SELECT single SORTORDER 
  FROM SADLSTSORT 
  INTO ld_fi_sortorder3.


SELECT single BLKSIZE 
  FROM SADLSTIAD 
  INTO ld_fi_blocksize.

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 SDCAS_ADDRESS_LIST_CREATE or its description.


   
 

SDCAS_ADDRESS_LIST_CREATE - Create address list
SDCAS_ADDRESS_LIST_ADDR_INSERT - 
SDCAS_ADDRESS_KEY_CONVERT - 
SDCAS_ADDRESS_HEADER_WRITE - 
SDCAS_ADDRESS_HEADER_READ - 
SDCAS_ADDRESS_HEADER_DELETE -