OwS Tutorial: Mapping Properties onto Style Sheets

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 we were still forced to place all property definitions into table which not only gives an OwS document a very artificial 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 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.

Custom OwS Style Sheets

The use of custom style sheets follows a very simple rule:

"Any text that is formatted using a stylesheet named OwS.XYZ within the definition scope of a concept A is considered as the value of the property XYZ of the concept A."

E.g. if we want to get rid of the tables for setting the value of the Definition property of a concept, we only need to define a custom style sheet OwS.Definition and format the definition text of the concept with that style sheet.

Style Sheet		Text		Comment
Überschrift 3		Cardiologic Clinic, Prof. Smyth (cardiologic clinic)		assuming that a #heading directive is defined for heading level 3: define a new concept and open its definition space
OwS.Definition		The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.		set the value of the property "Definition"

Defining a Custom Style Sheet

The definiton of a custom style sheet is done by using existing MS Word features:

• Write a paragraph of text that shall become the vale of a property
• Mark the text with the mouse and click the right mouse button. A context menu appears.
• Select the menu item "Formatvorlagen". Another context menu appears. Select "Auswahl als neue Schnellformatvorlage speichern...". A menu appears.
• In the menu type the name of the style sheet (e.g. OwS.Definition) into the entry field and click "OK".

Now the new style sheet is also available in the styles quick list and can easily be applied to other paragraphs of text.

Putting Qualifiers into Style Names

MS Words does not impose any restrictions on the names of style sheets. Therefore you may as well name a style sheet "OwS.Designation[Language=de][Use=Synonym]" in order to set a paragraph as the value of the Designation property with the language set to German and marking it as a synonym.

Style Sheet		Text		Comment
Überschrift 3		Cardiologic Clinic, Prof. Smyth (cardiologic clinic)		assuming that a #heading directive is defined for heading level 3: define a new concept and open its definition space
OwS.Designation[Language=de]		Kardiologische Klinik		set the value of a Gwrman language designation of the defined concept
OwS.Definition		The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.		set the value of the property "Definition"

Full Example

---

Style Sheet		Text		Comment
OwS		#heading 2 codesystem .Name ( .Version )		Comment
OwS		#heading 3-4 concept .Display ( .Name )		Comment
OwS		default Group = EXA		Comment
OwS		default Copyright = ($ copyright (c) 2016, Jörg Caumanns		Comment
Standard				Comment
Überschrift 2		T05 Clinics and Wards (0.1)		Comment
OwS.URI		http://hospital.com/T05		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
OwS.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
OwS.Designation[Language=de]		Kardiologische Station für Frauen und Kinder		Comment
Überschrift 4		Cardiologic care ward for Intensive Care (ward 51.2)		Comment
OwS.Designation[Language=de]		Kardiologische Intensivstation		Comment
Überschrift 3		Orthopedic Clinic, Prof. Miller (orthopedic clinic)		Comment
OwS.Designation[Language=de]		Orthopädische Klinik		Comment
OwS.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
OwS.Designation[Language=de]		Orthopädische Station für Knie- und Hüft-Patienten		Comment
Standard				Comment

---