HealthShare® Health Connect Change Notes (2019.1.4)
This document is meant to help you assess the impact of upgrading to the HealthShare Health Connect 2019.1.4 maintenance release. It lists the changes in this maintenance release and all preceding maintenance releases since release 2019.1.0. Topics in this document include:
- InterSystems News, Alerts, and Advisories
- Changes in Maintenance Release HealthShare Health Connect 2019.1.3
- Changes in Maintenance Release HealthShare Health Connect 2019.1.2
- Changes in Maintenance Release HealthShare Health Connect 2019.1.1
- For Additional Help
This document now uses only external identifiers for the changes. Previous versions of this document included internal identifiers, but due to a policy change, the internal identifiers will no longer be included.
The underlying technology of Health Connect 2019.1.4 is based on InterSystems IRIS. For information about changes to InterSystems IRIS for 2019.1.4, see Changes in Maintenance Release InterSystems IRIS Data Platform 2019.1.4.
InterSystems News, Alerts, and Advisories
From time to time, InterSystems publishes items of immediate importance to users of our software. These include alerts, mission-critical issues, important updates, fixes, and release announcements. You can obtain the most current list at https://www.intersystems.com/support-learning/support/product-news-alerts/Opens in a new tab. InterSystems recommends that you check this list periodically to obtain the latest information on these issues.
Changes in Maintenance Release HealthShare Health Connect 2019.1.3
Maintenance release 2019.1.3 includes the following changes, grouped by category:
The following sections describe the changes in detail.
Changes in the Kernel Category
DP-412701: Update OpenSSL source codes from version 1.0.2zb to 1.0.2zd.
Category: Kernel
Platforms: All
Version: 2019.1.3
Description: Update OpenSSL source code from version 1.0.2zb to 1.0.2zd. In addition to being used in the kernel, the OpenSSL library is used in the Apache-based private web server for any https connections, in the ODBC client for TLS-based connectivity, and in the PKI service.
Changes in Maintenance Release HealthShare Health Connect 2019.1.2
Maintenance release 2019.1.2 includes upgrade checklist items, which are collected in the first section. The sections after that describe all the changes, grouped by category. The upgrade checklist items are repeated in their respective categories.
- Upgrade Checklist
- Healthcare Interoperability
- Productions
- Interoperable SOAP Outbound Adapter to be able to set Write Timeout
- Interoperability Record Map File and FTP services to be able to skip invalid records
- Expose SFTP Session RemoteCharset and LocalCharset to the Interoperability FTP adapter
- Interoperability MQ Series Inbound and Outbound adapter to support username and password
- Avoid Deleting Segment Global for Open Documents
- Web Gateway
The following sections describe the changes in detail. This maintenance release contains upgrade checklist items, which are listed in the first section.
Upgrade Checklist
This section lists the changes that may require changes in code, configuration, or operation. Note that these items are repeated in the more specific categories as well.
DP-11979: Change in timeout for SharedConnection=1 web sockets
NOTE: This item may require a change to code, configuration, or operation.
Category: Web Gateway
Platforms: All
Version: 2019.1.2
Description: For SharedConnection=1 web sockets, we will time the socket out after the CSP session times out, as we do for SharedConnection=0 web sockets. Before this change, the socket would be active forever.
Changes in the Healthcare Interoperability Category
JB1998: Moved the HL7 Annotation and HL7 Schema global files to the HealthConnect module
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.2
Description: The HL7 Annotation and HL7 Schema global files have been moved to the HealthConnect module.
Changes in the Productions Category
JGM837: Interoperable SOAP Outbound Adapter to be able to set Write Timeout
Category: Productions
Platforms: All
Version: 2019.1.2
Description:
The underlying HTTP request code in %Net.HttpRequest allows specifying a timeout value for writes to the web server.
This change exposes a new setting in the EnsLib.SOAPP.OutboundAdapter "Write Timeout" (localized) which is used to specify the timeout value for writes to the web server. The default is the same as current behavior - namely to wait for an unlimited time.
JGM911: Interoperability Record Map File and FTP services to be able to skip invalid records
Category: Productions
Platforms: All
Version: 2019.1.2
Description: The EnsLib.RecordMap.Service.FileService and EnsLib.RecordMap.Service.FTPService stop processing a source file if a record fails validation, for example a field is too long. A new setting is provided "Fatal Errors" which is similar to that in the batch services. In the EnsLib.RecordMap.Service.FileService and EnsLib.RecordMap.Service.FTPService processing the new FileErrors setting can be either "Any" or "ParseOnly and is as follows:
An error saving an individual Record, such as a validation error, will be treated as fatal and end the processing of the message when the setting is "Any". This is the current behaviour.
If "ParseOnly" is selected, errors when saving individual Records will not be treated as fatal, and parsing of the message will continue after logging an error log and skipping the errored record.
If AlertOnError is enabled, an alert will be sent for a save error when "ParseOnly" is selected.
The default is "Any".
The error reported if ParseOnly indicates the position in the stream for the invalid record.
JGM938: Expose SFTP Session RemoteCharset and LocalCharset to the Interoperability FTP adapter
Category: Productions
Platforms: Windows
Version: 2019.1.2
Description: The underlying SFTP classes used by the Interoperability SFTP adpaters now implement two properties for the encoding of filenames: RemoteCharset and LocalCharset.
The introduction of these properties changed the default behavior since SSH draft working group standards give filename representation in the UTF-8 character set.
The ability to set these 2 properties is now exposed in the Interoperability FTP adapters as
SFTP Server Character Set (SFTPRemoteCharset)
Character set for file names used by the remote server. Defaults to UTF8. Set to empty string for no translation on the character sets for filenames. This setting is used to set the RemoteCharset property in the %Net.SSH.Session object.
SFTP Local Character Set
Character set used by the local system for filename encoding. For Windows the default is the empty setting which will leave local filenames as Unicode For UNIX the default is to convert to UTF8 This setting is used to set the LocalCharset in the %Net.SSH.Session object
JGM940: Interoperability MQ Series Inbound and Outbound adapter to support username and password
Category: Productions
Platforms: All
Version: 2019.1.2
Description: Interoperability MQ Series Inbound and Outbound adapter to support username and password authentication as provided by the core MQ classes.
The username and password are obtained from the exposed Credentials setting.
KDS439: Avoid Deleting Segment Global for Open Documents
Category: Productions
Platforms: All
Version: 2019.1.2
Description: In certain circumstances, when a virtual document (HL7, EDIFACT, ASTM, or X12) was cloned, but then the document was either closed or deleted, the segment data for the clone document would also be deleted. This would result in Invalid Oref errors if someone tried to access the clone's segments. This change fixes that problem.
Changes in the Web Gateway Category
DP-11979: Change in timeout for SharedConnection=1 web sockets
NOTE: This item may require a change to code, configuration, or operation.
Category: Web Gateway
Platforms: All
Version: 2019.1.2
Description: For SharedConnection=1 web sockets, we will time the socket out after the CSP session times out, as we do for SharedConnection=0 web sockets. Before this change, the socket would be active forever.
Changes in Maintenance Release HealthShare Health Connect 2019.1.1
Maintenance release 2019.1.1 includes upgrade checklist items, which are collected in the first section. The sections after that describe all the changes, grouped by category. The upgrade checklist items are repeated in their respective categories.
- Upgrade Checklist
- Healthcare Interoperability
- Modify XUA Creator class to remove debugging code and change Audience Restriction
- DocumentToProvideAndRegister.xsl had issue with repeating fields inside author
- Comments and Title in XDSb Submission and Folder get lost between provide and query
- MHD Responder handles all GET calls as a read on a binary
- XDSb Metadata update is inserting mulitple urn:healthshare:slots:sourceId tags
- SDA3-to-FHIR transformation was not populating MedicationAdministration
- FHIR-to-SDA3 business process fails when no payload is provided
- XDSb Query Requests with CreationTime parameters does not return OnDemand results
- Journaling
The following sections describe the changes in detail. This maintenance release contains upgrade checklist items, which are listed in the first section.
Upgrade Checklist
This section lists the changes that may require changes in code, configuration, or operation. Note that these items are repeated in the more specific categories as well.
HSHC-1442: DocumentToProvideAndRegister.xsl had issue with repeating fields inside author
NOTE: This item may require a change to code, configuration, or operation.
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: When DocumentToProvideAndRegister encountered multiple institutions inside an author, it was placing each institution in a separate authorInstituion tag. Now, when multiple author institutions appear inside an author, they are placed within value tags inside a single authorInstitution valuelist.
HSHC-1790: XDSb Query Requests with CreationTime parameters does not return OnDemand results
NOTE: This item may require a change to code, configuration, or operation.
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: When you submit an XDSb Query Request, two of the available parameters are $XDSDocumentEntryCreationTimeFrom and $XDSDocumentEntryCreationTimeTo. These let you specify a range of CreatedOn dates for the documents. However, querying OnDemand documents using these parameters erroneously returned zero results.
Changes in the Healthcare Interoperability Category
HSHC-1434: Modify XUA Creator class to remove debugging code and change Audience Restriction
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: Previously, the XUA Creator class (HS.HC.IHE.XUA.Creator) was shipped with debugging code included. This unnecessary code has been removed.
The Audience Restriction of the XUA Creator class has also been modified. A typo in the Audience Restriction URL has been corrected; the new URL is http://ihe.connectathon.XUA/X-ServiceProvider-IHE-Connectathon. Existing implementations that expect the typo need to be updated. Also, this Audience Restriction has been moved to a parameter of the class to improve usability.
HSHC-1442: DocumentToProvideAndRegister.xsl had issue with repeating fields inside author
NOTE: This item may require a change to code, configuration, or operation.
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: When DocumentToProvideAndRegister encountered multiple institutions inside an author, it was placing each institution in a separate authorInstituion tag. Now, when multiple author institutions appear inside an author, they are placed within value tags inside a single authorInstitution valuelist.
HSHC-1545: Comments and Title in XDSb Submission and Folder get lost between provide and query
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: When an XDSb ProvideAndRegisterRequest specified a value for the Title property of the SubmissionSet, the Title value was not present when the SubmissionSet was subsequently retrieved via XDSb FindSubmissionSets.
HSHC-1641: MHD Responder handles all GET calls as a read on a binary
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: MHD Responder handles all GET calls as a read on a binary. This issue has been resolved by blocking read on DocumentReference on the MHD Responder endpoint.
HSHC-1685: XDSb Metadata update is inserting mulitple urn:healthshare:slots:sourceId tags
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: XDSb Metadata update (ITI-57) was inserting a new urn:healthshare:slots:sourceId entry into the DocumentSlots tag every time the document was updated. Now,
HSHC-1766: SDA3-to-FHIR transformation was not populating MedicationAdministration
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: The SDA3-to-FHIR transformation was not populating the MedicationAdministration resource properly. This issue has been resolved.
HSHC-1767: FHIR-to-SDA3 business process fails when no payload is provided
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: When a FHIR-to-SDA3 business process required a payload but none was provided, the business process would stall. Now, completely blank incoming payloads will not cause the business process to hang.
HSHC-1790: XDSb Query Requests with CreationTime parameters does not return OnDemand results
NOTE: This item may require a change to code, configuration, or operation.
Category: Healthcare Interoperability
Platforms: All
Version: 2019.1.1
Description: When you submit an XDSb Query Request, two of the available parameters are $XDSDocumentEntryCreationTimeFrom and $XDSDocumentEntryCreationTimeTo. These let you specify a range of CreatedOn dates for the documents. However, querying OnDemand documents using these parameters erroneously returned zero results.
Changes in the Journaling Category
JournalingGroup2019: Multiple changes and corrections related to journaling and mirroring
Category: Journaling
Platforms: All
Version: 2019.1.1
Description: Various issues associated with journaling and mirroring have been addressed. The changes associated with these issues are SML2776, SML2781, SML2782, SML2783, SML2785, JO2990, JO3117, JO3137, JO3140, JO3141, RJF391, RJF392, HYY2362, HYY2364, and HYY2373.
For Additional Help
If you need assistance with evaluating how upgrading to this maintenance release will affect your applications, systems, or related plans, please contact the InterSystems Worldwide Support Center:
- Phone: +1.617.621.0700
- Fax: +1.617.734.9391
- Email: support@intersystems.com
Current release notes (and complete product documentation) can be found online at https://docs.intersystems.com.