ChatGPT 4o answer 2024

Certainly! Transforming an HL7 v2.4 ADT_A01 message to a FHIR R4 Patient resource in Mirth Connect requires familiarity with both HL7v2 and FHIR message structures. Below, I’ll guide you through the steps to set up a transformation channel in Mirth Connect to map an ADT_A01 message to a FHIR R4 Patient resource.

Prerequisites

1. Mirth Connect installed and configured.
2. Knowledge of the structure of HL7 v2.4 ADT_A01 messages.
3. Understanding of the FHIR R4 Patient resource JSON structure.

Step 1: Set up the Mirth Connect Channel

1. Create a New Channel in Mirth Connect and name it something like ADT to FHIR Transformation.
2. Set the Source Connector to accept HL7v2 messages. This could be configured as a TCP Listener, File Reader, or other suitable source connector depending on your input source.
3. Set the Destination Connector to output JSON (FHIR format). You may want to use a REST API, File Writer, or Database Writer, depending on the destination requirements.

Step 2: Configure the Source Transformer

1. Go to the Source Transformer in your Mirth channel and add a new step.
2. Choose JavaScript as the type for your transformation step.

Step 3: Write JavaScript for Transformation

Add the following JavaScript code to transform the HL7 ADT_A01 message to FHIR R4 Patient JSON:

// Initialize the FHIR Patient resource
var patientResource = {
  resourceType: "Patient",
  id: $('MSH-10'),  // Unique identifier from MSH segment
  identifier: ,
  active: true,
  name: [
    {
      use: "official",
      family: $('PID-5.1'),  // Last Name
      given:   // First Name
    }
  ],
  telecom: ,
  gender: $('PID-8') === 'M' ? 'male' : 'female',  // Gender mapping
  birthDate: DateUtil.formatDate($('PID-7'), 'yyyyMMdd', 'yyyy-MM-dd'),  // DOB with format change
  address: [
    {
      use: "home",
      line: ,  // Address line
      city: $('PID-11.3'),  // City
      state: $('PID-11.4'),  // State
      postalCode: $('PID-11.5')  // ZIP/Postal Code
    }
  ]
};

// Add managing organization if available
if ($('PV1-3.1')) {
  patientResource.managingOrganization = {
    reference: "Organization/" + $('PV1-3.1')  // Organization reference
  };
}

// Convert the JavaScript object to JSON
var fhirPatientJson = JSON.stringify(patientResource, null, 2);

// Map the JSON output to the destination
msg = fhirPatientJson;

Explanation of the Transformation Code

• Resource Initialization: The patientResource object is initialized with the necessary FHIR R4 Patient resource fields.
• Identifier: The identifier is mapped from PID-3.1 (MRN), with a sample OID for the system.
• Name: The name fields use PID-5 for last and first names.
• Telecom: Phone and email details are mapped from PID-13.
• Gender: The gender field maps ‘M’ and ‘F’ to ‘male’ and ‘female’, as per FHIR requirements.
• Birth Date: Formats the birth date from yyyyMMdd (HL7) to yyyy-MM-dd (FHIR).
• Address: Maps address components from PID-11.
• Managing Organization: Maps organization information if present from PV1-3.

Step 4: Configure the Destination Connector

1. Go to the Destination Connector and set the data type to JSON if you’re outputting JSON directly.
2. Use msg as the output variable, as it contains the JSON representation of the FHIR Patient resource.
3. Configure the destination endpoint (such as REST API URL or file location) to send the transformed JSON message to your FHIR-compliant system.

Step 5: Test the Channel

1. Deploy the channel and send a test ADT_A01 HL7 message to verify the transformation.
2. Check the output in your configured destination to ensure that the JSON format conforms to FHIR R4 standards.

Additional Notes

• Testing and Validation: Use FHIR validators or online tools to ensure the output JSON complies with FHIR R4 standards.
• Enhancements: You may want to add error handling and additional mappings depending on specific fields in your ADT message or FHIR implementation requirements.

This setup will transform an incoming HL7 v2.4 ADT_A01 message into a FHIR R4 Patient resource, ready to be consumed by a FHIR-compliant system.

For your inspiration here we share the first two Promts we experimented with at Meditecs (source)

Question: Can you create a sample transformation converting HL7 v2.4 to FHIR R4 in Mirth integration engine?

ChatGPT answer in 2024

Creating a transformation to convert HL7 v2.4 to FHIR R4 in the Mirth integration engine requires mapping each relevant HL7 segment to its corresponding FHIR resource format. Below is a sample JavaScript transformation script for Mirth Connect, focusing on patient demographics from an HL7 ADT (Admit, Discharge, Transfer) message to a FHIR Patient resource.

// Initialize FHIR Patient Resource
var patientResource = {
  resourceType: "Patient",
  identifier: [],
  name: [],
  telecom: [],
  gender: "",
  birthDate: ""
};

// Map HL7 PID Segment to FHIR Patient Resource
var pid = msg;

// Patient Identifier (from PID-3)
if (pid.toString()) {
  patientResource.identifier.push({
    use: "usual",
    system: "urn:oid:1.2.36.146.595.7.3.1.1",
    value: pid.toString()
  });
}

// Patient Name (from PID-5)
if (pid.toString()) {
  patientResource.name.push({
    use: "official",
    family: pid.toString(),
    given: [pid.toString()]
  });
}

// Telecom - Phone Number (from PID-13)
if (pid.toString()) {
  patientResource.telecom.push({
    system: "phone",
    value: pid.toString(),
    use: "home"
  });
}

// Gender (from PID-8)
switch (pid.toString()) {
  case 'M':
    patientResource.gender = "male";
    break;
  case 'F':
    patientResource.gender = "female";
    break;
  default:
    patientResource.gender = "unknown";
}


// Output FHIR Patient Resource as JSON
return JSON.stringify(patientResource, null, 2);

Explanation of Key Transformations

1. Identifier (PID-3): Maps the patient identifier from HL7 to the identifier array in the FHIR Patient resource.
2. Name (PID-5): Constructs the name array with family and given names.
3. Telecom (PID-13): Adds the patient’s phone number to the telecom array.
4. Gender (PID-8): Translates gender values (M/F) from HL7 to FHIR-compliant terms.
5. Birth Date (PID-7): Reformats the birth date from HL7 to the FHIR YYYY-MM-DD format.

Additional Notes

• Ensure that the Destination Connector is configured to send or store the JSON output.
• You may need to modify or expand the script to cover other segments (e.g., visit information) depending on your integration requirements.

Would you like an example covering additional HL7 segments or a different FHIR resource?

Feel free to comment and upvote, and of course upload your own Prompt to win!