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-TABIXOptional: Yes
Call by Reference: No ( called with pass by value option)
CHANGENUMBER - Change document number
Data type: CDPOS-CHANGENROptional: No
Call by Reference: No ( called with pass by value option)
TABLEKEY - Object class table key
Data type: CDPOS-TABKEYDefault: SPACE
Optional: Yes
Call by Reference: No ( called with pass by value option)
TABLENAME - Object class table name
Data type: CDPOS-TABNAMEDefault: 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-TABKEYDefault: SPACE
Optional: Yes
Call by Reference: No ( called with pass by value option)
KEYGUID - UUID in Character Format
Data type: CDPOS_UID-KEYGUIDDefault: SPACE
Optional: Yes
Call by Reference: No ( called with pass by value option)
KEYGUID_STR - UUID in Character Format
Data type: CDPOS_STR-KEYGUIDDefault: 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: CDHDROptional: No
Call by Reference: No ( called with pass by value option)
ET_CDRED_STR - Additional Change Document - Table for STRINGs
Data type: CDRED_STR_TABOptional: 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: CDSHWOptional: Yes
Call by Reference: No ( called with pass by value option)
EDITPOS_WITH_HEADER -
Data type: CDREDOptional: 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