Skip to main content

Introducing InterSystems FHIR Transformation Services

InterSystems FHIR Transformation Services enables you to automate the transformation of healthcare data in formats such as HL7 v2, C-CDA, or SDA3 into FHIR R4 resources.

HL7 v2, or Health Level Seven version two, is a messaging standard for health and medical transactions.

C-CDA, or Consolidated Clinical Document Architecture, is an XML-based standard for 11 common types of clinical documents.

SDA3, or Summary Document Architecture, is an InterSystems format used to represent healthcare data. Also XML-based, it is frequently used as an intermediary format when transforming healthcare data from one format to another.

By using FHIR Transformation Services, you can easily operate on data from different sources and disparate data exchange standards. The services are built on the core capabilities of InterSystems IRIS for Health for seamless conversion and delivery of healthcare data.

FHIR Transformation Services can receive healthcare messages from an Amazon S3 bucket and send the resulting FHIR resources to an S3 bucket (either the same bucket or different bucket) or to a FHIR database, such as InterSystems FHIR Server.

If you want to subscribe to FHIR Transformation Services, please contact usOpens in a new tab.

Once you have subscribed to FHIR Transformation Services, follow these easy steps in this introduction to get up and running.

For information on the day-to-day management of FHIR Transformation Services, see FHIR Transformation Services Reference Information.

To learn how a development team can work together using FHIR Transformation Services, see Tenants PageOpens in a new tab.

Log in to the Cloud Services Portal

If you have an account in the Cloud Services PortalOpens in a new tab, log in to the portal.

If you do not have an account, sign up for one, as follows:

  1. In your browser, go to the Cloud Services Portal create new account pageOpens in a new tab.

  2. On the Create a New Account page, enter the requested information, and click Create Account.

  3. Type the verification code sent to the email account you provided, and click Submit.

After you create your new account, you are logged into the Cloud Services Portal.

Sign Up for InterSystems FHIR Transformation Services

You can create a InterSystems FHIR Transformation Services subscription from the Cloud Services page of the Cloud Services Portal.

To subscribe to InterSystems FHIR Transformation Services:

  1. In Cloud Services Portal, on the main menu, click Cloud Services.

    The Cloud Services page shows you any active subscriptions you have to InterSystems cloud services and allows you to sign up for additional services.

  2. On the InterSystems FHIR Transformation Services card, click Subscribe.

  3. On the Subscribe page, read the pricing information and subscription options, and then Subscribe using the method of your choice.

    If you subscribe to InterSystems FHIR Transformation Services with InterSystems, we will bill you directly. If you subscribe with your current cloud provider, billing and subscription management are handled through your account with that cloud provider.

You can also subscribe to InterSystems FHIR Transformation Services and other InterSystems cloud services directly from the AWS MarketplaceOpens in a new tab.

When you subscribe to InterSystems FHIR Transformation Services, the subscription is tied to your Cloud Services Portal account and your default tenantOpens in a new tab.

Create a Deployment

Once you have signed up for InterSystems FHIR Transformation Services, you are ready to deploy it in the cloud.

Note:

If you have just subscribed to InterSystems FHIR Transformation Services in the AWS Marketplace, you may need to wait a few minutes for the subscription to be finalized. You can check to see if this has occurred by checking the Cloud Services page in the Cloud Services Portal and seeing if InterSystems FHIR Transformation Services is listed under Active Subscriptions.

Creating a deployment also includes setting up an initial configuration for the interface between Amazon S3 and FHIR Transformation Services. However, you can edit these settings later.

If you would like FHIR Transformation Services to send its output to an InterSystems FHIR Server, you must deploy FHIR Server and create an API key first.

