Praxis-Handbuch · weiterer Arbeitsplatz

Wenn die Einrichtung nicht von allein durchläuft

Normalerweise genügt ein Doppelklick auf EINRICHTEN.command. Dieses Heft ist für den anderen Fall: Es zeigt zu jedem Schritt, den das Skript sonst erledigt, den Weg von Hand — was zu klicken ist, und woran Sie sehen, dass es geklappt hat.

Paket-Fassung 2026-08-04f · gemessen an den Praxis-Macs von Dr. Klaproth

Grundregel für dieses Heft: Jeder Schritt hat einen Beweis. Wenn der Beweis fehlt, ist der Schritt nicht fertig — auch wenn keine Fehlermeldung kam. Die teuersten Störungen der letzten Wochen waren allesamt stumm.

Bevor Sie anfangen: zwei Fragen

Beide Antworten entscheiden, ob der Rest überhaupt Sinn ergibt.

Ist das ein Mac?

Der Connector läuft nur auf macOS.

Auf einem Windows-PC gilt

Anfragen ansehen und beantworten: ja. „In tomedo übernehmen" dort niemals klicken — die Datei landet dann auf jenem PC und erreicht tomedo nie.

Sind die Apple-Entwicklerwerkzeuge da?

Im Terminal eingeben

xcode-select -p

Gut: Es erscheint ein Pfad, z. B. /Library/Developer/CommandLineTools.

Erscheint stattdessen ein Fehler, fehlen die Werkzeuge. Dann läuft kein einziges Connector-Skript. Einmalig xcode-select --install ausführen (dauert 30–40 Minuten), danach hier weitermachen.

Der Haken dabei: python3 ist auf jedem Mac vorhanden und meldet sich als vorhanden — ohne die Werkzeuge ist es aber nur eine Attrappe. Deshalb wird hier nach xcode-select gefragt und nicht nach Python.

Die acht Schritte von Hand

Reihenfolge einhalten. Schritt 6 und 7 sind die beiden, an denen es erfahrungsgemäß hängt.

Paket holen und an seinen Platz legen

Von Hand

cd ~/Downloads
curl -fsSO https://diggai.de/downloads/diggai-tomedo-arbeitsplatz.zip
unzip -q -o diggai-tomedo-arbeitsplatz.zip -d /tmp/dgu
ditto /tmp/dgu/diggai-tomedo-arbeitsplatz ~/DiggAI-Connector
rm -rf /tmp/dgu

Beweis

cat ~/DiggAI-Connector/FASSUNG nennt die Fassung, z. B. 2026-08-04e.

Der Ordner muss ~/DiggAI-Connector heißen. Wird das Paket aus dem Downloads-Ordner heraus betrieben, trägt der Automatik-Dienst diesen Startort als sein Zuhause ein — und startet nicht mehr, sobald jemand dort aufräumt. Der Ausfall ist völlig stumm.

Connector und Automatik-Wächter installieren

Von Hand

cd ~/DiggAI-Connector
bash install.sh --mit-automatik

Beweis

pgrep -fl kreis_waechter.sh nennt eine Prozessnummer. Kommt keine Zeile, läuft der Wächter nicht — dann Schritt 8 unten.

Alte Einrichtungen stilllegen

Auf einigen Rechnern liegt noch ein Wächter aus dem Juli. Er bucht auf einen Sammelpatienten und beobachtet denselben Ordner — beides schadet.

Von Hand

launchctl list | grep -i diggai

Erscheint dort de.diggai.gdt-watcher, abschalten — nicht löschen:

launchctl bootout gui/$(id -u)/de.diggai.gdt-watcher
mkdir -p ~/DIGGAI/deaktiviert
mv ~/Library/LaunchAgents/de.diggai.gdt-watcher.plist ~/DIGGAI/deaktiviert/

Beweis

In der Liste steht nur noch de.diggai.connector.

Konfiguration setzen

Die Datei ~/DiggAI-Connector/diggai.conf mit einem Texteditor öffnen — oder die vier Zeilen so setzen:

