HealthShare® Health Connect Cloud Upgrade Checklist (2025.3.1)

DP-444395: Change property AllowedIPAddresses to BindToIPAddress

Category: Gateways - IRIS
Platforms: All
Version: 2025.3.0

This change alters the name of a property of External Language Servers. The property previously known as "AllowedIPAddresses" is now "BindToIPAddresses". An alias between this new name and the old one has been added, so if you are modifying an External Language Server definition through the %Net.Remote.ObjectGateway class, your configuration will continue to work. However, if you modify External Language Servers with %DynamicObject, your code must be updated to use the new property name.

DP-440718: [Interoperability] Amend FunctionSet class container identification

Category: Interoperability
Platforms: All
Version: 2025.2.0

If a Custom Utility Function class that mistakenly extends superclasses other than Ens.Rule.FunctionSet (and those super classes themselves do not extend Ens.Rule.FunctionSet) has been created, then any class methods in those superclasses cannot be used in Rules.

Code generated for Rules now uses the class where the class method is defined, not a subclass.

DP-440887: Deprecate EnsLib managed Gateways

Category: Interoperability
Platforms: All
Version: 2025.2.0

The server and port properties of the EnsLib.Gateway.*, EnsLib.JavaGateway.*, and EnsLib.DotNetGateway.* classes are now deprecated, so users should instead migrate to interact with gateway services through an External Language Server.

DP-443153: [Interoperability] Amend resource protecting Export For Deployment in Production Config page

Category: Interoperability
Platforms: All
Version: 2025.3.0

Sites that had granted users who should be able to export for deployment packages from the Production Configuration page will need to grant such users %Ens_DeploymentPkg:USE and may be able to remove %Ens_Deploy:USE. This only concerns the Zen Production Configuration page.

DP-443265: [Interoperability] Ensure Document TimeStamp is empty for non existent Lookup Table

Category: Interoperability
Platforms: All
Version: 2025.3.0

The document TimeStamp value for the projected Lookup Table document for a non existent or no named Lookup Table was previously returned as the current time. This is now corrected, and returns an empty string in line with other Interoperability projected documents. Any manually created workarounds should be reverted.

DP-443464: [Interoperability] Correct error thrown by X12 parser

Category: Interoperability
Platforms: All
Version: 2025.3.0

An issue that could cause the X12 parser to throw an UNDEFINED error when the binary data length field contained a value greater than the actual length of the binary data has been resolved. The parser now returns the error BinaryDataShort instead.

DP-435478: %Net.SSH.Session:Connect to use SHA256 for default hostkey hash

Category: Networking
Platforms: All
Version: 2025.2.0

New %Net.SSH.Session objects by default have a SHA256 hostkey. If you need a different size, you must pass "SHA1" or "MD5" as an argument to the Connect() method manually.

DP-441221: Export methods should respect /createdirs qualifier

Category: Object Library
Platforms: All
Version: 2025.2.0

This change modifies the behavior of ExportXMLList^%apiOBJ and ExportXMLPackage^%apiOBJ so that they explicitly check for the /createdirs qualifier before calling CreateDirectoryChain() to create a directory. Any usage of these routines that do not use the /createdirs qualifier may have some commands fail.

DP-443460: Fix integer $vector hash to be the same when region mags change

Category: ObjectScript
Platforms: All
Version: 2025.3.0

This change modifies the hashing of integer $vectors to fix an issue where some integer $vectors with identical element values did not produce the same hash. As a result of this bug, printing two vectors with the same elements as strings could yield different results. Note that vector comparison does not rely on these hashed strings unless you explicitly compare the string hash representations.

Customers using DataCheck should be aware that this change may reveal new (but trivial) differences in $vector-typed data across versions.

DP-437848: Enforce BufferLength in SQLBindParameter function

Category: ODBC
Platforms: All
Version: 2025.2.0

When binding parameters with the SQLBindParameter function, the system previously ignored the BufferLength parameter. Now that the parameter is enforced, any invocations of the SQLBindParameter function that use the BufferLength parameter will truncate data to the specified length.

DP-438389: Optionally preserve start date in the past via %SYS.TaskSuper.ImportTasks()

Category: SMP - System Management Portal
Platforms: All
Version: 2025.2.0

Previously, if you imported a task with a "LastScheduled" date in the past using the %SYS.TaskSuper.ImportTasks() method, then the "LastScheduled" date would be ignored and the task would be scheduled to run without accounting for the specified "LastScheduled" date. Now, by default, tasks imported in this way take the "LastScheduled" date into account.

