===============================================================================
DOCREPORT AI -- SCHNITTSTELLEN-EINRICHTUNG FUER TOMEDO (MACOS)
===============================================================================

Diese Anleitung fuehrt Sie in 4 einfachen Schritten durch die Anbindung von
DocReport AI an Ihre tomedo Praxissoftware auf macOS.

-------------------------------------------------------------------------------
1. SCHNELLSTART DER PVS BRIDGE
-------------------------------------------------------------------------------
1. Doppelklicken Sie auf die Datei:
   "1-KLICK-START-MAC.command"
2. Das Terminal oeffnet sich automatisch und erstellt die Austauschordner:
   - /Users/Shared/DocReport/in  (Export aus tomedo)
   - /Users/Shared/DocReport/out (Import in tomedo)
3. Geben Sie den 6-stelligen Kopplungs-PIN aus Ihrer DocReport Web-App ein.
4. Sobald "ERFOLG: Verbunden" erscheint, laeuft die Bridge im Hintergrund.

-------------------------------------------------------------------------------
2. TOMEDO: GDT-EXPORT KONFIGURIEREN (Patientendaten senden)
-------------------------------------------------------------------------------
1. Oeffnen Sie in tomedo oben das Menue:
   Admin -> Geraeteeinstellungen -> GDT
2. Klicken Sie unten links auf das Plus-Symbol (+), um ein neues Geraet anzulegen.
3. Tragen Sie im Fenster "GDT-Export" folgende Werte exakt ein:
   - Schnittstellen-Name:     DocReport AI
   - Empfaenger:              DOCREP
   - Sender:                  PVS (oder TOMEDO)
   - Pfad:                    /Users/Shared/DocReport/in/GDTENTR.gdt
                              (oder: /Users/Shared/DocReport/in)
   - Exporttyp:               GDT
   - GDT-Version:             03.00 (oder 02.10)
   - Kodierung:               NSWindowsCP1252 (oder ISO-8859-15)
   - Satzart (Standardfeld):  6301 - Stammdaten uebermitteln

4. ⚠️ WICHTIGSTER SCHRITT: AUSLOESER AKTIVIEREN ("Export bei:")
   Damit tomedo die Patientendaten tatsaechlich an DocReport uebergibt,
   muessen Sie auf der RECHTEN Seite im Bereich "Export bei:" mindestens
   ein Haekchen setzen:
   
   ==> [x] Oeffnen der Kartei     (EMPFOHLEN: Patient wird automatisch beim
                                   Oeffnen der Akte an DocReport gesendet!)
   ODER
   ==> [x] Anlegen eines Besuchs  (Uebertragung bei Anlage eines neuen Scheins)
   
   HINWEIS: Wenn keines dieser Haekchen gesetzt ist und kein Symbolleisten-
   Button aktiv ist, exportiert tomedo NIEMALS eine Datei!

5. OPTIONAL: Symbolleisten-Button fuer manuellen Klick:
   - Waehlen Sie im Fenster unter "Button-Icon" ein Icon aus.
   - Oeffnen Sie die Patientenkartei in tomedo, Rechtsklick auf die Symbolleiste
     oben -> "Symbolleiste anpassen..." und ziehen Sie das "DocReport AI"-Icon hinein.
   - Nun koennen Sie jederzeit auch per Klick den aktiven Patienten uebertragen!

6. Klicken Sie unten rechts auf "Speichern" und danach auf "OK".

-------------------------------------------------------------------------------
3. TOMEDO: GDT-IMPORT KONFIGURIEREN (Befunde & Ziffern empfangen)
-------------------------------------------------------------------------------
1. Oeffnen Sie in tomedo:
   Einstellungen -> Arbeitsplatz -> GDT-Import
2. Tragen Sie folgendes Import-Verzeichnis ein:
   - Verzeichnis:             /Users/Shared/DocReport/out
   - Dateiname:               *.gdt
3. Optionen aktivieren:
   - [x] Karteieintrag anlegen (Satzart 6310)
   - [x] Typ automatisch ermitteln (nutzt Feld 8402: "m" fuer editierbaren Text)
   HINWEIS ZUR NACHBEARBEITUNG IN TOMEDO:
   DocReport uebergibt Berichte standardmaessig mit der Kennung "m" (Medizinischer
   Text), damit der Bericht in tomedo vollstaendig im Fliess text editierbar bleibt
   und im Nachgang korrigiert oder ergaenzt werden kann.
   Falls tomedo importierte Eintraege dennoch sperrt:
   - Deaktivieren Sie in den tomedo GDT-Import-Einstellungen das Haekchen
     "Importierte Eintraege schreibgeschuetzt sperren".
   - Alternativ in tomedo: Rechtsklick auf den Eintrag -> "Eintrag bearbeiten".
4. Klicken Sie auf "Uebernehmen".

-------------------------------------------------------------------------------
4. FUNKTIONSTEST
-------------------------------------------------------------------------------
1. Oeffnen Sie einen beliebigen Patienten in tomedo.
2. Klicken Sie auf den "DocReport AI"-Button in der tomedo-Symbolleiste.
3. In der DocReport Web-App erscheint der Patient sofort im Behandlungsfenster.
4. Nach dem Gespraech / der Diktat-Erstellung klicken Sie in DocReport auf
   "In PVS uebertragen".
5. In tomedo erscheint in Sekundenschnelle der fertige Karteieintrag mit Befund,
   Dokumentation und vorgeschlagenen Abrechnungsziffern.

-------------------------------------------------------------------------------
5. EHR DESKTOP BRIDGE: TASTATURSIMULATION (CMD + ALT + V)
-------------------------------------------------------------------------------
Fuer Freitext-Felder, tomedo-Briefe oder wenn kein GDT eingerichtet ist:
1. Lassen Sie die Bridge im Hintergrund laufen.
2. Klicken Sie in tomedo in ein beliebiges Freitextfeld oder Karteikarten-Eingabefeld.
3. Druecken Sie auf der Mac-Tastatur:
   ==> Cmd + Alt + V (bzw. Befehl + Wahl + V)
   Der Text wird per Tastatursimulation direkt in das aktive Feld getippt!

-------------------------------------------------------------------------------
PROBLEMBEHEBUNG (GATEKEEPER AUF MACOS)
-------------------------------------------------------------------------------
Falls macOS beim Starten einer .app meldet "Programm ist beschaedigt":
Oeffnen Sie das Terminal und fuehren Sie einmalig aus:
xattr -cr "/Applications/DocReport PVS Bridge.app"
Oder nutzen Sie einfach das 1-Klick-Skript "1-KLICK-START-MAC.command",
das alle Berechtigungen und Quarantäne-Flags vollautomatisch bereinigt.

Support & Hilfe: support@docreport.eu | https://docreport.eu/pvs-integration
===============================================================================
