SAP Function CHANGEDOCUMENT_READ_POSITIONS - Change document: Read change document items

Parameter Reference Type Length Default Optional Text
ARCHIVE_HANDLE SYST-TABIX I 4 0 X Handle on Open Archive Files
CHANGENUMBER CDPOS-CHANGENR C 10 Change document number
KEYGUID CDPOS_UID-KEYGUID C 32 SPACE X UUID in Character Format
KEYGUID_STR CDPOS_STR-KEYGUID C 32 SPACE X UUID in Character Format
TABLEKEY CDPOS-TABKEY C 70 SPACE X Object class table key
TABLEKEY254 CDPOS_UID-TABKEY C 254 SPACE X Table Key for CDPOS in Character 254
TABLENAME CDPOS-TABNAME C 30 SPACE X Object class table name

Parameter Reference Type Length Text
ET_CDRED_STR CDRED_STR_TAB h 48 Additional Change Document - Table for STRINGs
HEADER CDHDR u 192 Change document header (structure CDHDR)

Parameter Reference Length Optional Text
EDITPOS CDSHW 1035 X Table with edited change document items
EDITPOS_WITH_HEADER CDRED 1181 X

Exception Text
NO_POSITION_FOUND No item found
WRONG_ACCESS_TO_ARCHIVE incorrect access to archive


INCLUDE 'DOCU_HAS_TO_BE_ELABORATED' OBJECT DOKU ID TX
The function module reads change document items and processes both theold and the new values according to their category. In some cases, theunits and currencies are added on to the value fields. Additionally,the corresponding table header is determined.
The change document number is required as a minimum entry.
The program RSSCD100 uses this function module and can be regarded as apossible application.
Example call:
DATA: NUMMER LIKE CDPOS-CHANGNR,
TABNAME LIKE CDPOS-TABNAME,
TABKEY LIKE CDPOS-TABKEY.
DATA: BEGIN OF EDIT_FORM OCCURS 50.
INCLUDE STRUCTURE CDSHW.
DATA: END OF EDIT_FORM.
...
CALL FUNCTION 'CHANGEDOCUMENT_READ_POSITIONS'
EXPORTING CHANGENR = NUMMER
TABLENAME = TABKEY
TABLEKEY = TABKEY
IMPORTING HEADER = CDHDR
TABLES EDITPOS = EDIT_FORM
EXCEPTIONS ...
INCLUDE 'ARCHIVE_PARAM_HANDLE_READ_CD' OBJECT DOKU ID TX
All change document items with the specifiedchange document numb are found.

Description
KEYGUID for searching in CDPOS_UID

Description
KEYGUID for searching in the table CDPOS_STR
The table key is the key of a changed table entry.
If no table key is specified, all change documentpositions with the specified change document numberare determined.
If a table key is specified, only the change documentpositions with both the specified change documentnumber and the table key are determined.
If no table name is specified, all change documentpositions with the specified change document numberare determined.
If a table name is specified, only the change documentpositions with the specified change document number andthe table name are determined.
The table must have the structure CDSHW.