Release Notes for Version 10.97.3 Critical Fixes Rollup 1

The following issues and enhancements have been fixed in this release.

Notes:

  • 10.97.3 Critical Fixes Rollups aren't compatible with other 10.97.x products, such as 10.97, 10.97.1, or 10.97.2.
  • For information about security vulnerabilities, refer to iconics.com/cert.

Common and Platform Services

Reference ID

Description

5800
7748
9611
9647

Various enhancements to improve the security of the software.

7603

Converting a Boolean to a string converts to True or False. Previous versions converted to 1 or 0.

Workaround: To maintain previous functionality, convert the Boolean value to a number before converting it to a string:

tostring(tonumber({{BooleanValue}}))

FrameWorX

Reference ID

Description

5696

Under some circumstances, the tags coming via the Reverse Net point manager indicate "Bad - Server Closed Connection" quality.

5930

Added an IdleTimeoutSeconds parameter to Ico.FwxServer.Net.NetPointManager.The parameter sets the timeout for all connections (the default is 30 seconds). The valid range is 1 to 3,600. To change the setting, go to Platform Services ConfiguratorPoint ManagersNetworking.

Note: If the setting isn't there, you will need to add it manually to:

C:\ProgramData\ICONICS\FwxServer.PointManagers.config

6616

When Tag Counting Mode is set to AssetWorX Tags (for Basic SCADA), the Hyper Historian SQL Query engine does not work.

7431

The FrameWorX server doesn't allow UA clients to browse tags when security is enabled.

Installation

Reference ID

Description

9087

The Microsoft OLE DB Driver for SQL Server setup prerequisite has been updated to v18.7.2.

Recipes

Reference ID

Description

7543

Added support for Recipe Management Runtime Info tags.

7849

A crash occurs when opening a display in GraphWorX64 Runtime that contains a GraphWorX64 Viewer linked to a display with a Recipe Grid.

8447

Audit messages are missing the user and machine name when recipes are remotely modified using the Recipe Grid control.

8525

The Recipe Navigator control causes context menu operations such as New Recipe Item to fail when connected to a remote server.

9221

FwxRecipeService may crash on startup if the SQL Server connection can't be resolved.

Schedules

Reference ID

Description

2599

Fixed a memory leak in the BACnet with SC schedule and calendar views.

7097

Workbench crashes in the calendar control when the Holiday has invalid XML.

6055

When connecting to a remote server, the Runtime tab of a schedule does not display any data.

Security

Reference ID

Description

5772

In the audit log, security changes are logged only in English.

7460

(MobileHMI and HTML5 WebHMI)SAML 2.0 IdP-initiated single signout does not log the user out of HTML5 clients.

Alarms and Notifications

AlertWorX

Reference ID

Description

8294

Fixed an issue where dynamic AssetWorX tags do not work in the Cc and Bcc fields.

You must select the Use UA Points option on the Email Settings tab.

8329
8462

If the AlertWorX service is slow to start, it will initially fail to load the configuration. When this occurs, the configuration doesn't load until a configuration change occurs.

9090
9091
9254

Fixed a crash in Alert Sierra and AlertWorX that occurs when a user adds two nodes with the same name.

Hyper Alarm Server

Reference ID

Description

6344

Workbench crashes when creating an alarm with a type that includes an input with the Boolean constant type and no default value.

6686

Fixed an issue where a new alarm type could not be created without adding the Severity field.

6746

When an alarm type input is changed from Constant to Adjustable in runtime, the alarms of that type do not trigger or change until Hyper Alarm Server is restarted.

6783

When the display scale in Workbench is set to 175% or more, the scroll bar on the General and the Expression tabs on the Alarm Types screen (Alarms and Notifications > Hyper Alarm Server > Types) is missing and it is not possible to view all of the content on the tabs.

7783

The Alarm State Storage feature with the Data Flush Period set to 0 doesn't update the .bin file when the server shuts down.

7784

The Update Adjustable Inputs feature does not work for Asset alarms.

7835

Records with descriptions that reference other Asset equipment properties resolve to "Bad."

Hyper Alarm Logger

Reference ID

Description

9041

When a search condition that includes a comparison with a Severity field is defined for a Data Exporter data set, the search condition does not work as expected.

AnalytiX

AnalytiX-BI

Reference ID

Description

5641

When retrieving equipment properties via the Dimensions > Asset Property step in an AnalytiX-BI data flow, the HasHistoryValues flag incorrectly returns False for properties configured as Hyper Historian tags.

6364

The AnalytiX-BI point manager crashes when a data model is brought offline while clients are connected to it, and then is brought online again.

