Vocabulary and RIM Harmonization Process

Background and Objectives

When HL7 first considered developing a single Reference Information Model (RIM) for use in all of the HL7 technical committees (as they were then known), it adopted a process of "RIM Harmonization" to assure that:

• There was a formal process for review and adoption of change proposals
• The process would include representation from all interested groups within HL7
  • (and from external Standards Development Organizations (SDOs) that wished to collaborate)
• The representatives would reach consensus before approving a proposal
• An updated, documented, "approved" RIM would be available at each HL7 Working Group Meeting to allow progress on the RIM-based standards being developed in HL7

The first Harmonization Meeting was held July 8 & 9, 1997 in Indianapolis, Indiana. Since then there has been at least one "interim" Harmonization Meeting between each pair of Working Group Meetings. By 1999, when Vocabulary content became part of the core definition of the RIM classes, the scope was extended to include Vocabulary, and this dual responsibility has remained ever since.

Approval Process

As with all formal processes, a formal declaration of the Harmonization Meeting and their purpose is issued with at least 30-days advance notice. The specific scheduled date of these meetings is determined well in advance of the meeting and no later than the end of the Working Group Meeting prior to the Harmonization Meeting. In general, the harmonization schedule is published as part of the Publishing Calendar posted on the HL7 web site.

When the Meeting is formally announced, the details are listed and the proposal posting service is enabled on the Harmonization Event page on the HL7 web site.

Submission Process and Schedule

Change proposals for the HL7 RIM and Vocabulary content must be documented with the submission template provided on the Harmonization page. The template and its package:

• indicates the purpose of each field
• shows which fields are required
• provides a check list for submissions, and
• provides an example.

Proposals are submitted through the Harmonization page. When posted, they are given a unique name, they are added to the posted list of proposals, and a notice of posting is sent to the HL7 Harmonization List Server. Interested parties should subscribe to the Harmonization list.

Initial Proposal Deadline

The deadline for initial proposal submission is set for 11:59 PM (Eastern time) on the Sunday four weeks or more before the scheduled Harmonization Meeting. The e-mails to the Harmonization list constitute the "Agenda Notice" for substantive items to be considered at the meetings.

Initial Proposal Rules:

1. Proposals must be received from a Work Group that has "standing" in the forthcoming meeting (see Representation discussion below)
2. Initial proposals not received by this date will not be scheduled for review in the Harmonization Meeting
3. In order to be acceptable (see Technical Review below), the proposal must be sufficiently complete and correct that it could be implemented from the information in the proposal, once approved.
4. If endorsement of the proposing Work Group is not yet final, such endorsement must be completed before the Final Content Deadline and the endorsement must not change the proposal in such a way as to alter the scope and intent, as expressed in the initial proposal, except by reducing its scope.

Technical Review

Within ten days of the Initial Content Deadline, a Technical Review Panel will be convened to assess the completeness and correctness of the proposals received. The panel is made up of representatives from the MnM, Vocabulary, International, and individuals who must "implement" the proposals.

The objective of the Technical Review is to evaluate each of the proposals against the "rules" cited above, particularly the rule on being compete and correct. Since this is a technical review, the group will not evaluate proposals for the acceptability correctly expressed content.

As a result of their deliberations, the Technical Review will find each proposal as:

• Accepted for review as stands;
• Accepted with Mod - seeking minor additions or corrections as part of a "Final Proposal"
• Rejected as Incomplete for review because, in the judgment of the reviewers, the proposal could not have been readily implemented based in the Initial Proposal.
• Rejected as Without Status for the meeting because the proposal was received late, or because the proposal was not from a Work Group with standing at Harmonization.

If a proposal is "Rejected" in this review, it will not be scheduled on the Harmonization Agenda. This ruling can be appealed at the Harmonization Meeting in order to seek to have the proposal reinstated.

If a proposal is "Accepted", it will be scheduled on the Harmonization Meeting agenda. If it is listed as "Accepted with Mod", the proposing committee is expected to correct the proposal and resubmit it before the Final Proposal Deadline in order to address the concerns from Technical Review.

Final Proposal Deadline

The deadline for initial proposal submission is set for 11:59 PM (Eastern time) on the Sunday one week or more before the scheduled Harmonization Meeting. Any proposal that was received prior to the Initial Proposal Deadline may be updated by the proposing work group. The rules for what constitute acceptable changes or content for "final" proposals follows.

Final Proposal Rules:

1. The endorsement of the proposing committee MUST be documented.
2. Changes requested from Technical Review must have been made.
3. Other changes are acceptable so long as the fundamental intent and scope of the proposal is not unaltered, except for a reduction in scope.

Harmonization Meeting

Prior to the meeting, the Final Proposals will be assembled and packaged along with a spread sheet to establish the agenda and facilitate review. Meetings are held during conference calls (supported by GoToMeeting screen-sharing) of four hours duration comprised of two sessions with a mid-meeting break. At the beginning of each session, the quorum and voting roles will be established and documented. At the beginning of the first session on the first day, the floor will be "open" for appeals to "rejections" during Technical Review.

Amendment During Meeting

A primary factor in the success of the Harmonization process to date has been the ability to reach true consensus during the discussions. This is only possible because the proponent has the opportunity to amend a proposal during review in order to meet concerns and issues raised by other participants.

In the past, the vast majority of proposals have been modified in some fashion during the meeting. Most modifications have been minor, but some have involved substantial re-factoring of a solution. In general, the intent and scope of the proposal is not changed, except perhaps to reduce scope.

Proponent Presence Required During Review

In order for the consensus process and amendment to work, the it is essential that a representative of the proposing Work Group be present and that person be authorized to accept such amendments to the proposals. For that reason,

• NO proposal will be considered during the meeting unless a representative of the proposing Work Group is present throughout the discussion and voting

Adoption and Publication

As soon as possible after the meeting the results of the meeting - amended proposals, spread sheet documentation of actions and minutes will be assembled and distributed through the Harmonization page.

Prior Page Content and History

This Page was initiated by Russ Hamm May 17, 2010

I moved two prior Harmonization-related sub-items (that had been listed under MnM on the "Main page") here, because as this page is completed, this is where those links belong. GWBeeler

• Harmonization Wiki Template

  This template came into being in 2006, but has never been formally used as a harmonization source path. I (GWBeeler) suggest this be dropped for the following reason(s):

  • The current proposal management process is highly dependent upon being able to extract 'specific data fields from the Word document, and the Wiki template has no facilities that lend themselves to reliable automated parsing.
  • We should focus current improvements on the updating of the Word "template"

• Vocabulary Harmonization Tool

  The Vocabulary Maintenance Language remains a main-stay of vocabulary harmonization processing, but the specific tool linked from here has no active users, and therefore, I (GWBeeler) suggest this link be dropped.