Release Notes - MR 02.05 - Dec. 12, 2013
Go to downloadable artifacts
Purpose of the Release notes
These Release Notes provide a high level summary of the changes made to the pan-Canadian HL7 v3 artifacts in support of the MR 02.05 release. A detailed description of all of the changes can be found in the corresponding Change Log (SC-3004-EN - Change File - MR02.05 - 20131212). Separate Terminology Release Notes and a Terminology Change Log are also available for this release.
These Release Notes are intended to be used in conjunctions with the other business and technical artifacts published as part of this release.
Stakeholders are strongly encouraged to review the Release Notes prior to exploring the rest of the published artifacts.
Highlights of the Release
The MR 02.05 Release is a planned release to address enhancements and technical corrections identified by pan-Canadian Stakeholders, as well as to upgrade the standard to align with updated versions of terminology (e.g. SNOMED CT and LOINC). This release was developed from a baseline of MR 2009 R02.04.03.
This release also marks an important milestone in the evolution of the development environment employed for creating our future maintenance releases. The new paradigm reflects a strong Model Interchange Format (MIF) focus where the MIF is viewed as a self-documenting source of all truth, all other artifacts (e.g. graphical rendering of the MIF, html relationship models, “doc” rendering for business views, etc.) being viewed as derivatives created by the appropriate rendering plugins. This paradigm, while not fully realized yet, promises a more complete, agile, integrated ecosystem allowing public access to the same tools that generated the release and are unambiguously maintained by the Standards Collaborative.
Following this transition point, the Standards Collaborative will progressively move away from using the V3 Generator suite of tools to using Remixer as a development platform.
For the purposes of business continuity and quality control, the current release has been developed using both avenues, the V3Generator suite of tools as well as the Remixer suite of tools. The go forward strategy for the maintenance activities associated with the pan-Canadian HL7 v3 space is the use of Remixer and a reduction of released artifacts to only those serving as the source of truth, all other artifact generation being relegated to plugins. A decision on this final list of deliverables has not yet been made and is expected to be developed in consultation with the public in early 2014, following the two pan-Canadian releases (CeRx and MR series).
Following the above reasoning, messaging RFCs contained in this release were developed using both HL7 V3 tools and Remixer and the resulting Model Interchange Format (MIF) files were compared to ensure that they were equivalent. The MIF v2 files from both tools have been published with this release, and the Remixer MIFs have been identified as beta. We strongly encourage stakeholders to use the Remixer MIFs and to identify any issues encountered while using these MIFs to the Standards Collaborative.
Remixer
Remixer is an HL7 V3 development tool created by Canada Health Infoway to both develop the pan-Canadian HL7 V3 messages and to allow Jurisdictions to constrain these messages to meet their needs. The Remixer tool currently produces Model Interchange Format files (MIF) in version 2.1.3, and allows for the generation of APIs. A new feature is also being added to Remixer to allow both pan-Canadian standards and Jurisdictional standards to be rendered in HTML format. At the time of the writing of these release notes the HTML rendered standards have been published as an beta release to gather feedback from Stakeholders on their usability and layout.
The Remixer tool does add some enhanced functionality, for example:
There are binding strength (CNE or CWE) discrepancies between models generated by the HL7 V3 tooling and terminology documentations that is a known issue in previous releases. • Where the models reference a concept domain, the source of truth resides in the Terminology Worksheet • Where the model reference a value set, the source of truth resides in the specific model attribute.
Artifacts generated by Remixer are correct in this respect.
The Remixer MIF v2 has been developed to be equivalent to the MIF v2 produced by the HL7 v3 Generator, however there are some known accepted differences between the MIFS generated by the two tools as identified below:
| Remixer MIF v2 | Rationale |
|---|
| Graphic representation graphic links have been removed | The decision to remove the links was reached in consultation with field experts. The Remixer based graphical rendering of the MIF is replacing the Visio view using HTML5 browser technology. This rendering technology (SVG) allows for lossless zoom capabilities providing for a better user experience while also allowing for the navigation of the model. |
| The application attribute in the renderingInformation: is change to ‘Message Re-Mixer to MIF Exporter’ from ‘Visio to MIF transform’ | Reflects the use of Remixer to generate these MIFs |
| Whitespaces are normalized inside xhtml elements and inside the name attribute of <mif:businessName> | Not anticipated to impact stakeholders |
Known Issues
This is a list of known issues that have been identified as part of the development of this release.
| SCWG | FID | Known Issue | Artifact |
|---|
| SCWG 6 | 692 | The Standards Collaborative is currently streamlining release processes to become more responsive to our Stakeholders needs. As a result, there is a need to make changes to the Standards Maintenance processes outlined in Section 10 of the Implementation Guide Volume 0 – Overview guide. | Implementation Guide Volume 0 |
| SCWG 2 | 769 | A bug was encountered in the RMIM Designer version we are using (4.5.1.1) which broke existing models. Act relationship to a choice box was not being represented correctly. This was fixed in RMIM Designer version 4.7.8. These three models were edited using this later version of the RMIM Designer. The entry point for these models now have a “PropertycontextConduction” tag, a feature which was introduced in the later version of RMIM designer, | REPC_MT220001CA, REPC_MT220003CA, REPC_MT230001CA |
| SCWG 6 | 694 | The example messages contain data (e.g. terminology references) that originate from HL7 International and in some cases this information is not a part of the Canadian domain. This is an existing issue with all panCanadian HL7 v3 releases. | All Example Message Instances |
| Remixer | 16345 | Remixer does not currently export the derivedFrom information when new classes and or attributes are created in RM. The derivedFrom node is missing from the Remixed MIFs | Remixer Beta MIF v2 |
| SCWG 6 | 693 | Some MS Word View of the message models references the terminology object type (concept domain or value set) bound by a message attribute incorrectly. Also due to the long name of some concept domains, some text within the message attribute property table are being cut off. In both issues, please refer to the Visio message model for the source of truth | Some Word Views for Message Models |
| SCWG 6 | 695 | A small number of example messages do not validate against the schema. | Example Message Instances |
| SCWG 6 | 696 | The interaction MIFs are inconsistently representing the Receiver Responsibility details. It sometimes show the Trigger event as well as the Interaction and sometimes only the interaction | Remixer Beta MIF v2 and HL7 v3 |
| SCWG 5 | 468 | In certain models the sequence and content of attributes, classes and associations may be different in the Remixer models from the HL7 V3 generated models. The HL7 V3 models are considered to be correct. | POLB_MT004100CA |
| SCWG 2 | 770 | In certain models the sequence and content of attributes, classes and associations may be different in the Remixer models from the HL7 V3 generated models. The HL7 V3 models are considered to be correct. | REPC_MT220001CA
REPC_MT220002CA
REPC_MT220003CA
REPC_MT230001CA
REPC_MT230002CA
REPC_MT230003CA
REPC_MT500003CA |
| SCWG 6 | 697 | Minor differences in the names, descriptions and version number between HL7 V3 and Remixer MIFs. | Interactions MIFs, Message Type MIFs
The MIFs generated by the HL7 V3 generator should be considered the source of truth for this release
SCWG |
| SCWG 7 | 590 | There appears to be a bug within RMIM Designer that prevents proper association of a constraint with an attribute. This occurred in PRPA_MT101001CA - Add Client but NOT in PRPA_MT101002CA - Revise Client. The work- around used was to add the constraint text, "ONLY allow a value to be associated with multipleBirthOrderNumber if the multipltBirthInd is 1." to an existing class constraint associated with the Person class. | PRPA_MT101001CA – Add Client |
| Artifacts | Tools |
|---|
| Master Terminology Worksheet | Excel 2010 |
| Terminology Reference to Message Models | FindVocabUsage.xslt v13332 |
| Vocabulary Model Interchange Format (MIF) | MTW Conversion.xls v22434 ExpandCAUVSchema.xslt v18104 |
| Model MIF-2 View Remixer (beta) | Remixer v3.0.1rc10 |
| Model MIF-1 View | HL7 V3 Generator 3.2.2_20100219CA |
| Model MIF-2 View | HL7 V3 Generator 3.2.2_20100219CA |
| XML Schemas | HL7 V3 Generator 3.2.2_20100219CA |
| Message Worksheets Excel (xls) view | HL7 V3 Generator 3.2.2_20100219CA HL7_RMIM_HMD_master-v2.26 Excel 2010 |
| Message Worksheet Table View | HL7 V3 Generator 3.2.2_20100219CA |
| Models – Visio View | Visio 2007, RMIM Designer 4.7.1 + a required fix made by the SC and submitted to HL7 International as bug 1966 RoseTree 5.0.20 |
| Models – Word View | Generatedocs.doc v21852 |
| Sample Messages | Eclipse Instance Editor |
| Additional Tools Used as part of the generation process | PubDB_v205.mdb HL7 Description Editor v-1.3.4 HL7 Publishing Widget v-5.0.25 ExportGraphics.vsd v1159 |
RIM Repository – Vocabulary: 2.41.2
RIM Repository – Structure: 2.19