GECAMed bietet die Möglichkeit Briefe aus Vorlagen zu erstellen. Zum Beispiel einen Brief an einen Kollegen, der wichtige medizinische Informationen über einen Patienten enthält. Die Vorlagen können von jedem Benutzer selbst erstellt werden. Sie enthalten Platzhalter, die beim Erstellen eines Briefes automatisch mit den Daten des gewünschten Patienten ersetzt werden.
Das Erstellen, Bearbeiten, Speichern und Drucken wird über eine externe Textverarbeitungs-Software erledigt. Hier stehen die beiden am weitest verbreiteten Systeme zur Auswahl: Microsoft Office und sein freier Konkurent OpenOffice. Sie müssen sich nicht an ein neues Programm gewöhnen und können alle Ihre gewohnten Briefmodelle, Formatierungen etc. benutzen.

GECAMed verwaltet sogenannte Briefvorlagen. Es handelt sich dabei um Modelle, die zum Erstellen eines Standard-Briefes benutzt werden. Diese Vorlagen können Variablen (sogenannte Platzhalter) enthalten, die dann beim automatischen Erzeugen eines konkreten Briefes durch aktuelle Arzt- und Patienteninformationen ersetzt werden.

Jeder Benutzer kann seine eigenen Vorlagen erstellen und diese auch der ganzen Praxis zur Verfügung stellen. Zum einfacheren Verwalten eine grossen Anzahl von Vorlagen ist es möglich, jeder Vorlage eine Kategorie zuzuweisen. Durch die Verwendung sinnvoller Kategorien wird es einfacher, eine gesuchte Vorlage aufzufinden. Ausserdem werden in der Listenansicht die Vorlagen zuerst nach Kategorie und innerhalb der Kategorie nach Namen sortiert. Die Kategorie dient also auch als Ordnungskriterium.

Folgendes Beispiel soll den Vorgang der Briefegenerierung mithilfe einer Vorlage verdeutlichen.

Abb. 1

Bei der Briefgenerierung werden Platzhalter in der Vorlage (Abbildung 1 links), leicht zu erkennen an den eckigen Klammern ([PHYS_FULL_NAME], [PHYS_PHONE], [PAT_FULL_NAME_AND_ADDRESS], [PAT_ALLERGIES] usw.) durch die entsprechenden Informationen über den Arzt und den Patienten ersetzt (Abbildung 1 rechts). Platzhalter bestehen aus ganz normalem Text, der in die Vorlage eingetippt oder besser einkopiert werden kann. Wendet man Textformatierungen auf Platzhalter an, so bleiben diese Formatierungen später auch bei dem ersetzten Text erhalten.

Zum Erstellen, Bearbeiten, Löschen usw. von Vorlagen wechseln Sie bitte in das Briefmodul über die entsprechende Schaltfläche in der linken Modulleiste (Abbildung 2). Auf der Modul-Oberfläche finden Sie unter eine Auflistung Ihrer Briefvorlagen. Der Bereich unter enthält die sogenanten Meta-Daten zu der jeweils ausgewählten Vorlage, die dort auch teilweise verändert und abgespeichert werden können. Unter können Sie die Liste der Vorlagen nach Kategorien filtern bzw nach einem Suchbegriff suchen. Die Suche bezieht sich nur auf den Namen der Vorlage. Eine Suche im Dokument selber findet nicht statt.

Abb. 2: Das Brief-Modul

Unter finden Sie Schaltflächen zum Speichern, Öffnen, Kopieren, Hinzufügen und Löschen von Vorlagen.

