Everything within this section is only visible while editing. Use Page Properties ID "STUB", "REFACTURE", "PROGRESS", "rDEV", "rDOC", "rLANG" and "DONE". Everything contained within the table is displayed in the (INTERNAL) Reports page.
Resources & Remarks
Modification History Add a new line to this table and fill it whenever you edit the page.
Preview - Product Version 2021 Winter (as of November 12, 2021)yuuvis® client as reference implementationFollow-upAs of Release Candidate Alpa2, the Inbox, My processes and My Follow-ups views are extended and therefore the process model for a follow-up has been refactored as well. Models of previous versions are not supported anymore. Processes defined via deprecated models will appear without subject and attachments. Action: Delete all processes defined via deprecated models of previous versions either in the client application or directly via Web-API Gateway. Standard column and filter configurationsThe location for saving the standard column and filter configurations has been changed from the User Service to the Web-API Gateway Service. The reason is to use only one location for standard configurations. Action: In this case, such standard configurations were used you have to upload them again using the corresponding Web-API Gateway Service endpoint. If the configurations were changed by users with the role YUUVIS_MANAGE_SETTINGS you can download the current configuration using the export feature in the settings of the client. |
Each yuuvis® Momentum version update introduces changes in the system. In general, we try to deploy such changes in a non-breaking way. If this is not possible, you will find all necessary and vital information on this page. The following breaking changes are incompatible changes we had to deploy into operation, and therefore you—as a yuuvis® user—need to be aware of them and take action accordingly. An update to a new version that skips some of the previous versions is possible and does not require updating to each version in between. However, in this case, you must carry out all actions in the order in which they are listed below. Starting with your current version up to the version you want to update to.
The internal tokens (JWT) created by the AUTHENTICATION Service are now signed.
Actions:
com.os.services.core.security.EnableServiceSecurity
from the library services-security
, you need to update the library to version 5.7.0.com.nimbusds:nimbus-jose-jwt
for parsing of incoming JWTs, you have to use the class com.nimbusds.jwt.SignedJWT
instead of the class com.nimbusds.jwt.PlainJWT
.In role sets, permissions can now be set for the creation of objects by introducing the action create
. So far, the object creation was enabled together with the edit permission via the action write
. Additionally, the role YUUVIS_CREATE_OBJECT had to be assigned to users in order to enable object creation via API Gateway. As of now, this role does not affect the functionality of the API Gateway and is not part of the global default role set anymore.
>> Access Authorization and Permissions
Actions:
<action>create</action>
to each permission including a write
action that should allow for object creation further on. If the permission includes a condition, ensure that no CONTAINS statement is involved. Use the endpoints for managing permissions.Remove the following lines from section ### API-endpoints
in authorization.accessses
in the configuration file authentication-prod.yml:
- endpoints: /api/dms/objects method: POST access: hasAuthority('YUUVIS_CREATE_OBJECT') |
In previous versions, the endpoint POST /tenant-management/api/admin/users that is accessible with the role YUUVIS_TENANT_ADMIN allowed for the assignment of the role YUUVIS_SYSTEM_INTEGRATOR to other users. This is not possible anymore. Only the endpoint POST /tenant-management/api/system/tenants/{tenant}/users that is accessible with the role YUUVIS_SYSTEM_INTEGRATOR allows for the assignment of the role YUUVIS_SYSTEM_INTEGRATOR to other users.
The ContentPreviewComponent
provided by the framework library does not allow for printing anymore. Users have to download the binary content files and print them from their local drives.
The endpoint URLs have been changed to match the structure of other service-specific endpoint URLs. The new URLs are used by yuuvis® client as reference implementation and yuuvis® architect.
The endpoints are grouped consistent with the Web-API Gateway Swagger-UI. The changes are highlighted in bold letters in the new URL.
|
Action: If you are already referencing one of the following endpoints in your applications, please update the corresponding URLs. See also Update Instructions 2021 Summer.
Using a new Elasticsearch index structure for tables, single table cells can be accessed in search queries. Tables indexed for Elasticsearch with the former format are still accessible in the system, but not by means of single-cell search queries.
Action: If you have already been using table properties in your system, please reindex them by means of the COMMANDER service. The process can run in the background, the operation of the system does not have to be interrupted. Use the command dbs-reindex Command. The reindexing will also apply to every tag in the system.
The internal storage format in the Elasticsearch index was changed for tags, since they need to be stored in the new table format as well.
Action: If you have already been using tags in your system, please reindex them by means of the COMMANDER service. The process can run in the background, the operation of the system does not have to be interrupted. Use the command dbs-reindex Command. The reindexing will apply also to every queriable table property assigned to any stored object.
Tag names are now validated during a tag creation or update process. To pass the validation, they have to match the regular expression [a-z](:?[a-z][a-z0-9]*)* and must not be longer than 32 characters.
Action: Please check your used tag names and replace any used capital letter by a lowercase letter.
In order to allow for single-cell search in tables, table column names must not have a prefix in their property definition in the schema. The schema validation will no longer accept a schema containing table column names with prefixes.
Action: Please update all column names of table properties accordingly in your sources.
According to the new indexing of table properties, the endpoints for getting a schema definition provide table column names without any prefix. Especially if the table property is defined in a tenant schema or in an app schema, the table column names will also not have any prefix. Since the reference client uses the exact value of table columns for localization, form modeling and scripting, changes have to be adopted.
Action: Please remove the prefixes from table column names referenced in the localization, in forms and in scripts.
All of your document object type definitions used in the client must have a static reference (
static="true")
to the secondary object type appClientsystem:leadingType
. The type comes with a reference to appClientsystem:leadingTypeId
property and is defined in our newly delivered app schema Clientsystem
.
The property (field) is used to handle the transformation of a document object type during its lifecycle:
system:objectTypeId
.(static="false"
) at later point in time, their object type IDs are assigned as leading typeThe values are set for each update by the new sothook, which has to be installed and configured. It writes the current leading object type IDs into the property.
>> "Referencing the 'appClientsystem:leadingType' Object Type" | "Setting up Client-Specific Services"
In Keycloak, you have to assign the new 'YUUVIS_CREATE_OBJECT' role to all users who need to be able to create new objects.
>> "Access Authorization and Permissions"
The Search Service API supports rapid development of custom clients and is part of the API-WEB service. It is used by our reference implementation: yuuvis® client. The API has been changed and a query's result is now an array instead of an object.
>> "Search Service API"
The API comes with a personal, tenant-specific schema, which consists of unchangeable system properties, and the global schema. It determines the attributes and properties that objects must or may have. Our system properties have been renamed from "enaio" to "system".
Example: System properties enaio:objectId, enaio:createdBy and enaio:creationDate have been renamed to system:objectId, system:createdBy and system:creationDate.
Action: Please update all used system properties accordingly in your sources.
>> Schema
Your personal, tenant-specific schema consists of unchangeable system properties and the global schema. It determines the attributes and properties that objects must or may have.
You can retrieve your schema by sending a GET request to the URL /admin/schema ("Get the raw tenant schema" endpoint) and bring in your schema modifications update using
POST request to the URL /admin/schema ("Update the tenant schema" endpoint).
Note that the schema's version has been modified from 4.0 to 5.0.
<schema xmlns="http://optimal-systems.org/ns/dmscloud/schema/v5.0/" ...
Action: If you are going to update a schema, make sure that you use the new version number 5.0.
>> Admin Endpoints