Changelog

Release version 0.5.0

New Features & Major Changes

Improved exception handling in CLI - upon error starter application should now correctly terminate with error code 1
OPC UA Endpoint
- Additional parameters available in configuration
Docker container now runs using a non-root user
Base persistence configuration updated
- changed initialModel from filename to AASEnvironment object
- added initialModelFile
- removed decoupleEnvironment property. To achieve previous behavior you need to manually decouple the model by making a deep copy, e.g. via DeepCopyHelper.deepCopy(...)
Asset Connection
- OPC UA
  - Support mapping to specific element in (multi-dimensional) array/vector
  - Additional parameters available in configuration: requestTimeout, acknowledgeTimeout, retries, securityPolicy, securityMode, securityBaseDir, transportProfile, userTokenType, applicationCertificateFile, applicationCertificatePassword, authenticationCertificateFile, authenticationCertificatePassword

Internal changes & bugfixes

General
- Improved startup process & console ouput
HTTP Endpoint
- DELETE requests now correctly return HTTP status code 204 No Content. The following URL patterns are affected:
  - /submodels/{submodelIdentifier}
  - /submodels/{submodelIdentifier}/submodel/submodel-elements/{idShortPath}
  - /shells/{aasIdentifier}/aas/submodels/{submodelIdentifier}/submodel/submodel-elements/{idShortPath}
- Using not allowed HTTP methods not correctly returns 405 Method Not Allowed instead of 500 Internal Server Error
- Unsupported URLS (valid URLs with additional path elements) now correctly return 400 Bad Request instead of 405 Method not allowed
- GET /shells/{aasIdentifier} now correctly returns status code 404 Not Found when called with an existing ID that is not an AAS (instead of 500 Internal Server Error)
OPC UA Endpoint
- Major code refactoring
Persistence
- Major code refactoring
Asset Connection
- Fixed endless feedback loop when adding a subscription provider and value provider to the same element
- OPC UA
  - fixed deserialization error when using operation provider with argument mappings
- HTTP
  - subscription provider now only fires when then value has changed (before that it fired with any read)
Miscellaneous
- Now using dockerfile to build docker container instead of jib maven plugin

New Features

Improved logging (new CLI arguments -q, -v, -vv, -vvv, --loglevel-faaast, --loglevel-external)

Internal changes & bugfixes

Asset Connection
- OPC UA
  - Fixed problem converting DateTime values
Fixed error related to JSONPath expressions that could occure in asset connections when using certain JSONPath expressions
Fixed error in reference helper with setting proper type of key elements when an identifiable and a independant referable have the same idshort
Removed dependencies on checks module which is only needed for codestyle check while compiling and therefore not released on maven. This caused a missing dependency exception when using any FA³ST module within your code.

New Features

Internal changes & bugfixes

Dynamic loading of custom implementations (AssetConnection, Persistence, MessageBus, Endpoint and Dataformat) now works as expected. NOTE: This requires package your custom implementation as a fat jar and put it in the same location as the FA³ST starter jar.
Streamlining dependencies
Improved console output for file paths
Added checks to ensure model paths provided are valid
Asset Connection
- OPC UA
  - Fix problem when InputArguments or OutputArguments node was not present for Operations
  - Use ExpandedNodeId to parse NodeId Strings
- HTTP
  - Fixed problem when using HttpAssetConnection configuration
Development
- Enforce JavaDoc present at compile-time (through checkstyle)
- No longer release test module
- Create javadoc jar for parent POM

Bugfixes

New Features

Persistence
- File-based persistence added
- Each persistence implementation can now be configured to use a given AAS model as initial value
Asset Connection
- HTTP asset connection added
- Basic authentication (username & password) added for OPC UA, MQTT and HTTP
- Introducing protocol-agnostic library for handling different payload formats including extracting relevant information from received messages as well as template-based formatting of outgoing messages (currently only implemented for JSON)
HTTP Endpoint
- API
  - Submodel Interface calls now also available in combination with Asset Administration Shell Interface, e.g. /shells/{aasIdentifier}/aas/submodels/{submodelIdentifier}/submodel
  - Asset Administration Shell Serialization Interface now supported (at /serialization)
- Support for output modifier content=path
- CORS support, can be enabled by setting isCorsEnabled=true in config (default: false)
- now returns status code 405 Method Not Allowed if URL is correct but requested method is not supported
Support for valueType=DateTime
Support for Java 16
Improved robustness (e.g. against common invalid user input or network issues)
Improved console output (less verbose, always displays version info)
Improved documentation

Internal changes & smaller bugfixes

Validation now checks for unsupported datatypes
Version info correctly displayed when started as docker container or via local build/debug
Fixed potential crash when initializing value with empty string althtough that is not a valid value according to the value type, e.g. int, double, etc. (empty string value is treated the same as null)
Asset Connection
- Fixed error when using operation provider
- OPC UA
  - subscription provider now syncs value upon initial connect instead of waiting for first value change on server
- MQTT
  - print warning upon connection loss
  - properly handle invalid messages without crashing
Added strict enforcement of valid output modifiers for each API call
Dynamically allocate ports in unit tests
Add builder classes for event messages & config classes
Replace AASEnvironmentHelper with methods of EnvironmentSerialization

First release!