Schaltfläche	Funktion	Beschreibung
	Details speichern	Speichert die Meta-Daten der Vorlage, sofern diese verändert wurden. Der Inhalt der eigentlichen Vorlage kann nur durch das Öffnen mit der Textverarbeitungs-Software geschehen.
	Öffnen	Öffnet die Briefvorlage mit der eingestellten Textverarbeitungs-Software. Nur so können Änderungen am Inhalt der Vorlage vorgenommen werden. Zum Abspeichern benutzen Sie die entsprechende Funktion des Texteditors.
	Kopieren	Erstellt eine vom Inhalt her identische Kopie der ausgewählten Vorlage. Diese erscheint sofort in der Listendarstellung und kann dort mit „Öffnen“ weiter bearbeitet werden.
	Neue erstellen	Startet den Prozess der Erstellung einer neuen Vorlage. Siehe nächstes Kapitel.
	Löschen	Löscht die ausgewählte Vorlage. Fragt nach Bestätigung.

Meta-Daten und Ihre Bedeutung:
Im Meta-Daten-Bereich werden die Meta-Daten der ausgewählten Vorlage sichtbar gemacht und können dort auch teilweise verändert werden. Nach einer Änderung kann der Benutzer mit der Funktion „Speichern“ die geänderten Meta-Daten abspeichern. Folgende Meta-Daten sind für eine Vorlage vorhanden:

Bezeichnung	Bedeutung	veränderbar
Name	Name oder Titel der Vorlage. Wird in der Listendarstellung angezeigt.	Ja
Kategorie	Filter, Ordnungs- und Sortierkriterium für Vorlagen, insbesondere nützlich zur übersichtlicheren Verwaltung einer grösseren Anzahl von Briefvorlagen.	Ja, mit Auswahl aus erweiterbarer Liste
Beschreibung	Erklärung zum Inhalt und zur Verwendung der Vorlage. Wird in der Listendarstellung mit angezeigt.	Ja
Anwendung	Das Textverarbeitungsprogramm, mit dem die Vorlage erstellt wurde (MS-Word oder Open Office). Wird während der Ersterstellung festgelegt, in Abhängigkeit vom voreingestellten Texteditor.	Nein
Erstellt von	Kürzel des Arztes, unter dessen Kennung* die Vorlage erstellt wurde.	Nein
Erstellt am	Datum der Ersterstellung.	Nein
Geändert von	Kürzel des Arztes, unter dessen Kennung die Vorlage zuletzt modifiziert wurde.	Nein
Geändert am	Datum der letzten Änderung.	Nein
Privat	Indikator der anzeigt, ob die Vorlage von allen Ärzten oder nur vom erstellenden Arzt verwendet werden kann.	Ja, umschltbar mit Schaltfläche: öffentlich privat

*mit „Kennung“ ist hier der Arzt gemeint, der zum Zeitpunkt der Erstellung der aktuelle Arzt war.

Zum Erstellen einer neuen Vorlage betätigen Sie bitte die Schaltfläche in der Modulkopfleiste. Es öffnet sich ein Fenster, in dem Sie die unter anderem die Meta-Daten der neuen Vorlage eingeben können (Abbildung 3).
Jede Vorlage benötigt einen eindeutigen Namen und eine Kategorie. Geben Sie den Namen bei ein. Die Kategorie können Sie aus der Auswahlliste bei auswählen. Um eine neue Kategorie zu erstellen, markieren Sie einfach den Text der gewählten Kategorie in der Auswahliste und geben Sie einen neuen Kategorie-Namen ein.

Der Dialog bietet Ihnen die Möglichkeit, die vorhandenen Platzhalter in das neue Dokument einzufügen. Sie können die Platzhalter auch nachträglich in der Textsoftware manuell eingeben. Die Platzhalter sind in mehrere Kategorien unterteilt wie PHYSICIAN, OFFICE, BILLING und GENERAL. Für besonders reichhaltige Datenquellen wie Patienten gibt es sogar mehrere Kategorien, wie PATIENT_ADDRESS, PATIENT_INFO, PATIENT_GENDER usw. Wählen Sie bei die entsprechende Kategorie aus, in der sie den gesuchten Platzhalter vermuten. Die Liste zeigt sodann die Platzhalter der gewählten Kategorie an. Jeder Platzhalter steht für eine bestimmte Information, die beim Erstellen eines Briefes mit den aktuellen Daten ersetzt wird.