If you previously relied on the old behavior, you may set the runPastTasksTomorrow argument of %SYS.TaskSuper.ImportTasks() to 1.

DP-422287: Update CREATE FOREIGN TABLE behavior

Category: SQL
Platforms: All
Version: 2025.2.0

The point of failure for some ill-formed foreign tables has been moved from query-time to create-time. As a result, some CREATE FOREIGN TABLE statements that previously succeeded could now fail. However, these failures typically indicate that a SELECT statement against the foreign table would have failed anyway.

To prevent the possibility of these validation runtime errors during a CREATE FOREIGN TABLE statement, use the NOVALIDATE keyword.

This change in behavior only applies to foreign tables that use other database management systems as their external source; schema validation is not performed when creating file-based foreign tables.

DP-434312: inherit the CALCSELECTIVITY parameter from the super field

Category: SQL
Platforms: All
Version: 2025.2.0

If you add CALCSELECTIVITY=0 on a property that is an embedded object, the system no longer calculates statistics both for that property and for the corresponding serial object properties. For example, if you have a class Sample.Person with a field Home, which is of type Sample.Address, and assign the Home field CALCSELECTIVITY=0, then no stats will be collected for Home or any of the serial object properties for Home.

DP-439031: $IsVector(null string) will be True

Category: SQL
Platforms: All
Version: 2025.2.0

$IsVector("") now returns 1, rather than 0. The new behavior better conforms to expectations set by other $vector functions, which treat "" as a valid vector.

DP-441931: Changes to JSON Path Language expressions to align with standards

Category: SQL
Platforms: All
Version: 2025.3.0

This change resolves discrepancies between the implementation of the JSON Path Language (used in the JSON_TABLE SQL function) and the ISO SQL Standard. In particular, it corrects the results returned when applying the member wildcard to the context value. Array accessor expressions are also affected. Any JSON Path Language expressions that use these elements may need to be modified accordingly. See the documentation for more information.

DP-443617: Change in when ROWLEVELSCURITY parameter defines the %RLI index

Category: SQL
Platforms: All
Version: 2025.3.0

The %RLI index is generated automatically only when the ROWLEVELSECURITY class parameter is set to 1. If this parameters is set to any other value, the index is no longer generated automatically, which may affect performance. To ensure the %RLI index is defined in this version, set the ROWLEVELSECURITY class parameter to 1.

DP-433826: Make Audit queries faster and fix a bunch of bugs

Category: System
Platforms: All
Versions: 2025.2.3, 2025.3.0

Indices have been added to several fields to improve performance; when you upgrade, the IRISAUDIT database must have enough free space to accommodate these indices (approximately 5% of the size of the audit log).

Audit log data exported from previous versions of InterSystems IRIS cannot be imported to InterSystems IRIS 2025.3.

DP-440592: Object could be closed with incorrect roles

Category: System
Platforms: All
Version: 2025.2.0

Previously, if an object in a REST application went out of scope while I/O redirection was active, its %OnClose method could be run with different roles than when it was created. That issue has been resolved, but the fix may cause an application with very deep nesting (large $STACK value) to encounter a error. If necessary, the frame stack size can be increased by getting the current size with $SYSTEM.Util.GetFrameStackSize() and setting a larger value with $SYSTEM.Util.SetFrameStackSize(). The new value will be in effect for all new processes, not just the current one.

DP-441122: Correct $THIS value in a class method

Category: System
Platforms: All
Version: 2025.2.0

Previously, the $THIS value in a class method could sometimes be an object reference, instead of the class name. If you wrote any class methods that used $THIS to refer to an object reference, you must change your code to access the object reference a different way.

DP-437099: Correct inconsistency in CORS handling configuration

Category: Web Services
Platforms: All
Versions: 2024.1.4, 2025.1.1, 2025.2.0

Previously, CORS handling was inconsistent if a web application used map forwarding. In previous versions, the value of the HandleCorsRequest parameter in the dispatch class defined in the web application determined CORS handling, unless the route had Cors="true", in which case the HandleCorsRequest parameter in the final dispatch class (that is, the one that handles the request) would determine CORS handling.

With this change, the HandleCorsRequest parameter in the final dispatch class always determines CORS handling.

This change also requires that you recompile all existing REST web services upon upgrade.