Developer
Technische Redaktion
Topics related to the usage of our interfaces.
API
Find here an overview of all available interfaces.
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' Endpoints
-
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.
Backend
Learn about the concepts of using yuuvis® Momentum backend or jump directly into the coding guided by our example tutorials.
Core Concepts
Documentation for yuuvis® Momentum Core in a structured, theoretical way, with links to the tutorial section.
Authentication against the Core API
This article details the authentication methods compatible with the yuuvis® Core API and how to choose the correct one for your use case.
Schema - Defining Object Types
Detailing the available schema, object type definitions as well as property definitions.
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.
Search Query Language
How to query in an SQL-like manner.
Object Representation Formats
A description of the structure in which yuuvis® Momentum expects objects to be formatted and returns objects.
Database Schema
The described database tables are used to manage the metadata of objects.
Binary Content Files
Binary content files can be imported and assigned to document objects in yuuvis® Momentum. Archiving can be managed and renditions can be retrieved.
Document Lifecycle Management (DLM)
This article gives information on tagging and schema flow functionality (secondary object types) in the context of a document's lifecycle.
Document Retention
A retention can be used to ensure that a document object is not deleted and the binary content file assigned it is not deleted or changed.
Apps
Management of apps that are based on yuuvis® Momentum via schema, permissions, system hook configuration and availability configurations.
Error Handling
Structure and identification codes of errors that can be thrown during different processes.
System Hooks
Define additional actions triggered by specified events, extend the functionality of yuuvis® Momentum API.
Interceptors
Intervening a running process at a certain position and redirecting the process flow in order to include project-specific processing steps.
Core Example Tutorials
Follow the tutorials that guide you through the document management with yuuvis® Momentum by means of code examples.
Login to the Core API (Java)
This tutorial will give you a brief overview of the most important login procedures for the yuuvis® API system and how to use them in a Java Client application
Importing Documents via Core API
This tutorial shows how documents can be imported into a yuuvis® API system via the Core API. During this tutorial, a short Java application will be developed that implements the HTTP requests for importing documents. We additionally provide a JavaScript version of this tutorial.Retrieving Documents via Core API
In this tutorial, we will discuss various ways to retrieve objects via the Core API from the yuuvis® API system using an OkHttp3 Java client.Updating Documents via Core API
This tutorial demonstrates how to update documents in yuuvis® API with the Core API. The following example will result in a short Java application that implements the HTTP requests for updating a document.Deleting Documents via Core API
This tutorial explains how documents can be deleted using the Core API with the help of a Java client. This tutorial requires basic knowledge of importing documents using the Core API.Retrieving Document History Entries
This tutorial shows how we can use a Java application to make a request to the Core API of the yuuvis® API system to retrieve the history entries of a DMS document. In addition, it briefly describes which history entries are generated for a document.Compound Documents
Concatenate multiple binary content files as byte arrays in one compound document. Create sub-documents that refer to specified ranges within the total byte array.
Managing the Schema
This tutorial shows how to use the Core API to get the tenant-specific schema of the system, how to validate a schema, and how to bring in a new schema.Changing Schema Structures ("Schema Flow")
This tutorial shows how to change your basic schema for individual instances of an object type during the entire lifecycle of a document. Classify objects at a later point in time, add or remove property groups at runtime by defining and referencing "floating" secondary object types.
Tagging Objects for Processing
Based on tags, you set up complex stateful processing chains. This tutorial describes how tags can be added, displayed, and updated in an example context. For this purpose, a typical application will be discussed: An import management system, which is an example for a processing chain, where tags are a helpful tool to describe the current status of each object.
Setting and Querying Structured Data
This example tutorial provides explanations and code examples to get an idea on how to define and specify structured data properties and on how to query them.
Overwriting the 'required' Property Attribute
This tutorial shows how to reference the same property definition in different object type definitions, in some of them as a required property and in others as a non-required property.
Preprocessing Metadata using Webhooks
An example Webhook consumer service set up using Java and Spring Boot.
Interceptor Example Tutorial
Learn how to set up a Microservice that can fill the role of an interceptor of any of the available interceptor types. Java code examples of such microservices can also be found here.
Importing Documents (JavaScript)
This tutorial shows how documents can be imported into a yuuvis® API system via the Core API. This tutorial is an extension of the Java import tutorial, applying its concepts to a different popular programming language, JavaScript.
Additional Services
Services for functional extension as upper layers on top of the yuuvis® Momentum core system.
Client Development
Learn how to build an own client application by means of developer libraries or modify our yuuvis® Momentum client as reference implementation according to your business use case. Alternatively, you could also build an independent solution using our yuuvis® styles.
Client Services
Services for building a client for yuuvis® Momentum.
Tenant Management
Services for tenant and user management via API.
Business Process Management (BPM)
Services for Business Process Management.
Artificial Intelligence Platform
Enables yuuvis® Momentum users to automatically classify documents and extract metadata from documents using machine learning models trained on their own data, both on-premises and in the cloud.
CATALOG Service
The service provides the usage of catalogs defined as document object types in a tenant schema.
SAP Integration
Combine yuuvis® Momentum with SAP.
Frontend
-
Page:yuuvis® styles —
If you are creating a new application intended to handle specific data of the yuuvis® backends and you only need the CSS files, you can use the npm package: https://www.npmjs.com/package/@yuuvis/styles.
Shortly, we will publish a website that shows all styles used as an example application on https://yuuvis-cc.yuuvis.org/
-
Page:Custom Client Build with Libraries —
Documentation of the client core and framework libraries, as usable for custom client development.
-
Page:Form Scripting (Client-side) —
If you configure custom forms for objects, you can additionally use executable scripts to, e.g., validate data, change data, change field properties - such as "read-only" or "mandatory" - and show context-related messages. Form-related scripts enhance your options by adding further functionalities to support your use cases and processes the best.
-
Page:Client Scripting API —
This article describes the Client Scripting API used to develop custom clients as well as client-side form scripts. For more information on building custom clients, refer to the client API documentation.