DMS Endpoints
Manage DMS objects in yuuvis® Momentum or retrieve structural information for the tenant that are relevant for all its users.
In the default configuration, any logged-in user has access to the endpoints. However, the creation, retrieval, update and deletion of DMS objects require corresponding roles.
As of version 2022 Autumn, some processes that lead to an update of the index of the search engine can be called with the query parameter waitForSearchConsistency
.
>> find details below
HTTP Method as of product version | Purpose | Response Format | Description |
---|---|---|---|
Basic CRUD Operations | |||
POST | Store one or more new DMS objects | JSON | Stores files and their metadata as DMS objects of a specified type. |
POST as of 1.0 | Search for objects by search query | JSON | Returns a hit list according to the CMIS-based search query provided within the request body. Returns a JSON array of the DMS objects found and visible by read permission. Two parameters allow for paging. |
GET as of 1.0 | Retrieve object metadata by ID | JSON | Retrieves the metadata of a DMS object identified by objectId. |
GET as of 1.0 | Retrieve document content by ID | binary data | Gets the content file related to a DMS object identified by objectId. |
GET as of 2020 Autumn | Retrieve text rendition of content by ID | plain text | Gets the content file's full text rendition related to a DMS object identified by objectId. |
POST | Update text rendition by ID | HTTP status code | Updates the full-text rendition related to a DMS object identified by |
GET as of 2020 Winter | Retrieve PDF rendition of content by ID | Gets the content file's PDF rendition related to a DMS object identified by objectId. | |
GET as of 2023 Spring | Retrieve slide rendition of content by ID | PNG | Retrieves the slide rendition of the binary content file that is assigned to the DMS object specified by objectId ./api/dms/objects/{objectId}/contents/renditions/slide |
POST as of 1.0 | Update object metadata by ID | JSON | Updates all metadata of a DMS object, identified by objectId, with the metadata send within the request. |
PATCH as of 2019 Winter | Patch-Update object metadata by ID | JSON | Patch-updates metadata of a DMS object identified by objectId with the metadata send within the request. |
PATCH as of 2021 Autumn | Patch-update object metadata by ID | JSON | Updates metadata in multiple objects specified by ID in the JSON request body. |
POST as of 1.0 | Update document content by ID | JSON | Replaces the content file of an DMS object identified by objectId with the binary file provided in the request. Implicitly creates a new version. |
DELETE as of 1.0 | Delete object by ID | http status code | Deletes a DMS object identified by objectId. |
DELETE as of 2021 Winter | Delete multiple objects by ID | http status code | Deletes multiple objects specified by ID in the JSON request body. |
Operations on old Versions | |||
GET as of 1.0 | Retrieve object metadata by ID (all versions) | JSON | Retrieves the metadata of all versions of a DMS object identified by objectId. |
GET as of 1.0 | Retrieve object metadata by ID (specified version) | JSON | Retrieves the metadata of a given version of a DMS object identified by objectId and versionNr. |
GET as of 1.0 | Retrieve document content by ID (specified version) | binary data | Gets the content related to a version of a DMS object identified by objectId and versionNr. |
GET as of 2022 Winter | Retrieve PDF rendition of content by ID (specified version) | Returns the content file's PDF rendition of the DMS document object version specified by | |
GET as of 2023 Spring | Retrieve slide rendition of content by ID (specified version) | PNG | Returns the content file's slide rendition of the DMS document object version specified by objectId and versionNr ./api/dms/objects/{objectId}/versions/{versionNr}/contents/renditions/slide |
POST | Restore specified version. | JSON | Restores the old version of an object specified by |
DELETE as of 1.0 | Delete object by ID (specified version) | http status code | Deletes a version of a DMS object identified by objectId and versionNr. |
History Access | |||
GET as of 1.0 | Retrieve a list of history entries | JSON | Retrieves the history entries of a DMS object identified by objectId. |
Content Validation | |||
GET as of 1.0 | Validate content by ID | JSON | Validates the content of a DMS object identified by objectId. |
GET as of 1.0 | Validate content by ID (specified version) | JSON | Validates the content of a version of a DMS object identified by objectId and versionNr. |
Repository Operations | |||
POST as of 2019 Winter | Move document content by ID to specified repository | JSON | Moves the binary content file assigned to the object specified by |
POST as of 2019 Winter | Move document content by ID (specified version) to specified repository | JSON | Moves the binary content file assigned to the selected version of the object specified by |
Document Lifecycle Management - Tagging | |||
GET as of 2020 Summer | Retrieve object tags by ID | JSON | Retrieves all tags of a DMS object identified by objectId. The tags are displayed as a table with the values name, state, creationDate and traceId. |
POST as of 2020 Summer | Add object tag by ID | JSON | Adds a tag to a DMS object identified by objectId. |
POST as of 2020 Summer | Update object tag by ID | JSON | Updates a tag of a DMS object identified by objectId. |
POST as of 2020 Summer | Add/update object tag by search query | JSON | Returns a list of objects according to the CMIS-based search query provided with the query= parameter. For the first record returned, the tag and state of the request given will be added/updated. All other objects matched by the query remain unchanged. |
DELETE as of 2020 Summer | Delete object tag by ID | http status code | Deletes a tag of a DMS object identified by objectId. |
Schema Retrieval - Object Type Information | |||
GET as of 1.0 | Retrieve applied tenant schema | XML / JSON | Gets the applied tenant schema in its native structure. |
GET as of 1.0 | Retrieve applied tenant schema with an alternative structure | JSON | Gets the applied tenant schema. This ist similar to the GET /api/dms/schema/native. The result schema contains the same DMS object types, but it is structured in a different way. |
GET as of 1.0 | Retrieve an object type's definition by its local name | JSON | Retrieves the definition of the object type identified by localname. The definition contains attributes of the object type and definitions of all its fields. |
Version and App Information | |||
GET as of 2022 Spring | Retrieves installed product version | JSON | |
GET as of 2021 Summer | Retrieve all applications for the tenant | JSON | Retrieves all applications available in the tenant the currently logged-in user belongs to. |
Parameter 'waitForSearchConsistency' for Endpoints with Effect on the Search Index
As of version 2022 Autumn, some processes that lead to an update of the index of the search engine can be called with the query parameter waitForSearchConsistency
.
Value of 'waitForSearchConcistency' | Processing | Description | Advantage | Disadvantage |
---|---|---|---|---|
true | synchronous | The success response of the corresponding endpoint is returned after the successful update of the search index. | The changes are available even for search requests that are sent immediately after the synchronous processing. | The waiting time before the response is rather long. |
false | asynchronous | The success response of the corresponding endpoint does not wait for the update of the search index. | The waiting time for the response is far shorter. | Search requests sent immediately after the change request may be processed before the search index is updated. |
The update and import endpoints listed below accept an optional query parameter waitForSearchConsistency
.
Endpoints | Default for waitForSearchConsistency |
---|---|
Import: POST /api/dms/objects | false |
Metadata update: POST /api/dms/objects/{objectId} PATCH /api/dms/objects/{objectId} PATCH /api/dms/objects | true |
Content update: POST /api/dms/objects/{objectId}/contents/file | true |
Restore: POST /api/dms/objects/{objectId}/versions/{versionNr}/actions/restore | true |
Deletion: DELETE /api/dms/objects/{objectId} (as of 2023 Summer) DELETE /api/dms/objects (as of 2023 Summer) | true |
Tagging: | true |
Text rendition: POST /api/dms/objects/{objectId}/contents/renditions/text | true |