Gemsstock Sprint 5: First Theia Prototype

Louis Müller

Below you can find the demo content of our Gemsstock Sprint 5 review. In summary, you can expect the following topics:

Internal discussions and issue references can be found on Confluence: Sprint 5: Demo

Reguël Wermelinger

Combine Data Class attribute refactoring

Faster process data restructuring is available again, as on LTS 8.

Audience
Process Developers, Pre-sales

Value

Design a big master DataClass that flows through processes
Identify and extract specific DataClasses as the process evolves
Fast and automated refactoring, rather than error prone manual changes
Yet we change automatically:
- the Data-/Entity-Class hierarchy
- usages in XHTML views
- usages in plain Java code

Version

11.1.0
10.0.4

Discussion

Do you apply other frequent refactorings manually? Any wishes to go further? E.g. automated DataClass attribute rename refactorings wished?

Next steps

Adjust usages in Processes/IvyScript too

Screenshots / Code
https://dev.axonivy.com/doc/10.0/designer-guide/data-modeling/data-classes.html#attribute-refactoring

Alexander Suter

Standardize REST Client Communication

To communicate with REST Services, we use the Jersey technology, which is based on the Java standard javax.ws.rs. There are three places, where we need to communicate with REST Services:

REST Clients, as part of your Axon Ivy Projects
Elasticsearch as Fulltext Search Engine
Azure Active Directory as Identity Provider

All three features, will behave exactly the same, when it comes to REST Client communication. Everywhere we have a async-transport backed by a connection pool, read- and connect timeouts by default 👍.

Which means, we have fixed potential resource leaks within the Azure AD Identity Provider:

open connections in cases of errors
speed up the performance by caching the client
read- and connect timeouts.

Furthermore: We trace the request body and response body for all these features and upcoming new features!

Audience: Axon Ivy Engine Operators
Value: Stability
Version 11.1.0, 10.0.4

Screenshots / Code

Trace Rest Client Request and Reponse

Tracing Elasticsearch Request and Response

Tracing Azure Identity Provider Request and Response

Sensitive requests won't be traced (use request property SensitiveData)

Alexander Suter

Workflow Statistic REST API 📊

We want to provide statistical data over workflow data and provide them in Axon Ivy Portal as charts 📈. We decided to index the workflow data in Elasticsearch and provide aggregations via a REST Endpoint.

Buckets & Metrics
We are now in the world buckets & metrics. You can group your data for example by state and you get for each state a bucket with the count of tasks for this bucket. You can make sub-aggregations. Which means you can group by startTimeStamp and then by state. Then you will get buckets in buckets.

We also provide metrics like SUM, AVG, MIN and MAX. You can make a single metric aggregation e.g. customfield.string.lending:max or you can combine it with buckets.

REST Endpoints

/{app}/api/workflow/tasks/stats

You can now run bucket and metric aggregations:

/{app}/api/workflow/tasks/stats?agg=startTimeStamp,state

/{app}/api/workflow/tasks/stats?agg=startTimeStamp:max

The pattern is:

?agg={field}:{operation}:{payload},{field2}:{operation2}:{payload2},{fieldX}:{operationX}:{payloadX}

~~Mobile~~ Workflow API
I've started to renovate the existing mobile workflow API endpoint. We no longer use the term mobile there and see it more as general endpoint provided by Axon Ivy.

https://developer.axonivy.com/api-browser?configUrl=https://developer.axonivy.com/doc/11.1/openapi/config.json&urls.primaryName=workflow#/

Let's evolve the existing workflow APIs and make it even better.

Audience: Workflow Admins
Value: Workflow Overview
Version: 11.1.0

Discussion

Any concerns?

Next steps

Improve REST endpoint capability in general
Enrich REST API with more task properties
Add a case stats endpoint

Screenshots / Code
By calling this URL:

You can make charts like that:

Lukas Lieb

Next-Gen Inscription Updates

Bring the new MappingTree to the next level 🚀

View and modify mapping data
Tree utilities (search, filter,...)
IvyScript support in expression input
Show unknown mappings

Many technical backend refactorings 🛠

Audience: Process Developers, Pre-sales
Version: 11.1.0
Discussion: Any feedback?

Screenshots / Code

Tobias Gretler

Database Demo in Axon Ivy Market

There is a new database demo in Axon Ivy Market available 🦔:
https://market.axonivy.com/db-demos

Axon Ivy's database demo shows how to create, read, update and delete data from database tables. With the help of database activities, you can integrate existing databases perfectly.

Audience

Axon Ivy Process Developers

Value

Documentation how integrate databases

Version

10.0

Discussion

Do you like it?

Next steps

We would like to make a demo for JPA (Java Persistence API)

Screenshots / Code