DIGGAI_WATCH_DIR="$HOME/DiggAI-Praxis/eingang"
DIGGAI_IMPORT_DIR="$HOME/DiggAI-Praxis/gdt"
DIGGAI_ANLEGEN="fragen"
DIGGAI_DUMMY_PATIENT_NR="197554"

Und die Ordner anlegen:

mkdir -p ~/DiggAI-Praxis/eingang ~/DiggAI-Praxis/gdt ~/DiggAI-Praxis/pdf

Nach jeder Änderung an dieser Datei den Wächter durchstarten (Schritt 8). Der laufende Dienst hält die alten Werte im Speicher — und --status liest die Datei frisch und zeigt deshalb nicht, womit der laufende Dienst tatsächlich arbeitet.

Beweis

bash ~/DiggAI-Connector/tools/kreis_waechter.sh --status zeigt die Zeile „Neue Patienten: RÜCKFRAGE am Bildschirm".

Download-Ordner des Browsers umstellen

Firefox: Einstellungen → Allgemein → Downloads → „Alle Dateien in folgendem Ordner abspeichern" → ~/DiggAI-Praxis/eingang.

Safari: Einstellungen → Allgemein → „Download-Ort" → derselbe Ordner.

Der Downloads-Ordner geht nicht. macOS schützt Downloads, Schreibtisch und Dokumente besonders. Ein Hintergrunddienst bekommt dort keinen Lesezugriff — ohne Meldung, ohne Dialog. Die Übernahmen bleiben einfach liegen, und im Protokoll steht nur „gestartet". Genau daran ist es am 3. August einen halben Tag lang gescheitert.

Beweis

Im Portal einen Vorgang übernehmen — die Datei erscheint in ~/DiggAI-Praxis/eingang, nicht in Downloads.

tomedo: GDT-Importgerät und Anhang-Lauscher

Das sind Arbeitsplatz-Einstellungen — sie liegen nicht am Server und müssen an jedem Rechner einzeln gesetzt werden. Am einfachsten per Doppelklick auf tools/tomedo_gdt_lauscher.command. Von Hand in tomedo:

Einstellungen → Geräte → GDT-Import

Importpfad: /Users/<benutzer>/DiggAI-Praxis/gdt/
Dateimuster: DIGGAI_*.gdt
Karteieintrag aktualisieren: an

Einstellungen → Kartei → Anhang-Lauscher

Suchpfad: /Users/<benutzer>/DiggAI-Praxis/pdf
Rekursive Suche: an — sonst sieht er die Unterordner nicht
Zuordnung über Patienten-ID: an
Zuordnungs-Ebene: 1 · Ausdruck: ([0-9]+)
Karteieintragstyp: DiggAI

Die Patientennummer ist der Ordnername, nicht Teil des Dateinamens. Der Connector legt jede PDF als pdf/<Patientennummer>/<datei>.pdf ab — deshalb Ebene 1 und rekursive Suche. Steht die Zuordnung über Patienten-ID auf aus, meldet der Lauscher trotzdem Erfolg und hängt die PDF an den falschen Patienten.

Der Importpfad wird nur beim Programmstart gelesen. Nach der Änderung tomedo einmal beenden und neu starten — danach steht die Anmeldemaske, die Anmeldung ist Sache der Praxis.

Beweis

defaults read com.zollsoft.tomedo-macOS ZSGDTDateiImportPfad nennt den Praxis-Pfad.

Freigaben — die einzigen Handgriffe, die Apple nicht automatisieren lässt

Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen. Drei Einträge müssen eingeschaltet sein:

AEServer

applet

bash

DiggAIRunner

Terminal

tomedo

So soll die Liste aussehen. „applet" darf aus bleiben — es wird nicht gebraucht; mehr freizugeben als nötig ist kein Vorteil.

„bash" erscheint erst nach dem ersten Automatik-Lauf — stumm und auf aus. Also: Freigaben setzen, einen Vorgang übernehmen, dann die Liste erneut öffnen und „bash" einschalten.

