Quelltext der Seite OwS Tutorial: Mapping Properties onto Style Sheets

== Motivation ==

;Rationale
:In [[OwS Tutorial: Mapping Concept Hierarchies onto Word Sections|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 [[OwS Tutorial: Mapping Concept Hierarchies onto Word Sections|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 [[OwS Tutorial: Defining a Terminology|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="text-align:left; width:4em" | Style Sheet !! &nbsp; !! style="text-align:left; width:40em" | Text !! &nbsp; !! style="text-align:left" | ''Comment''
|- style="vertical-align:top"
| Überschrift 3|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Arial;font-size:100%">'''Cardiologic Clinic, Prof. Smyth (cardiologic clinic)'''</span>
   |}
|| || assuming that a #heading directive is defined for heading level 3: define a new concept and open its definition space
|- style="vertical-align:top"
| OwS.Definition|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Times;font-size:100%">''The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.''</span>
   |}
|| || set the value of the property "Definition" 
|}

=== Defining a Custom Style Sheet ===
[[Datei:Defining_a_Style_Sheet.png|320px|right]]
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="text-align:left; width:4em" | Style Sheet !! &nbsp; !! style="text-align:left; width:40em" | Text !! &nbsp; !! style="text-align:left" | ''Comment''
|- style="vertical-align:top"
| Überschrift 3|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Arial;font-size:100%">'''Cardiologic Clinic, Prof. Smyth (cardiologic clinic)'''</span>
   |}
|| || assuming that a #heading directive is defined for heading level 3: define a new concept and open its definition space
|- style="vertical-align:top"
| OwS.Designation[Language=de]|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Arial;font-size:100%">Kardiologische Klinik</span>
   |}
|| || set the value of a Gwrman language designation of the defined concept
|- style="vertical-align:top"
| OwS.Definition|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Times;font-size:100%">''The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.''</span>
   |}
|| || set the value of the property "Definition" 
|}

== Full Example ==
<hr>
{|
|-
! style="text-align:left; width:4em" | Style Sheet !! &nbsp; !! style="text-align:left; width:40em" | Text !! &nbsp; !! style="text-align:left" | ''Comment''
|- style="vertical-align:top"
| OwS|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Courier;font-size:91%">#heading 2 codesystem .Name ( .Version )</span>
   |}
|| || a level 2 headline triggers the definition of a new code system
|- style="vertical-align:top"
| OwS|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Courier;font-size:91%">#heading 3-4 concept .Display ( .Name )</span>
   |}
|| || level 3 and 4 headlines trigger the definition of a new concept. The headline text consists of the concept's display name and its OwS internal name in parentheses (which is also the default for the concept's code). 
|- style="vertical-align:top"
| OwS|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Courier;font-size:91%">default Group = EXA</span>
   |}
|| || if the code system is to be uploaded to CTS-LE this default sets the folder in which the code system will be placed.
|- style="vertical-align:top"
| OwS|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Courier;font-size:91%">default Copyright = ($ copyright (c) 2016, Jörg Caumanns</span>
   |}
|| || set the default copyright notice to be linked with newly defined code systems
|- style="vertical-align:top"
| Standard|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Arial;font-size:100%"></span>
   |}
|| || 
|- style="vertical-align:top"
| Überschrift 2|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Arial;font-size:118%">'''T05 Clinics and Wards (0.1)'''</span>
   |}
|| || A new code system is defined. The scope of the section determines the definition scope of the code system.
|- style="vertical-align:top"
| OwS.URI|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Arial;font-size:100%">http://hospital.com/T05</span>
   |}
|| || set the "URI" property of codesystem
|- style="vertical-align:top"
| OwS.Description|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Times;font-size:100%">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.</span>
   |}
|| || set the "Description" property of the code system
|- style="vertical-align:top"
| Überschrift 3|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Arial;font-size:100%">'''Cardiologic Clinic, Prof. Smyth (cardiologic clinic)'''</span>
   |}
|| || A new concept is defined. The scope of the section determines the definition scope of the concept.
|- style="vertical-align:top"
| OwS.Designation[Language=de]|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Arial;font-size:100%">Kardiologische Klinik</span>
   |}
|| || German language designation of the concept
|- style="vertical-align:top"
| OwS.Definition|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Times;font-size:100%">''The Cardiologic Clinic (Head: Prof. Smyth) takes responsibility for all cardiologic interventions and acute care therapies.''</span>
   |}
|| || value of the concept's "Definiton" property
|- style="vertical-align:top"
| Überschrift 4|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:5em"| 
   |<span style="font-family:Arial;font-size:100%">'''''Cardiologic care ward for Women and Children (ward 51.1)'''''</span>
   |}
|| || a subconcept is defined
|- style="vertical-align:top"
| OwS.Designation[Language=de]|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:5em"| 
   |<span style="font-family:Arial;font-size:100%">Kardiologische Station für Frauen und Kinder</span>
   |}
|| || German language designation of the concept
|- style="vertical-align:top"
| Überschrift 4|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:5em"| 
   |<span style="font-family:Arial;font-size:100%">'''''Cardiologic care ward for Intensive Care (ward 51.2)'''''</span>
   |}
|| || another subconcept is defined
|- style="vertical-align:top"
| OwS.Designation[Language=de]|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:5em"| 
   |<span style="font-family:Arial;font-size:100%">Kardiologische Intensivstation</span>
   |}
|| || 
|- style="vertical-align:top"
| Überschrift 3|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Arial;font-size:100%">'''Orthopedic Clinic, Prof. Miller (orthopedic clinic)'''</span>
   |}
|| || 
|- style="vertical-align:top"
| OwS.Designation[Language=de]|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Arial;font-size:100%">Orthopädische Klinik</span>
   |}
|| || 
|- style="vertical-align:top"
| OwS.Definition|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:3em"| 
   |<span style="font-family:Times;font-size:100%">''The Orthopedic Clinic (Head: Prof. Miller) takes responsibility for all interventions and therapies related to knee and hip problems.''</span>
   |}
|| || 
|- style="vertical-align:top"
| Überschrift 4|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:5em"| 
   |<span style="font-family:Arial;font-size:100%">'''''Orthopedic care ward for knee and hip patients (ward 52.1)'''''</span>
   |}
|| || 
|- style="vertical-align:top"
| OwS.Designation[Language=de]|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:5em"| 
   |<span style="font-family:Arial;font-size:100%">Orthopädische Station für Knie- und Hüft-Patienten</span>
   |}
|| || 
|- style="vertical-align:top"
| Standard|| ||style="background:#fff588"| 
  {|
  |style="text-align:left; width:0em"| 
   |<span style="font-family:Arial;font-size:100%"></span>
   |}
|| || 
|}
<hr>