GNU Health/Imaging

From Wikibooks, open books for an open world
Jump to navigation Jump to search

Default imaging module[edit | edit source]

The default GNU Health imaging module (health_imaging) provides basic imaging support and workflow. Only basic, non-DICOM images are supported. No DICOM viewer is provided.

Creating a request[edit | edit source]

  1. Create draft request
    • Wizard under Imaging > Dx Imaging - New
      Imaging request wizard
    • Fill in:
      Imaging request form
      • Patient
      • Urgent or not
      • Specific test(s)
      • Requesting doctor
    • Click Request
  2. Generate order
    • Find draft requests under Imaging > Dx Imaging - New > Draft
      List of imaging requests
    • Click Request button on the draft request in the detailed view
      Request imaging order
      • Request will now be under the Requested tab

Generating results[edit | edit source]

  1. Click Generate Results button on the form (under Dx Imaging Requests)
  2. Fill in data (available under the Dx Imaging - Results menu item)
    • Add images under the Images tab
    • Add comments under the Comment tab

View results[edit | edit source]

Results are found under the Imaging > Dx Imaging - Results menu item.

List of results

Configuring available tests[edit | edit source]

Available tests can be configured under the Configuration > Dx Imaging menu item.

There are two sub-sections:

  • Dx Imaging Test Types (MRI, Ultrasound, etc)
  • Dx Imaging Tests (available tests)

Orthanc Integration[edit | edit source]

Introduction[edit | edit source]

This module (health_orthanc) provides a light integration between Orthanc DICOM servers and GNU Health. The module uses the robust REST API provided by Orthanc to synchronize patient and study information in GNU Health. Put simply, the code asks the Orthanc REST API what studies and patients it has and then saves that information locally in GNU Health. No image files are saved. No DICOM viewer provided.

Usage[edit | edit source]

A new dropdown menu titled Orthanc is available under Health > Imaging.

Default menu

The menu has 2 sub-sections:

  • Patients
  • Studies

These sub-sections provide the list of studies and patients on the known Orthanc servers. You can filter and search normally. The views are generally read-only. On the list of Orthanc patients, however, some patients will be linked to local patients if the remote and local MRN/PUID match. Otherwise, Orthanc patients can be manually linked to a local patient by updating their patient field.

Note: When an imaging request is completed, the result can be directly linked to Orthanc studies through the new Studies tab under the Imaging > Dx Imaging - Results entry.

Link orthanc studies to imaging requests

Administration[edit | edit source]

Server configuration[edit | edit source]

A new dropdown menu titled Orthanc is available under Health > Configuration

Config menu

The menu has 2 sub-sections:

  • Add Orthanc Server
  • Servers

To add a new remote server click Add Orthanc Server. This will open a wizard that guides the user through adding a server:

Add server
  • Fill in the label (must be unique), full domain, username, and password.
  • Click Begin

After a short time, a success message should appear.

Add server success

In case of invalid domains or credentials, there will be an error page instead of a success page.

Add server error

The Servers page lists the current servers. Clicking on a specific server will show its credentials, validated status, and other important information. Of note, updating the domain, username, or password will trigger a background, remote check to validate the newly updated information.

Server configuration

Synchronization[edit | edit source]

The module provides a trytond-cron job which by default synchronizes all validated servers every 15 minutes. This can be changed through the Scheduled Actions configuration under Administration > Scheduler.

Scheduler menu
Change synchronization timing

Servers can by manually synchronized by clicking the Sync button on their individual view.

Manual synchronization

Troubleshooting[edit | edit source]

Server(s) not automatically synchronizing[edit | edit source]

Make sure trytond-cron is running.