Die Schalter sehen im inaktiven Fenster alle nach „aus" aus. Erst das Fenster anklicken, dann ablesen — sonst diagnostiziert man „alle Rechte weg", wo nichts fehlt.

Zusätzlich erscheint einmalig das Fenster „bash" möchte „System Events" steuern → Erlauben. Das ist eine andere Berechtigung als die Bedienungshilfen und wird separat abgefragt.

Beweis

Nicht die Liste, sondern das Protokoll: In ~/Library/Logs/diggai-kreis-waechter.log steht nach einem Vorgang „Kreis geschlossen". Ein Test im Terminal beweist nur Terminals eigene Freigabe, nichts über den Hintergrunddienst.

Wächter durchstarten

Von Hand

launchctl kickstart -k gui/$(id -u)/de.diggai.connector

Meldet das „Could not find service", stattdessen neu laden:

launchctl bootout gui/$(id -u)/de.diggai.connector 2>/dev/null
sleep 2
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/de.diggai.connector.plist

Beweis

pgrep -fl kreis_waechter.sh nennt eine Prozessnummer.

Die Abnahme

Erst dieser Durchlauf beweist, dass der Arbeitsplatz fertig ist — nicht die Liste der erledigten Schritte.

✓

Im Portal übernehmen und 90 Sekunden nichts tun

Einen Vorgang öffnen → „In tomedo übernehmen" → dann die Hände vom Rechner. Der Eintrag muss von selbst in der Kartei erscheinen.

DatumUhrzeitTypEintrag

04.08.2611:47DiggAI📎 Anhang

04.08.2611:47TA-DiggAiTermin am: 22.09.2026 · Absagegrund …

Zwei Zeilen gehören zusammen: der Karteieintrag mit dem Inhalt der Anfrage und die Büroklammer mit dem Original-PDF.

Gemessene Dauer: vom Klick im Portal bis zum fertigen Karteieintrag samt PDF vergingen 33 Sekunden. Wer früher nachsieht, hält einen laufenden Vorgang für einen Ausfall.

Während der Übernahme schwebt ein kleines Fortschrittsfenster über tomedo: es zeigt den echten Stand des Vorgangs (aus der Quittung des Connectors) und warnt davor, währenddessen in tomedo zu tippen. Es öffnet sich einmal je Vorgang und schließt sich nach sauberem Ende von selbst. Muss der Vorgang warten (z. B. auf den tomedo-Server), steht der Grund im orangen Band des Fensters — das Fenster bleibt dann stehen, bis der Vorgang gebucht ist.

Wenn der Patient noch nicht in tomedo steht

Dann fragt der Arbeitsplatz nach — und erledigt nach einem Klick alles Weitere allein.

DiggAi – neuer Patient

⚠️

Eine neue Anfrage aus dem DiggAi-Portal gehört zu einem Patienten, den es in tomedo noch nicht gibt:

Karla Kettenprobe
geboren am 03.03.1985

Soll DiggAi den Patienten jetzt anlegen und die Anfrage in seine Kartei eintragen?

So sieht die Rückfrage aus. Sie erscheint auf dem Arbeitsplatz, der den Vorgang übernommen hat.

Ihre Antwort	Was dann passiert
Patient anlegen	DiggAi legt den Patienten an, prüft ihn über Name und Geburtsdatum gegen, öffnet die Kartei, trägt die Anfrage ein und hängt das PDF an. Gemessen: 26 Sekunden von der Antwort bis fertig. Vergibt der tomedo-Server die Patientennummer einmal nicht sofort, wartet die Automatik von selbst: nach 5 Minuten meldet sie sich einmal sichtbar, danach versucht sie es alle 10 Minuten erneut — sobald die Nummer da ist, wird ohne weiteres Zutun gebucht. Es geht nichts verloren.
Später fragen	Die Anfrage ruht 10 Minuten und wird danach erneut vorgelegt. Es geht nichts verloren.
Keine Antwort	Nach 2 Minuten schließt sich das Fenster von selbst — behandelt wie „Später fragen". Eine Anfrage, die in der Mittagspause eintrifft, ist damit nicht verloren.
Nicht anlegen	Halt mit sichtbarer Meldung; eine Kopie liegt in `~/DiggAI-Connector/quarantine/`. Der Vorgang wird nicht gebucht.

