SANTESOFT - SANTE WORKLIST SERVER

Sante Worklist Server

Quick start guide

Copyright © 2020 Santesoft LTD, all rights reserved

 SANTESOFT - SANTE WORKLIST SERVER

Table of Contents
Overview ........................................................................................................................................................................ 3
Features and benefits .................................................................................................................................................... 3
Minimum System Requirements ................................................................................................................................... 3
Installing Sante Worklist Server ..................................................................................................................................... 3
Installation on Windows Server 2012 ............................................................................................................................ 4
Installation on Windows Server 2008 ............................................................................................................................ 4
Configuration ................................................................................................................................................................. 5
Network Configuration ............................................................................................................................................... 5
Mapping HL7 message fields to Database fields ........................................................................................................ 6
Evaluation ...................................................................................................................................................................... 8
Purchasing ...................................................................................................................................................................... 8
Program activation......................................................................................................................................................... 8
The User Interface........................................................................................................................................................ 10
The Toolbar .................................................................................................................................................................. 11
Toolbar Commands ...................................................................................................................................................... 12
Create New Record ................................................................................................................................................... 12
Import HL7 Message From File ................................................................................................................................. 13
Query DICOM Worklist Node .................................................................................................................................... 14
Database To HL7 Field Mapping ............................................................................................................................... 15
Network Setup .......................................................................................................................................................... 17
DICOM Network Log ................................................................................................................................................. 19
Quick Start Guide ...................................................................................................................................................... 20
Program Information ................................................................................................................................................ 21
Exit............................................................................................................................................................................. 22
View Record .............................................................................................................................................................. 23
Edit Record ................................................................................................................................................................ 24
Send Record .............................................................................................................................................................. 25
Export Record............................................................................................................................................................ 25
Copy Record To Clipboard ........................................................................................................................................ 25
Delete Record ........................................................................................................................................................... 26
Compose And Send HL7 Message ............................................................................................................................. 26
 SANTESOFT - SANTE WORKLIST SERVER

Overview
Sante Worklist Server (MWL Server) is an autonomous program that can receive via HL7 communication messages
the patients demographics and scheduling information of exams that are stored in a HIS/RIS system (Hospital
Information System / Radiology Information System) and transfer them to any modality/medical scanner via DICOM
communication protocols (C-FIND). The program offers an automated, error-free and reliable transfer of the
information form HL7 nodes (HIS/RIS) to DICOM nodes (medical scanners) without any human reaction.

Features and benefits

• The server can run as Windows service
• Unlimited number of patients/exams (it depends only on hard disk size)
• Unlimited number of connections with HL7 nodes
• Unlimited number of connections with DICOM nodes
• It can query other DICOM Worklist nodes
• Mapping of HL7 message fields to program's database fields
• Supports all charsets (latin, chinese, japanese, korean, cyrillic, arabic, greek, turkish, etc.)
• Supports DICOM network services (C-FIND SCU/SCP, C-ECHO SCU/SCP)
• Compatible with all modalities (CT, MR, NM, US, XA, MG, CR etc.).
• Perpetual license that never expires.
• Free updates and free technical support for product's lifetime
• Windows Server 2019/2016/2012/2008 and Windows 10/8.1/8/7/Vista (64-bit) compatible
• Easy to use with native Windows "look and feel"

Minimum System Requirements

• Windows Server 2019/2016/2012/2008 or Windows 10/8.1/8/7/Vista 64-bit
• Intel Core i3 1.3GHz or greater
• 4 GB memory or more
• Monitor that supports resolution 1366x768 or above
• 100MB free space on hard disk

Installing Sante Worklist Server

The user must run the setup file as administrator. After downloading, press the right mouse button and select the
menu item "Run as administrator".
 SANTESOFT - SANTE WORKLIST SERVER

Installation on Windows Server 2012

The user must install the "Media Foundation" from "Add Roles and Features" wizard of the Server Manager.

Installation on Windows Server 2008

Before the program installation the user must install this update of Microsoft:
https://support.microsoft.com/en-us/kb/2117917
 SANTESOFT - SANTE WORKLIST SERVER

