OntoDL Tutorial: Mapping Concept Hierarchies onto Word Sections

Motivation

Rationale

In the first lessons the OntoDL define statement has been used for defining a codesystem and its concepts. A concept hierarchy wes set up by nesting define statements.

In this lesson you will learn how to use MS Word heading levels as an alternative and mor comfortable way to define hierarchies of OntoDL objects.

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.

The #heading Directive

---

Style Sheet		Text		Translates to	Comment
OntoDL		#heading 2 codesystem .Name			The OntoDL Macro interpreter is advised to generate codesystem definitions from level-2 headings. The text of the respective headlines shall be taken as the value of the codesystem's Name property (which is as well the name of the codesystem).
OntoDL		#heading 3-4 concept .Name			The OntoDL Macro interpreter is advised to generate concept definitions from level-3 and level-4 headings. The text of the respective headlines shall be taken as the value of the concept's Name property (which is as well the name of the concept).
OntoDL
Überschrift 2		Animals		define codesystem (Animals) {	We are entering a level-2 chapter within the document. Everything within this chapter is part of the definition scope of the corresponding codesystem definition.
Überschrift 3		Birds		define concept (Birds) {	We are entering a level-3 section within the document. Everything within this section is part of the definition scope of the concept named "Birds".
Überschrift 4		Parrot		define concept (Parrot) {	We are entering a level-4 section within the document. Everything within this section is part of the definition scope of the concept "Parrot". As the level-4 section is within the level-3 section the concept "Parrot" is defined within the definition scope oft he concept "Birds" which makes it a sub-concept of "Birds".
Überschrift 4		Eagle		}     define concept (Eagle) {	The definiton scope of "Parrot" is clodes due to the beginning of a new level-4 section. The concept "Eagle" is defined within the definition scope of the concept "Birds" which makes it another sub-concept of this concept.
Überschrift 3		Mamals		} }   define concept (Mamals) {	While beginning a new level-3 section, the definition scopes associated to the open level-4 section ("Eagle") and level-3 section ("Birds") are closed.
Überschrift 4		Mouse		define concept (Mouse) {
Standard				} } }	The text ends. All open definition scopes ("Mouse", "Mamals" and "Animals") are closed.

---

Full Example

---

Style Sheet		Text		Comment
OntoDL		#heading 2 codesystem .Name ( .Version )		Comment
OntoDL		#heading 3-4 concept .Display ( .Name )		Comment
Standard				Comment
Überschrift 2		T03 Heading Directive (0.1)		Comment
OntoDL		URI http://hospital.com/T03 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
Überschrift 3		Cardiologic Clinic, Prof. Smyth (cardiologic clinic)		Comment
OntoDL		Designation[Language=de] Kardiologische Klinik Definition The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.		Comment
Überschrift 4		Cardiologic care ward for Women and Children (ward 51.1)		Comment
OntoDL		Designation[Language=de] Kardiologische Station für Frauen und Kinder		Comment
Überschrift 4		Cardiologic care ward for Intensive Care (ward 51.2)		Comment
OntoDL		Designation[Language=de] Kardiologische Intensivstation		Comment
Überschrift 3		Orthopedic Clinic, Prof. Miller (orthopedic clinic)		Comment
OntoDL		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
Überschrift 4		Orthopedic care ward for knee and hip patients (ward 52.1)		Comment
OntoDL		Designation[Language=de] Orthopädische Station für Knie- und Hüft-Patienten		Comment

---