Durch einen Doppelklick auf einen Platzhalter wird dieser von der linken Liste in die rechte Liste verschoben. Die rechte Liste enthält die Platzhalter, die in die neue Vorlage eingefügt werden sollen. Über die Schaltflächen bei können Sie die Platzhalter zwischen den Listen hin- und her bewegen. Die so ausgewählten

Platzhalter der Kategorie CONTACT sind mit der Auswahl eines Kontaktes aus dem Adressbuch verknüpft. Wenn Sie zur Brieferstellung eine Vorlage verwenden, die einen Platzhalter der Kategorie CONTACT enthält, werden Sie zunächst aufgefordert, eine entsprechende Kontaktadresse aus dem Adressbuch auszusuchen, die dann die Adressdaten des Empfängers liefern wird.

Zur Vorsortierung der möglichen Empfänger können Sie unter eine Kontakt Kategorie auswählen. Die Auswahlliste enthält die Kategorien des Adressbuchs. Siehe dazu auch Adressbuch Modul.

Abb. 3: Neue Vorlage erstellen

Wenn Sie bereits eigene Briefvorlagen bzw. Briefköpfe für Ihre Textverarbeitung haben und diese auch in GECAMed nutzen wollen, so können Sie sie direkt zum Erzeugen einer neuen Briefvorlage in GECAMed verwenden. Erstellen Sie zunächst eine neue Briefvorlage wie im vorherigen Kapitel beschrieben. Wählen Sie dazu im Erstellungs-Dialog die Schaltfläche „Briefkopf importieren“ (Abbildung 4) aus und verfahren Sie weiter wie bereits oben beschrieben.

Abb. 4: Briefkopf importieren

Wenn Sie nun das Fenster mit „Ok“ schliessen wird ihre Vorlage in der Textverarbeitungssoftware geöffnet. Sofern Sie Platzhalter ausgewählt haben, werden diese an das Ende des Dokumentes angehängt. Sie müssen die Platzhalter dann nur noch an den entsprechenden Stellen in der Vorlage unterbringen, passend formatieren und dann das Dokument speichern.

Zum Erstellen eines Briefes von einer Briefvorlage gehen Sie bitte so vor: Öffnen Sie eine Patientenakte im Patienten-Modul. Wählen Sie aus der rechten Funktionsleiste die Schaltfläche Neuer Brief (Abbildung 5). Abb. 5: Neuen Brief erstellen

Es erscheint nun ein Fenster, in dem alle verfügbaren Briefvorlagen zu sehen sind (Abbildung 6). Sie können die Liste sowohl nach Titelwörtern () als auch nach der Kategorie () filtern, wobei jeweils immer entsprechend weniger Vorlagen angezeigt werden. Unter können Sie dem neuen Brief einen eigenen Namen geben. Standardmäßig wird der Name der Vorlage verwendet. Sie können den Namen frei verändern.

Wählen Sie nun durch Doppelklick oder „OK“ die gewünschte Vorlage aus der Liste aus. Es öffnet sich die Textverarbeitungssoftware mit dem neuen Brief, der zunächst lediglich eine Kopie der Vorlage ist. Dann aber werden automatisch die Platzhalter durch aktuelle Daten ersetzt. Danach können Sie den Brief weiter bearbeiten, z.B. um den Gesundheitszustand eines Patienten in einem Bericht zu kommentieren.

Um den Brief zu speichern betätigen Sie die „Speichern“ Funktion Ihres Textverarbeitungsprogrammes. Das Dokument wird sodann in GECAMed gespeichert und wird in der Historie des Patienten abgelegt. Benutzen Sie die Druckfunktion der Textverarbeitungssoftware zum Ausdrucken des Dokumentes.

