Ensemble HL7 Version 2 Development Guide - InterSystems ...

Elements of a Routing Production
Ensemble provides a built-in schema category definition for each published version of the HL7 standard.
These HL7 category definitions can be viewed and edited in XML format by opening the corresponding
.HL7 file in Ensemble Studio. Each .HL7 file consists of a set of XML statements which define the
HL7 messages.
To create your own custom schema category, simply create a new .HL7 file and add XML statements
to it. You can do this by creating a new file or copying an existing file, as follows:
1. Start Ensemble Studio and change to an Ensemble-enabled user namespace.
Important:
InterSystems recommends that you do not place custom code or data in the systemprovided
namespaces ENSLIB or ENSDEMO where it will be deleted the next
time you upgrade Ensemble. The ENSEMBLE namespace and any new namespace
that you create to hold your work is preserved across Ensemble upgrades.
2. From the File menu, choose New.
3. The New dialog displays. Select the Custom tab.
4. Select the HL7 Schema icon and click OK.
5. Enter a New Schema Name. This is the name of the new schema. When you save the
schema definition, it becomes the name of the new *.HL7 file.
6. Enter a Base Schema Name. Specify the name of the schema base. Use one of the
built–in categories: 2.1, 2.2, 2.3, 2.3.1, 2.4, or 2.5.
7. Click OK.
If you have already created a custom schema category that matches your requirements closely, you
might prefer to copy and edit this custom schema instead of creating a new custom schema. Use the
following steps:
1. Open any existing custom schema category file as follows:
• Start Studio.
• Select File Open.
• For the Look in field choose an Ensemble-enabled user namespace.
• In the Files of type field select All files.
• In the File name field enter the extension *.hl7 or *.HL7. The names of several schema
category files appear.
• Select an existing custom schema category file as the model for your new file. Do not select
any of the built–in schema category files (2.1.HL7, 2.2.HL7, 2.3.HL7, 2.3.1.HL7,
2.4.HL7, or 2.5.HL7). If there are no custom schema category files to choose from, create
a new file as described in the previous procedure.
32 Ensemble HL7 Version 2 Development Guide