Product Version 2020 Summer (2.2)

What's new in this release?

Features

Here, yo willl find some of the new release's features. Check out the Change Log for further information on all changes.

Contentanalyzer Service Controllable

The Contentanalyzer service provides a simple text extraction and the determination of the MIME type as a synchronous "service" for the analysis of objects.

Statically - and therefore comprehensively - you can set the service for each object using the JSON configuration file so that text extraction ("content": "false") and/or the determination of the MIME type ("mimetype": "false") is switched off. If the service is not to be used in general and should be skipped accordingly, the parameter "skip": "true" is available. You make the settings in the general configuration file for the microservices (Git for configuration, .../system/serviceConfiguration.json). The configuration is read by the API gateway service (skip the Contentanalyzer service) and by the Contentanalyzer itself. If you change settings, restart both services.

For a dynamic control of the text extraction of the servicefor example, in connection with compound documents where this is not requiredthe "option" with the argument "synchronousContentAnalysis": "true" is available for the request of the "Store one or more documents as new DMS objects (POST /api/dms/objects)" endpoint. Depending on the respective application context, you control this service directly and flexibly using the request.

(OKTO-4309)

Tracing Options (New Endpoints)

Two new system endpoints tell you more about the state of DMS calls (/api/dms) currently running:

  •  /api/system/calls - delivers information on all running DMS calls in the system and gives you an impression of the system load
  • /api/system/calls/{traceid} - delivers information on the corresponding DMS calls for the given traceid

The result, which is provided in JSON format, contains per call information about traceid, the called endpoint, start time and tenant. Finished and erroneous calls are not part of the result.

(OKTO-4310)

Document Lifecycle Management

"Schema Flow" Using Floating Secondary Object Types

Flexible structural change of the schema ...

For the greatest possible flexibility in all lifecycles of an object, we provide floating secondary object types ("dynamic") in addition to static ones. The already existing concept of "static" secondary object types, which can be used to group properties and then assign these property groups to object types (e.g., documents or folders), has been enhanced. So called "floating" secondary object types allow you to make schema changes for individual object type instances during the lifecycle and thus flexibly adapt them to your management processes. For example, you can classify imported objects only at a later point in time and add or remove the necessary property groups of a floating secondary object type at runtime by updating its type.

For an object type, you define references to secondary object types in the schema definition: e.g., <secondaryObjectTypeId static="false">INV</secondaryObjectTypeId>. For each reference you also define whether it is static (static="true", default) or floating (static="false").

  • static reference - the secondary object type is automatically available in all instances of the object type
  • floating reference - the secondary object type is added to an already existing instance of an object type via one of the update endpoints (POST /api/dms/objects/{objectId} / PATCH /api/dms/objects/{objectId}). In the "system:secondaryObjecttypeIds": property area of the metadata.json file, you use the keywords "add":, "value": or "remove": to flexibly add single or multiple property groups of secondary object types as needed or remove them if obsolete. During the initial import of an object (POST /api/dms/objects), the keyword "value": can be used to add multiple secondary object types right from the beginning.

Note that values for the secondary object type's properties must be given if set to required and no defaultValue is defined. Adding or removing individual properties is not possible. You can only do this using "floating" secondary object types.

Search for objects that use secondary object types by explicitly specifying it in the FROM clause: select * from appSot:INV.

>> "Secondary Object Types" concept | "Changing Schema Structures ("Schema Flow")" tutorial.

(OKTO-4191)

Traceable, Stateful Processing of Documents Using Tags

In document lifecycle management, multi-stage and asynchronous processes are not uncommonquite the contrary. The first process steps are carried out with the highest priority. More complex and currently not absolutely essential process steps are carried out asynchronously with a lower priority. This saves time, and carrying out operations in parallel lets you distribute resources more evenly. To resume a process chain, additional information about the current status of the process is necessary. In order to not mix an object's metadata with its status data, we introduced the possibility to tag objects. 

Tags describe the status of an object within a process chain. They consist of a unique tag name (name) and an integer value, representing the status (state). They are managed independently of the schema or version, which means that it is not necessary to define them in the schema, and that tags are always available with the most current version of an object.

Objects can be searched by tags and selected for the next process step. All tagging activities are recorded by the yuuvis® system in the object history (Audit Trail). Thanks to this, you can always retrace who has done what and when. Trouble shooting, reporting on the process status or general issues are made easy by this centrally stored history.

Five new endpoints are available for the handling of tags:

Typical use cases are combinations of third-party applications, whose process chains are controlled by a certain tag (i.e., workflows or renditions). You can learn about the different options in our tutorial, where we take you through a simple import management process for subsequent classification of imported documents (code samples are included).

>> "Tagging Objects for Processing" tutorial plus code examples in gitHub

(OKTO-4146)

Changelog

Bugfixes