Genau ein Arbeitsplatz sollte anlegen dürfen. Legen zwei Rechner denselben Menschen gleichzeitig an, entsteht eine Dublette in der Patientenkartei. An allen weiteren Rechnern in diggai.conf DIGGAI_ANLEGEN="0" setzen. Dasselbe gilt für Bildschirme, die Patienten einsehen können — im Dialog steht ein Klarname.

Kontaktdaten: Adresse, E-Mail, Telefon und Mobilnummer werden eingetragen, soweit die Anfrage sie mitbringt — das ist je nach Dienst verschieden. Lässt sich ein Feld nicht zweifelsfrei erkennen, schreibt der Connector dort nichts hinein und vermerkt es im Protokoll: eine falsche Rufnummer wird angerufen, eine fehlende fällt auf. Alle Angaben stehen in jedem Fall vollständig im Karteieintrag.

Wenn etwas hakt

Die Meldungen, die in der Praxis tatsächlich vorkamen — und was sie bedeuten.

Beobachtung	Bedeutet	Abhilfe
„tomedo ist abgemeldet"	Meist stimmt es: tomedo meldet sich nach etwa 10 Minuten Ruhe selbst ab.	In tomedo anmelden — die Anfrage wird danach von selbst gebucht. Aber: steht eine Zeile darüber „timed out after 180 seconds", blockiert in Wahrheit ein Dialog in tomedo. Den erst wegklicken.
„… wartet auf die Patientennummer vom tomedo-Server"	Der Patient ist angelegt, aber der tomedo-Server hat die endgültige Nummer noch nicht vergeben. Kurz ist das normal; dauert es Minuten, stockt die Verbindung zum tomedo-Server.	In tomedo prüfen, ob die Anlage gespeichert ist und der Server erreichbar ist. Nichts löschen — die Anfrage bleibt liegen und wird automatisch gebucht, sobald die Nummer da ist (belegt: nach 4½ Stunden Serverstörung ohne Zutun nachgebucht).
Nichts passiert, Protokoll zeigt nur „gestartet"	Der Wächter sieht den Eingangsordner nicht.	Schritt 5: Download-Ordner darf nicht `~/Downloads` sein.
„keine Berechtigung für den Hilfszugriff"	Bedienungshilfen fehlen (Fehler −25211 / −1728).	Schritt 7 — besonders bash.
Zeitüberschreitung, Fehler −1712	Entweder blockiert ein Dialog in tomedo, oder die Automation-Freigabe fehlt.	Bildschirm ansehen und den Dialog beantworten; sonst „bash möchte System Events steuern" erlauben.
Eine Datei bleibt liegen	Der Wächter fasst nur an, was nach seinem Start erschien — Altbestand bleibt bewusst liegen.	`touch ~/DiggAI-Praxis/eingang/DIGGAI_….gdt` — etwa 35 Sekunden später steht sie in der Kartei. Niemals eine GDT von Hand in den `gdt/`-Ordner kopieren; dann fehlt die PDF-Zuordnung.
Der Vorgang hängt im Eingang fest	Der Übernehmen-Knopf direkt im Eingang kann Zeilen zurücklassen.	Vorgänge über den Reiter Bearbeiten übernehmen und danach auf „Erledigt" setzen.

Kontrolle im Alltag

Zwei Stellen, mehr braucht es nicht

Doppelklick auf ~/DiggAI-Connector/status.command — zeigt Wächter, Ordner, offene Meldungen.
Das Protokoll: ~/Library/Logs/diggai-kreis-waechter.log. Die Zeile „Kreis geschlossen" ist der Beleg, dass ein Vorgang vollständig in der Kartei steht.

Was der Connector niemals tut

Er löscht nichts. Jede Datei wandert nach der Verarbeitung nach verarbeitet/ oder quarantine/ — auch die, an denen er gescheitert ist.