OwS Tutorial: Using Defaults (Part 1)

Motivation

Rationale

In the previous lesson the OwS #heading directive was introduced for mapping heading levels onto levels of a code system definition. Even though this makes the text look much more like a description than a formal definition, there are still many OwS statements inside the code system definition. The ambition of OwS is to provide easy means for turining ordiary MS Word texts into powerful code system definitions.

In this lesson you will learn how to take common property definitions out of single code system definitions by using defaults. Defaults allow you to define common properties only once in the begining of an OwS file.

What you need

You should have worked through lesson 2 of this tutorial in order to have a basic understanding of OwS objects and properties. 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.

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
OwS		default Language = de		Comment
Standard				Comment
Überschrift 2		T04 Global Defaults (0.1)		Comment
OwS		URI http://hospital.com/T04 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 4		Cardiologic care ward for Women and Children (ward 51.1)		Comment
OwS		Designation Kardiologische Station für Frauen und Kinder		Comment
Überschrift 4		Cardiologic care ward for Intensive Care (ward 51.2)		Comment
OwS		Designation Kardiologische Intensivstation		Comment
OwS				Comment
Überschrift 4		Orthopedic care ward for knee and hip patients (ward 52.1)		Comment
OwS		Designation Orthopädische Station für Knie- und Hüft-Patienten		Comment

---

<?xml version="1.0" encoding="UTF-8"?>
<ValueSet ....>
    ...
    <copyright value="copyright (c) 2016, Jörg Caumanns"/>
    <codeSystem>
        ...
        <concept>
            <code value="cardiologic clinic"/>
            <display value="Cardiologic Clinic, Prof. Smyth"/>
            <definition value="The Cardiologic Clinic ...."/>
            <designation>
                <language value="de"/>
                <value value="Kardiologische Klinik"/>
            </designation>
            <concept>
                <code value="ward 51.1"/>
                <display value="Cardiologic care ward for Women and Children"/>
                <definition/>
                <designation>
                    <language value="de"/>
                    <value value="Kardiologische Station für Frauen und Kinder"/>
                </designation>
            </concept>
         ...
     </codeSystem>
</ValueSet>