[OnyxCeph³™ Wiki]

OnyxClientSetup unterstützt einen Silent-Mode mit folgenden Kommandozeilenparametern:

• Fehlt ein Parameter, so stoppt OnyxClientSetup an der betreffenden Position
• Bei -PATH=Default wird in das Standardverzeichnis ..\Programme\Image Instruments\Onyx3Client\ installiert
• Wenn nicht übergeben, wird dem Pfad automatisch das Standard-Unterverzeichnis Onyx3Server hinzugefügt
• Sind im Pfad Leerzeichen vorhanden, den Parameter in Anführungsstrichen übergeben: -PATH=“C:\\Onyx Ceph“

Beispiele
Folgende Kommandozeile verbindet auf den Server SRV über Port 16300 und installiert einen deutschen Arbeitsplatz im Standardverzeichnis:

OnyxClientSetup.exe -Auto -Server=[SRV]@SRV -Lang=1 -Path=Default 

Folgende Kommandozeile verbindet auf den Server SRV über Port 16500 und installiert einen englischen Arbeitsplatz im Verzeichnis D:\OnyxCeph\Onyx3Client:

OnyxClientSetup.exe -Auto -Server=[SRV]@172.1.1.250 -Port=16500 -Lang=2 -Path=D:\OnyxCeph 

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:

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³™ der HTTP Infoserver 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.

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. Übergabe von Patient und Bild mittels einer DICOM-Datei:

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