Configuration
Network Configuration
Before the first use of the software, the user must configure it. The program acts as a DICOM worklist server and it
can be queried by medical scanners about the scheduled procedures, thus it must be configured as a DICOM node.
That is, it must receive an AE Title and an IP port for DICOM communications as every other DICOM node. The
program acts also as an HL7 client, it can receice HL7 messages about the scheduled procedures from HIS/RIS
programs and for that purpose must receive an IP port for the communication with other HL7 nodes. For the
configuration the user must use the command Network Setup from the toolbar. This command displays the
following dialog box:

DICOM AE Title, DICOM port

The AE Title and IP port for DICOM communications with the other DICOM nodes.

HL7 Port
The IP port for the communication with other HL7 nodes like HIS/RIS software.

IP Address
This address is received automatically from Windows OS. The user can change this value only from the TCP/IP
configuration of Windows.

Sending Application / Sending Facility

The program can send HL7 messages to other HL7 clients. The program will use these values in the corresponding
fields MSH.3 and MSH.4 of the HL7 messages.

Send Acknowledgement
Some HL7 servers require to receive an acknowledgement as a proof that the client received the message. With this
option enabled, the program sends this acknowledgement to the server.
 SANTESOFT - SANTE WORKLIST SERVER

Defult Charset
If the HL7 message does not contain any information about the used charset, the program uses the value of this
box.

Run the server as service

This option enables the software to run as windows service.

Mapping HL7 message fields to Database fields

Not all the HL7 applications use the same fields of an HL7 message to store the same piece of information. In the
example below the two messages use different position of the OBR segment to store the modality:

MSH|^~_&|EUROMEDICA|EUROMEDICA|SYNGO.PLAZA|SYNGO.PLAZA|20190315090409||ORM^O01|201903150904097|P|2.3.1|
PID||7007|7007||NAME||19731215|M|||ADDRESS||6944600091|2107778888||||8833925||||||||||GR|||
PV1||I|15076600732|||||^EOPYY^A||||||15076600732|||||54847|||||||||||||||||||||||||201903150852||||||||
ORC|NW|54847|||IP||^^^20190315085226||201903150852||||||201903150852|||||
OBR|1|54847||21100^CT|R||20190315095000|20190315100000||||||||||CT||||||CTAWP73120|||201903150852|||||

MSH|^~\&|application|application|REC_APP|REC_FAC|201912291543||ORM^O01||P|2.3.1|||||||||
PID|||1|1|Patient^Name||19591206|M|||||||||||||||||||||
PV1|||||||||||||||||||||||||||||||||||||||||||||||||||
ORC|NW|||||||||||||||||||||||
OBR|||2005-9999|1234^BRAIN||200512301613529400|||||||||||||||CT|||||||||||||||||||||

The first message uses the ORB.18 field to store the modality while the second one uses the field ORB.21. For that
reason the user must map the fields of the HL7 message that generates a specific HL7 server to the database fileds
of Sante Worklist Server. This command lets the user to do this mapping with the following dialog box:
 SANTESOFT - SANTE WORKLIST SERVER

Export To File button

The user can save the mapping to a disk file for backup and for use in another installation of the program.

Import From File button

Lets the user to load from the disk drive a previously saved mapping.

Study UI Setup button

Some medical scanners does not accept worklist responces if those responces do not contain Study UI value and
this field in the response is blank. With this button, the program can create Study UIs automatically for those
scanners:

The program will create Study UIs only if the received HL7 message from HIS/RIS software does not contain any
value for this field, as well as the target scanner exists in the list of the above dialog box.
 SANTESOFT - SANTE WORKLIST SERVER

Evaluation
The program without a registration key can run for 90 days for evaluation purposes. After that period, a valid
registration key is required.

Purchasing
The program can be purchased form our online store at:
https://santesoft.com/win/sante-worklist-server/order.html

Program activation
After the purchase the user will receive an email with the registration key. To activate the program, the user must
select the Program Information command and in the dialog box appears the button “Insert Registration Key”.

This button displays a dialog box that allows the user to activate the program. The information of the registration
key is case sensitive and the user must insert it exactly as is in the email.
 SANTESOFT - SANTE WORKLIST SERVER

The User Interface

The window of the program is divided to 3 parts:

1. On the top part of the window there is the command toolbar that contains the commands of the program.
When the user holds the mouse pointer over a command for a moment, the program displays a help text
that discribe that command:

2. In the left part the window there are the controls that lets the user to query the local database and view
the records.
3. In the middle part of the window is the list that contains the records that the database engine returns after
a query of the user of the program.
 SANTESOFT - SANTE WORKLIST SERVER

The Toolbar

Create New Record

Import HL7 Message From File

Query DICOM Worklist Node

Database To HL7 Field Mapping

Network Setup

DICOM Network Log

Quick Start Guide

Program Information

Exit

View Record

Edit Record

Send Record

Export Record

Copy Record To Clipboard

Delete Record

Compose And Send HL7 Message

 SANTESOFT - SANTE WORKLIST SERVER

Toolbar Commands
Create New Record

Although the HL7 data are usally created by HIS/RIS software and they are sent to Worklist server via an HL7
message, the program offers to user the ability to create new worklist records from scratch. The fields that are
pointed out with a star (*) are mandatory fields.
 SANTESOFT - SANTE WORKLIST SERVER

Import HL7 Message From File

This command lets the user to insert into database an HL7 message that has been saved in a text file.

The file must be a text file that contains an HL7 formated message like this example:

MSH|^~_&|EUROMEDICA|EUROMEDICA|SYNGO.PLAZA|SYNGO.PLAZA|20190315090409||ORM^O01|201903150904097|P|2.3.1|
PID||7007|7007||NAME||19731215|M|||ADDRESS||6944600091|2107778888||||8833925||||||||||GR|||
PV1||I|15076600732|||||^EOPYY^A||||||15076600732|||||54847|||||||||||||||||||||||||201903150852||||||||
ORC|NW|54847|||IP||^^^20190315085226||201903150852||||||201903150852|||||
OBR|1|54847||21100^CT|R||20190315095000|20190315100000||||||||||CT||||||CTAWP73120|||201903150852|||||
 SANTESOFT - SANTE WORKLIST SERVER

Query DICOM Worklist Node

With this command, the program lets the user to query other Worklist Servers of the network and import their
records into database of the program.
 SANTESOFT - SANTE WORKLIST SERVER

Database To HL7 Field Mapping

Not all the HL7 applications use the same fields of an HL7 message to store the same piece of information. In the
example below the two messages use different position of the OBR segment to store the modality:

MSH|^~_&|EUROMEDICA|EUROMEDICA|SYNGO.PLAZA|SYNGO.PLAZA|20190315090409||ORM^O01|201903150904097|P|2.3.1|
PID||7007|7007||NAME||19731215|M|||ADDRESS||6944600091|2107778888||||8833925||||||||||GR|||
PV1||I|15076600732|||||^EOPYY^A||||||15076600732|||||54847|||||||||||||||||||||||||201903150852||||||||
ORC|NW|54847|||IP||^^^20190315085226||201903150852||||||201903150852|||||
OBR|1|54847||21100^CT|R||20190315095000|20190315100000||||||||||CT||||||CTAWP73120|||201903150852|||||

MSH|^~\&|application|application|REC_APP|REC_FAC|201912291543||ORM^O01||P|2.3.1|||||||||
PID|||1|1|Patient^Name||19591206|M|||||||||||||||||||||
PV1|||||||||||||||||||||||||||||||||||||||||||||||||||
ORC|NW|||||||||||||||||||||||
OBR|||2005-9999|1234^BRAIN||200512301613529400|||||||||||||||CT|||||||||||||||||||||

The first message uses the ORB.18 field to store the modality (CT) while the second one uses the field ORB.21. For
that reason the user must map the fields of the HL7 message that generates a specific HL7 server to the database
fileds of Sante Worklist Server. This can be done with use of command Database To HL7 Field Mapping. This
command displays the following dialog box that lets the user to do this mapping:
 SANTESOFT - SANTE WORKLIST SERVER

Export To File button

