This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "Requirements-Terminology Model"

From HL7Wiki
Jump to navigation Jump to search
Line 31: Line 31:
 
| Because of the vast number of code systems, value sets, mappings and other terminology artifacts that will exist and the wide variety of organizations that create and maintain those artifacts, it is unrealistic to expect that all terminology artifacts could possibly be encompassed or published within a single model.  Multiple models are inevitable.  However, most models will have dependencies on contents that are in turn defined within other models.  (In some cases, the dependencies may be circular).  Understanding the models a given terminology model depends on is therefore essential to being able to use that model.
 
| Because of the vast number of code systems, value sets, mappings and other terminology artifacts that will exist and the wide variety of organizations that create and maintain those artifacts, it is unrealistic to expect that all terminology artifacts could possibly be encompassed or published within a single model.  Multiple models are inevitable.  However, most models will have dependencies on contents that are in turn defined within other models.  (In some cases, the dependencies may be circular).  Understanding the models a given terminology model depends on is therefore essential to being able to use that model.
 
|-
 
|-
| '' Methodology''  
+
| '' MIF''  
 
| mif-vocabulary-model.xsd/VocabularyModel  
 
| mif-vocabulary-model.xsd/VocabularyModel  
 +
|}
 +
 +
 +
{| border="2" cellspacing="0" cellpadding="3" width="600"
 +
| '''Requirement'''
 +
| When persisting or exchanging a representation of a terminology model, there are various degrees of detail that may need to be exposed and the persisted artifact needs to indicate what level of representation is present.
 +
|-
 +
| ''Rationale''
 +
| While made up of multiple distinct parts, there are significant dependencies between all of the aspects of a set of terminology artifacts.  Specifications need to be able to easily reference the set of terminology artifacts that apply to them.  The easiest way to do that is to define a single "package" containing all of the terminology artifacts that can be updated from time to time and which can be referenced either as a specific version of the package or as "the current package".
 +
|-
 +
| ''Methodology''
 +
| Possible levels are:
 +
* complete: Indicates that the content of the model rendition represents a complete definition of the vocabulary artifacts present within that model.
 +
* partial-validation: Indicates that the content of the model rendition represents a subset as required for validation of static model definitions.  This representation may include artifacts defined within other models rather than referencing them as dependent models for simplicity of exchange.
 +
* partial-publishing: Indicates that the content of the model rendition represents a subset as required to expose the vocabulary model for publishing
 +
* partial-implementation: Indicates that the content of the model rendition represents the subset needed to perform implementation of a particular set of static artifacts.  This representation may include artifacts defined within other models rather than referencing them as dependent models for simplicity of exchange.
 +
|-
 +
| '' MIF''
 +
| mif-vocabulary-model.xsd/VocabularyModel/@definitionKind
 
|}
 
|}
  

Revision as of 18:32, 16 July 2009

A terminology model is a collection of terminology artifacts that, together, support defining the terminology constraints that can apply in standard specifications. The specific types of artifacts that a terminology model may contain include:

Note: The requirements for why each of the above artifacts are necessary are covered either elsewhere within this specification or in the requirements listed below.


Requirement Terminology Models need to be able to be packaged and identified as a single artifact
Rationale While made up of multiple distinct parts, there are significant dependencies between all of the aspects of a set of terminology artifacts. Specifications need to be able to easily reference the set of terminology artifacts that apply to them. The easiest way to do that is to define a single "package" containing all of the terminology artifacts that can be updated from time to time and which can be referenced either as a specific version of the package or as "the current package".
Methodology mif-vocabulary-model.xsd/VocabularyModel


Requirement Terminology models must identify any other terminology models they are dependent on
Rationale Because of the vast number of code systems, value sets, mappings and other terminology artifacts that will exist and the wide variety of organizations that create and maintain those artifacts, it is unrealistic to expect that all terminology artifacts could possibly be encompassed or published within a single model. Multiple models are inevitable. However, most models will have dependencies on contents that are in turn defined within other models. (In some cases, the dependencies may be circular). Understanding the models a given terminology model depends on is therefore essential to being able to use that model.
MIF mif-vocabulary-model.xsd/VocabularyModel


Requirement When persisting or exchanging a representation of a terminology model, there are various degrees of detail that may need to be exposed and the persisted artifact needs to indicate what level of representation is present.
Rationale While made up of multiple distinct parts, there are significant dependencies between all of the aspects of a set of terminology artifacts. Specifications need to be able to easily reference the set of terminology artifacts that apply to them. The easiest way to do that is to define a single "package" containing all of the terminology artifacts that can be updated from time to time and which can be referenced either as a specific version of the package or as "the current package".
Methodology Possible levels are:
  • complete: Indicates that the content of the model rendition represents a complete definition of the vocabulary artifacts present within that model.
  • partial-validation: Indicates that the content of the model rendition represents a subset as required for validation of static model definitions. This representation may include artifacts defined within other models rather than referencing them as dependent models for simplicity of exchange.
  • partial-publishing: Indicates that the content of the model rendition represents a subset as required to expose the vocabulary model for publishing
  • partial-implementation: Indicates that the content of the model rendition represents the subset needed to perform implementation of a particular set of static artifacts. This representation may include artifacts defined within other models rather than referencing them as dependent models for simplicity of exchange.
MIF mif-vocabulary-model.xsd/VocabularyModel/@definitionKind


Requirement Terminology Models may have a number of different types of annotations
Rationale See rationales for individual annotations types
Implementation