Falls die Briefvorlage Platzhalter der Kategorie CONTACT aufweist werden Sie vor dem Erstellen des Briefes aufgefordert, eine Kontaktperson aus GECAMed's Addressbuch auszuwählen (siehe (Abbildung 7). Das ist notwendig, damit die verwendeten [CONTACT_…] Platzhalter mit aktuellen Werten ersetzt werden können.

Abb. 6: Brief erstellen

Abb. 7: Brief mit Kontakt

Bis einschliesslich GECAMed Version 1.2.06 war die Liste der Platzhalter im Kernprogramm von GECAMed fest programmiert und konnte nicht „von aussen“ verändert werden. Dies hat sich seit Version 1.2.07 grundlegend geändert. Die neuen Platzhalter sind fortan ausschliesslich in der Datenbank definiert und können dementsprechend auch schnell dort geändert werden, und zwar über einfache Datenbank Operationen.

Die Semantik der Platzhalter, also ihre aktuelle Wertezuweisung während der Briefgenerierung, erfolgt mithilfe von JavaScript Code, welcher wiederum auf im GECAMed Client vorhandene Java Objekte zugreifen kann. Die Programmierung der Platzhalter wurde also zum grossen Teil aus dem GECAMed Kern und Java heraus in die Datenbank und nach JavaScript verlagert.

Die in den verschiedenen GECAMed Versionen zur Verfügung gestellten „offiziellen“ Platzhalter können hier als PDF Dateien heruntergeladen werden:

Eine Briefvorlage benutzt entweder alte oder neue Platzhalter. Vorlagen, die mit GECAMed Version 1.2.07 oder höher erstellt wurden, verwenden immer die neuen Platzhalter, vorher erstellte immer die alten.

Welche Platzhalter von einem Template benutzt werden, kann anhand des Icons erkannt werden. Vorlagen mit alten Platzhaltern haben ein Spinnennetz über dem Icon liegen (siehe Abbildung 8: zeigt ein Icon einer Breifvorlage mit alten Platzhaltern, eine mit neuen).
Die alten Platzhalter können jedoch in neue umgewandelt werden. Rechtsklicken Sie dazu auf die Briefvorlage und wählen Sie „Platzhalter auf neue Version updaten“ (siehe Abbildung 8 ). GECAMed wird die Briefvorlage öffnen und die alten Platzhalter durch die entsprechenden neuen ersetzten. Sie haben dann die Möglichkeit, das Dokument zu prüfen und eventuell noch zu bearbeiten. Erst wenn Sie die Briefvorlage gespeichert und geschlossen haben, werden die neuen Platzhalter übernommen.

Abb. 8: Platzhalter Versionen in Briefvorlagen

Die Platzhalter stehen in der GECAMed Datenbank im Schema „letter“, in der Tabelle „placeholders“. Um einen neuen Platzhalter hinzuzufügen, geben Sie ihm einen (eindeutigen) Namen (Spalte „name“), ordnen Sie ihn einer Kategorie zu (Spalte „type“) und definieren Sie in der Spalte „script“ den JavaScript Code, der beim Aufruf ausgeführt werden soll. Wie erwähnt, sollten Sie bei der Namensgebung Ihres Platzhalters immer MY_ davor schreiben.

Der Text, durch den der Platzhalter ersetzt wird, entspricht dem Rückgabewert der letzten Anweisung im JavaScript Code. Benutzen Sie NICHT die „return“-Anweisung in JavaScript um einen Wert zurückzugeben!
Der folgende Beispielcode gibt den Namen des Patienten zurück:

var firstName = PATIENT.getFirstName();
var surName = PATIENT.getSurName();
var maidenName = PATIENT.getMaidenName();

// hier wird der volle Name erstellt und damit gleich zurückgegeben
firstName + " " + surName + " " + maidenName;

Ist der Name eines Platzhalters leer, also NULL, stellt dies eine Sammlung von Funktionen dar, die innerhalb des Skripts von Platzhaltern der selber Kategorie benutzt werden können. Ist die Kategorie auch NULL handelt es sich um globale Funktionen, die von überall her benutzt werden können.