Altova MapForce 2023 Enterprise Edition

MapForce includes support for mapping data to or from HL7 version 3 documents. Specifically, you can map data from any component type supported by your edition of MapForce to HL7 3.x instance files, or vice versa.


The HL7 version 3 standard is based on XML, unlike the HL7 version 2. Therefore, you can add HL7 version 3 components to the mapping in the same way as adding any other XML schema. Note that MapForce does not install any HL7 version 3 schemas by default. However, you can download and install the HL7 version 3 schemas separately, by following the instructions below.


To install the HL7 version 3 XML schemas:


1.Download the package called "HL7 EDI Configuration Files" from the "MapForce Libraries" page at the Altova download center, Be aware that this package includes both HL7 version 2 configuration files (which are EDI-based) and HL7 version 3 XML schemas.

2.Double-click the downloaded executable file and follow the installation wizard steps.

3.When prompted to choose a setup type, select Custom, and then click Next.

4.Choose to install the HL7 version 3 schemas, for example:



After installation, the HL7 version 3 XML schemas are available in the following directory: C:\Program Files\Altova\Common2023\Schemas\hl7v3.


Note:If you use 32-bit MapForce on a 64-bit operating system, adjust the path above to C:\Program Files(x86)\Altova\Common2023\Schemas\hl7v3.


Once you have installed the HL7 version 3 XML schemas, you can start a mapping as follows:


1.Run MapForce.

2.On the Insert menu, click XML Schema/File.

3.Browse for the schema file. You can select for example, the PRPA_IN101301UV02.xsd file from the installation directory above.

4.When prompted to supply the instance file, select the HL7 version 3 instance file corresponding to the message type selected previously if you would like to read data from it and map it to some other format. Otherwise, if you plan to generate the instance file (not read data from it), click Skip.


You have now added the HL7 version 3 component to the mapping, and can proceed to designing the actual mapping connections. For an introduction to designing mappings with MapForce, see the Tutorials.


An example mapping that converts data from an HL7 version 2.6 file to HL7 version 3 file is available at the following path: <Documents>\Altova\MapForce2023\MapForceExamples\HL7V260_To_HL7V3.mfd. A fragment of this mapping is illustrated below.


In the mapping illustrated above, the source component is an HL7 version 2.6 instance file. To add such components to the mapping, select the menu command Insert | EDI, and then select the required message types from the "HL7" group. This is an EDI component; you can view or change the instance file and other settings pertaining to this component by double-clicking the component's title bar, see also EDI Component Settings.


The target component is an HL7 version 3 instance file. This is an XML component, as already stated above, and you can add such components to the mapping by selecting the menu command Insert | XML Schema/File. For reference to all the settings that you can change for XML components, see XML Component Settings.

© 2016-2022 Altova GmbH