Version 2.2.5973.0

TcHmiSrvExtNet.Core version 2.2.5973.0 was released on April 23, 2024.

New features in this release

Class ExportSymbolAttribute and enum Visibility were added to export symbols and their JSON schemas based on .NET types to the Config.json and Schema.json of TwinCAT HMI server extensions. In contrast to dynamic symbols, these symbols aren't created dynamically at runtime, but statically at compile time by an MSBuild task contained in the NuGet package Beckhoff.TwinCAT.HMI.TcHmiSrvExtNet.Core.SDK. This class replaces the TcHmiSchemaGenerator.CSharpAttributes.TcHmiExportSymbolAttribute from the TcHmiSchemaGenerator.dll.
Enum member ValueTypeUInt64 was added.
The following method was added to get an UInt64 using the specified IFormatProvider if property ValueType is ValueTypeUInt64:

Property CommandExtensionData was added.
The following methods were added to change the friendly name of the TwinCAT HMI server extension:

The following methods were added to return an empty String instead of Name if the specified localization cannot be found in the language JSON file of the TwinCAT HMI server extension at the moment:

Property ValueIsNumber also returns true if property ValueType is ValueTypeUInt64.
Enum Int64ParseHandling was added to control how values of type Int64 and UInt64 are parsed when writing JSON text using a TcHmiJsonSerializer.
Property TcHmiJsonSerializerInt64ParseHandling was added to control how values of type Int64 and UInt64 are parsed when writing JSON text.
Property TcHmiApplicationSettings was added to pass additional settings when initializing TwinCAT HMI server extensions.
Type RecursiveValueResolver now also supports resolving Values containing an instance of type Alarm, Event or Message.
This also affects calling methods ValueExtensionsResolveBy(Value, QueueString), ValueExtensionsResolveBy(Value, String), ValueExtensionsTryResolveBy(Value, QueueString, Value) and ValueExtensionsTryResolveBy(Value, String, Value).