OwS Tutorial: Defining Custom Types

Motivation

Rationale

In lesson 3 the OwS #heading directive was introduced as a means for deriving OwS object hierarchies from MS Word style sheets. Nevertheless you were still forced to place all property definitions into table which not gives an OwS document a very formal style but even requires a full restructuring of existing specification documents which you may want to turn into OwS documents.

In this lesson you will learn how to assign property values by means of custom style sheets. By this OwS definitions look like prosa text which makes them more readable and gives you more flexibility in applying any layout to your OwS documents.

What you need

You should have worked through lesson 3 of this tutorial in order to have a basic understanding on how OwS utilizes MS Word styles sheets. Beside this you need your MS Word with the OwS macro installed.

Example

This example builds upon the storyboard introduced in Lesson 1 which is now given some more complexity:

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.
After integrating the terminology with all internal systems, the hospital as well wants to make the information within the terminology available to external partners through its terminology server. Important information that needs to be added to the existing concept definitions is contact data for the clinics and wards.

Full Example

---

Style Sheet		Text		Comment
OwS		default Group = EXA		Comment
OwS		default Copyright = ($ copyright (c) 2016, Jörg Caumanns		Comment
OwS		define type orgUnit : concept {		Comment
OwS		define property ContactDetails {		Comment
OwS		URI http://hospital.com/property/ContactDetails ValueType string		Comment
OwS		}		Comment
OwS		#heading 2 codesystem .Name ( .Version )		Comment
OwS		#heading 3-4 orgUnit .Display ( .Name )		Comment
OwS				Comment
Überschrift 2		T06 Custom Properties (0.1)		Comment
OwS.URI		http://hospital.com/T056		Comment
OwS.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.		Comment
Überschrift 3		Cardiologic Clinic, Prof. Smyth (cardiologic clinic)		Comment
OwS.Designation[Language=de]		Kardiologische Klinik		Comment
OsW.Definition		The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.		Comment
OwS.ContactDetails		E-Mail: cardiology@hospital.com		Comment
Überschrift 4		Cardiologic care ward for Women and Children (ward 51.1)		Comment
OwS.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
OwS.Designation[Language=de]		Orthopädische Klinik		Comment
OsW.Definition		The Orthopedic Clinic (Head: Prof. Miller) takes responsibility for all interventions and therapies related to knee and hip problems.		Comment
OwS.ContactDetails		E-Mail: orthopedy@hospital.com		Comment
Überschrift 4		Orthopedic care ward for knee and hip patients (ward 52.1)		Comment
OwS.Designation[Language=de]		Orthopädische Station für Knie- und Hüft-Patienten		Comment
Standard				Comment

---