Versions Compared

Old Version 58

changes.mady.by.user Technische Redaktion

Saved on

compared with

New Version Current

changes.mady.by.user Technische Redaktion

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Page Properties
hiddentrue
idREFACTURE

Product Version
Report Notepublished, only the object history - rest of the concept is outstanding
Assignee

Resources & Remarks

Remarks

  • Antje: page created
  • Antje: table with history codes created
  • (warning) Needs to be moved to the Document Lifecycle page as subpage - if the DLM page is ready to get published
  • (warning) Heading 1 "Summary" deleted for now - needs to be added later on if the concept is written in detail
  • Antje: Cleanup Section startet in the hidden part
  • Antje: Cleanup Section moved to Commander tooling page

For a cleanup the audit trail, the commander service can be used as a tool to remove audit trail entries.

>>> audit-cleanup Command


Modification History

NameDateProduct VersionAction
Antje08 FEB 20212.4New page properties macro.
Antje03 JAN 20222022 Springrestoring added (325)
Antje23 NOV 20222022 Winterpost text rendition (306) added
Antje28 NOV 20222022 Winterrestructure table



Excerpt
hiddentrue

The audit trail is the history protocol of an object, serving to document its total lifecycle. There are many different actions that trigger the creation of a new entry in the respective object's audit trail.

...

Anchor
auditTrail_HistoryCodes
auditTrail_HistoryCodes

History Codes

The GET "/dms/objects/{id}/history” REST endpoint returns a list of changes made to the object with the ID {objectId}. The meanings of the individual history codes are listed in the table below.

Core APIDescription
Action codeDetail
Explanation
Subaction codeEndpoints triggering the entryDescriptionExplanation
Import:
100
Object created
OBJECT_CREATED-POST /api/dms/objectsObject createdThe specified object was created by functions of the client or by an import.
101OBJECT_CREATED_WITH_CONTENT-POST /api/dms/objects
101
Document created
OBJECT_CREATED_WITH_CONTENT
The object was created using functions of the client or via an import operation.
/api/dms/objects
110
Object tag created
OBJECT_TAG_CREATED: [<name>, <state>]
A tag for the object was created.
<state>POST /api/dms/objects/{objectId}/tags/{name}/state/{state}Object tag createdA tag for the object was created.
Deletion:
200
Object irrevocably deleted
OBJECT_DELETED
The object was deleted and cannot be restored.
-

DELETE /api/dms/objects/{objectId}

DELETE /api/dms/objects/{objectId}/versions/{versionNr} (up to 2023 Summer)

Object irrevocably deletedThe object was deleted and cannot be restored.
201 (as of 2023 Summer)OBJECT_CONTENT_DELETED
202Object marked for deletion
-DELETE /api/dms/objects/{objectId}/contents/fileBinary content of the object is removed.A new object version was created that has no contentStreams section anymore.
202OBJECT_FLAGGED_FOR_DELETE
The object was moved to the recycle bin.
-

DELETE /api/dms/objects/{objectId}

Object marked for deletionThe object was moved to the recycle bin.
210
Object tag deleted
OBJECT_TAG_DELETED: [<name>, <state>]<state>DELETE /api/dms/objects/{objectId}/tags/{name}Object tag deletedA tag for the object was deleted.
220VERSION_DELETED: [<versionNr>]-DELETE /api/dms/objects/{objectId}/
tags
versions/{
name}
versionNr} (as of 2023 Autumn)Object version deleted.The object version was deleted and cannot be restored.
Update:
300
Metadata modified
OBJECT_METADATA_CHANGED-

POST /api/dms/objects/{objectId}

PATCH /api/dms/objects/{objectId}

Metadata modifiedThe metadata of the object or its status was edited using functions of the client or via an update carried out during the import operation.
301OBJECT_DOCUMENT_CHANGED-DELETE /api/dms/objects/{objectId}
/
api/dms/objects
tags/{
objectId
name}
301
Content changed
OBJECT_DOCUMENT_CHANGED
The document was edited using functions of the client or via an update carried out during the import operation.
/api/dms/objects/{objectId}/contents/file
303
Object updated and content moved
OBJECT_UPDATE_CONTENT_MOVED
The object was updated and the document was moved.Object tag modified
-

