Naming Conventions

From HL7 TSC
Revision as of 12:51, 27 January 2016 by Llaakso (talk | contribs)
Jump to navigation Jump to search

Excerpt and paraphrase from HL7 Governance and Operations Manual (GOM) 12.02.02 01 Constructing Other HL7 Ballot and Protocol Specification Names and HL7 Essential Requirements (HL7 ER) 02.01.01 Constructing Normative Ballot and Protocol Specification Names The full document name shall begin with an organizational identifier followed by family name, product type and release number with a subfamily name, product type and release number, if applicable, then the product name and release number followed by the realm designation, if applicable, and the ballot type and number. In the case of a reaffirmation ballot the term “Reaffirmation of” shall precede the family name.

The naming construct is described below using a notation of {required} or [optional] with literals expressed in bold italics .

Ballot Document Name and Information
Structure Comments
{Organization Identifier} Organization Identifier shall be:
  • HL7 indicating a Health Level Seven International document
  • HL7/Other [such as NCPDP] indicating an HL7 document published in conjunction with another organization
[Reaffirmation of]
{ One or more of the following 3 line items required
[Family Name] [Product Type] [Release [Release Number]] : The standard family names are
  • Version 2.x (V2.x);
  • Version 3 (V3) [note: V3 itself does not have a release number, although each of its products typically will];
  • Clinical Document Architecture® CDA®) [note: CDA shall be further designated as R1 or R2];
  • Electronic Health Records System-Functional Model (EHRS-FM);
  • Fast Healthcare Interoperability Resources (FHIR® is the preferred designation);
  • where a document includes reference to two or more family names it may be identified as a Cross Paradigm Specification.

Product types are defined as

  • Specification or Standard;
  • Domain Analysis Model (DAM);
  • Functional Model (FM);
  • Functional Profile (FP);
  • Implementation Guide (IG);
  • Logical Model [note: a Logical Model is not a Cross Paradigm Specification];
  • and Profile.

The TSC may, at their discretion, declare additional product types.

[Sub-family Name] [Product Type] [Release [Release Number]] ; Subfamily names are specific to a given family and are not further defined in this document.
[Product Name], [Release [Release Number]]
[ - Realm Designation] HL7 Version 3 Standard > Vocabulary > HL7 Value Sets > HL7 Realm