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

Difference between revisions of "Vocabulary Maintenance Language (Domain Revision)"

From HL7Wiki
Jump to navigation Jump to search
m
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{VocMntStyle/TabsHeader|This=5}}
+
{{VocMntStyle/TabsSimple|5=1}}
<div style="border:2px solid #A3B1BF; padding:.5em 1em 1em 1em; border-top:none; background-color:#fff; color:#000">
+
<div style="margin-top:0.7em; margin-bottom:0.5em; text-align:left; font-size:98%; vertical-align:bottom; padding:3px">
[[Image:Edit-this-page-large.png|right|Click ''Edit this page'' to change an article]]
+
<span style="font-weight:bold; font-Size=108%">[[{{PAGENAME}}#Concept_Domain_Revision|ReviseDomains]]&nbsp;···</span>
The most basic wiki feature of all is: '''[[Wikipedia:Sandbox|Edit this page!]]'''  With the exception of a few [[Wikipedia:Protected page|protected pages]], every page has a link that says "'''''edit this page'''''". This link lets you do exactly that: edit the page you're looking at. Sites like these, where anyone can edit anything, are known as '[[wikis]]'.
+
[[{{PAGENAME}}#Creating_Concept_Domains|CreateDomains]]&nbsp;·
Go to the [[/sandbox/]] and click the "''edit this page''" link. You'll see the wiki code for that page. Add something fun and interesting or "Hello world!" then save it and see what you've done! (Note: not on this page)
+
[[{{PAGENAME}}#Define_or_Redefine_Concept_Domain|(Re)defineDomain]]&nbsp;·
 
+
[[{{PAGENAME}}#Rename Concept Domain|RenameDomain]]&nbsp;·
==Show preview==   
+
[[{{PAGENAME}}#Move_Concept_Domain|MoveDomain]]&nbsp;·
One important feature to start using now is the '''[[Wikipedia:Show preview|Show preview]]''' button. Try making an edit in the [[/sandbox/]], then clicking the <!-- Can someone put an actual button here to make things clear to newusers? -->'''{{Mediawiki:Showpreview}}''' ''Sandbox'' button instead of ''Save Changes''. This allows you to see what the page will look like after your edit, ''before'' you actually save. We all make mistakes; this feature lets you catch them. Using Show Preview before saving also lets you try format changes and other edits without cluttering up the [[Wikipedia:Page history|page history]] and has a number of other advantages. Don't forget to save your edits after previewing, though!
+
[[{{PAGENAME}}#Delete_Concept_Domain|DeleteDomain]]&nbsp;
 
 
==Edit summary==
 
[[Image:Edit_Summary-2.png|Edit summary text box|right]]
 
Before you hit ''Save'', it's considered good [[Wikipedia:Etiquette|etiquette]] (or "Wikiquette") to enter a polite explanation of your changes in the '''[[Wikipedia:Edit summary|Edit summary]]''' box between the edit window and the Save and Preview buttons. It can be quite terse; for example if you just enter "typo", people will know you made a minor spelling or punctuation correction, or some other small change. Also, if the change you have made to the page is minor, such as a spelling or grammar correction, be sure to check the box "This is a [[Help:Minor edit|minor edit]]" (this is only available if you have logged in).
 
 
 
{{-}}
 
<div style="float:left; align:left; margin-top: -1.5em; background-color: #f5faff; padding: .2em .6em; font-size: 130%; border: 1px solid #cee0f2;">'''Play around in the [[/sandbox/]]'''</div>
 
 
 
<div style="float:right; margin-top: 0.0em; margin-bottom:3px; background-color: #cee0f2; padding: .2em .6em; font-size: 130%; border: 1px solid #a3b1bf;">'''Continue the tutorial with [[Wikipedia:Tutorial (Formatting)|Formatting]]''' <span style="font-size: larger; font-weight: bold;">?</span></div>
 
</div>
 
<div style="clear:both"></div>
 
 
</div>
 
</div>
 +
{{:VocMnt-DomainRev}}
 +
:{{to-top}}
 +
{{:VocMnt-Footnotes}}

Latest revision as of 18:46, 30 September 2007

Introduction   Proposal   Code System   Value Set   Domain   Properties   Appendices    

ReviseDomains ··· CreateDomains · (Re)defineDomain · RenameDomain · MoveDomain · DeleteDomain 

Concept Domain Revision

[Not fully exposed in application]

A concept domain represents an abstract conceptual space that can be associated with RIM-derived coded attributes. A concept domain can be represented by one or more value sets, where each associated value set applies in a given context. Further, sub-sets of concept domains may, themselves, be represented as concept domains in a parent-child semantic hierarchy. The set of operations that can be made on concept domains includes: create, define (or redefine), rename, move (in the hierarchy) and delete, as indicated below:

Element vocabularyDomainRevision -- Revising Concept Domains

Creating Concept Domains

[Exposed under VS in application]

The vast majority of the concept domains will be created during the RIM modeling process. The following operation can be used in cases where the domain doesn’t already exist in the RIM model.

Element createVocabularyDomain

The creation of a new domain needs to be voted upon, therefore createVocabularyDomain has an optional ballotStatus element. The description is technically optional, but is virtually required by HL7's style and balloting guides. It provides a description of the concept domain. createVocabularyDomain has the following attributes:

Attributes of createVocabularyDomain
vocabularyDomain The name of the new concept domain to be created
restrictsDomain The name of the parent concept domain (optional).
Example XML for createVocabularyDomain

The example above creates two concept domains – OrderableBeers and OrderableAles. OrderableAles is defined as a proper subset (restriction or constraint) on OrderableBeers.

Jump to top of page

Define or Redefine Concept Domain

[Not exposed in application]

A new or revised definition can be assigned to a concept domain with the defineVocabularyDomain element.

Element defineVocabularyDomain

As with all updates, defineVocabularyDomain can have its own ballotStatus if needed to reflect special cases. It has a newDescription element that contains the revised description or can be empty if the description is to be completely removed. defineVocabularyDomain has a single attribute:

Attribute of defineVocabularyDomain
vocabularyDomain The name of the concept domain to be (re)defined.
Jump to top of page

Rename Concept Domain

[Not exposed in application]

A new name can be assigned to a concept domain with the renameVocabularyDomain element.

Element renameVocabularyDomain

As with all updates, renameVocabularyDomain can have its own ballotStatus if needed to reflect special cases. renameVocaabularyDomain has two attributes:

Attributes of renameVocabularyDomain
vocabularyDomain The current name of the concept domain to be (re)defined.
newDomainName The new name of the concept domain.
Jump to top of page

Move Concept Domain

[Not exposed in application]

A concept domain can be moved within the domain hierarchy – made a child of another domain, made a child of a different domain than previously, or removed from under its parent -- using the moveVocabularyDomain element.

Element moveVocabularyDomain

As with all updates, moveVocabularyDomain can have its own ballotStatus if needed to reflect special cases. moveVocaabularyDomain has three attributes:

Attributes of moveVocabularyDomain
vocabularyDomain The name of the concept domain being moved.
fromDomain The current direct parent of the concept domain, if any. This attribute should be omitted if the concept domain doesn’t currently occur under any other node.
toDomain The new parent of the concept domain. If omitted, the concept domain no longer has a parent in the domain hierarchy.
Jump to top of page

Delete Concept Domain

[Not exposed in application]

A concept domain can be deleted from the set of HL7 domains using the moveVocabularyDomain element.

Element deleteVocabularyDomain

As with all updates, moveVocabularyDomain can have its own ballotStatus if needed to reflect special cases. moveVocaabularyDomain has one attributes:

Attribute of deleteVocabularyDomain
vocabularyDomain The name of the concept domain to be deleted.
Jump to top of page

Not exposed in application
Capability that is listed as Not exposed in application are functions that are not (as of this writing) supported by the Harmonization Tooling application.
Not fully exposed in application
Capability that is listed as Not fully exposed in application represents a set of capabilities, some, but not all of which is implemented in the Harmonization Tooling application.
Exposed under VS in application
Code System capability that is listed as Exposed under VS in application are functions that cannot be invoked directly, but that are present in processing value set changes on Value Sets whose Code System is established by a previous binding
Concept Domain
The term Concept Domain was formally adopted by the HL7 Vocabulary Technical Committee as the name for an abstract conceptual space that may be represented by (bound to) a set of concepts found in one or more specific code systems. Previous to this adoption, the preferred name for the same abstract conceptual space was Vocabulary Domain. In editing this document, the term "vocabulary domain" has been replaced with "concept domain", except where the term is part of the XML schema. In order to avoid "breaking" software tools that were built to the previous version of the schema, the XML attribute and element names retain the phrase "vocabularyDomain".