Change Log
Changelog
Section titled “Changelog”The following contains a record of all notable changes made to the PowerTSM suite of products, sorted by their version number starting with the most recently released one.
This project adheres to Semantic Versioning.
4.13.0 - 2026-10-13
Section titled “4.13.0 - 2026-10-13”This release lets time series searches and single time series requests include attributes, list attribute units and list attribute value descriptions, adds a changedSince filter and bulk loading of time series, and fixes bulk requests, custom functions on Linux and vulnerable OS packages in the Docker image.
- New
includequery parameter onGET /repositories/{repository}/timeSeriesto return the assigned attributes, their list attribute units and the used list attribute values with their descriptions. (TSM-8970) - New
includequery parameter onGET /repositories/{repository}/timeSeries/{timeSeries}with the same values as the time series search. (TSM-8952) - List attribute values of assignments without a unit are resolved in the attribute’s only or default list attribute unit, like in the PowerTSM App. (TSM-9012)
- New
include=valuesquery parameter onGET /repositories/{repository}/lists/unitsto return the values of every list attribute unit. (TSM-8980) - New
changedSincefilter onGET /repositories/{repository}/timeSeriesandGET /repositories/{repository}/calculations/aggregation, and in the .NET API’s time series search parameters. (TSM-8959) - Dedicated bulk handler for
GET /repositories/{repository}/timeSeries/{timeSeries}that loads the items of a bulk request together instead of one request per item. (TSM-8982) - New
ITimeSeriesStore.Find/TryFindandLoad/TryLoadoverloads taking aTimeSeriesResultContentto load attributes, list attribute units and used list attribute values. (TSM-8962, TSM-8965) - New
ITimeSeriesStore.LoadBulk/TryLoadBulkmethods to load many time series by name or ID in one call. Custom implementations ofITimeSeriesStoreshould override them, as their default implementations load the time series one after the other. (TSM-8953)
Changed
Section titled “Changed”- Custom implementations of
ITimeSeriesStorehave to override the newTimeSeriesResultContentoverloads ofTryFindandTryLoad, whose default implementations fail with HK09002 for any content with units or value descriptions. Please note that this may require changes be made to custom implementations! (TSM-8962, TSM-8965) - Custom implementations of
IListAttributeUnitReferenceFactory<TIdentifier>have to implement the newTryCreateoverload taking the unit’s values. Please note that this may require changes be made to custom implementations! (TSM-8980) GET /repositories/{repository}/lists/unitsnow returns the units ordered by id, andGET /repositories/{repository}/lists/units/{unit}/valuesreturns the values ordered by sort order and id. (TSM-8980)- Items of a bulk request for
GET /repositories/{repository}/timeSeries/{timeSeries}with an invalidincludevalue, an unparsableid:or an unsupported query parameter now fail with HK01014 instead of HK09006, HK09007 or HK09008. (TSM-8982) - Time series results with attributes no longer carry a list attribute unit for attributes that are not of type List, even if their assignment stores one. (TSM-9012)
Deprecated
Section titled “Deprecated”- The
includeAttributesquery parameter ofGET /repositories/{repository}/timeSeriesis deprecated in favour ofinclude. It remains in every 4.13+ and 5.x release and will be removed in a major release, 6.0 at the earliest. (TSM-8970) ITimeSeriesStore.Find/TryFindoverloads takingincludeAttributesare deprecated. They remain in every 4.13+ and 5.x release and will be removed in a major release, 6.0 at the earliest. (TSM-8962)
- Custom functions provided as
.csxfiles now compile on Linux hosts, e.g. in Docker containers. (TSM-8862) - Bulk requests targeting an endpoint that is served differently depending on the API version no longer fail for every item. (TSM-8938)
- Items of a bulk request without a dedicated bulk handler now respect serialization parameters such as
casing,timeFormatornumberFormatin the bulk request’sAcceptheader. (TSM-8947) IAttributeDataStoreno longer deletes the attribute data already stored when it rejects a single list attribute value or node. (TSM-8959)
Security
Section titled “Security”- HTTP API Docker images are now built on the latest version of their .NET base image and install the available Debian security updates, fixing known vulnerabilities in OS packages such as PCRE2. (TSM-8928)
4.12.3 - 2026-09-18
Section titled “4.12.3 - 2026-09-18”This patch release keeps database connections from being held back from the connection pool when a data read is abandoned early, and fixes a data loss when writing to a compressed time series across a block that held no data yet.
Changed
Section titled “Changed”- Collections obtained via
ITimeSeriesDataCollection<T>.Memoized()now replay an error of the underlying read instead of silently ending the series, re-read the data when every enumerator was disposed before the read completed, and throw anObjectDisposedExceptionwhen a disposed enumerator is advanced. (TSM-8716) - Custom storage providers: a failure while creating the database command is now reported through the result yielded by
TrySelectinstead of being thrown out of the enumeration, and the newReleaseConnectionQuietlymethod releases a connection without surfacing a failure of that release. (TSM-8716)
- Database connections are now returned to the pool when the enumeration of a data read is aborted, instead of being reclaimed only by the garbage collector. (TSM-8716)
- Writing to a compressed time series without preserved historic data no longer loses stored data points when the write begins in a block that held no data yet and reaches into an already populated block. (TSM-8899)
4.12.2 - 2026-09-09
Section titled “4.12.2 - 2026-09-09”This patch release brings the database fixes released for PowerTSM 3.11.3.1 and 3.11.3.2 to databases that are already on 4.x, and makes formula evaluation await the asynchronous setup work of custom functions.
Changed
Section titled “Changed”- On SQL Server, a database error while saving attribute values using the 3.x stored procedures inside a transaction opened by the caller now aborts that entire transaction instead of failing only the individual statement. (TSM-8872)
InitializeandPerformBeforeCalculationof custom functions are now awaited before formula evaluation, so genuinely asynchronous setup work completes beforeEvaluateruns. (TSM-7716)- Database patch 4.12.2 brings the PowerTSM 3.11.3.1 and 3.11.3.2 fixes to 4.x databases: bulk quotation deletion no longer swallows database errors or stops early, saving attribute values from several connections on SQL Server no longer deadlocks, deleting a time series no longer locks the entire time series table, and the last spontaneous value of a versioned time series is now read from the versioned audit table. (TSM-8872)
4.12.1 - 2026-07-30
Section titled “4.12.1 - 2026-07-30”This patch release restores the bulk request endpoint, which was unusable in the 4.12.0 release, and extends it to accept free-form placeholders and values written directly into the endpoint. It also aligns sub-interval data aggregation with PowerTSM 3.x and includes fixes for SQL Server installation and XML documentation, plus a security dependency update.
Changed
Section titled “Changed”- Writing data points spaced closer together than the time series’ interval now aggregates them using time-weighted-average, consistent with PowerTSM 3.x. (TSM-7510)
- SQL Server no longer warns about the maximum clustered index key length when installing the database scripts. (TSM-8646)
- XML documentation delivered alongside the .NET API assemblies is complete again for generic
Resultand paging members. (TSM-8667) - Bulk
endpointtemplates now accept free-form placeholder names, as well as query parameters and path segments written directly into the endpoint. (TSM-8671, TSM-8674, TSM-8676) - Bulk requests were unusable in the 4.12.0 release: every request was rejected with
400 Bad Request, and items could report the wrong status or an empty or corrupted body. Bulk requests work again, and each item now reports its actual status together with a single problem details document. (TSM-8677, TSM-8679, TSM-8702, TSM-8711)
Security
Section titled “Security”- Updated
System.Security.Cryptography.Xmlto version 8.0.4 to address four newly published high-severity advisories. (TSM-8752)
4.12.0 - 2026-06-26
Section titled “4.12.0 - 2026-06-26”This release introduces bulk request support, dedicated health check endpoints, a dedicated attribute data format, and extends time series search with attribute data. Includes improved API version routing, localization support, and several bug fixes across the HTTP and .NET APIs.
- Bulk multiple API requests into a single call via
POST /automation/bulk. (TSM-6927) - Dedicated health check endpoints
GET /health/readyandGET /health/live. (TSM-8296) - Dedicated attribute data format with dictionary-based JSON serialization for API version 4.12 and above. (TSM-7857)
- Configurable localization support in the HTTP API via
TSM:Http:Hosting:SupportedCultures. (TSM-8426) - New
ITimeSeriesStore.Findoverloads withincludeAttributesflag to load assigned attributes in a single query. (TSM-8564) - New
includeAttributesquery parameter onGET /repositories/{repository}/timeSeries. (TSM-8574)
Changed
Section titled “Changed”- Database errors are now logged at Error level with full diagnostic detail (SqlState, ErrorCode, failing query). (TSM-8371)
- HTTP API now reflects the negotiated API version in the
Content-Typeresponse header and provides per-version OpenAPI documentation. (TSM-8583) - HTTP API requests without an
Acceptheader are now treated asAccept: application/jsonby default. (TSM-8618)
Deprecated
Section titled “Deprecated”IAttributeDataStoremethods takingITimeSeriesDataCollection<string?>are deprecated and will be removed in a future major release. (TSM-7857)ITimeSeriesStore.Find/TryFindoverloads withoutincludeAttributesare deprecated and will be removed in a future major release. (TSM-8564)
- Route parameters with percent-encoded characters are now correctly single-decoded in the HTTP API. (TSM-5881)
- Deleting a time series with a history of differing storage configurations no longer fails with an internal server error. (TSM-7762)
- .NET API Examples solution no longer fails to compile. (TSM-8375)
- Incorrect response type in Swagger/OpenAPI documentation for
GetUnitOfListAttributeAssignment. (TSM-8390) - .NET API Examples updated to use non-obsolete functions. (TSM-8401)
- Incorrect error code (
HK00000) when deleting a referenced attribute on German operating systems. (TSM-8397) - Loading a constant unit conversion now returns the same result as finding it. (TSM-8557)
Security
Section titled “Security”- Updated
System.Security.Cryptography.Xmlto version 8.0.3 to address CVE-2026-33116. (TSM-8446)
4.11.2 - 2026-04-30
Section titled “4.11.2 - 2026-04-30”This release includes a bug fix in the HTTP and .NET API.
Changed
Section titled “Changed”- IListAttributeValue.SortOrder was changed from nullable (int?) to non-nullable (int), with the factory’s sortOrder parameter defaulting to 0. TSM-8486)
4.11.1 - 2026-04-27
Section titled “4.11.1 - 2026-04-27”This release includes several bug fixes, a security update, and minor improvements to the HTTP and .NET APIs.
- Formula time series now use the default interval transformation method instead of returning an error when referencing a time series with an undefined unit. TSM-7785)
- Issues with .NET API Examples (TSM-8401 ,TSM-8375)
- Open API specification Issue (TSM-8390)
- Incorrect Error code on German operation systems (TSM-8397)
Security
Section titled “Security”- Updated System.Security.Cryptography.Xml to version 8.0.3 to address CVE-2026-33116 and eliminate potential security audit concerns. TSM-8446
4.11.0 - 2026-03-24
Section titled “4.11.0 - 2026-03-24”This version fixes several bugs in both the .NET API and the HTTP API and adds features to search and delete functionalities.
- Ability to search for empty attribute assignments (TSM-7171).
- Additional methods for managing list-type attributes. (TSM-8327, TSM-8329)
- New configuration key for improving stability during deletion of large amounts of data. (TSM-8022)
Changed
Section titled “Changed”- The HTTP API no longer exposes details about SQL queries to the client in the event of an error. (TSM-7894)
- Additional
forceparameter for handling errors when managing list-type attributes. Please note that this may require changes be made to client software! (TSM-8182, TSM-8183, TSM-8184, TSM-8203, TSM-8333) - More properties now nullable in HTTP API (TSM-8176, TSM-8202)
Deprecated
Section titled “Deprecated”- The flag “Interpolated” (
22) is now obsolete and will be removed in the next major release. (TSM-8152) - A method overload in the .NET API (
IAttributeStoreFactory.Create) with an unused parameter has been marked obsolete. (TSM-7905)
- Issues with Open API specification. (TSM-8070)
- Ability to delete quotations within transactions. (TSM-8125)
- Performance problem when writing duplicate values to non-cyclic time series. (TSM-8158)
- Inability to pass quotation parameters when reading data. (TSM-8209)
- File lock on
HAKOM.xmlwhile running the HTTP API. (TSM-8044)
4.10.1 - 2025-12-22
Section titled “4.10.1 - 2025-12-22”Fixes issues with the previous release.
- Can’t create time series using PowerTSM App when running against HTTP API. (TSM-8080)
4.10.0 - 2025-12-18 [YANKED]
Section titled “4.10.0 - 2025-12-18 [YANKED]”This release introduced a bug and should not be deployed. Use patch 4.10.1 instead!
Focuses on improvements to the HTTP API and its documentation.
- Improve ability to find time series based on their attributes. (TSM-6920, TSM-7745)
- Manage list-type attributes using the HTTP API. (TSM-7860)
- Improve the included database scripts used for setting up an empty PowerTSM database. (TSM-7432)
- Allow configuration of certificate for hosting the HTTP API with SSL. (TSM-7544)
- Support request/response compression in HTTP API. (TSM-7707)
- Ability to omit storage information in references used in making HTTP requests. (TSM-7889)
- Support for new PostgreSQL installation without explicit table spaces. (TSM-7993)
- Support for list-type attributes in .NET API and HTTP API. (TSM-7860)
Changed
Section titled “Changed”- Trailing zeros in the second part of timestamps are now truncated in responses from the HTTP API (TSM-7887)
Deprecated
Section titled “Deprecated”- Inconsistently named query parameters in HTTP API - These are now clearly marked es deprecated in the OpenAPI specification.
- Fixed several issues with the Open API specification for the HTTP API. (TSM-7766,TSM-7841,TSM-7842,TSM-7895)
- Performance issues when writing data (TSM-7908)
- Several other minor fixes (TSM-7767,TSM-7763)
4.9.3 - 2025-10-03
Section titled “4.9.3 - 2025-10-03”Restores compatibility between 3.x clients and 4.x databases
- Include Latest Database Changes in Scripts (TSM-7751)
4.9.2 - 2025-09-05
Section titled “4.9.2 - 2025-09-05”Bugfix in the HTTP API
[Known Issue]: There are issues when accessing a 4.9.2 database using version 3 clients. If this is a requirement, please update to patch 4.9.3
- Creating a time series sometimes fails silently. (TSM-7568)
4.9.1 - 2025-08-29
Section titled “4.9.1 - 2025-08-29”Improved error handling and ability to write custom functions for formula time series. Added new features to HTTP API.
- Several new HTTP API endpoints (TSM-7442, TSM-7370, TSM-7374, TSM-6587, TSM-7397)
- Improvements to custom functions (TSM-7284,TSM-7285,TSM-7283,TSM-7480)
- HTTP API can now respond with non-numeric values (i.e. division-by-zero results, infinities) (TSM-7416)
- Several minor bugs (TSM-5410,TSM-7404,TSM-7418)
- Improved error messages (TSM-7397,TSM-6678,TSM-7394)
4.9.0 - 2025-06-23
Section titled “4.9.0 - 2025-06-23”Extends the .NET and HTTP APIs and adds several new configuration settings, minor bug fixes and overall performance improvements. Also improves HTTP API documentation.
- Additional date/time conversion methods exposed in .NET API. (TSM-7139)
- OpenAPI specification is now included in the HTTP API. (TSM-6425)
- Ability to log to Microsoft Application Insights. (TSM-7010)
- HTTP API supports reverse proxy headers. (TSM-7130)
- Management of node-type attributes. (TSM-6580,TSM-6584,TSM-6585,TSM-6586)
Changed
Section titled “Changed”-
.NET API did not expose types required for some common use cases. (TSM-7146)
[4.8.0] - 2024-12-11
Section titled “[4.8.0] - 2024-12-11”This is the initial public release of version 4 for testing by selected customers and partner companies. Version 4 represents a complete rewrite of the HAKOM PowerTSM product line to bring the product up to the most modern software development standards.
It has yet to include all of the features that version 3 has accumulated over the decades, especially since we’re reevaluating a lot of the functionality.
For detailed information about the differences between versions 3.x and 4+ of the PowerTSM product suite and migration guides, please contact our support team
Earlier Releases
Section titled “Earlier Releases”For information regarding changes between 4.0 and 4.9 please contact our support team.
For information regarding migration from 3.x to any release higher than 4.x, please contact our support team.
For information regarding changes in any 3.x version, please refer to the legacy documentation page.