7435

Queries with an ORDER BY clause may fail with a "Column name is not unique" error if they use the same aggregate over the same column twice, even if the columns have unique aliases.

7447

The AnalytiX-BI server may become unresponsive if one or more tables are connected to data sources that take an extensive amount of time (more than 4 minutes) to return their data. Also, queries that use predicates with many conditions (more than 20 conditions) will cause a large spike in memory consumption and will execute slowly.

8263

When creating an AnalytiX-BI data flow that retrieves data from a custom AnalytiX-BI query with column aliases, the query incorrectly returns non-aliased column names.

8884

When editing the query of an AnalytiX-BI data view, tab characters aren't preserved if they are at the beginning of a line.

BridgeWorX64 and Workflow

Reference ID

Description

5559

If you use the Test Transaction button to execute a transaction, the parameters string has extra < and > characters.

7987

The ICONICS BridgeWorX64 Scheduling service may crash when a transaction is scheduled to run on an alarm subscription, and the alarm received from the subscribed source contains null in the EventID field.

CFSWorX

Reference ID

Description

6963

A Connected Field Service Workers source that is connected to Azure Active Directory imports guest users when it should only import member users.

7516

When Sort workers by location is set for worker lookup, the default expression does not work with Hyper Alarm Server.

8569

Alarm updates are now available at the start of a workflow without first using one of the blocks that triggers an alarm update, as long as the workflow trigger is an alarm.

Energy AnalytiX

Reference ID

Description

6710

The Energy AnalytiX license requirements have been simplified. Now, the EnergyAnalytiX license only needs to be accessible from the node where Energy AnalytiX and AssetWorX are deployed.

6735

Improved an error message explaining that Energy AnalytiX calculation expressions do not support calculations of type x= {[meter:*.*}} + constant because these types of calculations cannot be mapped to a related historian calculation expression.

6827

Energy dashboards display data with different time stamps on the Yearly dashboards when compared to similar periods on the Long-Term dashboards.

6828

When using the Meter Data Spikes Tool in Workbench, some of the time stamps are inconsistent.

ReportWorX64

Reference ID

Description

5288

If you upload a template to ReportWorX64 when the file is open in Excel, it appears to work fine until you apply the changes, and then it displays the error, "Value cannot be null. Parameter name: bytes."

7581

When the name of a worksheet is changed and the Excel file is immediately saved, the file gets corrupted, and the ReportWorX64 Express configuration can no longer be loaded.

7614

A custom column that uses a formula that references another sheet (such as =Sheet2!A1) breaks when the data is downloaded.

7880

The Send Email redirector does not send email.

Controls

AlarmWorX64 Viewer

Reference ID

Description

3194

AlarmWorX64 Viewer does not resolve language aliases in specific cases when a control appears on the screen for the first time.

5551

(MobileHMI and HTML5 WebHMI)The context variable @@row.index does not work in commands executed from an HTML5 AlarmWorX64 Viewer.

6823

Some tooltips for the History Control in the AlarmWorX64 Viewer are not properly localized.

7716

Under some circumstances, AlarmWorX64 Viewer may ignore aliases set by the Load Graphics Display command.

8996

(MobileHMI and HTML5 WebHMI) If an alarm was previously active in the viewer and was acknowledged and returned to normal, and then becomes active again, it briefly displays the time stamp of the previous alarm.

9308

(MobileHMI and HTML5 WebHMI) AlarmWorX64 Viewer may incorrectly resolve expressions in virtual columns when there are long-running historical alarm data requests (large data sets).

Asset Navigator

Reference ID

Description

7352

When resolving styling rules that define icons, Asset Navigator might crash when reloading data.

EarthWorX Viewer

Reference ID

Description

7468

Fixed an issue in HTML5 where pushpins were located incorrectly in displays that contained culture-specific static values for latitude/longitude data sources. These values are now automatically converted into culture-invariant strings.

8526

(MobileHMI and HTML5 WebHMI) If your regional settings use a comma as the decimal separator and you manually enter the latitude and longitude of an EarthWorX pin, the pin isn't positioned correctly. The pin jumps to the upper right corner of the map.

If your regional settings use a period as the decimal separator, changing the latitude and longitude of a pin causes that pin to move in configuration mode. This doesn't happen when using a comma as the decimal separator. The pin doesn't move in configuration mode, but jumps to the correct position in runtime.

GridWorX Viewer

Reference ID

Description

5399

Resolving and updating tags in column headers in HTML5 is not consistent with the desktop (WPF) viewer.

