OwS Object Type: Concept

Description

OwS objects of type Concept represent concepts within a code system. In OwS Concept objects may be defined

• within the definition scope of an object of type OwS Object Type: Codesystem for defining a new concept
• at global scope (only for introducing existing concepts)

Each Concept object shall have a unique name within its definition scope. Additionally the combination of a concept's system and code properties shall be unique within an OwS document.

Defining Concepts

Concepts can be defined within an OwS document by using

• full definitions (MS Word tables for setting property values)
• internal references (e.g. LOINC.concepts[code=(68609-7)])
• qualified concepts (e.g. (68609-7)@LOINC)
• #heading directive (e.g. #heading 2 Concept .Name)
• #table directive (e.g. #table 2 Concept .name .display)

Referencing Concepts

Within the definition scope of a code system, concepts are referenced by their name. Outside this scope the can either be referenced by their name or their code together with the name of the code system (name@System or code@System).

Defined Properties

Property Name	RWDS	Type	Subtype	Card.	Definition
name	RD	string		1..1	Name of the concept as set when the concept was defined. If no name is given (e.g. when using the #table directive) the value of the code property is taken as the concept name. If even no code is geven, the value of the display property is used as the concept name.
type	RD	string		1..1	always: "Concept"
code	RWD	string		1..1	Code of the concept. A concept's code shall be unique within a code system. If no code is set, OwS takes the concept name as the concept's code.
system	R	Codesystem		1..1	Each concept was initially defined as part of a code system. This property provides a reference to the respective OwS object. Note: For concepts within a value set this property provides the link to the code system where the concept originated from.
parent	R	Concept		1..1	Reference to the superordinate concept. If the concept is a root-concept, a concept with name and code set to "NULL" will be provided.
definition	RW	collection	string	0..*	Definition of the concept. Adding a value to this property will add another collection element unless the set-statement with mode set to "overwrite" is used.
display	RWD	string		0..1	Text to be shown in the CTS2LE Ontology Browser. Note: OwS cuts the value of this property at 200 characters. For providing longer texts for concepts, you shall use the definition or designation property. If no display value is set, OwS uses the following property values in the given oreder as a default: first string object within designation collection with language set to the default language first string object within designation collection first 200 characters from definition property value
designation	RW	collection	string	0..*	Alternative designations for the concept. Designations may differ by language and/or use. Adding a value to this property will add another collection element unless the set-statement with mode set to "overwrite" is used.
level	R(W)	string		1..1	Hierarchy level of a concept within a concept tree. Top-level concepts within a code system have level="1". Concept definitions outside a code system have level="0". This property can only be set throuth the #table directive.

RWDS = Read Access - Write Access - Default Value if not explicitly set - Side Effects

FHIR Mapping

DSTU-2: Terminology (codesystem)

<?xml version="1.0" encoding="..."?>
<ValueSet xmlns="http://hl7.org/fhir" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:xml="http://www.w3.org/XML/1998/namespace" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ext="http://semantik.fokus.fraunhofer.de/ehealth/fhir-extensions#" xsi:schemaLocation="http://hl7.org/fhir ../fhir-std/spec-v1.0.2/valueset.xsd">
...
<codeSystem>
<concept>
<code value="code"/>
<display value="display"/>
<definition value="definition"/>
<designation>
<language value="designation.language"/>
<use>
<system value="designation.use.Codesystem.uri"/>
<version value="designation.use.codesystem.version"/>
<code value="designation.use.code"/>
<display value="designation.use.display"/>
</use>
<value value="designation"/>
</designation>
... <!-- further designations -->
<concept>
... <!-- definiton of sub-concept -->
</concept>
... <!-- further sub-concepts -->
</concept>
... <!-- further concepts -->
</codeSystem>
</ValueSet>

---

DSTU-2: Value Set (compose)

<?xml version="1.0" encoding="..."?>
<ValueSet xmlns="http://hl7.org/fhir" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:xml="http://www.w3.org/XML/1998/namespace" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ext="http://semantik.fokus.fraunhofer.de/ehealth/fhir-extensions#" xsi:schemaLocation="http://hl7.org/fhir ../fhir-std/spec-v1.0.2/valueset.xsd">
...
<compose>
<include>
<system value="Codesystem.uri"/>
<version value="Codesystem.version"/>
<concept>
<code value="code"/>
<display value="display"/>
<designation>
<language value="designation.language"/>
<use>
<system value="designation.use.Codesystem.uri"/>
<version value="designation.use.Codesystem.version"/>
<code value="designation.use.code"/>
<display value="designation.use.display"/>
</use>
<value value="designation"/>
</designation>
... <!-- further designations -->
</concept>
... <!-- further concepts of the included code system -->
</include>
... <!-- further included systems and concepts -->
</compose>
</ValueSet>

---