Configuring HealthShare Message Transformation Services
To configure HealthShare Message Transformation Services, you create one or more transformation pipelines. A transformation pipeline is a channel between an input location, HealthShare Message Transformation Services, and a target location.
A transformation pipeline stores several key pieces of information:
-
The type of input data you will supply (for example, HL7 version 2 messages)
-
The type of output data you expect (for example, FHIR R4 resources)
-
Where the services can retrieve the input data
-
Where the services should deposit the output data
-
The credentials required to access the input location and target location
-
Metrics that you can use to determine the efficiency of the pipeline
-
Error logs that enable you to troubleshoot the pipeline
The following sections describe how to manage transformation pipelines and credentials.
Create a Transformation Pipeline
You can create one or more transformation pipelines as follows:
-
In the HealthShare Message Transformation Services home page, click New Transformation Pipeline.
-
Fill in the fields.
For a description of each field, see Transformation Pipeline Properties.
-
Click Save.
The transformation pipeline remains in Pending status while the services perform the operations required to activate it. When the pipeline is able to transform data, its status changes to Live. For more information, see Transformation Pipeline Statuses.
Edit a Transformation Pipeline
You can edit the properties of a transformation pipeline as follows:
-
In the HealthShare Message Transformation Services home page, locate the pipeline to edit.
-
In the Actions column for the pipeline, click the ellipsis, and then click View.
-
At the bottom of the Properties page for the pipeline, click Edit.
-
Modify the properties as needed.
For a description of each field, see Transformation Pipeline Properties.
-
Click Save.
Delete a Transformation Pipeline
You can delete transformation pipelines that are no longer needed as follows:
-
In the HealthShare Message Transformation Services home page, locate the pipeline to delete.
-
In the Actions column for the pipeline, click the ellipsis, and then click Delete.
A confirmation message appears.
-
Click Delete.
Transformation Pipeline Properties
Each transformation pipeline has the following properties:
Specify a name for the transformation pipeline.
Select the option that best describes the input and output data types.
Select the credentials that provide HealthShare Message Transformation Services access to the Amazon S3 bucket containing the input data. This may be the same as the Target Credentials.
You can create a new set of credentials by clicking New and specifying the required information. For more information, see Managing Credentials.
Specify the name of the Amazon S3 bucket and folder that you will use to supply input data, for example, Transformation/in. For more information see Set Up the Input Location.
You can test whether the services can access the input location by clicking Test.
Specify the name of the Amazon S3 bucket that the services will write error logs to, for example, Transformation/logs.
Select the cloud-based data repository where HealthShare Message Transformation Services deposits the transformed FHIR resources. The remaining fields change based on your selection.
Select the credentials that provide HealthShare Message Transformation Services access to the AWS service containing the output data. This may be the same as the Input Credentials.
You can create a new set of credentials by clicking New and specifying the required information. For more information, see Managing Credentials.
Specify the target location identifier:
-
If using an Amazon HealthLake data store, this is the data store identifier, which you can find in the Amazon HealthLake console.
-
If using an Amazon S3 bucket, this is the bucket name and folder. For example, Transformation/out.
You can test whether the services can access the target location by clicking Test.
For more information see Set Up the Target Location.
Transformation Pipeline Statuses
Transformation pipelines can be in one of several states:
A user has created a new pipeline or edited an existing pipeline, and HealthShare Message Transformation Services are performing the operations necessary to activate it.
The transformation pipeline is actively polling the input location for files and transforming data.
A user has deleted a pipeline and HealthShare Message Transformation Services are performing the operations necessary to remove it.
The transformation pipeline cannot access the input location or target location.
If a pipeline is unreachable, you can try editing the Input Credentials or Target Credentials associated with the pipeline. For more information, see Edit a Transformation Pipeline.
Managing Credentials
When you create a transformation pipeline, you specify a set of credentials that enables HealthShare Message Transformation Services to interact with the input location, error logs location, and target location. For these credentials, you may configure cross-account access or provide a pair of keys associated with an AWS IAM user. These methods are described in Provide HealthShare Message Transformation Services with Access to the AWS IAM Policy
You can manage credentials from the HealthShare Message Transformation Services portal.
Add Credentials
To store the credentials in HealthShare Message Transformation Services for use in a transformation pipeline, perform the following steps:
-
In the HealthShare Message Transformation Services menu, click Credentials.
The Credentials page appears.
-
Click New Credentials.
-
Select the Credential Type, and fill in the remaining fields.
-
Selecting AWS key-pair requires the AWS IAM user’s secret access key. If you do not have this, you can create a new AWS IAM user.
-
Selecting Cross Account requires additional setup within the AWS console.
-
Delete Credentials
To delete a set of credentials that you no longer need, perform the following steps:
-
In the HealthShare Message Transformation Services menu, click Credentials.
The Credentials page appears.
-
Locate the credentials to delete in the list.
-
Click the Delete icon for the credentials to delete.
If you delete a set of credentials from the HealthShare Message Transformation Services portal, you cannot create a set of credentials with the same name for seven days.