7043

When the display scale is set to 250% or more, the OK and Cancel buttons aren't visible in the pop-up window in GridWorX Viewer Runtime in GraphWorX64.

9305

The X-axis in an HTML5 GridWorX Viewer chart does not display the correct labels for data sets with a large number of samples when the LabelInterval property is modified.

Pivot Control

Reference ID

Description

5528

(MobileHMI and HTML5 WebHMI) Web browser controls inside a Pivot Control are misaligned. They appear too high and overlap the page labels.

Recipe Grid

Reference ID

Description

7849

A crash occurs when opening a display in GraphWorX64 Runtime that contains a GraphWorX64 Viewer linked to a display with a Recipe Grid.

7043

When the display scale is set to 250% or more, the OK and Cancel buttons aren't visible in the pop-up window in Recipe Grid Runtime in GraphWorX64.

Recipe Navigator

Reference ID

Description

7181

Recipe Navigator may crash when global aliases are used.

7238

GraphWorX64 crashes when scrolling down the list of recipes in Recipe Navigator to view a newly added or copied recipe.

Schedule Control

Reference ID

Description

5253

The Schedule Control initially appears blank until you start scrolling.

7552

Fixed an issue in the BACnet with SC Schedule View that was causing a failure to read the protocol revision of a BACnet device.

7578

The BACnet with SC schedule viewer does not apply changes properly when changing the order of items in the Exceptions list. In addition, adding multiple exceptions or Point List items and then clicking Apply doesn't save your changes.

Table Control

Reference ID

Description

5814
5863
7064

Optimized the performance of the Table Control.

TrendWorX64 Viewer

Reference ID

Description

5452

(MobileHMI and HTML5 WebHMI) If the Time Shift property of a pen is changed in runtime via global aliasing, the time in the legend does not update with the new value.

6355

A Pen Removed event provides an incorrect value for the pen index.

7099

(MobileHMI and HTML5 WebHMI)The Create Pen command on a pick action with Drag Drop set to True cannot be dragged and dropped onto a TrendWorX64 Viewer.

7319

(MobileHMI and HTML5 WebHMI) An Edit Trend Chart command with a Summary Interval parameter updates the trend interval instead of the summary interval.

8266

(MobileHMI and HTML5 WebHMI)High or Low Limit values in the legend are not immediately updated when the axis range changes.

Data Connectivity

BACnet with SC

Reference ID

Description

2537

Improved the speed of data import after Network Discovery.

4395

When you disable a channel or remove a device or object, AssetWorX continues to display the invalid alarms.

7013

The BACnetRuntimeID property has an incorrect value.

7028

Reading all the data from the propertyList property causes a buffer overflow error and does not fall back to reading the propertyList property in smaller chunks.

7130

In property discovery, scanning uses the propertyList property every time it scans the properties even when Protocol Revision is less than (<) 14.

7552

Fixed an issue in the BACnet/SC ScheduleWorX64 Viewer that was causing a failure to read the protocol revision of a BACnet device.

8245

When two devices with identical names are on a BACnet network, the import fails.

8315

The conversion of single or double values fails in the EDE Exporter.

8420

Added a vendor-specific property, DisableRouting, to the Network Port object.

8492

BACnet object names aren't correctly displayed in IoTWorX in the ISO 10645 UCS-2 character set on Linux.

8559

Some objects generate a "Bad - no such object" warning even though the object and the property are valid.

5222
9012
9013
9014
9015

BACnet alarms are not visible in AlarmWorX Viewer when the root bac: is selected. If the source is different (for example, a channel or a device), the alarms are visible. This occurs when the BACnet configuration database is loaded or imported.

9277

EDE export fails when there are proprietary objects.

9278

EDE export consumes a lot of Workbench resources.

9637

The RemoveListElement operation is not performed when alarms, trends, or history alarms are disabled.

9665

Hyper Historian doesn't merge data from BACnet trend buffers.

9708

BACnet Network Discovery for IoTWorX doesn't work.

GridWorX (Databases)

Reference ID

Description

7677

If multiple data sources use the same trigger tag, the GridWorX point manager service subscribes to the same trigger tag multiple times, creating unnecessary points in its session with FrameWorX Server.

Modbus

Reference ID

Description

5518

When loading a GraphWorX64 display, direct Modbus tags hang at "Bad - Waiting for initial data" quality.

5629

Unable to browse Modbus tags in Data Browser and Data Explorer when using the Device Nodes feature in desktop mode. This occurs because the Device Nodes feature is designed for IoTWorX and is not supported on the desktop.

