Release notes

What’s new at Bosch Semantic Stack? Browse the release notes.

For general updates on solutions built with Bosch Semantic Stack tools, visit www.bosch-semantic-stack.com.

Version 4.21.0

Available now

Includes: DTR-7.12.0, AMC-2.6.0, SES-1.1.0

New & noteworthy:

  • Integration of the OpenAPI Generator for generating client libraries. The REST API itself is unchanged. Users of the generated client libraries need to adapt.

  • UI Framework update

  • Bugfixes, infrastructure updates, library updates and improvements

  • Digital Twin Registry: Final removal of Registry REST API V1 and generated classes in the client libraries

  • Aspect Model Catalog: Performance optimization for searching namespaces

Version 4.20.0

Available from January 29, 2024

Includes: DTR-7.11.0, AMC-2.5.0

New & noteworthy:

  • Introduction of circuit breaker pattern to protect infrastructure

  • Migration to new GitHub organization

  • Bugfixes, infrastructure updates, and improvements

  • Aspect Model Catalog: Update of search functionality for Aspect Models and namespaces to filter for the criteria "state" and "latest"

2023.R3 (DTR)

Digital Twin Registry

Includes: DTR-7.6.1, DTR-7.7.0, DTR-7.8.0, DTR-7.8.1, DTR-7.8.2, DTR-7.8.3, DTR-7.8.4, DTR-7.9.0, DTR-7.10.0

At a glance:

Sort twins according to your sorting criteria in the API response

Receive the retrieved results in the order you prefer by sorting them.

Select only relevant attributes to be returned in the API response

To optimize your queries, select the attributes that you really want to have in the response and leave out all other fields.

Empty POST requests get through

Empty POST requests sent to the Digital Twin Registry are accepted as valid requests.

Error messages also get displayed in the UI

All error messages are displayed correctly and completely in the Digital Twin Registry UI.

Rate limiting implemented

To protect our infrastructure, rate limiting is now active, which prevents unlimited requests from leading to an overload.

Legacy domains not supported anymore

After an extensive transition phase, legacy domains for Bosch Semantic Stack services and documentation are not supported anymore.

2023.R3 (AMC)

Aspect Model Catalog

Includes: AMC-2.3.6, AMC-2.3.7, AMC-2.3.8, AMC-2.3.9, AMC-2.3.10, AMC-2.3.11, AMC-2.4.0, AMC-2.4.1

At a glance:

Share namespaces and Aspect Models across tenants

To foster collaboration, namespaces and Aspect Models can now be shared across tenants. If a namespace has been shared with you, you will see not only your own but also the Aspect Models that have been shared with you.

View all Aspect Model versions bundled in aggregated lists

All versions of an Aspect Model now get displayed together, in an aggregated list. The latest version can be seen at the top, all other versions are bundled below.

Improved display of error messages

Error messages now get displayed as individual paragraphs to make them easily distinguishable.

2023.R3 (AAS)

Digital Twin Registry (AAS)

Includes: DTR-7.6.1, DTR-7.7.0, DTR-7.8.0, DTR-7.8.1, DTR-7.8.2, DTR-7.8.3, DTR-7.8.4, DTR-7.9.0, DTR-7.10.0

At a glance:

Catena-X certified

We are delighted to announce that the Digital Twin Registry by Bosch Semantic Stack is the first registry for digital twins to be certified by Catena-X.

The Digital Twin Registry is now certified by Catena-X

Grant read access to selected shells

As a data provider, let your business partners access the data they need by enabling them to read a selection of your Asset Administration Shells.

Add labels to shells

Categorize Asset Administration Shells according to your needs by adding up to 10 labels to a shell.

Read more: Shell labels

Bundle shells into shell groups

Make handling large sets of Asset Administration Shells easier by bundling them into groups.

Read more: Shell groups

Request the amount of shells on your tenant

With the tenant statistics service, you can now also track the amount of Asset Administration Shells registered on your tenant.

2023.R2 (DTR)

Digital Twin Registry

Includes: DTR-7.4.0, DTR-7.5.0, DTR-7.5.1, DTR-7.5.3, DTR-7.6.0

At a glance:

Receive notification messages for changes on your digital twins

Get notified about what is going on in your Digital Twin Registry. You can now receive messages for changes to your digital twins. Be informed when digital twins or aspects have been created, retrieved, updated, or deleted.

  • Look up the notifications via your web browser — directly in the Digital Twin Registry web app.

  • Consume the Kafka notification messages, for example, by a Spring Boot consumer.

To enable this feature for your tenant, send an email to support.semantic-stack@bosch.com.

Give write access only to selected users of your Asset Administration Shells

Distinguish between users who can only retrieve your Asset Administration Shells and users who can create, update, or delete shells. You can now selectively grant read or write access to your users by assigning one of the dedicated roles:

  • AAS Viewer for read access

  • AAS Manager for write access

Keep local identifiers confidential through Business Partner Numbers (BPN)

You can now provide your business partners with individual Business Partner Numbers (BPN).

With such a BPN being a mandatory part of API calls to the Digital Twin Registry, your business partners will not see any of the local identifiers of your assets when consuming your assets' data. This way, you can ensure that third parties get the data they need while you will not reveal internal IDs, for example, part numbers, to your business partners.

