Using the HealthLake Business Operation
Within a production, you can include a pre-built business operation to access FHIR® resources in Amazon HealthLakeOpens in a new tab. To do so, add EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab to your production and configure it. Elsewhere in your production, create messages to send to this business operation. For these messages, use a set of specialized message classes that carry data for FHIR® interactions.
If this business operation does not meet your needs, create a custom business operation that directly uses the HealthLake outbound adapter.
Introduction
EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab is a pre-built business operation that supports FHIR® interactions. This business operation provides configurable settings that you use to authenticate to Amazon HealthLake. The business operation is designed to receive a specific set of specialized messages and use them for FHIR® interactions. The message classes support the following requests:
-
POST
-
GET
-
PUT
-
DELETE
-
FHIR search queries
For example, if EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab receives a message of type EnsLib.AmazonHealthLake.POSTRequestOpens in a new tab, it makes a POST request, using the data store, resource type, and content contained in the message. In each case, this business operation returns an instance of %Net.HttpResponseOpens in a new tab, with the HealthLake data within the Data property of that instance.
Specialized Message Classes
InterSystems IRIS® data platform provides the following message classes, recognized as input by EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab:
-
EnsLib.AmazonHealthLake.POSTRequestOpens in a new tab—When EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab receives this type of message, it creates a POST request using the Content and ResourceType properties of the message.
Content is the FHIR data in JSON format, and ResourceType is the type of resource (such as Patient).
-
EnsLib.AmazonHealthLake.GETRequestOpens in a new tab—When EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab receives this type of message, it creates a GET request using the ResourceID and ResourceType properties of the message.
ResourceID is the ID of the resource and ResourceType is the type of resource (such as Patient).
-
EnsLib.AmazonHealthLake.PUTRequestOpens in a new tab—When EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab receives this type of message, it creates a PUT request using the Content, ResourceID, and ResourceType properties of the message.
Content is the FHIR data in JSON format, ResourceID is the ID of the resource, and ResourceType is the type of resource (such as Patient).
-
EnsLib.AmazonHealthLake.DELETERequestOpens in a new tab—When EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab receives this type of message, it creates a DELETE request using the ResourceID and ResourceType properties of the message.
ResourceID is the ID of the resource and ResourceType is the type of resource (such as Patient).
-
EnsLib.AmazonHealthLake.QueryRequestOpens in a new tab—When EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab receives this type of message, it creates a query request using the SearchType and SearchParameters properties of the message.
SearchType is the type of resource to query. SearchParameters is a comma-separated list of valid FHIR search parameters supported by HealthLake. For a list of search parameters supported by HealthLake, see the HealthLake DocumentationOpens in a new tab.
To use EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab in a production, customize other business hosts to create instances of these specialized message classes and send them to the EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab.
In each case, EnsLib.AmazonHealthLake.BusinessOperationOpens in a new tab returns (as output) an instance of %Net.HttpResponseOpens in a new tab, whose Data property carries data returned from HealthLake.