POST /api/dms/objects/{objectId}/actions/move/
contents/repositories/{repositoryId}

POST /api/dms/objects/{objectId}/versions/{versionNr}/
actions/move/contents/repositories/{repositoryId}

Object updated and content moved
310
The object was updated and the document was moved.

306 

(as of 2022 Winter)

RENDITION_CHANGED

1

POST /api/dms/objects/{objectId}/contents/renditions/textText rendition added/updated.A rendition of the binary content file of a DMS object was added or updated via endpoint. The subaction specifies the type of rendition.
310OBJECT_TAG_UPDATED: [<name>, <state>]
One of the object's tags was changed.
-

POST /api/dms/objects/{objectId}/tags/{name}/state/{state}?overwrite=true

POST /api/dms/objects/tags/{name}/state/{state}?query=<SQL>

325Object restored from an old version

Object tag modifiedOne of the object's tags was changed.
325

OBJECT_RESTORED_FROM_VERSION: [<versionNr>]

-POST /api/dms/objects/{objectId}/versions/{versionNr}/actions/restoreObject restored from an old versionThe data of the old object version were used to update the current object version.
340DOCUMENT_MOVED-

POST /api/dms/objects/{objectId}

/versions

PATCH /api/dms/objects/{

versionNr}/actions/restore340

objectId}

system:parentId property modified
DOCUMENT_MOVED
The value for the system:parentId property was modified (added, updated, removed). Additionally, an audit entry with action 300 was created.
POST
Retrieve:

400

DOCUMENT_ACCESSED-

GET /api/dms/objects/{objectId}/contents/file

PATCH

GET /api/dms/objects/{objectId}/versions/{versionNr}

Retrieve:400

/contents/file

GET /api/dms/objects/{objectId}/contents/renditions​/pdf

Output content
DOCUMENT_ACCESSED

The document content was read by the user, printed, or otherwise output. No changes were made.

/api/dms/objects/{objectId}/contents/file401Metadata retrievedMETADATA_ACCESSEDThe object's metadata were retrieved for viewing.

As of 2022 Summer: If a user retrieves the binary content file of the same object version multiple times within 10 minutes, only the first retrieval is documented in the audit trail.

The following processes internally retrieve the object's binary content file and thus trigger the creation of an audit entry as well:

  • the first retrieval of a PDF rendition after the object creation
401METADATA_ACCESSED-

POST /api/dms/objects/search

GET /api/dms/objects/{objectId}

GET /api/dms/objects/{objectId}/versions

GET /api/dms/objects/{objectId}/contents/renditions​/pdf

Metadata retrieved

The object's metadata were retrieved for viewing.

The following processes internally retrieve the object's metadata and thus trigger the creation of an audit entry as well:

  • each retrieval of a PDF rendition 
402
Text preview downloaded
RENDITION
_TEXT
_ACCESSED
The text rendition of the object's document file was retrieved.
1GET /api/dms/objects/{objectId}/contents/renditions​/textText rendition accessed

Rendition of the binary content accessed.

If a user retrieves the same type of rendition for the same object multiple times within 10 minutes, only the first retrieval is documented in the audit trail.

The subaction specifies the type of rendition

2GET /api/dms/objects/{objectId}/contents/
renditions/text
renditions​/pdfPDF rendition accessed

Info
iconfalse

Read on

Section


Column
width45%

Retrieving Document History Entries 

Insert excerpt
Retrieving Document History Entries
Retrieving Document History Entries
nopaneltrue
 Keep reading


Column
width45%

Endpoint for retrieving a document's history

This endpoint retrieves the history entries of a DMS object identified by objectId. History entries document modifications of or actions performed on a DMS object. Keep reading



...