Getting Started
- Technische Redaktion
We have recently changed the URL structure of our developer documentation. Redirects for the most important pages are set up. However, we cannot guarantee that all your bookmarks will still find their intended destination. Please also refer to the search in the top bar or the navigation on the left-hand side to find what you are looking for.
We apologize for any inconvenience.
About this Documentation
The yuuvis® Momentum documentation has a functional structure based on the division into the core system and additional services as you can see in the navigation. If you are already familiar with the product, you can use the page tree to easily navigate directly to your topic.
Alternatively, the entry points provided below may help you to find topics of your interest.
We hope this growing portal serves you well and invite you to submit requests or suggestions to us.
Previous Versions
Jump to the corresponding documentation space.
Target Groups
Find here articles of your interest ...
Main Topics
An introduction into the system. Learn about the basic concepts of yuuvis® Momentum.
Schema - Defining Object Types
Detailing the available schema, object type definitions as well as property definitions.
Search Query Language
How to query in an SQL-like manner.
Access Authorization and Permissions
A yuuvis® Momentum user has to be authorized to the functionality of the system by assigning roles. For the individual roles, permissions can be set to allow actions on objects restricted by defined conditions where appropriate and the usage of specific endpoints can be controlled.
Basic Use Case Flows
Graphical overviews describing the interaction of the yuuvis® Momentum core services in exemplary basic use case flows.
Custom Client Build with Libraries
Documentation of the client core and framework libraries, as usable for custom client development.
About yuuvis® Momentum
API
An overview of all our public interfaces is provided.
Endpoints
Core
-
Page:DMS Endpoints — Manage DMS objects in yuuvis® Momentum or retrieve structural information for the tenant that are relevant for all its users.
-
Page:Admin Endpoints — These endpoints allow the administration of system properties for a tenant. They enable the tenant administrator to apply changes to the tenant-specific schema of available object types as well as to the rolesset carrying the permissions. Tenant is always the one the requesting administrative user belongs to.
Note: to use this API, you must be a tenant administrator. This means that you must have specific authorizations.
-
Page:System Endpoints — These endpoints allow the administration of the yuuvis® Momentum system. Global schemas and role sets are merged into each tenant's schema and role set, making the contained object types and roles available in each of them.
Note: To use this API, you must be a system administrator. This means that you must have specific authorizations.
-
Page:Rendition Endpoints — These endpoints provide document renditions in different formats.
Additional Services
-
Page:KAIROS-API Endpoints — The KAIROS-API endpoints for inference schema management.
-
Page:CATALOG Service Endpoints — The CATALOG service API provides CRUD (create, read, update, delete) operations on catalogs and catalog entries.
-
Page:PREDICT-API Endpoints — The PREDICT-API endpoints allow for the development of client applications with integrated AI functionality.
-
Page:BPM Engine Endpoints — These endpoints allow the management of workflow processes and tasks.
-
Page:Tenant Management Endpoints — These endpoints can be used to retrieve information from the identity provider. Role and user management for a tenant and to create and delete tenants in Keycloak.
-
Page:Web-API Gateway Endpoints — The higher-level API of the Web-API Gateway on top of the core, as it is useful for client application developers.
-
Page:User Settings Endpoints — The USERSERVICE API allows accessing and managing custom user information, settings and content.
Services
Find here a list of all yuuvis® Momentum services including core and periphery.
Overview of all yuuvis® Momentum Services
The requirement of high and thus horizontal scalability as well as high availability is currently best combatted by architectures comprising of distributable small services which can be run in more than one instance. Such architectures offer redundance and pinpoint scalability—leading, among other advantages, to the wild success of this architectural pattern. This article describes the services yuuvis® Momentum is made of.
Core Services
The services yuuvis® Momentum Core is made of.
yuuvis® Momentum fields a core consisting of a small zoo of cloud-native microservices, which allows for high availability and scalability. The entirety of the core's functions is made available through the API-gateway as core API. Two services—three if counting in the API-gateway— serve the microservice architecture itself: ADMIN allowing service administration like restarting a service or changing its intended amount of instances, and CONFIG, reading, caching and delivering configuration information to the other services.
Name | Function | Configuration profiles | Certificates | Standard ports | Scalable |
---|---|---|---|---|---|
Gateway | |||||
API | API-gateway | prod, redis, docker, kubernetes, metrics | no | 7450-7459 | yes |
Basic Core Services | |||||
AUTHENTICATION | user authentication, session management | prod, oauth2, docker, kubernetes, metrics | yes | 80 | no |
ORGANIZATION | mapping users to roles (the latter carrying the permissions) | prod, oauth2, keycloak, docker, kubernetes, metrics | yes | 7440-7449 | yes |
SYSTEM | schema management | prod, docker, redis, kubernetes, metrics | yes | 7400 | yes (as of 2020 Autumn) |
REPOSITORY | management of the binary storage | prod, storage, docker, kubernetes, redis, metrics | no | 7500-7509 | yes |
REGISTRY | management of object metadata in the relational database | prod, docker, jpapostgres, dbs, redis, kubernetes, metrics | no | 7510-7519 | yes |
INDEX | indexing in Elasticsearch | prod, es, docker, kubernetes, redis, metrics | no | 7291-7300 | yes |
SEARCH | processing of queries | prod, es, docker, kubernetes, metrics | no | 7221-7230 | yes |
AUDIT | object history, audit trail management | prod, jpapostgres, dbs, docker, kubernetes, metrics | no | 7251 | yes |
CONTENTANALYZER | synchronous full-text extraction and determination of the MIME type | prod, docker, kubernetes, metrics | no | 7430-7439 | yes |
Archive Services | |||||
ARCHIVE | connector for storage solutions | prod, docker, storage | no | 7530-7539 | yes |
Rendition Services | |||||
CONTROLLER | job messaging using third party RabbitMQ and more, used for asynchronous operations | prod, docker, es, oauth2, lc, mq, kubernetes | yes | 7332-7335 | yes |
TEXTEXTRACTOR | asynchronous full-text extraction | prod, docker, es, lc, mq, kubernetes | no | 7400-7429 | yes |
RENDITION | generation of renditions of submitted documents | no | 7341 | yes | |
Structural Services | |||||
ADMIN* ** | administration, monitoring, configuration | prod, docker, kubernetes | no | 7273 | yes |
CONFIGSERVICE | configuration server | prod, docker, native | no | 7281 | yes (with limitations) |
DISCOVERY** | service registration | prod, docker | no | 7261 | no |
Rollback Administration | |||||
COMMANDER* | command tool for rollbacks | prod, dbs, es | no | 7412 | no |
* service of special interest for DevOps | ** obsolete when using Kubernetes
Additional Services
Services for functional extension as upper layers on top of the yuuvis® Momentum core system.
The client services offer, in accordance with the layered onion approach, both additional functionality as well as higher-level API functions valuable to client applications. Next to the user and the viewer services, the web-api gateway service is the main service for the client development.
>> Client Development
Name | Function | Configuration profiles | Certificates | Standard ports | Scalable |
---|---|---|---|---|---|
Client Services | |||||
API-WEB | web-api gateway, bundling of higher-level functions in one client API, adds more features like custom forms, localization, and object type icons to the system. | prod | no | 7550 | yes |
CLIENT | reference client based on core and framework libraries that can be used for custom client development | prod | no | 80 | yes |
ARCHITECT (as of 2020 Winter) | supports custom form modeling including form scripts, localization of technical names, and user management (will be moved to another application later this year). | prod | no | 80 | yes |
VIEWER | offers client-side viewing capability for certain file types | prod | no | 80 | yes |
USERSERVICE | stores user settings and caches user information | - | no | 8080 | yes |
SOTHOOK | fills the property appClientsystem:leadingTypeId | prod | no | 10779 | yes |
Tenant Management | |||||
TENANT-MANAGEMENT | tenant management API with endpoints for maintaining tenants and their users | prod, oauth2 | no | 8080 | yes |
MANAGEMENT-CONSOLE | management console API as backend service for maintaining organizations that maintain tenants. | - | no | 7560 | yes |
MANAGEMENT-CONSOLE-CLIENT | Web-client with a graphical user interface for the management console API. | - | no | 80 | yes |
METRICS | provides tenant specific metrics. The tenant management API offers exposed endpoints of this service. | - | no | 8080 | yes |
Business Process Management (BPM) | |||||
BPM-ENGINE | Flowable-based BPM engine | - | no | 8080 | yes |
BPM-ADMIN-UI | admin user interface for the BPM engine | - | no | 8080 | no |
Auto ML Platform (beta version - not yet included in installations) | |||||
KAIROS-API Service | - | ||||
ML Training Pipeline | - | ||||
PREDICT-API Service | - |
As of version 2021 Autumn, the status of each individual service can be checked by calling the health check endpoint https://<host>/<service>
/manage/health
as described for the core services.
>> Health Check for Services
Specific Terms
Learn about the terminology used to describe the features of yuuvis® Momentum.
Glossary
› open...
Current Development
Find here the most recent information on our current development.
Release Information
› open...
Recently Changed Articles
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page: