Die Übergabe von Patientendaten an OnyxCeph³™ erfolgt durch starten der Datei OnyxCeph.exe mit speziellen Kommandozeilenparametern. Es gibt 2 Möglichkeiten die Patientendaten an OnyxCeph³™ zu übergeben. Entweder über Kommandozeilenparameter oder über eine Textdatei im INI-Format. In beiden Fällen werden Parameter zur Übergabe verwendet. Folgende Parameter werden unterstützt:

¹ Als Kommandozeilenparameter "<CLEAR>" immer in Anführungszeichen.
² Format: JJJJMMTT, z.B. "20090530" oder JJJJ-MM-TT, z.B. "2009-05-30" oder „Kurzes Datum“ von Windows z.B. tt.mm.jjjj → "30.05.2009"

Neben Patientendaten können auch Bilddateien zur Bildaufnahme an OnyxCeph übergeben werden. Unterstützt werden die Formate BMP, TIF, JPG, GIF, CMP, PNG, PCX, IMG, DICOM u.a.
Um sicherzustellen, dass die Bilder dem richtigen Patienten zugeordnet werden, muss zumindest die Patienten-ID unter Nutzung des oben beschriebenen Markers PatID übergeben werden. Die Übergabe aller weiteren Patientendaten ist zusätzlich möglich.
Zum Übergeben von 2D-Bildern an OnyxCeph³™ können die folgenden Marker benutzt werden:

¹ # steht für die Bildnummer beginnend mit 1 ; der erste Eintrag lautet z.B. -PicPath1="C:\tmp\img.jpg"

Bei Übergabe der Patienten- bzw. Bilddaten über Kommandozeilenparameter wird die Datei OnyxCeph.exe mit den Markern und gefolgt von den Werten als Kommandozeile gestartet. Jedes Wert sollte wir folgt übergeben werden:

Zwischen den Werten muss mindestens ein Leerzeichen stehen (siehe Beispiele unter Punkt 6).

Ist in OnyxCeph³™ das HTTP Interface aktiv, so können die Stammdaten auch über eine HTTP-Anfrage an OnyxCeph³™ übergeben werden.
OnyxCeph³ agiert dann als HTTP-Server und bedient das konfigurierte Port. Ist die CheckBox Nur lokal aktiv (Standard), so werden nur Verbindungen von der IP 127.0.0.1 zugelassen.

Ist in Wert kein Leerzeichen enthalten, so können die Anführungsstriche weggelassen werden.

Bitte beachten, dass in URLs einige Zeichen nicht zulässig sind, und „escaped“ werden müssen.
So muss statt dem Leerzeichen %20 und statt dem Backslash \ die Zeichenfolge %5C übergeben werden.
Sie dazu auch: https://de.wikipedia.org/wiki/URL-Encoding

Hier muss erst eine Textdatei im INI-Format erzeugt werden. In dieser Datei muss ein Abschnitt [PatDat] vorhanden sein. In diesem Abschnitt können die Patienten und Bilddaten unter Verwendung der oben beschriebenen Marker gespeichert werden. Ein Beispiel finden Sie am Ende des Textes.
Um die Datenübernahme zu starten, muss OnyxCeph.exe mit den Parametern: -PatID und -Data gestartet werden. Nach -Data= muss der komplette Pfad der INI-Datei mit den Patientendaten übergeben werden. OnyxCeph³™ prüft, ob die über -PatID übergebene Patientennummer mit der Patientennummer in der INI-Datei übereinstimmt. Nur dann werden die Daten übernommen.

Eine DICOM-Datei enthält sowohl die Patientendaten, als auch Bilddaten. Wenn nach dem Kommandozeilenparameter:

der Name mit Pfad einer DICOM-Datei übergeben wird, so werden die Stammdaten des Patienten abgeglichen und das Bild in der 2D-Bildaufnahme geöffnet.
Der Parameter -PicErase wir hier ebenfalls unterstützt.

Beim DICOM-Import werden andere übergebene Parameter ignoriert, und brauchen nicht übergeben zu werden.

Eine .O3C-Container-Datei enthält sowohl die Patientendaten, als auch Bilddaten. Es können die Daten mehrerer Patienten enthalten sein. Wenn nach dem Kommandozeilenparameter:

der Name mit Pfad einer Container-Datei übergeben wird, so werden die Stammdaten der Patienten und die Bilddaten abgeglichen. Dazu öffnet sich der Container-Import-Dialog.
Wurde der Container vom Versender auf einen FTP-Server hochgeladen, so kann über den Kommandozeilenparameter ContainerFTP der Schlüssel übergeben werden:

Mit dem Kommandozeilenparameter ContainerNote kann ein String übergeben werden, der dem Kommentar der übernommen Bilder angehängt wird:

Nach dem Import wechselt OnyxCeph³ automatisch zu dem Klienten und Patienten.
Beim Container-Import werden andere übergebene Parameter ignoriert, und brauchen nicht übergeben zu werden.

Über die Parameter ActionBefore und ActionAfter können bestimmte Module gestartet werden. Aktuell wird der Start folgender Module unterstützt (wird noch erweitert):

• ActionBefore (vor Stammdatenabgleich)

• ActionAfter (nach Stammdatenabgleich bzw. Containerimport)

Zur Datenübergabe muss die Datei OnyxCeph.exe aufgerufen werden. Diese Datei ist an jedem Client lokal installiert. Die Default-Position ist:

 <Programme>\Image Instruments\Onyx3Client\OnyxCeph.exe

Da diese Position jedoch während der Installation geändert werden kann, ist es am sichersten, die Position des Client-Installationsverzeichnisses aus der Registry auszulesen. Dazu wird der folgende Schlüssel benötigt:

 HKEY_LOCAL_MACHINE\SOFTWARE\Image Instruments\OnyxCeph\Install Path

Dort kann abgelesen werden, wo der OnyxCeph³ Client installiert wurde.

a. Auslesen d. Registry-Schlüssels

 HKEY_LOCAL_MACHINE\SOFTWARE\Image Instruments\OnyxCeph\Install Path

Der Wert kann z.B. "C:\Programme\Image Instruments\Onyx3Client\" lauten

b. Übergabe eines Patienten:

 "C:\Programme\Image Instruments\Onyx3Client\OnyxCeph.exe" -PatId="123" -Firstname="Test" -Lastname="Patient" -Birthday="19960313" -Sex="F" -PatMarker=-1---

c. Übergabe zweier Bilder zu bereits vorhandenem Patienten:

 "C:\Programme\Image Instruments\Onyx3Client\OnyxCeph.exe" -PatId="123" -PicCount=2 -PicPath1="C:\temp\XRay.tif" -PicPath2="C:\My Images\Foto.jpg"

d. Übergabe zweier STL-Dateien, Dateien nach dem Import löschen:

 "C:\Programme\Image Instruments\Onyx3Client\OnyxCeph.exe" -PatId="123" -PicErase=1 -PicCount=2 -PicPath1="C:\scan\OK.stl" -PicPath2="C:\scan\UK.stl"

e. Übergabe von Patient und Bildern in einem Schritt:

OnyxCeph³™ soll die Quelldateien nach der Übernahme löschen:

 "C:\Programme\Image Instruments\Onyx3Client\OnyxCeph.exe" -PatId="123" -Firstname="Test" -Lastname="Patient" -Birthday="19960313" -Sex="F" -Title="Dr. med. dent." -City="Chemnitz" -PicCount=2 -PicErase=1 -PicPath1="C:\temp\XRay.tif" -PicInfo1="Lateral Ceph" -PicDate1="20000815" -PicPath2="C:\My  Images\Foto.jpg" -PicInfo2="Lateral Foto" -PicDate2="20000814"

f. Patient über HTTP öffnen und Name aktualisieren:

Öffnet den Patienten 123 und aktualisiert ggf. die Stammdaten

 http://127.0.0.1:24000/setpat -PatId="123" -Firstname="Test" -Lastname="Patient"

Birthday="19960313" PatMarker=”-1—”

g. Patient und Präsentationstemplate über HTTP öffnen:

Öffnet den Patienten 123 und dann das Präsentationstemplate Onyx_Images_8

 http://127.0.0.1:24000/setpat -PatId=123 -ActionAfter="Presentation:Onyx_Images_8"

h. Patient über HTTP kopieren:

Kopiert den Patienten 123 mit allen Bildern, die Kopie erhält die neue Patientennumer 123Neu und wird in "Test Patient" umbenannt

 http://127.0.0.1:24000/setpat -ActionBefore="ClonePatient:123" -PatID="123Neu"

-Firstname="Test" -Lastname="Patient"

i. Verwendung einer Datei zur Datenübergabe:

Hierzu muss zunächst eine INI-Datei mit beliebigem Name erzeugt werden:

MeinePatientenDaten.ini:

 [PatDat]
 PatId=123
 Firstname=Test 
 Lastname=Patient 
 Birthday=19960313 
 Sex=F
 Title=Dr. med. dent.
 City=Chemnitz 
 PicCount=1 
 PicPath1=C:\temp\XRay.tif 
 PicInfo1=Lateral Ceph
 PicDate1=20000815 

Danach kann OnyxCeph³™ mit folgendem Parameteraufruf gestartet werden:

 "C:\Programme\Image Instruments\Onyx3Client\OnyxCeph.exe" -PatId="123" -Data="C:\Temp\MeinePatientenDaten.ini"

j. Übergabe von Patient und Bild mittels einer DICOM-Datei:

OnyxCeph³™ soll die Patienten und Bilddaten aus der DICOM-Datei laden und nach der Übernahme löschen:

 "C:\Programme\Image Instruments\Onyx3Client\OnyxCeph.exe" -DICOM=C:\Temp\XRayPost.DCM" -PicErase=1

k. Import von Patienten und Bildern aus einem Container:

OnyxCeph³ soll die Patienten und Bilddaten aus einem Container laden, dieser liegt auf einem FTP-Server. In das Kommentarfeld der aufgenommenen Bilder soll die Auftragsnummer eingetragen werden:

 "c:\Programme\Image Instruments\Onyx3Client\OnyxCeph.exe" -ContainerFTP="C5UW5SJNN3....B6DKHUWUQKD73" -ContainerNote=#42

oder über HTTP:

 http://127.0.0.1:2400/setpat -ContainerFTP="C5UW5SJNN3....B6DKHUWUQKD73" ContainerNote=#42