Naming Conventions

From HL7 TSC
Jump to navigation Jump to search

Excerpt and paraphrase from HL7 Governance and Operations Manual (GOM) 12.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/Other [such as NCPDP] indicating an HL7 document published in conjunction with another organization
  • HL7 indicating a Health Level Seven International document
[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®);
  • where a document includes reference to two or more family names it may be identified as a Cross Paradigm Specification.

In the case of a Standard or Standard for Trial Use (STU) the full family name shall be used; e.g. Fast Healthcare Interoperability Resources or Clinical Document Architecture®. In lieu of the full family name the appropriate acronym may be used for Implementation Guides, Profiles, and other documentation.

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