<!DOCTYPE html>
<html lang="de">
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->

  <!-- Bootstrap -->
  <link href="css/bootstrap.min.css" rel="stylesheet">
  <link href="css/jumbotron-narrow.css" rel="stylesheet">

  <style>
    h5 { font-weight:bold; }
  </style>

  <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
  <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
  <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
  <![endif]-->
  <title>zaaReloaded2</title>
  <meta name="author" content="Daniel Kraus">
  <meta name="description" content="Add-in für Microsoft Word 2010-2013, das die Zentrale Arztbriefablage um Funktionen für das Formatieren von Laborwerten erweitert.">
  <link rel="icon" type="image/png" href="img/icon.png">
  <style>
    floatbox {
      padding: 0;
      margin: 0 0.5em;   
    }
  </style>
</head>
<body>
  <div class="container">
    <div class="header clearfix">
      <nav>
        <ul class="nav nav-pills pull-right">
          <li>
            <a href="#anleitung">Anleitung</a>
          </li>
          <li>
            <a href="#anpassen">Anpassen</a>
          </li>
          <li>
            <a href="downloads/">Download</a>
          </li>
          <li>
            <a href="http://git.bovender.de">Code</a>
          </li>
          <li>
            <a href="doc/">Code Docs</a>
          </li>
          <li>
            <a href="doc/md_HISTORY.html">Versionsgeschichte</a>
          </li>
        </ul>
      </nav>
      <img src="img/icon.png" alt="zaaReloaded">
    </div>
    <div class="jumbotron">
      <h1>zaaReloaded2</h1>
      <p class="lead">
        Erweiterung für Microsoft&reg; Word 2010-2013, das die
        <a href="http://www.smi.ukw.de/sap-klinische-verfahren/archivsysteme/zentrale-arztbriefablage.html">Zentrale Arztbriefablage (ZAA)</a>
        um Funktionen für das Formatieren von Laborwerten erweitert. 
      </p>
      <p class="text-center">
        <a class="btn btn-lg btn-primary" href="downloads/">
          Download
        </a>
      </p>
    </div>

    <div class="row">
      <div class="col-md-12">
        <div class="clearfix">
          <h2 class="page-header" id="anleitung">
            Anleitung
          </h2>

          <p>
            <img class="center-block img-responsive" src="img/firstrun.png" alt="Begrüßungsfrage">
          </p>
          <p>
            Beim allerersten Mal, wenn das Add-in zusammen mit Word
            gestartet wird, wird man gefragt, in welchem Modus das
            Add-in operieren soll. Im <em>Ärztemodus</em> wird man ggf.
            aufgefordert, Zusatzinformationen zu Laborparametern (z.B.
            Ziel-Spiegel von Medikamenten) anzugeben; im
            <em>Sekretariatsmodus</em> unterbleiben solche Nachfragen.
          </p>

          <div class="panel panel-primary">
            <div class="panel-heading">
              <h3 class="panel-title">
                1. Labor einfügen
              </h3>
            </div>
            <div class="panel-body">
              <p>
                <img class="center-block img-responsive" src="img/vorher.png" alt="Vorher">
              </p>
            </div>
            <div class="panel-footer">
              <p>
                Laborwerte auf üblichem Wege in einen Arztbrief einfügen
                (alternativ kann der Befehl "Demo" ausgeführt werden,
                dann wird ein Beispieldokument mit Laborwerten
                geöffnet).
              </p>
            </div>
          </div>

          <div class="panel panel-primary">
            <div class="panel-heading">
              <h3 class="panel-title">
                2. zaaReloaded-Funktion aufrufen
              </h3>
            </div>
            <div class="panel-body">
              <p>
                <img class="center-block img-responsive" src="img/ribbon.png" alt="zaaReloaded2-Ribbon">
              </p>
            </div>
            <div class="panel-footer">
              <p>
                Im zaaReloaded-Tab (s.o.) den linken Knopf "Formatieren"
                klicken.
              </p>
            </div>
          </div>

          <div class="panel panel-primary">
            <div class="panel-heading">
              <h3 class="panel-title">
                3. Ggf. Stil auswählen
              </h3>
            </div>
            <div class="panel-body">
              <p>
                <img class="center-block img-responsive" src="img/stilauswahl.png" alt="Stil auswählen">
              </p>
            </div>
            <div class="panel-footer">
              <p>
                Beim ersten Mal erscheint eine Liste mit Stilen, aus der
                man den gewünschten Stil auswählt (siehe Abbildung).
                Beim nächsten Mal, wenn man auf diesen Knopf drückt,
                wird der zuletzt verwendete Stil genommen.
              </p>
            </div>
          </div>

          <div class="panel panel-primary">
            <div class="panel-heading">
              <h3 class="panel-title">
                4. Ggf. Kommentar ergänzen
              </h3>
            </div>
            <div class="panel-body">
              <p>
                <img class="center-block img-responsive" src="img/itemcommentview.png" alt="Kommentar eingeben">
              </p>
            </div>
            <div class="panel-footer">
              <p>
                Sofern der <em>Ärztemodus</em> eingestellt ist, können
                für bestimmte Laborparameter Zusatzkommentare eingegeben
                werden, z.B. um den Zielspiegelbereich eines
                Medikamentes anzugeben.
              </p>
              <p>
                Wenn man diesen Dialog mit "Abbrechen" oder
                <kbd>ESC</kbd> beendet, erscheint ein gelb markierter
                Hinweis im formatieren Laborblock.
              </p>
              <p>
                Wenn man hingegen keinen Kommentartext eingibt, wird
                kein Kommentar eingefügt, also auch das Präfix (hier
                "(Ziel-Talspiegel:") und das Suffix (hier "µg/l)")
                nicht.
              </p>
            </div>
          </div>

          <div class="panel panel-primary">
            <div class="panel-heading">
              <h3 class="panel-title">
                5. Fertig!
              </h3>
            </div>
            <div class="panel-body">
              <p>
                <img class="center-block img-responsive" src="img/nachher.png" alt="Nachher">
              </p>
            </div>
            <div class="panel-footer">
              <p>
                Einen Moment warten... Voilà.
              </p>
            </div>
          </div>

          <h2 class="page-header">
            Updates
          </h2>
          <p>
            Das Addin sucht täglich nach Updates und lädt und installiert
            diese bei Bedarf im Hintergrund.
          </p>

          <h2 class="page-header" id="anpassen">
            Anpassen
          </h2>
          <p>
            zaaReloaded liest die Laborwerte aus einem Arztbrief ein,
            analysiert sie, und gibt sie entsprechend einem vom Benutzer
            programmierbaren Stil wieder aus.
          </p>
          <div class="panel panel-default col-lg-7 col-md-5 pull-right floatbox">
            <div class="panel-body">
              <img class="img-responsive center-block" src="img/stilbearbeiten.png" alt="Stil bearbeiten">
              Screenshot des Stil-Editors
            </div>
          </div>
          <p>
            Das Addin enthält einen Stil-Editor, mit dem die eingebauten Stile
            bearbeitet und neue Stile entworfen werden können. Stile
            können importiert und exportiert werden.
          </p>
          <p>
            Bei einem Stil kann definiert werden, ob pathologische
            Laborwerte auf bestimmte Weise hervorgehoben werden sollen
            (fett, kursiv, unterstrichen), und in welchen Situationen
            der Referenzbereich ausgegeben werden soll: Niemals, immer
            oder bei pathologischen Werten und/oder Parametern, die
            intern als "speziell" markiert sind (<a href="#parameter">s.u.</a>).
          </p>
          <p>
            Die Stile bestehen aus sogenannten Elementen, die der Reihe
            nach abgearbeitet werden. Ein Element ist entweder ein
            <em>Steuerelement</em> oder ein <em>Ausgabeelement</em>.
          </p>
          <h3>
            Ausgabeelemente
          </h3>
          <p>
            <em>Ausgabeelemente</em> sind für die Ausgabe von Laborwerten
            oder anderem Text zuständig. Ein Beliebiger-Text-Element gibt
            ganz einfach den Text aus, den es enthält. Auf diese Weise
            kann man z.B. zusätzliche Zeilen in die Laborausgabe einfügen
            für Werte, die nicht aus dem Lauris übernommen werden, etwa
            ein Nephrologisches Sediment, das dann noch händisch
            vervollständigt werden muß.
          </p>
          <div class="panel panel-default col-lg-7 col-md-5 pull-right floatbox">
            <div class="panel-body">
              <img class="img-responsive center-block"
              src="img/elementbearbeiten.png" alt="Laborparameter-Element bearbeiten"> 
              Laborparameter-Ausgabeelement
            </div>
          </div>

          <h4>
            Laborparameter-Element
          </h4>
          <p>
            Die eigentliche Power des Add-ins liegt in
            Laborparameter-Elementen. Jedes Element gibt einen Absatz mit
            Laborwerten aus, die frei definiert werden können (vgl.
            Abbbildung).
          </p>
          <p>
            Man schreibt einfach die gewünschten Parameter durch Kommata
            getrennt in das Eingabefeld. Optional kann man durch einen
            Doppelpunkt getrennt eine Beschriftung voranstellen. In der
            Abbildung ist das "Klinische Chemie".
          </p>
          <h5 id="parameter">
            Parameter-Bezeichnungen
          </h5>
          <p>
            zaaReloaded2 verwendet teilweise eigene Bezeichnungen für
            Parameter, bspw. "Na" für Natrium, während in der originalen
            Lauris-Ausgabe "Natrium" steht. Momentan gibt es noch keine
            Möglichkeit, die bekannten Parameter im Add-in selbst
            einzusehen; die Liste steht aber im Quellcode: <a
            href="http://git.bovender.de/?p=zaaReloaded2.git;a=blob;f=zaaReloaded2/Defaults/parameters.txt"
            target="_blank">git.bovender.de/.../paramteters.txt</a>. In
            der Datei ist für manche Parameter auch die gewünschte Zahl
            an Dezimalstellen hinterlegt sowie die Angabe, ob in der
            Referenzbereich auch bei normalem Wert mit ausgeben werden
            soll (abhängig von der Stil-Einstellung).
          </p>
          <h5>
            Kommentare
          </h5>
          <p>
            <img class="img-responsive center-block" src="img/itemcomment.png" alt="Parameter-Kommentar">
          </p>
          <p>
            Wenn hinter einem Parameter-Namen ein Text in
            Anführungszeichen eingegeben wird, wird dieser Text als
            <em>Kommentar</em> ausgewertet (siehe Abbildung oben). Beim
            Formatieren wird dieser Kommentar mit einer
            Eingabe-Aufforderung angezeigt, wobei der Text zwischen den
            spitzen Klammern (im Beispiel "&lt;*** BITTE ANGEBEN
            ***&gt;") als Vorgabe verwendet wird (die spitzen Klammern
            verschwinden natürlich):
          </p>
          <p>
            <img class="img-responsive center-block" src="img/itemcommentview.png" alt="Eingabeaufforderung für Kommentar">
          </p>
          <p>
            In den <em>Einstellungen</em> können die
            Eingabe-Aufforderungen für Kommentare im Sinne eines
            <em>Sekretariatsmodus</em> ausgeschaltet werden. Dann wird
            der Kommentar in der Ausgabe <mark>gelb
            hervorgehoben</mark>.
          </p>
          <h5>
            Platzhalter
          </h5>
          <p>
            Mittels <em>Platzhaltern</em> ("Jokern", "Wildcards") können
            alle Laborwerte ausgegeben werden, die bis dahin noch nicht
            explizit ausgewählt wurden. Wenn man "*" verwendet, werden
            alle noch nicht selektierten Werte ausgegeben. Mit "U-*"
            werden nur die noch nicht verwendeten Werte des Spot-Urins
            ausgegeben und mit "SU-*" die noch nicht verwendeten Werte
            des Sammelurins.
          </p>

          <h4>
            Beliebiger Text
          </h4>
          <p>
            Das Ausgabe-Element "Beliebiger Text" macht genau das:
            Beliebigen Text ausgeben, der nicht weiter bearbeitet wird.
            Auf diese Weise kann man z.B. Platzhalter für Urinsedimente
            ausgeben lassen, die dann noch händisch vervollständigt
            werden müssen.
          </p>

          <h3>
            Steuerelemente
          </h3>
          <p>
            Mit <em>Steuerelementen</em> kann z.B. die Auswahl eines Datums
            für die Laborausgabe (erster/letzter Tag usw.) kontrolliert oder
            auch der Dokumentfluß gesteuert werden, wobei bislang nur die
            Ausgabe in zwei Spalten implementiert ist.
          </p>
          <p>
            Steuerelemente zur Auswahl von bestimmten Daten
            (erster/letzter Tag usw.) enthalten <em>Kindelemente</em>. Nur
            Ausgabeelemente können Kindelemente sein. Ein Steuerelement
            wählt die Laborwerte für das entsprechende Datum aus und
            übergibt sie den Kindelementen, die die Laborwerte ausgeben.
            Mit dem Steuerelement <em>Jeder Tag</em> werden alle
            Laborwerte nach Kalendertagen sortiert, und die Kindelemente
            geben die Werte für jeden Kalendertag aus.
          </p>
        </div>
      </div>
    </div>

    <footer class="footer">
      <p>
        &copy; 2015 <a href="http://www.bovender.de">Daniel Kraus</a>
        <span class="pull-right">
          Handarbeit mit
          <a href="http://www.vim.org">
            Vim
          </a>
          und
          <a href="http://getbootstrap.com">
            Bootstrap
          </a>
        </span>
      </p>
    </footer>
  </div>

  <!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
  <!-- Include all compiled plugins (below), or include individual files as needed -->
  <script src="js/bootstrap.min.js"></script>
</body>
<!-- vim: set tw=72 et ai sts=2 ts=2 sw=2 : -->
</html>