OwS Introduction: Installation and Setup

Preconditions

In order to install and use OwS make sure that you have

• a valid license for CTS2-LE and OwS (The OwS VBA macro is included with the CTS2-LE Terminology Server Full Update License. Users with other licenses may obtain a dedicated license for OwS from Fraunhofer FOKUS)
• installed MS Word 2010 or newer on your computer (Attention: not all MS Word versions are fully tested yet)
• access to the Fraunhofer BSCW (you should have got a account together with the CTS2-LE license)
• access to a CTS2-LE server instance (as a fallback you may use the public CTS2-LE at Fraunhofer FOKUS, which is configured as a default into OwS)

Installation and Configuration

1. Create a folder on your local computer where you want to place the OwS template. If you already have a directory for your custom MS Word templates, that will do fine.
2. open https://bscw.fokus.fraunhofer.de/bscw/bscw.cgi/2478444 in your web browser. Login to the Fraunhofer FOKUS BSCW. As an alternative you can open the Fraunhofer FOKUS BSCW and navigate to "CTS2-LE Customer Center / Loaders and Tools / _restricted (Full Update License) / OwS".
3. copy all files included in the BSCW folder to the local folder you created in step 1
   1. OwSVorlage vXX.dotm: MS Word Template including the OwS VBA macro
   2. Class Library.docm: VBA library including some helper classes needed to run the OwS VBA macro
4. Open the folder that you created in step 1. Do a right click on "OwSVorlage vXX.dotm" and select "Open" ("Öffnen"). It is important to use the context menu to open the file because a double click will create a new document instance.
5. In the MS Word menu open the Macro dialog box at "Ansicht / Makros". In the dialog select "OwS2FHIR" and click on "Edit" ("Bearbeiten").
   1. In some version of MS Word it may happen that the button "Edit" is disabled. In this case, just close the dialog boy and open it again.
6. In the left pane you see all classes and modules of the OwS2FHIR macro. Select "Project (OwSVorlage vXX)".
7. In the MS Word menu select "Extras / References" ("Extras / Verweise"). Klick the button "Search" ("Durchsuchen") and navigate to the folder where you installed OwS. Set "All Files (*.*)" as the requested file type. Select the file "Class Library.docm" and press "OK". Close the dialog box by clicking "OK".
8. Save "OwSVorlage vXX.dotm" and close MS Word.

Running OwS

1. Open the folder where you installed OwS. Doubleclick on "OwSVorlage vXX.dotm". MS Word opens up with the OwS template.
2. Delete the startup-content of the new file and write your own OwS document.
3. Compile your document into FHIR ValueSet resources:
   1. In the MS Word menu open the Macro dialog box at "Ansicht / Makros". In the dialog select "OwS2FHIR" and click on "Run" ("Ausführen"). In some version of MS Word it may happen that the button "Ausführen" is disabled. In this case, just close the dialog box and open it again.
   2. After the compiler run, OwS opens a dialog box and lists all errors and warning. If no errors were detected the FHIR ValueSet resource files are written to the directory where you saved your OwS file. If the "UploadServerURL" property of the CTS2LE system object is set, the FHIR ValueSet resources will automatically be uploaded to the defined CTS2-LE terminoloy server.

Adding OwS to the MS Word Menu Pane

If you don't want to click through the MS Word menues every time you want to start the OwS compiler, you can create a dedicated button in the MS Word menu pane:

1. Select the MS Word menu "File / Options" ("Datei / Optionen"). A dialog box appears.
2. In the left pane select "Menüband anpassen".
3. In the drop-down box "Befehle auswählen" select "Makros"
4. In the right list box select the menu where you want to place a button for starting the OwS compiler.
   1. Click on "Neue Gruppe".
   2. Click on "Umbenennen". Enter a name for the Shortcut and select an icon.
5. In the left list box select "Project.OwS2FHIR.OwS2FHIR". Click on "Hinzufügen".
6. In the right list box select "Project.OwS2FHIR.OwS2FHIR". Click on "Umbenennen". Give the macro a more comfortable name (e.g. "OwS") and select an icon. Close the dialog box by clicking "OK".
7. Close the dialog box by clicking "OK".

Creating a Shortcut for OwS

You may as well like to add OwS as a shortcut to the top left pane of MS Word:

1. Select the MS Word menu "File / Options" ("Datei / Optionen"). A dialog box appears.
2. In the left pane select "Symbolleiste für den Schnellzugriff".
3. In the drop-down box "Befehle auswählen" select "Makros"
4. In the left list box select "Project.OwS2FHIR.OwS2FHIR". Click on "Hinzufügen".
5. In the right list box select "Project.OwS2FHIR.OwS2FHIR". Click on "Ändern". Give the macro a more comfortable name (e.g. "OwS") and select an icon. Close the dialog box by clicking "OK".
6. Close the dialog box by clicking "OK".