FertiMed Handbuch FertiMed-Version: 4.5.2 Datum letzte Änderung: 13.11.2002 17:43 Autor: Belloni Informatik, P.Belloni Inhaltsverzeichniss: 1. Installation 1.1 Server 1.1.1 Access Datenbank: 1.1.2 MS SQL-SERVER Datenbank: 1.1.3 Oracle SQL-SERVER Datenbank: 1.2 Client: 1.2.1 Zusätzliche Installationen mit Oracle 2. Konfiguration 2.1 Dateien und Verzeichnisse im Server 2.1.1 Stammverzeichnis 2.1.2 Dokumentablage 2.1.3 Dokumentvorlagen 2.1.4 Geographische Karten 2.1.5 Update 2.2 Dateien und Verzeichnisse im Client 2.2.1 Stammverzeichnis 2.2.2 Links für den Programmstart 2.2.3 Module 2.3 Information zu FertiMed 2.4 Information zu Zentrum 2.5 Logbuch Zentrum 2.6 Logbuch FertiMed 2.7 Verknüpfte Tabellen 2.8 Navigation 2.9 Security 2.9.1 Access Programm 2.9.2 FertiMed Benutzerkonten 2.9.3 FertiMed Gruppenkonten 2.9.4 Zugriff Tabellen 2.9.5 Zugriff Formular 2.9.6 Zugriff Datenbank 3. Tabellen 3.1 Detailtabellen 3.1.1 Einfache 3.1.2 Fivnat 3.2 FertiMed System Tabellen 3.3 Lokale Tabellen 4. Formulare 5. Serienbriefe 5.1 Druckzentrum 5.2 Dokumentvorlagen 5.3 Dokument Felder 6. Versionen-Kontrolle/Update: 2 2 2 2 2 2 2 3 3 3 3 3 3 3 3 3 4 4 4 4 5 5 5 5 6 6 6 6 6 6 7 7 7 7 7 7 7 8 8 8 8 9 9 1. Installation 1.1 Server 1.1.1 Access Datenbank: Verzeichnisse erstellen und Dateien kopieren gemäss Ziff 2.1 Netzlaufwerk auf das Stammverzeichnis erstellen und für FertiMed-Benutzer bzw. lokalen Windows-ClientBenutzer freigeben. 1.1.2 MS SQL-SERVER Datenbank: MS SQL-Server ab Version 7.0. Die Skriptdatei „FertiMed MS SQL-Server.sql“im MS SQL-Server ausführen. Erstellt werden: ein FertiMed (DBA) mit DBA Rechten ein FertiMeduser für die ODBC-Verbindung zu FertiMed mit Delete, Insert, Update, Select und Connect Rechten. FertiMed Tabellen im FertiMed-Schema 1.1.3 Oracle SQL-SERVER Datenbank: Oracle ab Version 8i Die Skriptdatei „FertiMed MS-SQL.sql“im Microsoft SQL-Server ausführen. Erstellt wird: ein FertiMed (DBA) mit DBA Rechten ein FertiMeduser für die ODBC-Verbindung zu FertiMed mit Delete, Insert, Update, Select und Connect Rechten. FertiMed Tabellen im FertiMed-Schema 1.2 Client: MS-Access2000 oder nur dessen Runtime-Dateien installieren. Verzeichnisse erstellen und Dateien kopieren gemäss Ziff 2.2 Registrieren der Module gemäss Ziff 2.2.3 Für den Programmstart, Links erstellen gemäss Ziff. 2.2.2 FertiMed.ini Datei anpassen gemäss Ziff 2.2.1. 1.2.1 Zusätzliche Installationen mit Oracle Mit dem Oracle-Installer den Oracle-ODBC-Treiber installieren. Danach den aktuellen (8.1.78 von www.oracle.de) ODBC-Treiber installieren. Durch ein Problem mit den Kommas mit Oracle-ODBC (alle Versionen bis 8.1.78), in der Registry den Eintrag HKLM\Software\Oracle\Home0\NLS_LANG/GERMAN_GERMANY.WE8ISO8859P1 in AMERICAN_AMERICA.WE8ISO8859P1 ändern. FertiMed.ini Datei anpassen gemäss Ziff 2.2.1. 2. Konfiguration 2.1 Dateien und Verzeichnisse im Server 2.1.1 Stammverzeichnis [Netzlaufwerk]:\patis\FertiMed\ FertiMed_Daten.mdb Die FertiMed Datenbank PatisFMStandard.mdw 2.1.2 Dokumentablage [Netzlaufwerk]:\patis\FertiMed\DokumentAblage\ Serienbriefe.doc Ablage der erstellten Serienbriefe Siehe auch Ziff. 2.4 2.1.3 Dokumentvorlagen [Netzlaufwerk]:\patis\FertiMed\DokumentVorlagen\ Serienbriefe.dot Ablage der erstellten Serienbriefe Siehe auch Ziff. 2.4 2.1.4 Geographische Karten [Netzlaufwerk]:\patis\FertiMed\GeoKarten\ Erstellte Geo-Karten mit Microsoft MapPoint Europa. 2.1.5 Update [Netzlaufwerk]:\patis\FertiMed\Update\ Enthält die neueste FertiMed-Version Siehe Ziff. 6 2.2 Dateien und Verzeichnisse im Client 2.2.1 Stammverzeichnis [C]:\Programme\Patis\FertiMed\ Stammverzeichnis FertiMed.mdb Die FertiMed Applikation FertiMedCenter.mdb Das FertiMedCenter FertiMed.INI [Daten] DatenDB2=”;DATABASE=[Netzlaufwerk]:\patis\FertiMed\FertiMed_Daten.mdb” DatenDB1=”;DATABASE=[C]:\Programme\Patis\FertiMed_Daten.mdb” Für den Anschluss an eine DB-Server: DatenDB1=ODBC;DSN=FertiMedSql7;UID=FertiMeduser” DatenDB1=ODBC;DSN=FertiMedOracle;UID=FertiMeduser” Die Daten für FertiMed können mit verschiedenen Datenbank-Quellen verknüpft werden. Erstellen Sie eine fortlaufende Nummer um andere Quellen mit FertiMed zu verbinden. Die Tabellen werden anhand der Tabelle LT_Verknuepfte_Tabellen eingelesen. Wichtig!: Im FertiMedCenter muss der Eintrag LT_Aktuelle_Patienten in der Tabelle LT_Verknuepfte_Tabellen auf die FertiMed-Applikation (FertiMed.mdb) verwiesen sein. DatenDB1=”;DATABASE=[C]:\Programme\Patis\FertiMed_Daten.mdb” [UPDATE] AppName=FertiMed SoftwareFrom=[Netzlaufwerk]:\patis\FertiMed\Update\FertiMed.mdb SoftwareLocal=[C]:\patis\FertiMed\FertiMed.mdb FertiMed.log Fehlermeldungen 2.2.2 Links für den Programmstart FertiMed.lnk FertiMed Center.lnk Link zum starten der FertiMed-Applikation ...\MSACCESS.EXE [C]:\patis\FertiMed\FertiMed.mdb /wrkgrp [Netzlaufwerk]:\patis\FertiMed\PATISFMStandard.mdw Link zum starten der FertiMed-Applikation ...\MSACCESS.EXE [C]:\patis\FertiMed\FertiMedCenter.mdb /wrkgrp [Netzlaufwerk]:\patis\FertiMed\PATISFMStandard.mdw UpdateFertiMed.exe 2.2.3 Module [C]:\Patis\FertiMed\Moduls FertiMedMaill.dll Updatet die FertiMed-Datei. Siehe Ziff 6 Muss mit regsvr32.exe registriert werden. Ist für das versenden der Fivnat-Daten und Fehlermeldungen, zuständig. 2.3 Information zu FertiMed Dieses Formular ist nur durch den FertiMed-Administrator in der Navigation „Support“ aufrufbar. Version: Ist diese Versionsnummer zu der Versionsnummer unter Information zu Zentrum (Ziff. 2.4 ) unterschiedlich so wird der Update-Prozess gestartet (Ziff. 2.1.5 und Ziff. 6). Fivnat Email: Email Adresse an der die Fivnat-Datenbank für die Fivnat Auswertungen gesendet wird. Error Email: Erkennt FertiMed einen Fehler, so zeigt FertiMed ein Fehler-Dialog-Fenster um eine Fehlermeldung mit Kommentar an diese Emailadresse (an den FertiMed-Support) zu senden. FertiMed Center Name: Name der FertiMed-Center Datei, um das FertiMed-Center aus FertiMed zu starten zu können. 2.4 Information zu Zentrum Dieses Formular ist nur durch den FertiMed-Administrator in der Navigation „Support“ aufrufbar. - Aktiv: Diese Adresse ist die Aktive LiteVersion: Wenn diese aktiviert wird, Programm neu starten. DisplayMsgRecSave: Meldung anzeigen, wenn bearbeitender Datensatz gespeichert wird. DisplayPrinter: Wenn aktiviert, erscheint ein Druckersymbol in den Formularen. Das verbinden von Formularen und den Serienbriefen entnehmen Sie der Ziff. 5.1 Zentrumnummer: Fivnat-Zentrummnummer - Email: Die eigene Emailadresse. SMTP Host: Mailserver im Zentrum Dokumentvorlagen: Verzeichnis in denen sich die Dokumentvorlagen befinden. DokumentAblage: Standard Verzeichnis, bei speichern eines Serienbriefes Aktuelle FertiMed-Version: Ist diese Versionsnummer zu der Versionsnummer unter Information zu FertiMed (Ziff. 2.3) unterschiedlich so wird der Update-Prozess gestartet (Ziff. 2.1.5 und Ziff. 6). Eigener Update-Prozess aktiviert: Wenn aktiviert, kann gemäss Ziff. 6 der Update-Prozess gestartet werden. 2.5 Logbuch Zentrum Logbuch über Arbeiten an FertiMed im Zentrum. 2.6 Logbuch FertiMed Logbuch über Arbeiten an FertiMed. 2.7 Verknüpfte Tabellen - Es müssen alle Tabellen von FertiMed in dieser Tabelle aufgelistet sein. Tabelle: Tabellennamen ConnectNr: 0=Lokal, wird nicht verknüpft, > 1= verknüpfte Tabelle. Die Nummer bestimmt mit welcher Datenbank diese Tabelle verbunden wird (FertiMed.ini, DatenDB[x]=...). Siehe Ziff. 2.2.1 Titel: Bei den Detailtabellen „DT_“welche durch den Benutzer erweiterbar sind, sollte für das editieren ein sinnvoller Titel angegeben werden. EingabeErforderlich: Definiert ob diese Tabelle eine Eingabe erfordert. Für das Überprüfen, ob die Daten für den Patienten vollständig eingegeben wurden. 2.8 Navigation - Feld Eintrag rechts: Bezeichnung des Links in der rechten Auswahlliste FormName/TagName: Jede Navigations-Formular besitzt in der Tag-Eigenschaft einen Namen Schaltfläche links: Nummer der Schaltfläche Schaltfläche Bezeichnung links: Bezeichnung für die Schaltfläche links. Reihenfolge rechts: Festlegen der Reihenfolge in der Auswahlliste What: Welche Aktion o Formular = Formular öffnen o o o o o o o o o o o o o Report Query Makro Meldung Execute Tabelle AccessÖffnen Statistik-Standard Crit1 Crit2 Full Lite Admin = Report öffnen = Abfrage öffnen = Makro Ausführen = Meldung anzeigen = Programm ausführen = Tabelle öffnen = Ausführen/Öffnen eines Access Programms = öffnen des Standard-Statistik-Formulars = Kriterium für die Aktion (z.B. die Meldung, welches Formular öffnen...) = Kann im z.B. aufzurufenden Formular als Kriterium benutzt werden. = In der Vollversion aktiv = In der LiteVersion aktiv = Wenn Admin angemeldet, aktiv 2.9 Security 2.9.1 Access Programm Das FertiMed wird bei einer Anmeldung von einem nicht Administrator automatisch für Code-Zugriffe geschlossen. Das heisst, das FertiMed kann beim Starten nicht für Code-Zugriffe unterbrochen werden. Um den Code-Zugriffe in FertiMed wieder zu ermöglichen, muss sich der FertiMed-Administrator 2 mal anmelden, die Start-Option /Runtime muss ausgeschaltet sein. 2.9.2 FertiMed Benutzerkonten Jeder Benutzer muss sich bei Benutzung von FertiMed mit Passwort anmelden. Die .mdw Datei von FertiMed, welche die Sicherheitsinformationen enthält, muss sich auf dem [Netzlaufwerk]:\patis\FertiMed\ PATISFMStandard.mdw befinden. Zusätzlich zu den FertiMed-Benutzerkonten enthält FertiMed ein Konto in der Administratorengruppe (mit allen Rechten) um das Supporten zu gewährleisten, bei Abwesenheit des FertiMed-Administrators. Dieses Konto wird einer Person mitgeteilt, welches eine Vertraulichkeitserklärung unterzeichnet hat, oder dem Zentrum welches FertiMed einsetzt. 2.9.3 FertiMed Gruppenkonten FertiMed-Benutzer können diesen Gruppenkonten zugefügt werden. Diese Gruppenkonten haben bestimmte Zugriffe auf die Objekte in FertiMed. Es können weitere Gruppenkonten erstellt werden. Administratoren, alle Zugriffe Agehilf, für Arztgehilfinnen Androlab, für andrologisches-Labor FMBenutzer, FertiMed-Benutzer, alle Benutzer von FertiMed müssen dieser Gruppe angehören Masteruser, besondere Zugriffe, wie Abfragen erstellen oder ändern. ReproLab, für Reproduktions-Labor StatistikNormal, Ansicht auf „unwichtige“Statistiken StatistikWichtig, Ansicht auf „wichtige“(nicht öffentliche) Statistiken Benutzer, keinen Zugriff 2.9.4 Zugriff Tabellen Grundsätzlich hat jeder FertiMed-Benutzer über das Gruppenkonto ‚FMBenutzer’in FertiMed sämtlichen Zugriff auf die (nur) Tabellen und Abfragen. Damit entfällt der (riesige) Aufwand für die Rechteerteilung und die Fehleranfälligkeit beim benutzen von FertiMed, wie Berichte und Statistiken. Um einem Benutzer explizit die Zugriffsart für eine Tabelle zu verändern (z.B. nur Leseberechtigung, Zugriff verweigert), so müssen die Rechte dieses Benutzers in FertiMed auf Benutzer- und Tabellenebene eingestellt werden. Allgemein ist die Tabelle-Zugriffsbeschränkungsmöglichkeit mit Vorsicht zu gebrauchen. Die Zugriffssteuerung von FertiMed sollte bevorzugt auf der Formular-Ebene geschehen (Ziff. 2.9.5). Das verändern der Zugriffsteuerung unter ‚Benutzer – und Gruppenberechtigungen’bedarf die Rechte des FertiMed-Administrators. 2.9.5 Zugriff Formular Die Zugriffessteuerung für das öffnen eines Formulars wie auch die Statistiken und Berichte, kann über „Benutzer – und Gruppenberechtigungen“ eingestellt werden. Beispiel: ReproLab Gruppe hat keinen Zugriff auf das Spermiogramm-Formular. Der ReproLab-Gruppe muss einfach die Rechte für das Spermiogramm-Formular öffnen, entzogen werden. FertiMed prüft dies und zeigt eine Meldung. Das verändern der Zugriffsteuerung unter ‚Benutzer – und Gruppenberechtigungen’bedarf die Rechte des FertiMed-Administrators. 2.9.6 Zugriff Datenbank Der Zugriff auf die Datenbank erfolgt mittels ODBC Benutzer-DSN. Wichtig ist die Zuweisung der ODBCVerbindung an den Client-Benutzer, kein System-DSN. Auf dem Datenbank-Server gibt es einen Benutzer mit Voll-Zugriff auf alle Tabellen. Dieser User wird in der ODBC-Konfiguration mit Passwort angegeben. Damit erfolgt keine zusätzliche Anmeldung für Oracle beim Start von FertiMed. Bei der Variante mit Access als Datenbank erfolgt der Zugriff mittels Shared-Folders. 3. Tabellen DT_ MT_ LT_ T_ = Detail Tabellen, Primärschlüssel (ID), Fremdschlüssel (..._ID) einer MasterTabelle = Mastertabellen = Lokale Tabellen = FertiMed System Tabellen 3.1 Detailtabellen Existiert eine Detailtabelle (z.B. DT_Sonographie ) und eine gleiche mit der Endung „_LISTE“(z.B. DT_Sonographie_LISTE) so beschreibt diese die Liste von Möglichkeiten die Fivnat festlegt. Die Nummer beschreibt die (fortlaufende) Nummerierung dieses Feldeintrages (Mehrauswahl) auf dem Fivnatbogen. Damit ist dieser Eintrag nicht sprachenabhängig. Die Detailtabellen sind durch doppelklicken auf das Eingabefeld, änderbar. 3.1.1 Einfache ID =Schlüssel Bezeichnung =Text für Benutzer 3.1.2 Fivnat ID =Schlüssel Bezeichnung =Text für Benutzer Fivnat =Text für Fivnat FivnatNr =Fivnat Feldnummer 3.2 FertiMed System Tabellen T_Dokument_Felder Ein Möglichkeit, komplizierte Datenstrukturen für Serienbrief zusammenzuführen und zu erstellen. Siehe Ziff. 5.3 T_DokumentVorlagen FertiMed/Support/Dokument Vorlagen. Siehe Ziff. 5.2 T_Menu Navigationsinformationen für FertiMed Siehe Ziff. 2.8 T_Menu_Center Navigationsinformationen für FertiMed-Center Siehe Ziff. 2.8 T_Zentrum_Information Informationen über das Zentrum Siehe Ziff. 2.4 T_Zentrum_LogBuch Informationen über durchgeführte Arbeiten im Zentrum. Siehe Ziff. 2.5 3.3 Lokale Tabellen LT_Aktuelle_Patienten Patienten- und Fallnummer des aktuellen Patientenpaars. LT_FertiMed_Information Informationen über das FertiMed. Siehe Ziff. 2.3 LT_FertiMed_Logbuch Informationen über durchgeführte Arbeiten an FertiMed. Siehe Ziff. 2.6 LT_Fivnat_Aktuelle_Patienten Patienten- und Fallnummer des aktuellen Patientenpaars beim erstellen des Fivnat-Berichtes. LT_Fivnat_Felder Befehlsliste für das zusammenführen der Fivnat-Daten LT_Fivnat_Felder_Funktionen Funktionsroutinen, welche mit einer Abfrage nicht lösbar sind. LT_Fivnat_Out Aufbereitete Daten für den Fivnat-Export. LT_Verknuepfte_Tabellen Tabellen welche verknüpft werden. Siehe Ziff. 2.7 4. Formulare 5. Serienbriefe Für die Serienbrief Funktion, muss eine ODBC-Verbindung auf das FertiMedCenter erstellt werden. In FertiMedCenter werden alle Kundenspezifische Abfragen, Statistiken usw. abgelegt. Es besteht die Möglichkeit einfache oder komplexe Serienbriefe zu erstellen. Die einfache, verknüpfen Sie das Dokument mit der gewünschten Tabelle oder Abfrage über die ODBC-Schnittstelle „FertiMedCenter“, fügen Sie die angebotenen Felder ein, Fertig! Es gibt Tabellen, welche mit anderen Tabellen eine 1:n Verknüpfung besitzen und deshalb für einen direkten Serienbrief Zugriff ungünstig sind. Z.B. würde ein Patient mit vielen Krankheiten verknüpft, für jede Krankheit ein neues Dokument erstellt werden. Die Lösung liegt darin, das Sie eine Tabelle oder Abfrage mit dem Serienbrief verknüpfen welche durch definierte Anweisungen einer Tabelle (siehe Ziff. 5.3) erzeugt wurde. 5.1 Druckzentrum Hier wählen Sie eine Dokumentvorlage aus. Ist ein Formular mit einer Dokumentvorlage verknüpft, springt der Cursor auf diesen. Siehe Ziff. 5.2 5.2 Dokumentvorlagen Wird ein Formularname angegeben, so wird in diesem Formular links oben ein Druckersymbol angezeigt (Information Zentrum, DisplayPrinter=aktiv, siehe Ziff. 2.4). Beim öffnen des Druckzentrums, springt der Cursor automatisch auf die definierte Dokumentvorlage. Die Vorlagen müssen sich im Verzeichnis gemäss Ziff. 0 befinden. 5.3 Dokument Felder - DokumentFelderFilter: Filter welcher die Felder für den Komplexen Serienbrief zusammenfasst (siehe Ziff.5.2). SerienFeld: Name des einfügbaren Feldes im Seriebrief Tabelle/Abfrage: Tabelle oder Abfrage der gesuchten Information Feldname: Feldname der Tabelle oder Abfrage der dem Serienfeld zugewiesen wird. Aktion: Befehle welche z.B. Dieses Formular befindet sich im FertiMedCenter, welches für „normale“ Benutzer nicht aufrufbar ist. Hier werden die Informationen für den erweiterten Serienbrief zusammengestellt. Wird so ein Serienbrief aufgerufen, werden zuerst diese Befehle abgearbeitet und damit die Daten in eine Tabelle geschrieben. Danach wird der Serienbrief mit dieser Tabelle verbunden. Werden Änderungen an den Dokument Feldern durchgeführt, müssen die Felder der zu verknüpfenden Tabelle mittels „Fields in Tabelle aktualisieren“ aktualisiert werden. Diese erstellte oder aktualisiert Verknüpfungstabelle nennt sich LT_Dokument & Name des DokumentFelderFilter, z.B. LT_DokumentArztbriefstandard. Daraus wird noch eine Abfrage generiert (qDokumentArztbriefStandard), um z.B. Daten für den Arztbrief zu manipulieren. 6. Versionen-Kontrolle/Update: In der Tabelle T_Zentrum_Information, Feld AktuelleFertiMedVersion der FertiMed-Datenbank ist die aktuelle Version des Kunden und in der Tabelle LT_FertiMed_Information, Feld Version (siehe Ziff. 2.3)die Version der Applikation definiert. Unterscheiden sich diese Angaben, so wird der Update-Prozess gestartet. Nach dem Start von FertiMed wird nach einer Aufforderung das Programm UpdateFertiMed.exe ausgeführt, welches sich im Stammverzeichnis Clientseitig befindet. Die Informationen für das kopieren befinden sich in der FertiMed.ini.