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.comexternallink 20.

Version 4.26.0

Available now

Includes: DTR-7.14.3, AMC-2.7.4

New & noteworthy:

  • Digital Twin Registry:

    • OpenAPI specification download for Digital Twin Registry and Asset Administration Shell

    • Improved error message on Asset Administration Shell when there is no BPN provided

    • Bugfix for Bulk API patch operation to correctly add/remove the provided labels according to the list operator

  • Aspect Model Catalog:

    • Front-end implementation to generate OpenAPI of aspects

    • Upload of namespace packages with TTLs containing different SAMM versions

    • Bugfix to add the correct SAMM prefixes for TTL download

  • Bugfixes, infrastructure updates, library updates, and improvements

Version 4.25.0

Available from April 08, 2024

Includes: DTR-7.14.2, AMC-2.7.3

New & noteworthy:

  • Digital Twin Registry:

    • Performance optimization for accessing twins via twinType

    • Support AAS Discovery API to search for globalAssetId

    • Digital Twin Registry UI for AAS API to visualize shells and their basic information

  • Aspect Model Catalog:

    • Generation of the OpenAPI spec in the backend

    • Correction of the Aspect Model Catalog API description for supported features

    • Bugfix for containing question marks in Aspect Models

  • Bugfixes, infrastructure updates, library updates, and improvements

Version 4.24.0

Available from March 26, 2024

Includes: DTR-7.14.0, AMC-2.7.2

New & noteworthy:

  • Digital Twin Registry:

    • AAS performance optimizations for accessing Asset Administration Shell

    • Based on Catena-X requirements:

      • Combining the AAS Registry API base URL and AAS Discovery API base URL to one base URL

      • The minor version for the AAS Registry API and the AAS Discovery API is removed from the URL

  • Aspect Model Catalog:

    • Default sharing of Bosch Semantic Stack managed namespaces to all tenants

    • Upgrade of used ESMF SDK to version 2.6.0

    • Download of AASX format for Aspect Models in the Aspect Model Catalog UI

    • Paging support in the Aspect Model Catalog UI for showing namespaces with large amounts of objects

  • Bugfixes, infrastructure updates, library updates, and improvements

Version 4.23.0

Available from March 11, 2024

Includes: DTR-7.13.1, AMC-2.7.1

New & noteworthy:

  • Bugfixes, infrastructure updates, library updates, and improvements

  • Digital Twin Registry: Performance optimization for querying Asset Administration Shells via the AAS API

  • Aspect Model Catalog:

    • Backend supports the export of Aspect Models in AASX format

    • Backend operation elements support array of modelElementTypes for UI optimization

Version 4.22.0

Available from March 4, 2024

Includes: DTR-7.13.0, AMC-2.7.0

New & noteworthy:

  • Bugfixes, infrastructure updates, library updates, and improvements

  • Digital Twin Registry:

    • Final removal of AAS v1 API

    • Online documentation update for detailing AAS

  • Aspect Model Catalog:

    • Added link in the Aspect Model Catalog UI for getting generated JSON sample values of an Aspect Model

    • Bugfix for question marks in generated SVG for Aspect Models

    • Bugfix for getting all elements on namespace details

Version 4.21.0

Available from February 12, 2024

Includes: DTR-7.12.0, AMC-2.6.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 Digital Twin Registry 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, DTR-7.10.1

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.

Read more: Find Twins > Sorting

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.

Read more: Find Twins > Select

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, AMC-2.4.2

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, DTR-7.10.1

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 Twins to be certified by Catena-X.

The Digital Twin Registry is now certified by Catena-X

Read more: Your entrance ticket to the Catena-X data spaceexternallink 20

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.

Read more: Grant read access to business partners

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.

Read more: Digital Twin Registry Statistic APIexternallink 20

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 Twins

Get notified about what is going on in your Digital Twin Registry. You can now receive messages for changes to your Twins. Be informed when 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.

Read more: Send Notification Messages for state changes.

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.

Read more: Digital Twin Registry AAS API descriptionexternallink 20.

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

Out now: the Digital Twin Registry API v2externallink 20.

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.

Read more: Find Twins in the Digital Twin Registry > Paging.

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.

Read more: Semantic Aspect Meta Modelexternallink 20

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)externallink 20, 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.

Read more: Namespaces > The namespaces on 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.

Read more: Namespace state management.

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.

Read more: Namespace state management > Delete a 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.

Read more: Customize footer settings.

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 Twins

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

    • Typically, a 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 Twin can carry various aspects, pointing to the implemented aspect API which provides data for your Twin.

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

  • Add or delete aspect endpoints

  • Bundle your Twins in groups

    • With Digital Twin Groups, you can organize a set of Twins into one entity.

    • A Twin can be part of several Digital Twin Groups.

    • Easy operations or management for large sets of Twins.

    • Read more: Digital Twin Groups.

  • Work with templates

    • Aspect templates are an abstraction over aspects sharing common features among multiple 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