To create an InterSystems FHIR Transformation Services deployment:

  1. On the main menu, click Deployments.

  2. On the Deployments page, click Create New Deployment.

  3. On the Create InterSystems IRIS Deployment page, in the Deployment Options section:

    1. Under HealthShare Services, select InterSystems FHIR Transformation Services.

    2. Under Transformation Type, select a transformation. (HL7 v2 to FHIR R4 is currently the only choice.)

    3. Under FHIR Transformation Services Configuration, in the Input Properties section, specify the following properties:

      Input S3 Bucket — The S3 bucket where FHIR Transformation Services will look for messages.

      Input S3 Prefix — The complete input S3 prefix, for example, <folder>/<subfolder>

    4. Under FHIR Transformation Services Configuration, in the Output Properties section, select the Target Type.

    5. If the Target Type is FHIR Server, specify the following properties:

      API Key — The FHIR Server API Key, which you can find on the Credentials pageOpens in a new tab of your FHIR Server deployment

      Endpoint — The FHIR Server Endpoint, which you can find on the Overview pageOpens in a new tab of your FHIR Server deployment

      Bundle Mode — Select Transaction. This is the only option currently supported.

    6. If the Target Type is S3 Bucket, specify the following properties:

      Output S3 Bucket — The S3 bucket where FHIR Transformation Services will place the FHIR R4 bundles after transformation

      Output S3 Prefix — The complete output S3 prefix, for example, <folder>/<subfolder>

      Bundle Mode — Regardless of whether you choose Individual or Transaction, each input message is transformed into a single bundle of FHIR resources.

    7. Select the desired Error Behavior that occurs when FHIR Transformation Services encounters a message that cannot be successfully processed:

      Ignore — Continue processing messages (default).

      Pause — Pause processing until the error in the message is resolved by the user.

    8. Select the desired Archive Strategy for messages that are successfully processed:

      Delete — Delete source messages after transformation (default).

      Ignore — Leave source messages where they are after transformation.

      Archive — Move source messages to an archive folder after transformation.

    9. Click Continue.

  4. In the Cloud Options section:

    1. Under Cloud Provider, select a provider. (AWS is the only provider currently available.)

    2. Under Region, select a region.

      The FHIR Transformation Services deployment needs to be located in the same region as your input S3 bucket.

    3. If this is the first time you are creating a deployment in this region, click Activate.

      Note:

      It takes a few minutes to activate a region. If creating the deployment is not successful, wait a few minutes and try again.

    4. Click Continue.

  5. In the Deployment Name section:

    1. Type a name for your deployment. This cannot be changed once created.

    2. Click Continue.

  6. In the Review section:

    1. Review the summary information.

    2. Click Create.

It takes a few minutes to deploy FHIR Transformation Services. When the deployment has been created, the status under the deployment name changes from CREATING to COMPLETE.

Click the card for the deployment to go to the Overview page for your new deployment. This page contains summary information, including your deployment's Deployment ID. The Deployment ID uniquely identifies your deployment.

Other actions are available by clicking the action menu at the top right of the card, such as setting the Service Level for the deployment or deleting the deployment. For more information, see Deployments pageOpens in a new tab.

To read about all of the tasks you can perform on this deployment using the Cloud Services Portal, see Reference Information.

For information on setting up Amazon S3, see Configure Amazon S3 Buckets.

For information on using FHIR Transformation Services to transform healthcare data, see Transform Healthcare Data into FHIR Resources.

Configure Amazon S3 Buckets

Once you have subscribed to InterSystems FHIR Transformation Services and created a deployment, use the configuration steps below to configure Amazon S3. You will need to have access to the console of your Amazon AWS account.

  1. On the Amazon S3 page of the AWS Console, create an input S3 bucket in the same AWS region as your FHIR Transformation Services deployment (or have a preexisting S3 bucket in that region).

  2. If you would like to use a different bucket to hold the transformed FHIR data, create an output S3 bucket in the same AWS region as your FHIR Transformation Services deployment (or have a preexisting S3 bucket in that region).

  3. If you would like to send the FHIR data to InterSystems FHIR Server, deploy FHIR Server and create an API key.

  4. Configure the relevant S3 interface settings when you create a FHIR Transformation Services deployment or from the Configurations page of the deployment.

  5. On the Amazon S3 page of the AWS Console, apply a bucket policy to the input S3 bucket using information on the Configurations page. (If you are sending FHIR output to an S3 bucket different from the input bucket, apply a policy to the output S3 bucket, as well)

  6. On the Configurations page, activate a trigger on the input S3 bucket to notify FHIR Transformation Services when data is placed into the bucket.

Transform Healthcare Data into FHIR Resources

Once you have configured Amazon S3, FHIR Transformation Services will automatically pick up healthcare messages from the input S3 bucket, transform them, and place the FHIR bundles in the output S3 bucket or send the FHIR output to the FHIR Server. The FHIR resources created for one incoming message are packaged into a single FHIR bundle, in JSON format.

After a source message is successfully processed, it is handled according the Archive Strategy setting specified on the Configurations page:

  • Delete — Delete source messages after transformation (default).

  • Ignore — Leave source messages where they are after transformation.

  • Archive — Move source messages to the archive folder of the input S3 bucket after transformation.

If any errors are detected during the transformation process, the source message is moved to the errors folder of the input S3 bucket. You can review and resolve the error on the Errors page.

After an error is detected, processing proceeds according the Error Behavior setting specified on the Configurations page:

  • Ignore — Continue processing messages (default).

  • Pause — Pause processing until the error in the message is resolved by the user.

FeedbackOpens in a new tab