Topic outline

  • Building Your First HL7 Production

    Need to build productions in InterSystems HealthShare® Health Connect to route messages between systems?

    Follow this learning path to get an introduction to InterSystems® products, learn about the integration architecture and data transformations of Health Connect, and perform basic error handling and troubleshooting to test out your productions.

    If you would like to learn the same process using InterSystems IRIS for Health™, see Building Your First HL7 Production with InterSystems IRIS for Health.
    • Introduction to Ensemble and HealthShare Health Connect

      Before you start developing an HL7 production, it is good to understand how the different InterSystems products and technologies work together to provide the foundation of our integration architecture and larger healthcare solutions.

    • How do I use Health Connect as an integration engine?

      In the following online course, you will learn about the underlying architecture for integrations. You will explore the parts that make up a production, how these parts interact with each other, and common production workflows. Understanding the architecture and associated terms will give you the framework needed to discuss details about your integration solutions and will set the stage for the rest of this learning path.

    • How do I set up HL7 business services and business operations?

      Being able to receive and send HL7 messages is critical to the integration of systems at your workplace. In the following online course, you will learn about HL7 business services (which receive messages) and business operations (which send messages) in a production. You will also see how to add these components to a production, copy an existing component, and configure the most common settings for these components.

    • What are message routers and how do I create one?

      When developing HL7-based integrations, one of the primary requirements is to efficiently route messages from multiple sources to multiple downstream systems. This section of the learning path explains what HL7 message routers are, how to create one, and how to create HL7 rules that are used in message routers.

      In the following video, you will learn how to create a message router and build rules that route messages based on both the attributes and contents of a message.

    • What are data transformations and how do I build one?

      There are many times when the simple routing of messages from one system to another is not enough. Many HL7 messages need to be transformed to remove data that is not needed in the receiving system, or to reformat the message to match the receiving system's requirements.

      Data transformations ensure that downstream systems receive data in the correct format, regardless of the way that the data originally comes into the integration. In the following online course, you will learn the basics of building a data transformation using the graphical user interface in the Management Portal. This includes what a data transformation is, how to map fields from one message type to another, how to use both set and if actions, and how to concatenate fields and use functions.

    • How do I search for messages?

      While testing your production, you may find that you need to find a particular message in your system. For example: 

      • Perhaps you want to compare messages coming into versus out of the message router to ensure the correct actions are taking place. You could search for a message based on criteria such as time stamp, source business component, or target business component.
      • You may discover that your business operation is trying to send a message to a downstream system that is being rejected due to its formatting. To fix this problem, you may want to find this particular message to determine what the incorrect format is and change it appropriately.

      How can you find these message to figure out what happened and resend them? In this course, you will learn how to access the Message Viewer and search for, save, and resend messages.

    • How do I troubleshoot productions?

      Now that you are comfortable routing messages, building rules-based productions, and transforming data within HL7 messages, what do you do when things go wrong? The following resources will help you troubleshoot your production. You will learn about some of the key Management Portal pages that can help you investigate and determine how to fix some of the problems that may arise.

    • How do I design productions for a development environment?

      Now that you know how to create and modify an HL7 production, you will learn how to design a new production for a development environment.

    • Final Exercise

      In this exercise, you will move from a legacy system to HealthShare Health Connect and create an HL7 production based on a set of specifications. You will use a “build to the output” approach to create an interface that outputs the same messages as the legacy system

    • How do I provide feedback on this learning path?

      Thank you for completing this learning path. To assist us in making this as helpful as possible for future learners, please complete the reviewer survey by selecting the link below. Don't forget to click Done at the end to submit your responses.