CHANGEDOCUMENT_PREPARE_TABLES SAP Function module - Change document: Edit tables for change document

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

Associated Function Group: SCD0
Released Date: 22.12.1994
Processing type: Normal fucntion module

Pattern for FM CHANGEDOCUMENT_PREPARE_TABLES - CHANGEDOCUMENT PREPARE TABLES

CALL FUNCTION 'CHANGEDOCUMENT_PREPARE_TABLES' "Change document: Edit tables for change document
  EXPORTING
*   check_indicator = SPACE     "               Flag whether tables are to be changed
    tablename =                 " cdpos-tabname  Name of the table structure of the internal tables
*   check_only_logflags = SPACE  " cdcheck_logflags  Control Flag: Check Change Document-Relevant Fields Only
  IMPORTING
    result =                    "               Flag whether tables are identical
  TABLES
    table_new =                 "               Table contains the changed data
    table_old =                 "               Table contains the unchanged data
  EXCEPTIONS
    NAMETAB_ERROR = 1           "               Error when calling NAMETAB_GET
    WRONG_STRUCTURE_LENGTH = 2  "               Table line not long enough to set indicator
    .  "  CHANGEDOCUMENT_PREPARE_TABLES

ABAP code example for Function Module CHANGEDOCUMENT_PREPARE_TABLES

The ABAP code below is a full code listing to execute function module CHANGEDOCUMENT_PREPARE_TABLES 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_result  
 
 TYPE STRING
,
it_table_new  
 
 TYPE STANDARD TABLE OF STRING,"TABLES PARAM
wa_table_new
 
 LIKE LINE OF it_table_new
,
it_table_old  
 
 TYPE STANDARD TABLE OF STRING,"TABLES PARAM
wa_table_old
 
 LIKE LINE OF it_table_old
.


DATA(ld_check_indicator) = 'some text here'.
 

SELECT single TABNAME 
  FROM CDPOS 
  INTO @DATA(ld_tablename).


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

"populate fields of struture and append to itab
append wa_table_new to it_table_new.
 

"populate fields of struture and append to itab
append wa_table_old to it_table_old.
.

CALL FUNCTION 'CHANGEDOCUMENT_PREPARE_TABLES'
  EXPORTING
*   check_indicator =            ld_check_indicator
    tablename =                  ld_tablename
*   check_only_logflags =        ld_check_only_logflags
  IMPORTING
    result =                     ld_result
  TABLES
    table_new =                  it_table_new
    table_old =                  it_table_old
  EXCEPTIONS
    NAMETAB_ERROR =              1
    WRONG_STRUCTURE_LENGTH =     2
    .  "  CHANGEDOCUMENT_PREPARE_TABLES

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
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_result
 
 TYPE STRING ,
ld_check_indicator
 
 TYPE STRING ,
it_table_new
 
 TYPE STANDARD TABLE OF STRING ,
wa_table_new
 
 LIKE LINE OF it_table_new,
ld_tablename
 
 TYPE CDPOS-TABNAME ,
it_table_old
 
 TYPE STANDARD TABLE OF STRING ,
wa_table_old
 
 LIKE LINE OF it_table_old,
ld_check_only_logflags
 
 TYPE CDCHECK_LOGFLAGS .


ld_check_indicator = 'some text here'. 

"populate fields of struture and append to itab
append wa_table_new to it_table_new.

SELECT single TABNAME 
  FROM CDPOS 
  INTO ld_tablename.
 

"populate fields of struture and append to itab
append wa_table_old to it_table_old.
ld_check_only_logflags = 'Check type of data required'.

SAP Documentation for FM CHANGEDOCUMENT_PREPARE_TABLES