New API version with increased performance due to cursor-based paging

We have improved the performance of the Digital Twin Registry API by moving to cursor-based paging. This enables the Digital Twin Registry API to efficiently serve data even for very large data sets.

Breaking change announcement: The Digital Twin Registry API v1 will be deprecated by September 30, 2023. Please migrate your API calls to Digital Twin Registry API v2 in a timely manner.

SAMM Aspect Models supported

The Digital Twin Registry now also accepts SAMM Aspect Models.

Currently, you can work with both BAMM and SAMM Aspect Models. This is due to the transition of the open-source specification for Aspect Models — from BAMM Aspect Meta Model to the Semantic Aspect Meta Model (SAMM), with a new home at the Eclipse Semantic Modeling Framework.

Breaking change announcement: The Digital Twin Registry will only support SAMM Aspect Models by September 30, 2023. Please migrate any legacy BAMM Aspect Models to SAMM Aspect Models in a timely manner.

2023.R2 (AMC)

Aspect Model Catalog

Includes: AMC-2.2.0, AMC-2.3.0, AMC-2.3.1, AMC-2.3.4, AMC-2.3.5

At a glance:

Use SAMM Aspect Models

Following the recent release of the Semantic Aspect Meta Model (SAMM), you can now work with Aspect Models based on SAMM.

Legacy Aspect Models based on the BAMM Aspect Meta Model are not supported anymore by the Aspect Model Catalog.

View the available namespaces for your tenant

You can now look up the namespaces that have been activated for your tenant.

Manage the release state of your namespaces

Completing the namespace management feature, you can now transition your namespaces from draft, to released, to deprecated.

Note that your Aspect Models — as they are organized under namespaces — get the same release state as the namespace they belong to.

Delete DRAFT namespaces

A namespace that is still in the DRAFT release state can now be deleted from the Aspect Model Catalog.

Note that RELEASED namespaces can only be DEPRECATED but not deleted. This helps to prevent breaking changes for users who employ Aspect Models of an already RELEASED namespace.

2023.R2 (DTR + AMC)

At a glance:

When using the Digital Twin Registry to expose data for your business partners, you want your organization’s legal notice, data protection notice, etc., to be provided. The same is true when working together on Aspect Models with the Aspect Model Catalog.

You can now add your organization’s legal texts to the Digital Twin Registry and the Aspect Model Catalog. Your legal information gets displayed in the footer area of the graphical user interface in the web applications.

2023.R1 (DTR)

Digital Twin Registry

Includes: DTR-7.1.1, DTR-7.2.0, DTR-7.3.1

  • Infrastructure updates

  • Performance optimization

  • Maintenance

  • Bug fixing

2023.R1 (AMC)

Now generally available for Bosch Semantic Stack — the Aspect Model Catalog!

Aspect Model Catalog

AMC-2.1.0

Feature overview:

  • Publish Aspect Models

    • Upload Aspect Model packages (i.e., zip files containing one or more Aspect Models) to your tenant.

    • Other users on your tenant can now access your Aspect Models.

  • Find Aspect Models

    • Search for available Aspect Models on your tenant by Aspect Model name or by namespace.

      • Reuse Aspect Model elements in further Aspect Models.

      • Use the Aspect Model as a basis for the aspect API implementation of your software solution.

  • Set a release state for Aspect Models and namespaces

    • Available release states:

      • RELEASED

      • DRAFT

      • DEPRECATED

    • By setting an Aspect Model or namespace to RELEASED, you can prevent further changes and also indicate to other users on your tenant that there will be no further changes to the corresponding version of the Aspect Model or namespace.

  • Download Aspect Models

    • Download options include:

      • A single TTL file

      • Generated HTML documentation

      • JSON schema

      • The complete namespace with all its Aspect Models

  • API or web application — your decision

    • Use the Aspect Model Catalog through the web application which offers a graphical user interface, or use the API.

  • Documentation

2022

Now generally available — Bosch Semantic Stack with the Digital Twin Registry!

Digital Twin Registry

DTR-7.1.0

Feature overview:

  • Manage digital twins

    • Register, merge, delete, and look up digital twins for your assets.

    • Typically, a digital twin represents your assets, for example, machines, vehicles, or generally any product instances or product types.

  • Manage local identifiers

    • Add local identifiers to your twins.

    • By that, each twin can be found by searching for such local identifiers like vehicle identification numbers (VIN) or serial numbers etc.

  • Manage aspects

    • Each digital twin can carry various aspects, pointing to the implemented aspect API which provides data for your digital twin.

    • By adding aspects iteratively, you can start small while your digital twins can grow and provide more and more data over time.

  • Add or delete aspect endpoints

  • Bundle your digital twins in groups

    • With digital twin groups, you can organize a set of digital twins into one entity.

    • A digital twin can be part of several digital twin groups.

    • Easy operations or management for large sets of digital twins.

    • Read more: Digital twin groups.

  • Work with templates

    • Aspect templates are an abstraction over aspects sharing common features among multiple digital twins.

    • Instances of aspect templates are called virtual aspects.

    • With endpoint templates, virtual aspects are rendered at runtime as if they were concrete aspects.

    • Aspect templates are created in association with digital twin groups.

    • Read more: Aspect templates.

  • Documentation