| Page Properties | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
Resources & Remarks Modification History
|
...
Renditions are alternative representations of the content assigned to DMS objects. As such, they are only retrievable with read permission for the concrete object instances.
Please note that a rendition is not an exact representation of the original file. Deviations to the original file may arise and are NOT considered as bugs in our software.
Typical use cases for the individual kinds of rendition are:
| kind of rendition | typical use cases |
|---|---|
text | full-text search |
pdf | content preview |
slide | thumbnails for content visualization within hit lists in client applications |
Calculation and Storage
The yuuvis® Momentum core system offers automated rendition calculation for various supported formats of binary content files.
Note: The responsible services are enabled in the default configuration but the rendition repository has to be configured manually.
| kind of rendition | text | pdf | slide |
|---|---|---|---|
| service for calculation | CONTENTANALYZER | RENDITION | RENDITION |
| automated calculation | during import with content and content update processes | on (first) request | on (first) request |
| manual input | during the import or via update endpoint for existing objects, or via dms.request.objects.upsert.database-before webhook | - | - |
| storage location | search index | rendition repository | rendition repository |
| availability for DMS object versions | only for current version | for any (not deleted) version | for any (not deleted) version |
As the text rendition is used for full-text search, it is stored in the search index. If you want to extend the core system's functionality in terms of supported formats, it is possible to set or update the text rendition via API gateway endpoints. Thus, e.g., it is possible to integrate an OCR implementation to automatically calculate a full-text for binary content files of image file types.
...
The following table provides an overview for various binary content file types and the types of rendition that can be provided (
) by yuuvis® Momentum.
| Binary Content File Type | Extension | text rendition | pdf rendition | slide rendition |
|---|---|---|---|---|
| MS Office Word 97-2016 | doc, docx | | | |
MS Office PowerPoint 97-2016 | ppt, pptx | | | |
| MS Office Excel 97-2016 | xls, xlsx | | | |
| OpenDocument Text | odt | | | |
| OpenDocument Presentation | odp | | | |
| OpenDocument Spreadsheet | ods | | | |
| Rich Text Format | rtf | | - | - |
| Visio Drawing File | vsd, vsdx | - | (limited range of functions) | |
| Plain Text | txt | | - | - |
| Comma Separated Values | csv | | - | - |
| HyperText Markup Language (HTML) | html | | - | - |
| XML | xml | | - | - |
| JavaScript Object Notation | json | | - | - |
| MS Outlook | msg | | - | - |
| Encapsulated Portable Document Format | epdf | | - | - |
| Encapsulated Portable Document Format | | - | | |
Tagged Image File Format | tiff / tif | - | | |
Portable Bitmap Image | pbm | - | | - |
Bitmap Image File | bmp | - | | |
Graphical Interchange Format File | gif | - | | |
JPEG Image Exchangeable image file format (JPEG) | jpg, jng, jpeg | - | | (only jpg and jpeg) |
| Portable Network Graphic | png | - | | |
| Weppy Image Format (Lossy Compression) | webp | - | | |
Operations on Renditions
The API gateway provides the following endpoints for the handling of renditions. The individual operations are documented in the corresponding object's audit trail.
| kind of rendition | text | pdf | slide |
|---|---|---|---|
retrieval for current object version | GET /api/dms/objects/{objectId}/contents/renditions/text | GET /api/dms/objects/{objectId}/contents/renditions/pdf | GET /api/dms/objects/{objectId}/contents/renditions/slide |
| retrieval for any object version | - | GET /api/dms/objects/{objectId}/versions/{versionNr}/contents/renditions/pdf | GET /api/dms/objects/{objectId}/versions/{versionNr}/contents/renditions/slide |
| update | POST /api/dms/objects/{objectId}/contents/renditions/text | - | - |
| Info | |||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||
Read on
|
...