The user can save the mapping to a disk file for backup and for use in another installation of the program.

Import From File button

Lets the user to load from the disk drive a previously saved mapping.

Study UI Setup button

Some medical scanners does not accept worklist responces if those responces do not contain Study UI value and
this field in the response is blank. With this button, the program can create Study UIs automatically for those
scanners:

The program will create Study UIs only if the received HL7 message from HIS/RIS software does not contain any
value for this field, as well as the target scanner exists in the list of the above dialog box.
 SANTESOFT - SANTE WORKLIST SERVER

Network Setup

Before the first use of the software, the user must configure it. The program acts as a DICOM worklist server and it
can be queried by medical scanners about the scheduled procedures, thus it must be configured as a DICOM node.
That is, it must receive an AE Title and an IP port for DICOM communications as every other DICOM node. The
program acts also as an HL7 client, it can receice HL7 messages about the scheduled procedures from HIS/RIS
programs and for that purpose must receive an IP port for the communication with other HL7 nodes. This command
lets user to configure the server with the following dialog box:

DICOM AE Title, DICOM port

The AE Title and IP port for DICOM communications with the other DICOM nodes.

HL7 Port
The IP port for the communication with other HL7 nodes like HIS/RIS software.

IP Address
This address is received automatically from Windows OS. The user can change this value only from the TCP/IP
configuration of Windows.

Sending Application / Sending Facility

The program can send HL7 messages to other HL7 clients. The program will use these values in the corresponding
fields MSH.3 and MSH.4 of the HL7 messages.
 SANTESOFT - SANTE WORKLIST SERVER

Send Acknowledgement
Some HL7 servers require to receive an acknowledgement as a proof that the client received the message. With this
option enabled, the program sends this acknowledgement to the server.

Defult Charset
If the HL7 message does not contain any information about the used charset, the program uses the value of this
box.

Run the server as service

This option enables the software to run as windows service.
 SANTESOFT - SANTE WORKLIST SERVER

DICOM Network Log

This command displays the DICOM network activity.

With a double-click over a raw, the user can view details of the that activity.
 SANTESOFT - SANTE WORKLIST SERVER

Quick Start Guide

This command displays this document.

 SANTESOFT - SANTE WORKLIST SERVER

Program Information

This command displays information about the program and the register user.

Insert Registration Key button

After the purchase the user will receive an email with the registration key. This button displays a dialog box that
allows the user to activate the program. The information of the registration key is case sensitive and the user must
insert it exactly as is in the email.
 SANTESOFT - SANTE WORKLIST SERVER

Exit

Use this command to terminate the program end exit.

 SANTESOFT - SANTE WORKLIST SERVER

View Record

This command lets the user to review a database entry. The command is enabled when one record at least has been
selected in the list of the records of the database. Otherwise the command is grayed out.
 SANTESOFT - SANTE WORKLIST SERVER

Edit Record

This command lets the user to edit and modify a database entry. The fields that are pointed out with a star (*) are
mandatory fields and they cannot be deleted. The command is enabled when one record at least has been selected
in the list of the records of the database. Otherwise the command is grayed out.
 SANTESOFT - SANTE WORKLIST SERVER

Send Record

This command lets the user to send to a specific HL7 node a database entry, in the form of an HL7 message. The
command is enabled when one record at least has been selected in the list of the records of the database. Otherwise
the command is grayed out.

Export Record

This command lets the user to save in a disk file a database entry in the form of HL7 message. The command is
enabled when one record at least has been selected in the list of the records of the database. Otherwise the
command is grayed out.

Copy Record To Clipboard

This command lets the user to copy to clipboard a database entry in the form of HL7 message. The command is
enabled when one record at least has been selected in the list of the records of the database. Otherwise the
command is grayed out.
 SANTESOFT - SANTE WORKLIST SERVER

Delete Record

This command lets the user to delete one or more database entries that are not useful any more. The command is
enabled when one record at least has been selected in the list of the records of the database. Otherwise the
command is grayed out.

Compose And Send HL7 Message

This command lets the user to compose or to load a HL7 message from a file, to edit it and send it to a specific HL7
node.