Konfiguration

[Optional] Soldicom-Service für mehrere Mandanten konfigurieren

Für den Fall, dass in einer Praxis mehrere Mandanten mit DICOM4charly arbeiten möchten, deren Röntgengerät in seiner MWL-Anfrage keine Mandantenkennung liefert, muss die Konfiguration des Soldicom-Services angepasst werden.

Hinweis: Ausführliche Informationen zum Soldicom-Service sowie der Mandantenfähigkeit finden Sie hier: Soldicom-Service

 

[Optional] Ports ändern

Falls einer oder mehrere der erforderlichen Ports für DICOM4charly bereits belegt sind, konfigurieren Sie diese um:

Hinweis: Kundenspezifische Konfigurationen müssen unter ncjs in dem Verzeichnisconf2 abgelegt werden, da dieses Verzeichnis durch charly-Updates nicht überschrieben wird. Innerhalb des Verzeichnisses conf2 muss für jeden Microservice, für den eine kundenspezifische Konfiguration hinterlegt wird, ein weiteres Verzeichnis mit dem Namen des Microservices angelegt werden. Dort wird die kundenspezifische „application.yml“-Datei abgelegt.

Beispiel-Pfad einer kundenspezifischen „application.yml“-Datei mit Konfigurationen für den Soldicom-Service:
\Solutio\Server\ncjs\conf2\soldicom\application.yml

 

Hinweis: Sofern keine neuere charly-Version vorliegt, aktualisiert der charly-Updater ausschließlich den charly-Java-Server und nimmt dabei die Port-Änderungen vor. Falls eine neuere charly-Version verfügbar ist, aktualisiert der charly-Updater zusätzlich die charly-Version.

Voraussetzungen

  • Der charly-Updater liegt auf dem charly-Server (Download Windows bzw. Download macOS).
  • Der charly-Server verfügt über eine Internetverbindung.

  • Das Ausführen des charly-Updaters ist vorbereitet:

    1. Schalten Sie alle charly-Arbeitsplätze (Clients) aus.
    2. Schließen Sie auf dem charly-Server alle Programme.
    3. Führen Sie auf dem charly-Server eine Datensicherung durch.
    4. Starten Sie den charly-Server neu.
    5. Melden Sie sich mit Administratorrechten am charly-Server an.
    6. Deaktivieren Sie auf dem charly-Server den Virenscanner für den Zeitraum des Updates.

Vorgehensweise

  1. Starten Sie den charly-Updater.
  2. Folgen Sie den Anweisungen des charly-Updater-Assistenten bis zu der Maske für die Konfiguration der Ports für den SSL-Proxy sowie für den Messaging-Service.
  3. Ändern Sie den bzw. die Ports.

  4. Folgen Sie weiter den Anweisungen des charly-Updater-Assistenten.

    • Der charly-Updater führt die Port-Änderungen im charly-Java-Server durch.
  1. Öffnen Sie auf dem Server folgendes Verzeichnis:
    <charly-Installationspfad>\Solutio\Server\ncjs\
  2. Legen Sie in diesem Verzeichnis das Verzeichnis „conf2“ und darin das Verzeichnis „messaging“ an:
    <charly-Installationspfad>\Solutio\Server\ncjs\conf2\messaging\
  3. Legen Sie in dem Verzeichnis „messaging“ eine Textdatei an und benennen Sie diese mit „application.yml“.

  4. Kopieren Sie die folgende Einstellung in die application.yml:

    de.solutio.ncjs.messaging.broker.stomp.port:14712

  5. Ändern Sie den Port.

  6. Damit der Messaging-Service die fertig bearbeitete application.yml verwendet, muss der Messaging-Service gestoppt und anschließend wieder gestartet werden:

    • Windows

      1. Öffnen Sie die Administrator-Kommandozeile und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>\Solutio\Server\ncjs

      2. Stoppen Sie den Messaging-Service:

        acd.bat stop messaging

      3. Starten Sie den Messaging-Service:

        acd.bat start messaging

    • macOS

      1. Öffnen Sie das Terminal und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>/Solutio/Server/ncjs

      2. Stoppen Sie den Messaging-Service:

        sudo ./acd.sh stop messaging

      3. Starten Sie den Messaging-Service:

        sudo ./acd.sh start messaging

  7. Prüfen Sie, ob der Messaging-Service gestartet ist:

    1. Öffnen Sie ein Browserfenster.

    2. Geben Sie folgende URL ein: http://<IP des charly-Servers oder IP der charly-VM (bei Containerinstallation)>:8087

      • Das Eureka-Dashboard öffnet sich und zeigt alle registrierten und gestarteten Microservices des charly-Java-Servers. Nach ca. 1 – 2 Minuten sollte hier auch der Messaging-Service mit dem Status „UP“ gelistet sein.
Hinweis: Die folgende Schrittanleitung beschreibt die Vorgehensweise in einem charly mit einem Mandanten. Sofern Sie in Ihrer Praxis einen charly mit mehreren Mandanten und einem nicht-mandantenfähigen Röntgensystem einsetzen, müssen Sie in Schritt 4 der Schrittanleitung die Standard-Konfiguration entsprechend um Services für den oder die Mandanten erweitern.

Für weitere Informationen siehe Mandantenfähigkeit.

Vorgehensweise

  1. Öffnen Sie auf dem Server folgendes Verzeichnis:
    <charly-Installationspfad>\Solutio\Server\ncjs\
  2. Legen Sie in diesem Verzeichnis das Verzeichnis „conf2“ und darin das Verzeichnis „soldicom“ an:
    <charly-Installationspfad>\Solutio\Server\ncjs\conf2\soldicom\
  3. Legen Sie in dem Verzeichnis „soldicom“ eine Textdatei an und benennen Sie diese mit „application.yml“.
  4. Kopieren Sie die Standard-Konfiguration in die application.yml. Siehe Standard-Konfiguration für einen Mandanten.
  5. Bearbeiten Sie die application.yml: Ändern Sie in der kopierten Standard-Konfiguration den bzw. die Ports in freie Ports.

  6. Damit der Soldicom-Service die fertig bearbeitete application.yml verwendet, muss der Soldicom-Service gestoppt und anschließend wieder gestartet werden:

    • Windows

      1. Öffnen Sie die Administrator-Kommandozeile und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>\Solutio\Server\ncjs

      2. Stoppen Sie den Soldicom-Service:

        acd.bat stop soldicom

      3. Starten Sie den Soldicom-Service:

        acd.bat start soldicom

    • macOS

      1. Öffnen Sie das Terminal und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>/Solutio/Server/ncjs

      2. Stoppen Sie den Soldicom-Service:

        sudo ./acd.sh stop soldicom

      3. Starten Sie den Soldicom-Service:

        sudo ./acd.sh start soldicom

  7. Prüfen Sie, ob der Soldicom-Service gestartet ist:

    1. Öffnen Sie ein Browserfenster.

    2. Geben Sie folgende URL ein: http://<IP des charly-Servers oder IP der charly-VM (bei Containerinstallation)>:8087

      • Das Eureka-Dashboard öffnet sich und zeigt alle registrierten und gestarteten Microservices des charly-Java-Servers. Nach ca. 1 – 2 Minuten sollte hier auch der Soldicom-Service mit dem Status „UP“ gelistet sein.

 

In charly: Lizenz freischalten

Um DICOM4charly öffnen zu können, muss zunächst die Lizenz freigeschaltet werden.

 

Voraussetzungen

  • Sie haben die DICOM4charly-Lizenz der solutio GmbH & Co. KG erworben.

Vorgehensweise

  1. Klicken Sie in charly in der Menüleiste auf Hilfe > Zusätzliche Lizenzen.
  2. Aktivieren Sie in dem Fenster die CheckboxDICOM4charly und geben Sie in dem Feld daneben die Lizenz für die DICOM4charly-Schnittstelle ein.
  3. Klicken Sie auf den Button Speichern.

  4. Starten Sie charly neu.

    • Nach dem Neustart steht Ihnen in der Menüleiste unter Start die Option DICOM4charly zur Verfügung. Über diese Option rufen Sie DICOM4charly auf.

 

Im DICOM-Röntgensystem: Schnittstelle zu DICOM4charly konfigurieren

Hinweis: Für die Konfiguration der Schnittstelle zu DICOM4charly in Ihrem DICOM-Röntgensystem, lesen Sie bitte die Dokumentation des Röntgensystem-Herstellers.

Alle notwendigen Informationen für die Anbindung der DICOM4charly-Schnittstelle an das Röntgensystem, finden Sie in DICOM4charly > Stammdaten > Über diesen Dienst.

DICOM4charly bietet für Röntgensysteme folgende Services in der Rolle „Service Class Provider (SCP)“ an:

Der Hostname – die IP-Adresse des Servers in der Praxis – wird automatisch ermittelt und für beide Services gesetzt.

Die Kommunikation vom Röntgengerät zu DICOM4charly läuft standardmäßig über die Ports 10444 und 10445 (TCP). Sofern einer oder beide Ports in der Praxis bereits belegt sind, müssen die Ports in der „application.yml“-Datei des Soldicom-Services geändert werden. Siehe Ports der DICOM4charly-Services im Soldicom-Service ändern.

 

In DICOM4charly: DICOM-Röntgengerät und Service erstellen

Die DICOM-Röntgengeräte und Services erstellen Sie in DICOM4charly > Stammdaten > Röntgengeräte. Dabei gelten folgende Regeln:

 

Voraussetzungen

  • Sie benötigen die Netzwerkadresse, unter der das DICOM-Röntgengerät im Netzwerk erreichbar ist.

Vorgehensweise

  1. Klicken Sie in charly in der Menüleiste auf Start > DICOM4charly.

    • DICOM4charly öffnet sich.
  2. Klicken Sie in DICOM4charly auf Stammdaten > Röntgengeräte.

  3. Um ein DICOM-Röntgengerät anzulegen, klicken Sie rechts neben dem Suchfeld auf den Plus-Button .

    • Die Ansicht zum Anlegen von DICOM-Röntgengeräten öffnet sich.

  4. Geben Sie die Daten Ihres DICOM-Röntgengeräts ein:

    Feld Beschreibung
    Hersteller Name des Röntgengeräteherstellers
    Gerätename Produktname des Röntgengeräts
    Zimmer Standort des Röntgengeräts
    Netzwerkadresse Netzwerkadresse des Röntgengeräts

  5. Klicken Sie auf Speichern.

    • Das DICOM-Röntgengerät ist angelegt und wird in der Liste der Röntgengeräte angezeigt.

Nächste Schritte

  • Um die Konfiguration abzuschließen, erstellen Sie für das DICOM-Röntgengerät mindestens einen Service.

Voraussetzungen

  • Das DICOM-Röntgengerät, für das Sie einen Service erstellen möchten, ist erstellt. Für weitere Informationen siehe DICOM-Röntgengerät erstellen.

Vorgehensweise

  1. Klicken Sie in DICOM4charly auf Stammdaten > Röntgengeräte.

  2. Klicken Sie in der Liste bei dem DICOM-Röntgengerät, für das Sie einen Service erstellen möchten, auf den Anzeigen-Button .

    • Die Seite Röntgengerät anzeigen öffnet sich.

  3. Um einen Service anzulegen, klicken Sie rechts neben dem Suchfeld auf den Plus-Button .

    • Die Ansicht zum Anlegen von Services öffnet sich.

  4. Geben Sie die Daten des Services ein:

    Feld Beschreibung
    AE-Titel (Application Entity Title) – Name des Services, über den der Service eindeutig identifizierbar ist
    Röntgenverfahren Röntgenverfahren (Modalität), das der Service bietet, z.B. „PX“ für „Panoramic X-Ray“
    Port Port, über den die DICOM-Kommunikation läuft
    Rolle

    Rolle des Services.

    Hinweis: Für den Abruf der Röntgenaufträge hat der Service des Röntgengeräts immer die Rolle SCU. SCU (Service Class User) ist ein Gerät bzw. eine Applikation, die einen Dienst in Anspruch nimmt.

  5. Klicken Sie auf Speichern.

    • Der Service ist für das DICOM-Röntgengerät angelegt und wird in der Liste der Services angezeigt.

 

In charly: Röntgengerät mit DICOM-Röntgengerät verknüpfen

Das DICOM-Röntgengerät, das Sie in DICOM4charly angelegt haben, verknüpfen Sie mit dem korrespondierenden Röntgengerät aus charly. Diese Verknüpfung ist notwendig, damit aus charly über die DICOM4charly-Schnittstelle ein Röntgenauftrag an ein DICOM-Röntgengerät übermittelt werden kann.

 

Vorgehensweise

  1. Gehen Sie in charly unter Stammdaten > Geräte > Geräte.

  2. Wählen Sie aus der Geräteliste das Röntgengerät, das Sie mit dem DICOM-Röntgengerät verknüpfen möchten.

    • Der Reiter DICOM wird eingeblendet.

  3. Gehen Sie in den Reiter DICOM.

    • In der DropdownlisteRöntgengerät sehen Sie alle DICOM-Röntgengeräte, die Sie in DICOM4charly angelegt haben und für die Sie jeweils mindestens einen Service erstellt haben.
  4. Wählen Sie aus der Dropdownliste Röntgengerät, das DICOM-Röntgengerät, das Sie mit dem Röntgengerät aus charly verknüpfen möchten.

  5. Um die Einstellungen zu speichern, klicken Sie auf OK.

    • Wenn Sie im Röntgenbuch bei der Neuanlage eines Röntgenauftrags dieses Röntgengerät wählen, wird der Röntgenauftrag an DICOM4charly übermittelt.

 

How-to-Zusammenfassung

Ports ändern

Hinweis: Sofern keine neuere charly-Version vorliegt, aktualisiert der charly-Updater ausschließlich den charly-Java-Server und nimmt dabei die Port-Änderungen vor. Falls eine neuere charly-Version verfügbar ist, aktualisiert der charly-Updater zusätzlich die charly-Version.

Voraussetzungen

  • Der charly-Updater liegt auf dem charly-Server (Download Windows bzw. Download macOS).
  • Der charly-Server verfügt über eine Internetverbindung.

  • Das Ausführen des charly-Updaters ist vorbereitet:

    1. Schalten Sie alle charly-Arbeitsplätze (Clients) aus.
    2. Schließen Sie auf dem charly-Server alle Programme.
    3. Führen Sie auf dem charly-Server eine Datensicherung durch.
    4. Starten Sie den charly-Server neu.
    5. Melden Sie sich mit Administratorrechten am charly-Server an.
    6. Deaktivieren Sie auf dem charly-Server den Virenscanner für den Zeitraum des Updates.

Vorgehensweise

  1. Starten Sie den charly-Updater.
  2. Folgen Sie den Anweisungen des charly-Updater-Assistenten bis zu der Maske für die Konfiguration der Ports für den SSL-Proxy sowie für den Messaging-Service.
  3. Ändern Sie den bzw. die Ports.

  4. Folgen Sie weiter den Anweisungen des charly-Updater-Assistenten.

    • Der charly-Updater führt die Port-Änderungen im charly-Java-Server durch.
  1. Öffnen Sie auf dem Server folgendes Verzeichnis:
    <charly-Installationspfad>\Solutio\Server\ncjs\
  2. Legen Sie in diesem Verzeichnis das Verzeichnis „conf2“ und darin das Verzeichnis „messaging“ an:
    <charly-Installationspfad>\Solutio\Server\ncjs\conf2\messaging\
  3. Legen Sie in dem Verzeichnis „messaging“ eine Textdatei an und benennen Sie diese mit „application.yml“.

  4. Kopieren Sie die folgende Einstellung in die application.yml:

    de.solutio.ncjs.messaging.broker.stomp.port:14712

  5. Ändern Sie den Port.

  6. Damit der Messaging-Service die fertig bearbeitete application.yml verwendet, muss der Messaging-Service gestoppt und anschließend wieder gestartet werden:

    • Windows

      1. Öffnen Sie die Administrator-Kommandozeile und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>\Solutio\Server\ncjs

      2. Stoppen Sie den Messaging-Service:

        acd.bat stop messaging

      3. Starten Sie den Messaging-Service:

        acd.bat start messaging

    • macOS

      1. Öffnen Sie das Terminal und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>/Solutio/Server/ncjs

      2. Stoppen Sie den Messaging-Service:

        sudo ./acd.sh stop messaging

      3. Starten Sie den Messaging-Service:

        sudo ./acd.sh start messaging

  7. Prüfen Sie, ob der Messaging-Service gestartet ist:

    1. Öffnen Sie ein Browserfenster.

    2. Geben Sie folgende URL ein: http://<IP des charly-Servers oder IP der charly-VM (bei Containerinstallation)>:8087

      • Das Eureka-Dashboard öffnet sich und zeigt alle registrierten und gestarteten Microservices des charly-Java-Servers. Nach ca. 1 – 2 Minuten sollte hier auch der Messaging-Service mit dem Status „UP“ gelistet sein.
Hinweis: Die folgende Schrittanleitung beschreibt die Vorgehensweise in einem charly mit einem Mandanten. Sofern Sie in Ihrer Praxis einen charly mit mehreren Mandanten und einem nicht-mandantenfähigen Röntgensystem einsetzen, müssen Sie in Schritt 4 der Schrittanleitung die Standard-Konfiguration entsprechend um Services für den oder die Mandanten erweitern.

Für weitere Informationen sieheMandantenfähigkeit.

Vorgehensweise

  1. Öffnen Sie auf dem Server folgendes Verzeichnis:
    <charly-Installationspfad>\Solutio\Server\ncjs\
  2. Legen Sie in diesem Verzeichnis das Verzeichnis „conf2“ und darin das Verzeichnis „soldicom“ an:
    <charly-Installationspfad>\Solutio\Server\ncjs\conf2\soldicom\
  3. Legen Sie in dem Verzeichnis „soldicom“ eine Textdatei an und benennen Sie diese mit „application.yml“.
  4. Kopieren Sie die Standard-Konfiguration in die application.yml. Siehe Standard-Konfiguration für einen Mandanten.
  5. Bearbeiten Sie die application.yml: Ändern Sie in der kopierten Standard-Konfiguration den bzw. die Ports in freie Ports.

  6. Damit der Soldicom-Service die fertig bearbeitete application.yml verwendet, muss der Soldicom-Service gestoppt und anschließend wieder gestartet werden:

    • Windows

      1. Öffnen Sie die Administrator-Kommandozeile und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>\Solutio\Server\ncjs

      2. Stoppen Sie den Soldicom-Service:

        acd.bat stop soldicom

      3. Starten Sie den Soldicom-Service:

        acd.bat start soldicom

    • macOS

      1. Öffnen Sie das Terminal und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>/Solutio/Server/ncjs

      2. Stoppen Sie den Soldicom-Service:

        sudo ./acd.sh stop soldicom

      3. Starten Sie den Soldicom-Service:

        sudo ./acd.sh start soldicom

  7. Prüfen Sie, ob der Soldicom-Service gestartet ist:

    1. Öffnen Sie ein Browserfenster.

    2. Geben Sie folgende URL ein: http://<IP des charly-Servers oder IP der charly-VM (bei Containerinstallation)>:8087

      • Das Eureka-Dashboard öffnet sich und zeigt alle registrierten und gestarteten Microservices des charly-Java-Servers. Nach ca. 1 – 2 Minuten sollte hier auch der Soldicom-Service mit dem Status „UP“ gelistet sein.

Lizenz freischalten

Voraussetzungen

  • Sie haben die DICOM4charly-Lizenz der solutio GmbH & Co. KG erworben.

Vorgehensweise

  1. Klicken Sie in charly in der Menüleiste auf Hilfe > Zusätzliche Lizenzen.
  2. Aktivieren Sie in dem Fenster die CheckboxDICOM4charly und geben Sie in dem Feld daneben die Lizenz für die DICOM4charly-Schnittstelle ein.
  3. Klicken Sie auf den Button Speichern.

  4. Starten Sie charly neu.

    • Nach dem Neustart steht Ihnen in der Menüleiste unter Start die Option DICOM4charly zur Verfügung. Über diese Option rufen Sie DICOM4charly auf.

In DICOM4charly: DICOM-Röntgengerät und Service erstellen

Voraussetzungen

  • Sie benötigen die Netzwerkadresse, unter der das DICOM-Röntgengerät im Netzwerk erreichbar ist.

Vorgehensweise

  1. Klicken Sie in charly in der Menüleiste auf Start > DICOM4charly.

    • DICOM4charly öffnet sich.
  2. Klicken Sie in DICOM4charly auf Stammdaten > Röntgengeräte.

  3. Um ein DICOM-Röntgengerät anzulegen, klicken Sie rechts neben dem Suchfeld auf den Plus-Button .

    • Die Ansicht zum Anlegen von DICOM-Röntgengeräten öffnet sich.

  4. Geben Sie die Daten Ihres DICOM-Röntgengeräts ein:

    Feld Beschreibung
    Hersteller Name des Röntgengeräteherstellers
    Gerätename Produktname des Röntgengeräts
    Zimmer Standort des Röntgengeräts
    Netzwerkadresse Netzwerkadresse des Röntgengeräts

  5. Klicken Sie auf Speichern.

    • Das DICOM-Röntgengerät ist angelegt und wird in der Liste der Röntgengeräte angezeigt.

Nächste Schritte

  • Um die Konfiguration abzuschließen, erstellen Sie für das DICOM-Röntgengerät mindestens einen Service.

Voraussetzungen

  • Das DICOM-Röntgengerät, für das Sie einen Service erstellen möchten, ist erstellt. Für weitere Informationen siehe DICOM-Röntgengerät erstellen.

Vorgehensweise

  1. Klicken Sie in DICOM4charly auf Stammdaten > Röntgengeräte.

  2. Klicken Sie in der Liste bei dem DICOM-Röntgengerät, für das Sie einen Service erstellen möchten, auf den Anzeigen-Button .

    • Die Seite Röntgengerät anzeigen öffnet sich.

  3. Um einen Service anzulegen, klicken Sie rechts neben dem Suchfeld auf den Plus-Button .

    • Die Ansicht zum Anlegen von Services öffnet sich.

  4. Geben Sie die Daten des Services ein:

    Feld Beschreibung
    AE-Titel (Application Entity Title) – Name des Services, über den der Service eindeutig identifizierbar ist
    Röntgenverfahren Röntgenverfahren (Modalität), das der Service bietet, z.B. „PX“ für „Panoramic X-Ray“
    Port Port, über den die DICOM-Kommunikation läuft
    Rolle

    Rolle des Services.

    Hinweis: Für den Abruf der Röntgenaufträge hat der Service des Röntgengeräts immer die Rolle SCU. SCU (Service Class User) ist ein Gerät bzw. eine Applikation, die einen Dienst in Anspruch nimmt.

  5. Klicken Sie auf Speichern.

    • Der Service ist für das DICOM-Röntgengerät angelegt und wird in der Liste der Services angezeigt.

Im charly-Client: Röntgengerät mit DICOM-Röntgengerät verknüpfen

Vorgehensweise

  1. Gehen Sie in charly unter Stammdaten > Geräte > Geräte.

  2. Wählen Sie aus der Geräteliste das Röntgengerät, das Sie mit dem DICOM-Röntgengerät verknüpfen möchten.

    • Der Reiter DICOM wird eingeblendet.

  3. Gehen Sie in den Reiter DICOM.

    • In der DropdownlisteRöntgengerät sehen Sie alle DICOM-Röntgengeräte, die Sie in DICOM4charly angelegt haben und für die Sie jeweils mindestens einen Service erstellt haben.
  4. Wählen Sie aus der DropdownlisteRöntgengerät, das DICOM-Röntgengerät, das Sie mit dem Röntgengerät aus charly verknüpfen möchten.

  5. Um die Einstellungen zu speichern, klicken Sie auf OK.

    • Wenn Sie im Röntgenbuch bei der Neuanlage eines Röntgenauftrags dieses Röntgengerät wählen, wird der Röntgenauftrag an DICOM4charly übermittelt.