This How-To shows which settings are necessary to write change documents for an object and its items.

The change documents are written synchronously or asynchronously after persisting the data of the objects on the database ("save"). The QPPD exclusively uses a total of 12 database tables (P) in the /SCT/ namespace to store data for an object and its items. The change documents document at the technical level of the database tables which items have been added, deleted, or which fields have changed for existing items. Change documents can be written for each field of these database tables that is not used as a primary key. This documents those changes that have occurred since the object was loaded or since it was last saved.

The QPPD uses the standard SAP for the change documents. This means that there can be exactly one header information and any number of item information for a change document, which are stored in the three standard SAP tables CDHDR, CDPOS, and CDPOS_UID. Generally, change documents can be written for creating, changing, and deleting values. This means that for a change of a value in a database field exactly one entry is created on the item level of the change documents. The changes on a node are recorded in exactly one change document and a change document always refers to exactly one node. If, for example, the object consists of a total of 20 nodes and 10 nodes are changed, then 10 change documents are created after saving.

If an object or a node is deleted, the associated change documents (header and item information) are also deleted. If a value, a text, or a document of a node is deleted, but the node itself remains, these deletions are documented by the change documents.

The Customizing object Change document profile is used to define for which fields of the various database tables change documents are written. This change document profile is assigned to the regulation type and/or item categories as required. The assignment of the change document profile can be redefined in the hierarchy.

If the Customizing for the change document profiles is changed and this is already in use, any superfluous change documents that may arise can be deleted via a program.

The various settings are explained in the following text.