OntoDL Tutorial: Setting Properties (Part 1)

Motivation

Rationale

in the first lesson, the OntoDL object types codesystem and concept have been introduced. For the sampke code system a name, URI and version numer were provided while concepts had just been assigned a name which implicitly was considered the concept's code, too. Nevertheless, there is more to say about a code system or concept. E.g. a concept may need a definiton and a text to display to the user. Additional information may include synonyms for the concept or designations in different languages.

In this lesson you will learn how to use object properties to further describe a newly defined code system and concept

What you need

You should have worked through Lesson 1 of this tutorial in order to have a basic understanding of OntoDL objects. Beside this you need your MS Word with the OntoDL macro installed.

Example

This example builds upon the example introduced in Lesson 1 which again implements a simple story board:

Storyboard: In order to foster semantic interoperability among its IT-systems a hospital wants to define unique terminologies for its clinics. Each clinic and each ward shall be assigned a unique code that shall be used throughout all IT-systems for referring to that clinic or ward.

Properties of Code Systems and Concepts

Each OntoDL object can be further described by properties. In Lesson 1 the definitions of a URI and Version for a codesystem object are examples for the use of propereties. As properties are the most important means to control the definition of an object, OntoDL offers many different ways for assigning values to properties. In this lesson we will focus on the OntoDL Object Language syntax which is rather simple. All you need to do is to place a 2-column-table into the definition scope of an object that holds the property name in the first column and the assigned value of the property in the second column. The example below shows how to define a display value and a definition for a concept:

---

Style Sheet		Text		Comment
OntoDL		define concept (cardiologic clinic) {		The opening brace sets up the definition scope for the concept "cardiologic clinic". All property value assignements done within the definition scope are implicitly linked to this concept.
OntoDL		Display Cardiologic Clinic, Prof. Smyth Definition The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.		The left column gives the properties to be set while the second column gives the values to be assigned to these properties.
OntoDL		}		Comment

---

Predefined Properties

For each object type there are several properties defined in OntoDL which carry a defined semantics and are considered for the FHIR ValueSet resource that is generated from the OntoDL definitions. For each of these properties a fixed type is given; values assigned to such a property must comply to this type. Follow the links below to see the list of defined properties and their respective types for the object types introduced so far:

• codesystem
• concept

Some properties have a type collection with a defined subtype. Properties of collection may be assigend to an object mutiple times; e.g. you may add multiple definitions to a concept. The subtype defines the type of the objects within the collection; e.g. definiton is a collection of strings.

Example

---

Style Sheet		Text		Comment
OntoDL		define codesystem (T02 Property Tables) {		Comment
OntoDL		URI http://hospital.com/placeofstay Version 0.1 Description This terminology lists all clinics and wards of the ABC-hospital. All internal IT-Systems shall dynamically load information about clinics and wards from this terminology. Group EXA		Comment
OntoDL		define concept (cardiologic clinic) {		Comment
OntoDL		Display Cardiologic Clinic, Prof. Smyth Designation[Language=de] Kardiologische Klinik Definition The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.		Comment
OntoDL		define concept (ward 51.1) {		Comment
OntoDL		Display Cardiologic care ward for Women and Children Designation[Language=de] Kardiologische Station für Frauen und Kinder		Comment
OntoDL		define concept (ward 51.2) {		Comment
OntoDL		Display Cardiologic care ward for Intensive Care Designation[Language=de] Kardiologische Intensivstation		Comment
OntoDL		}		Comment
OntoDL		define concept (orthopedic clinic) {		Comment
OntoDL		Display Orthopedic Clinic, Prof. Miller Designation[Language=de] Orthopädische Klinik Definition The Orthopedic Clinic (Head: Prof. Miller) takes responsibility for all interventions and therapies related to knee and hip problems.		Comment
OntoDL		define concept (ward 52.1){		Comment
OntoDL		Display Orthopedic care ward for knee and hip patients Designation[Language=de] Orthopädische Station für Knie- und Hüft-Patienten		Comment
OntoDL		}		Comment
OntoDL		}		Comment

---