OPC UA

Reference ID

Description

7093

OPC UA server folder and tag names that have the left square bracket ([) in their name (such as Item[0]) cannot be browsed and have a quality of Bad - Invalid point name.

7330

An OPC UA connection might not work when it is renamed to a name that was previously deleted (for example, connection A was deleted, and then connection B was renamed to A).

8395

FrameWorX crashes when the OPC UA server returns invalid references from the Browse method.

Web Services

Reference ID

Description

6757

When configuring a web service method with a parameter value that contains the character sequence \" (a backslash followed by a double quotation mark), a run-time error occurs, and any data point associated with the method fails with a Bad - Unexpected Error message.

GraphWorX64

Reference ID

Description

5527

(MobileHMI and HTML5 WebHMI) A web browser control inside an embedded GraphWorX64 Viewer control is not positioned correctly when the display uses IsScalable = true and PreferredStretch = Uniform.

6199

(MobileHMI and HTML5 WebHMI) When confirming a write, the Yes button is not selected by default in the confirmation dialog like it is on the desktop (WPF).

6927

(MobileHMI and HTML5 WebHMI) A pick action with an Initial Click and a global command with at least one constant parameter (for example, a string or a number) is not executed.

6928

(MobileHMI and HTML5 WebHMI) A pick action with a Shortcut Key and a global command with at least one constant parameter (for example, a string or a number) is always disabled and cannot be executed.

7002

Fixed an issue where it was possible to click buttons in a GraphWorX64 display before the display had finished loading.

7042

The OK, Cancel, and Help buttons aren't visible in the Smart Tile Configuration window when the display scale is 250% or more on a high DPI monitor.

7212

(MobileHMI and HTML5 WebHMI) A layer set with No Zoom, No Pan, and No Scaling that also has horizontal or vertical alignment set might not remain in the correct place. In some cases, it loads off to the side where it isn't visible.

7295

The timing accuracy of a security logout due to inactivity has been improved.

Hyper Historian

Reference ID

Description

5277

The Data Exporter cannot export array and non-array values to the same SQL table column. If one tag logs number values, while another tag logs number arrays of length 1, and the Column Type of the exported data set is set to Value, the array values will cause the export task to fail. If the Column Type is set to Array of Values with the index set to 0, then the non-array values will cause the export task to fail. Changes have been made to address this issue and ensure that these types of tasks don't fail anymore (see ID 5319).

If you need to export the individual values of both tags to the same column, set the Column Type to Calculated, and set up the expression like this:

IF isarray({{Value}})
THEN getat({{Value}},0)
ELSE {{Value}}

6616

When Tag Counting Mode is set to AssetWorX Tags (for Basic SCADA), the Hyper Historian SQL Query engine does not work.

7437

When upgrading Hyper Historian from version 10.97.1 CFR 2 to 10.97.3, the configuration does not load when Use Advanced Configuration Cache is enabled.

7624

The atagnowf function in Hyper Historian calculated tags include historian tags that are disabled. This causes the disabled tags to return a "Bad - No Data" value.

IoTWorX and Internet of Things

Reference ID

Description

2286

When sending a negative integer value via MQTT Sparkplug B, the received value in GENESIS64 is not converted properly.

7764

IoTWorX isn't showing devices as online in Workbench even though they are publishing data.

7830

Newly added tags to the publish list are not sending buffered data.

8359

IoTWorX devices are not displaying the All Available Data and Published Data folders via Dynamic List.

8387

A Sparkplug B data point browsed via a FrameWorX network node creates an endless, browsable tree structure.

8492

BACnet object names aren't correctly displayed in IoTWorX in the ISO 10645 UCS-2 character set on Linux.

8828

Real-time data updates are dramatically slower when Local and Cloud Buffering is enabled.

9003

IoT Subscriber point manager stops receiving updates for one subscription, but other subscriptions still work.

9180

Fixed an issue where MQTT Sparkplug-B had several Severe Error messages in the TraceWorX log.

KPIWorX

Reference ID

Description

5766

Added support in GENESIS64 to integrate Microsoft Cloud for Sustainability (MCfS) calculated emissions into an MCfS data model. The related support is released in a Workbench Desktop package.

MobileHMI and HTML5 WebHMI

Reference ID

Description

5818

If you scan a QR code in the AppHub when another display is open, it does not open the display that is linked to the QR code.

6337

When the dynamic data source type is changed during runtime (for example, from Boolean to a number), HTML5 sometimes writes a 0 for the tag instead of the actual process point value that was entered by the user.

7493

The first time an HTML5 client connects to a server, the :ClientIPAddress tag fails to resolve if the display contains a process point that uses both language aliasing and global aliasing.

8264

When you use a tag for the initial value in a process point that uses Write Initial Value, and that tag resolves to blank, the original data point name is used instead.

Workbench

Reference ID

Description

5975

When there is no internet access, the Abbreviated What's New does not display even if the Help is installed locally.

6300
6301
6302
6303
6304
6306
6319
6322
6323
6324
6325
6326
6334
8018
8043

Product Help buttons are not properly linked to the Help.

6667

During system configuration, it's now more obvious when user credentials are invalid.

6816

Disabling FrameWorX in Configure Application(s) Settings might disable other core services that provide OPC Classic connectivity and simulation.

7427

Disabling a FrameWorX application causes the ICONICS Simulator Point Manager service to be stopped and disabled.

7531

Part of the Apply & Close and Apply & New buttons are hidden when the language of the operating system is set to French.

7532

In the Japanese translation, the Cancel button is not translated in the Filter Wizard popup in AlarmWorX64 Logger.

8190

Enabling or disabling applications from Workbench overwrites point manager settings that have been changed in Platform Services Configuration. This occurs only when Enable and run only the services for the applications that are in the project is selected.

8959

Added a PowerShell parameter for ignoring a GUID. For example, when importing an Asset configuration:

Import-WbConfiguration -Root $key - Provider Assets -Path [path_to_file] -Format Csv -Delimiter ',' -ImportMode CreateAndUpdate -IgnoreGuid True

8786

When packing and unpacking a project using find and replace, the primary and secondary computer names in the redundancy settings for Hyper Alarm Server and Hyper Alarm Logger cannot be replaced.

9093

The project reporting database is not installing the proper version, and Workbench does not notify the user that an upgrade is needed.

9107

An option (Purge database) in the Import/Export dialog is not correctly translated in French and is misleading for users.

9309

When Report tasks are retried after upgrading from 10.97.1 to 10.97.3 CFR 1, there are warnings in a task log.

Known Issues and Limitations

Reference ID

Description

2700

Importing certain invalid IFC files can cause GraphWorX64 to crash.

52673

The AlarmWorX64 MMX Configurator (Workbench Classic) does not support upgrading AlarmWorX64 MMX configurations when they are contained in databases with other ICONICS configurations (such as unified configuration databases). You can only update these configurations using the installation or the Configure System utility.

58862

The BACnet Classic trend buffer is not synchronized correctly (creating a gap in the historical trend) when the Hyper Historian Logger Service has been stopped for a period of time (at least 15 minutes, but it’s more likely to happen the longer that the logger has been stopped).

63359

HTML5 does not currently support Esri maps.

79462

On Windows 7 and Server 2012 systems, the ICONICS services can take an excessively long time starting (10 minutes or more). This can delay services that are needed to allow connections via Remote Desktop or Hyper-V console, which means that it can take more than 10 minutes before the system can be accessed.

The workaround for this issue is to change the start-up type for some services to Automatic (Delayed). Use the Services control panel or the Configure Services dialog in Workbench to change any ICONICS service running as Automatic to Automatic (Delayed). The ICONICS services still will be slow to become responsive, but users will be able to remote into the system in the meantime.

81025

Do not use Powershell cmdlets to add Energy AnalytiX extensions and related energy calculations to meter tags as the related AssetWorX equipment properties (including their connection to Hyper Historian) will not be automatically created, leaving the product in an invalid state.

83056

Alarm acknowledgment may not succeed when acknowledging many alarms at once that originate from an IoTWorX device. However, users can work around this issue by acknowledging alarms in smaller batches.

88637

If the AssetWorX configuration doesn't meet the following requirements, the sample Energy AnalytiX dashboards will have no data and the EnergyAssetsDimBi table under any of the three energy data models in AnalytiX-BI will display an error status:

  • The Energy AnalytiX extension must be added to the topmost equipment under Assets > Equipment.
  • Each piece of equipment that has the Energy AnalytiX extension must be configured with one of the following levels: Enterprise, Area, or Site. Use the General tab to configure the level.

To resolve these errors, ensure that your AssetWorX configuration meets the above requirements. See knowledge base article 4970 to learn how to refresh the data model.

90107

After making changes to the ICONICS security configuration, the Hyper Historian SQL Query Engine might return errors. To resolve these errors, restart the ICONICS Hyper Historian Raw Data Provider Host (HHRawDataProvider) service. If you are using the Query Engine with SQL Server, restart the SQL Server instance as well.