SAP CHANGEDOCUMENT_READ_POSITIONS Function Module for Change document: Read change document items









CHANGEDOCUMENT_READ_POSITIONS is a standard changedocument read positions SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for Change document: Read change document items 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 changedocument read positions FM, simply by entering the name CHANGEDOCUMENT_READ_POSITIONS into the relevant SAP transaction such as SE37 or SE38.

Function Group: SCD1
Program Name: SAPLSCD1
Main Program: SAPLSCD1
Appliation area: *
Release date: 22-Dec-1994
Mode(Normal, Remote etc): Normal Function Module
Update:



Function CHANGEDOCUMENT_READ_POSITIONS 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 'CHANGEDOCUMENT_READ_POSITIONS'"Change document: Read change document items
EXPORTING
* ARCHIVE_HANDLE = 0 "Handle on Open Archive Files
CHANGENUMBER = "Change document number
* TABLEKEY = ' ' "Object class table key
* TABLENAME = ' ' "Object class table name
* TABLEKEY254 = ' ' "Table Key for CDPOS in Character 254
* KEYGUID = ' ' "UUID in Character Format
* KEYGUID_STR = ' ' "UUID in Character Format

IMPORTING
HEADER = "Change document header (structure CDHDR)
ET_CDRED_STR = "Additional Change Document - Table for STRINGs

TABLES
* EDITPOS = "Table with edited change document items
* EDITPOS_WITH_HEADER = "

EXCEPTIONS
NO_POSITION_FOUND = 1 WRONG_ACCESS_TO_ARCHIVE = 2
.



IMPORTING Parameters details for CHANGEDOCUMENT_READ_POSITIONS

ARCHIVE_HANDLE - Handle on Open Archive Files

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

CHANGENUMBER - Change document number

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

TABLEKEY - Object class table key

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

TABLENAME - Object class table name

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

TABLEKEY254 - Table Key for CDPOS in Character 254

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

KEYGUID - UUID in Character Format

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

KEYGUID_STR - UUID in Character Format

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

EXPORTING Parameters details for CHANGEDOCUMENT_READ_POSITIONS

HEADER - Change document header (structure CDHDR)

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

ET_CDRED_STR - Additional Change Document - Table for STRINGs

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

TABLES Parameters details for CHANGEDOCUMENT_READ_POSITIONS

EDITPOS - Table with edited change document items

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

EDITPOS_WITH_HEADER -

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

EXCEPTIONS details

NO_POSITION_FOUND - No item found

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

WRONG_ACCESS_TO_ARCHIVE - incorrect access to archive

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

Copy and paste ABAP code example for CHANGEDOCUMENT_READ_POSITIONS 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:
lv_header  TYPE CDHDR, "   
lt_editpos  TYPE STANDARD TABLE OF CDSHW, "   
lv_archive_handle  TYPE SY-TABIX, "   0
lv_no_position_found  TYPE SY, "   
lv_changenumber  TYPE CDPOS-CHANGENR, "   
lv_et_cdred_str  TYPE CDRED_STR_TAB, "   
lt_editpos_with_header  TYPE STANDARD TABLE OF CDRED, "   
lv_wrong_access_to_archive  TYPE CDRED, "   
lv_tablekey  TYPE CDPOS-TABKEY, "   SPACE
lv_tablename  TYPE CDPOS-TABNAME, "   SPACE
lv_tablekey254  TYPE CDPOS_UID-TABKEY, "   SPACE
lv_keyguid  TYPE CDPOS_UID-KEYGUID, "   SPACE
lv_keyguid_str  TYPE CDPOS_STR-KEYGUID. "   SPACE

  CALL FUNCTION 'CHANGEDOCUMENT_READ_POSITIONS'  "Change document: Read change document items
    EXPORTING
         ARCHIVE_HANDLE = lv_archive_handle
         CHANGENUMBER = lv_changenumber
         TABLEKEY = lv_tablekey
         TABLENAME = lv_tablename
         TABLEKEY254 = lv_tablekey254
         KEYGUID = lv_keyguid
         KEYGUID_STR = lv_keyguid_str
    IMPORTING
         HEADER = lv_header
         ET_CDRED_STR = lv_et_cdred_str
    TABLES
         EDITPOS = lt_editpos
         EDITPOS_WITH_HEADER = lt_editpos_with_header
    EXCEPTIONS
        NO_POSITION_FOUND = 1
        WRONG_ACCESS_TO_ARCHIVE = 2
. " CHANGEDOCUMENT_READ_POSITIONS




ABAP code using 7.40 inline data declarations to call FM CHANGEDOCUMENT_READ_POSITIONS

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 TABIX FROM SY INTO @DATA(ld_archive_handle).
 
 
"SELECT single CHANGENR FROM CDPOS INTO @DATA(ld_changenumber).
 
 
 
 
"SELECT single TABKEY FROM CDPOS INTO @DATA(ld_tablekey).
DATA(ld_tablekey) = ' '.
 
"SELECT single TABNAME FROM CDPOS INTO @DATA(ld_tablename).
DATA(ld_tablename) = ' '.
 
"SELECT single TABKEY FROM CDPOS_UID INTO @DATA(ld_tablekey254).
DATA(ld_tablekey254) = ' '.
 
"SELECT single KEYGUID FROM CDPOS_UID INTO @DATA(ld_keyguid).
DATA(ld_keyguid) = ' '.
 
"SELECT single KEYGUID FROM CDPOS_STR INTO @DATA(ld_keyguid_str).
DATA(ld_keyguid_str) = ' '.
 


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!