Release notes 2022: Azure Health Data Services
This article describes features and enhancements released in 2023 for the FHIR® service, DICOM® service, and MedTech service in Azure Health Data Services.
Azure Health Data Services events include a public preview of two more event types for the DICOM service. These event types enable applications that use Azure Event Grid for event-driven workflows when DICOM images are created or deleted.
The Azure Health Data Services toolkit is available for public preview. The toolkit is an open-source project and allows you to customize and extend the functionality of your Azure Health Data Services implementations. The NuGet packages of the toolkit are available for download from the NuGet gallery, and you can find links to them in the repo documentation.
- Fixed: The error generated when resource is updated using if-match header and PATCH. A resource is updated if it matches the Etag header. See PR #2877.
Customers can deploy the MedTech service fully, including Event Hubs, an Azure Health Data Services workspace, FHIR service, MedTech service, and managed identity roles, by choosing a Deploy to Azure button on the documentation page. For more information, see Deploy the MedTech service using an Azure Resource Manager template.
Customers can determine if their mappings are working as intended, as they can see dropped events as a metric to ensure that data is flowing through accurately.
The Azure Health Data Services toolkit is open-source and allows you to customize and extend the functionality of your Azure Health Data Services implementations.
Fixed: Querying with :not operator was returning more results than expected. The issue is fixed and querying with :not operator should provide correct results. See PR #2790.
Fixed: Provided an error message for failure in export resulting from a long timespan. With failure in an export job due to a long timespan, a customer sees
RequestEntityTooLarge
HTTP status code. See PR #2790.Fixed: In a query sort, the system throws an error when chained search is performed with the same field value. The functionality returns a response. PR #2794.
Fixed: Server doesn't indicate
_text
not supported. When passed as URL parameter,_text
returns an error response when using thePrefer
heading withvalue handling=strict
. See PR #2779.Fixed: Added a verbose error message for invalid resource type. A verbose error message is added when a resource type is invalid or empty for
_include
and_revinclude
searches. See PR #2776.
The export capability for the DICOM service is generally available. Export enables a user-supplied list of studies, series, and instances to be exported in bulk to an Azure Storage account. For more information, see Export DICOM files.
Performance improvements cut the time to deploy new instances of the DICOM service by more than 55% at the 50th percentile.
Some customers experienced issues storing DICOM files that don't perfectly conform to the specification. To enable those files to be stored in the DICOM service, the strictness of the validation performed on STOW was reduced.
The service accepts:
- DICOM UIDs that contain trailing whitespace
- IS, DS, SV, and UV VRs that aren't valid numbers
- Invalid private creator tags
Azure Health Data Services is available in these regions: Central India, Korea Central, and Sweden Central.
$import
API is generally available in Azure Health Data Services API version 2022-06-01. See Executing the import by invoking the $import
operation.
$convert-data
added support for FHIR STU3-R4 conversion. See Data conversion for Azure API for FHIR.
Data filtering is supported in FHIR to data lake pipeline. See FHIR-Analytics-Pipelines_Filter FHIR data.
The analytics pipeline can process FHIR extensions to generate parquet data. See FHIR-Analytics-Pipelines_Process in pipeline.md at main.
Fixed: History bundles sorted with the oldest version first. There was an issue with the sorting order of history bundles on the FHIR server. History bundles were sorted with the oldest version first. Per FHIR specification, the sorting of versions defaults to the oldest version last. This bug fix addresses FHIR server behavior for sorting the history bundle.
To keep the sorting per existing behavior (oldest version first), we recommend you append
_sort=_lastUpdated
to the HTTP GET command utilized for retrieving history. For example:<server URL>/_history?_sort=_lastUpdated
. See PR #2689.Fixed: Queries weren't providing a consistent result count after being appended with
_sort
operator. The issue is fixed and queries should provide consistent result count, with and without sort operator.
The modality worklists (UPS-RS) service is generally available. Learn more about the worklists service.
Customers can see predefined metrics graphs with alerts on the MedTech landing page to ease the burden of monitoring their MedTech service.
There are predefined queries with relevant logs for common issues so that customers can debug and diagnose issues.
The DICOM Service is available in these regions: Southeast Asia, Central India, Korea Central, and Switzerland North.
For DICOM images containing multiple frames, performance improvements enable fast retrieval of individual frames (60-KB frames as fast as 60 MS). These improved performance characteristics enable workflows such as viewing digital pathology images, which require rapid retrieval of individual frames.
Added articles to enable customers to take advantage of the events improvements. See Consume Events with Logic Apps and Deploy Events Using the Azure portal.
Fixed: Export job not queued for execution. Fixes issue with export job not getting queued due to duplicate job definition in reference to container URL. See PR #2648.
Fixed; Queries not providing a consistent result count after appended with the
_sort
operator. Fixes the issue with the help of distinct operator to resolve inconsistency and record duplication in response. See PR #2680.
Fixed: Removes SQL retry on upsert. Removes retry on SQL command for upsert. The error still occurs, but data is saved correctly in success cases. See PR #2571.
Fixed: Added handling for SqlTruncate errors.Added a check for SqlTruncate exceptions and tests. Exceptions and tests catch SqlTruncate exceptions for decimal type based on the specified precision and scale. See PR #2553.
The DICOM service supports CORS. CORS allows you to configure settings so that applications from one domain (origin) can access resources from a different domain, known as a cross-domain request.
DICOMcast supports Azure Health Data Services workspaces that are configured to use Private Link.
Modality worklist (UPS-RS) endpoints were added to support change and retrieve operations for work items.
All REST API requests to the DICOM service must include the API version in the URI. For more information, see API versioning for the DICOM service.
Attributes that are defined to have a single value but specified multiple values are leniently accepted. The first value for these attributes is indexed.
FHIRPath Patch was added to Azure API for FHIR. This change implements FHIRPath Patch as defined on the HL7 website.
The bulk import feature enables importing FHIR data to the FHIR server at high throughput using the $import operation. Bulk import is for initial data load into the FHIR server. For more information, see Bulk-import FHIR data.
Fixed: Handles invalid header on versioned update. When the versioning policy is set to a versioned update, the most recent version of the resource is provided in the request's if-match header on an update. The specified version must be in ETag format. Previously, a 500 error was returned if the version was invalid or in an incorrect format. This update returns a 400 Bad Request. See PR #2467.
Fixed: Added back the core to resource path. Part of the path to a string resource was removed in the versioning policy. This fix adds it back in. See PR #2470.
Fixed: Reduced the strictness of validation of incoming DICOM files. When value representation (VR) is a decimal string (DS)/ integer string (IS),
fo-dicom
serialization treats the value as a number. Customer DICOM files might be old and contain invalid numbers. The service blocks the file upload due to the serialization exception. See PR #1450.Fixed: Correctly parse a range of input in the content negotiation headers. WADO with Accept: multipart/related; type=application/dicom throws an error. It accepts Accept: multipart/related; type="application/dicom", but they must be equivalent. See PR #1462.
Fixed: Parallel upload of images in a study fails. Handle race conditions during parallel instance inserts in the same study. See PR #1491 and PR #1496.
With Private Link, you can access Azure Health Data Services securely from your virtual network as a first-party service without having to go through a public Domain Name System (DNS). For more information, see Configure Private Link for Azure Health Data Services.
|This feature enables you to use the FHIRPath Patch operation on FHIR resources. For more information, see FHIR REST API capabilities for Azure Health Data Services FHIR service.
Fixed: SQL timeout returns 408 status code. Before the bug fix, a SQL timeout returned a 500 error. With the bug fix, a timeout in SQL returns a
FHIR OperationOutcome
with a 408 status code. See PR #2497.Fixed: Issue duplicate resources in search with
_include
. Fixed issue where a single resource is returned twice in a search that has_include
. See PR #2448.Fixed: Issue with PUT creates on versioned update. Fixed issue where PUT creates resulted in an error when the versioning policy is configured to
versioned-update
. See PR #2457.Fixed: Invalid header handling on versioned update. Fixed issue where invalid
if-match
header would result in an HTTP 500 error. Now an HTTP Bad Request is returned instead. See PR #2467.
The Events feature allows customers to receive notifications and triggers when FHIR observations are created, updated, or deleted. For more information, see Events message structure and What are events?.
This feature enables you to deploy Azure Health Data Services by using Azure Bicep. For more information, see Deploy Azure Health Data Services using Azure Bicep.
With Extended Query Tags, customers can query non-DICOM metadata for capabilities like multi-tenancy and cohorts.
This feature enables exporting FHIR data to storage accounts behind firewalls. For more information, see Configure export settings and set up a storage account.