Difference between revisions of "Naming Conventions"

From HL7 TSC
Jump to navigation Jump to search
Line 4: Line 4:
 
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 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 ''''.
+
The naming construct is described below using a notation of {required} or [optional] with literals expressed in '''''bold italics '''''.
  
  
Line 20: Line 20:
 
*HL7/Other [such as NCPDP] indicating an HL7 document published in conjunction with another organization           
 
*HL7/Other [such as NCPDP] indicating an HL7 document published in conjunction with another organization           
 
|-
 
|-
−
|'''[Reaffirmation of] '''||""|           
+
|'''''[Reaffirmation of] '''''||""|           
 
|-
 
|-
 
| {||One or more of the following 3 line items required  
 
| {||One or more of the following 3 line items required  
 
|-           
 
|-           
−
| [Family Name] [Product Type] [<b><i>Release</b></i> [Release Number]] :
+
| [Family Name] [Product Type] ['''''Release''''' [Release Number]] :
 
|The standard family names are  
 
|The standard family names are  
 
*Version 2.x (V2.x);  
 
*Version 2.x (V2.x);  
Line 44: Line 44:
 
The TSC may, at their discretion, declare additional product types.
 
The TSC may, at their discretion, declare additional product types.
 
|-   
 
|-   
−
|align="right"| [Sub-family Name] [Product Type] [<b><i>Release</i></b> [Release Number]] ;
+
|align="right"| [Sub-family Name] [Product Type] ['''''Release''''' [Release Number]] ;
 
|align="left"|Subfamily names are specific to a given family and are not further defined in this document.           
 
|align="left"|Subfamily names are specific to a given family and are not further defined in this document.           
 
|-
 
|-
−
|align="right"|[Product Name], [<b><i>Release</b></i> [Release Number]]||""|           
+
|align="right"|[Product Name], ['''''Release''''' [Release Number]]||""|           
 
|-
 
|-
 
| } ||""|  
 
| } ||""|  

Revision as of 23:09, 26 January 2016


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) 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
Retrieved from "https://tscwiki.hl7.org/w/index.php?title=Naming_Conventions&oldid=16552"