Sante Worklist Server
빠른 시작 가이드
Copyright © 2026 Santesoft LTD ,모든 권리 보유
Sante Worklist Server (MWL Server) 는 HL7 통신 메시지를 통해 HIS/RIS 시스템(Hospital Information System / Radiology Information System)에서 환자 인구통계 정보와 검사 일정 정보를 수신하는 독립 실행형 애플리케이션입니다. 이후 DICOM 통신 프로토콜(C-FIND)을 사용하여 이 정보를 모든 모달리티 또는 의료 스캐너로 전송합니다.
이 프로그램은 사람의 개입 없이 HL7 노드(HIS/RIS)에서 DICOM 노드(의료 스캐너)로 데이터를 자동으로 안정적이며 오류 없이 전송합니다.
소프트웨어를 처음 사용하기 전에 사용자가 프로그램을 올바르게 구성해야 합니다.
이 프로그램은 DICOM Worklist Server로 작동하며 의료 스캐너가 예약된 검사를 조회할 수 있습니다. 따라서 다른 DICOM 노드와 마찬가지로 AE Title과 DICOM 통신용 IP 포트를 설정하여 DICOM 노드로 구성해야 합니다.
또한 이 프로그램은 HL7 클라이언트로 작동합니다. HIS/RIS 시스템에서 예약된 검사 정보가 포함된 HL7 메시지를 수신할 수 있습니다. 이를 위해 다른 HL7 노드와 통신할 IP 포트도 지정해야 합니다.
구성하려면 도구 모음에서 프로그램 설정 명령을 선택합니다. 다음 대화 상자가 열립니다:

DICOM AE Title, DICOM 포트
다른 DICOM 노드와의 DICOM 통신에 사용할 AE Title과 IP 포트를 지정합니다.
HL7 포트
HIS/RIS 시스템과 같은 다른 HL7 노드와 통신하는 데 사용되는 IP 포트입니다.
IP 주소
이 주소는 Windows 운영 체제에서 자동으로 할당됩니다. 변경하려면 Windows의 TCP/IP 설정을 수정해야 합니다.
송신 애플리케이션 / 송신 시설
프로그램이 다른 HL7 클라이언트로 HL7 메시지를 전송할 때 이 값을 HL7 메시지 헤더의 MSH.3 및 MSH.4 필드에 사용합니다.
확인 응답 전송
일부 HL7 서버는 메시지 수신 확인을 요구합니다. 이 옵션을 사용하면 프로그램이 서버에 HL7 ACK 메시지를 반환합니다.
수신 조회에서 태그 0040,0001이 비어 있으면 클라이언트 AE Title 사용
일부 DICOM 노드는 스테이션 이름을 요청합니다. 태그 (0040,0001)이 비어 있으면 프로그램은 조회를 시작한 DICOM 노드의 AE Title을 스테이션 이름으로 사용합니다.
기본 문자 집합
HL7 메시지에 문자 집합이 지정되지 않은 경우 프로그램은 이 필드에 정의된 문자 집합을 사용합니다.
HL7 레코드 자동 삭제
프로그램은 더 이상 필요하지 않은 오래된 메시지를 데이터베이스에서 자동으로 삭제할 수 있습니다. 7일, 14일, 1개월 또는 3개월보다 오래된 메시지를 삭제할 수 있습니다.
업데이트 실패 시(레코드가 존재하지 않음) 새 레코드 생성
이 옵션을 사용하면 레코드가 없어 업데이트가 실패할 경우 프로그램이 데이터베이스에 새 레코드를 생성합니다.
HL7 메시지 자동 삽입용 모니터링 폴더
프로그램은 지정된 폴더의 HL7 메시지 파일을 모니터링합니다. 파일 확장자는 .txt 또는 .hl7이어야 합니다. 메시지가 데이터베이스에 성공적으로 삽입되면 확장자가 .DON으로 변경되고, 실패하면 .ERR로 변경됩니다.
삽입 후 HL7 메시지 삭제
이 옵션을 사용하면 성공적으로 삽입된 HL7 메시지 파일은 .DON으로 이름이 변경되는 대신 삭제됩니다. 삽입에 실패한 메시지는 삭제되지 않습니다.
서버를 서비스로 실행
이 옵션을 사용하면 소프트웨어를 Windows 서비스로 실행할 수 있습니다.
Sante Worklist Server는 하나 이상의 HIS/RIS 서버에서 HL7 형식의 메시지를 수신하여 데이터베이스에 저장합니다.
중요:Sante Worklist Server는 HIS/RIS 서버에 이러한 메시지를 요청할 수 없습니다. HIS/RIS 서버가 메시지를 Sante Worklist Server의 HL7 포트로 전송해야 합니다.
각 DICOM 모달리티는 Sante Worklist Server에 C-FIND 요청을 보내 데이터베이스에 해당 모달리티용으로 저장된 Worklist 항목을 가져옵니다. C-FIND 요청은 Sante Worklist Server의 DICOM 포트로 전송해야 합니다.
중요: Sante Worklist Server는 조회를 받지 않은 상태에서 Worklist 항목을 DICOM 모달리티로 푸시할 수 없습니다. 각 DICOM 모달리티는 관련 Worklist 항목을 받기 위해 Worklist Server에 조회를 보내야 합니다.
중요: HIS/RIS 서버는 HL7 메시지를 Sante Worklist Server의 HL7 포트로 보내야 하며, DICOM 모달리티는 C-FIND 요청을 Sante Worklist Server의 DICOM 포트로 보내야 합니다. 두 포트를 혼동하지 마십시오.
모든 HL7 애플리케이션이 동일한 정보를 HL7 메시지의 동일한 필드에 저장하는 것은 아닙니다. 아래 예에서 두 메시지는 OBR 세그먼트의 서로 다른 위치에 모달리티를 저장합니다:
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|||||||||||||||||||||
첫 번째 메시지는 필드 OBR.18 에 모달리티를 저장하고, 두 번째 메시지는 필드 OBR.21를 사용합니다. 따라서 특정 HL7 서버에서 생성된 HL7 메시지 필드를 Sante Worklist Server의 데이터베이스 필드에 매핑해야 합니다. 이 명령은 다음 대화 상자에서 매핑을 구성합니다:
使用 “HL7 샘플 파일 열기” 按钮,程序允许用户将一条 HL7 消息与 “데이터베이스-HL7 필드 매핑” 对话框并排打开。
사용자는 HL7 메시지에서 필드의 위치를 확인하고 '데이터베이스-HL7 필드 매핑' 대화 상자의 해당 필드에 올바른 값을 입력할 수 있습니다.
HL7 필드에 문자 "^"가 포함되어 있지 않으면 “Component(组件)” 의 값은 1이어야 합니다. HL7 필드에 문자 "^",(예: 1234^BRAIN)가 포함된 경우 값의 첫 번째 부분(1234)에 대해 'Component'는 1, 두 번째 부분(BRAIN)에 대해 2여야 합니다. 'Component' 값이 0이면 프로그램은 값을 분리하지 않고 전체 값(1234^BRAIN)을 사용합니다.
파일로 내보내기 按钮
매핑을 디스크 파일에 저장하여 백업하거나 다른 프로그램 설치에서 사용할 수 있습니다.
파일에서 가져오기 按钮
允许 이전에 저장한 매핑을 디스크에서 불러올 수 있습니다.
Study UID 설정 按钮
일부 의료 스캐너는 Worklist 응답에 Study Instance UID가 없고 해당 필드가 비어 있으면 응답을 수락하지 않습니다. 이 버튼을 사용하면 프로그램이 해당 스캐너용 Study Instance UID를 자동으로 생성할 수 있습니다:
HIS/RIS 소프트웨어에서 수신한 HL7 메시지에 이 필드 값이 없고 대상 스캐너가 위 대화 상자의 목록에 있는 경우에만 프로그램이 Study Instance UID를 생성합니다.
등록 키 없이 프로그램을 90일 동안 평가할 수 있습니다. 이 기간이 끝나면 유효한 등록 키가 필요합니다.
프로그램은 온라인 스토어에서 구매할 수 있습니다:
https://santesoft.com/win/sante-worklist-server/order.html
구매 후 등록 키가 포함된 이메일을 받게 됩니다. 프로그램을 활성화하려면 프로그램 정보 명령을 선택하고 나타나는 대화 상자에서 “등록 키 입력”.
이 버튼은 프로그램을 활성화할 수 있는 대화 상자를 표시합니다. 등록 키 정보는 대소문자를 구분하므로 이메일에 표시된 그대로 정확하게 입력해야 합니다.
프로그램 창은 네 부분으로 나뉩니다:
1. 창 상단是命令工具栏,其中包含程序的各项命令。

2. 창 왼쪽是用于查询本地数据库和레코드 보기的控件。

3. 창 중앙是记录列表,其中显示数据库引擎根据用户查询返回的记录。

4. 창 오른쪽是用于操作查询结果以及执行程序常规命令的控件。

|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
首次使用软件之前,用户必须对其进行配置。本程序作为 DICOM Worklist Server,可由医疗扫描设备查询已排程检查,因此必须配置为 DICOM 节点,即像任何其他 DICOM 节点一样设置 AE Title 和用于 DICOM 通信的 IP 端口。本程序还作为 HL7 客户端,可从 HIS/RIS 程序接收有关已排程检查的 HL7 消息,因此还必须设置一个用于与其他 HL7 节点通信的 IP 端口。此命令通过以下对话框配置服务器:

DICOM AE Title, DICOM 포트
用于与其他 DICOM 节点进行 DICOM 通信的 AE Title 和 IP 端口。
HL7 포트
HIS/RIS 시스템과 같은 다른 HL7 노드와 통신하는 데 사용되는 IP 포트입니다.
IP 주소
该地址由 Windows 操作系统自动获取。用户只能通过 Windows 的 TCP/IP 配置更改此值。
송신 애플리케이션 / 송신 시설
程序可以向其他 HL7 客户端发送 HL7 消息,并会在 HL7 消息的相应 MSH.3 和 MSH.4 字段中使用这些值。
확인 응답 전송
某些 HL7 服务器要求收到确认消息,以证明客户端已收到消息。启用此选项后,程序会向服务器发送该确认消息。
수신 조회에서 태그 0040,0001이 비어 있으면 클라이언트 AE Title 사용
许多 DICOM 节点会请求工作站名称;如果该字段没有值,程序会使用 AE Title 作为工作站名称。
기본 문자 집합
如果 HL7 消息中没有包含所用字符集的信息,程序将使用此框中的值。
HL7 레코드 자동 삭제
程序可以自动从数据库中删除不再有用的旧消息。可删除早于 7 天、14 天、1 个月或 3 个月的消息。
업데이트 실패 시(레코드가 존재하지 않음) 새 레코드 생성
이 옵션을 사용하면 레코드가 없어 업데이트가 실패할 경우 프로그램이 데이터베이스에 새 레코드를 생성합니다.
HL7 메시지 자동 삽입용 모니터링 폴더
程序会扫描监控文件夹中的 HL7 消息;如果存在가 포함되어 있지 않으면 将其插入数据库。消息文件扩展名必须为 .txt 或 .hl7。消息处理后,程序会为文件添加 扩展名 .DON (如果消息成功插入数据库),否则添加扩展名 .ERR。
삽입 후 HL7 메시지 삭제
如果启用此选项,程序会删除成功插入的消息,而不是为其添加 .DON 扩展名。未能插入数据库的消息不会被删除。
서버를 서비스로 실행
이 옵션을 사용하면 소프트웨어를 Windows 서비스로 실행할 수 있습니다.
이 명령은 DICOM 네트워크 활동을 표시합니다.
행을 두 번 클릭하면 해당 활동의 세부 정보를 볼 수 있습니다.

이 명령은 Windows 탐색기에서 로그 폴더를 엽니다.
이 명령은 이 문서를 표시합니다.
이 명령은 프로그램의 언어 설정을 지정합니다.
이 명령은 프로그램 및 등록 사용자에 대한 정보를 표시합니다.

등록 키 입력 按钮
구매后,用户将收到一封包含注册密钥的电子邮件。이 버튼은 프로그램을 활성화할 수 있는 대화 상자를 표시합니다. 등록 키 정보는 대소문자를 구분하므로 이메일에 표시된 그대로 정확하게 입력해야 합니다.

이 명령은 프로그램을 종료합니다.
이 명령은 프로그램 창을 시스템 트레이로 최소화합니다.
이 명령을 사용하면 데이터베이스 항목을 볼 수 있습니다.当数据库记录列表中至少选择了一条记录时,该命令可用;否则该命令显示为灰色并被禁用。

이 명령을 사용하면 데이터베이스 항목을 편집하고 수정할 수 있습니다.별표(*)가 있는 필드는 필수 필드입니다,不能删除。当数据库记录列表中至少选择了一条记录时,该命令可用;否则显示为灰色。

이 명령을 사용하면 레코드의 복사본을 만들 수 있습니다.当用户希望创建一条与另一条记录具有许多相同字段的新记录时,此功能非常有用。
이 명령을 사용하면 데이터베이스 항목을 HL7 메시지 형식으로 지정된 HL7 노드에 전송할 수 있습니다.至少选择一条数据库记录时该命令可用,否则显示为灰色。

이 명령을 사용하면 데이터베이스 항목을 HL7 메시지 형식으로 디스크 파일에 저장할 수 있습니다.하나 이상의 레코드를 선택한 경우에만 명령을 사용할 수 있으며, 그렇지 않으면 회색으로 표시됩니다.
이 명령을 사용하면 데이터베이스 항목을 HL7 메시지 형식으로 클립보드에 복사할 수 있습니다.하나 이상의 레코드를 선택한 경우에만 명령을 사용할 수 있으며, 그렇지 않으면 회색으로 표시됩니다.
이 명령을 사용하면 더 이상 필요하지 않은 하나 이상의 데이터베이스 레코드를 삭제할 수 있습니다.하나 이상의 레코드를 선택한 경우에만 명령을 사용할 수 있으며, 그렇지 않으면 회색으로 표시됩니다.
HL7 데이터는 일반적으로 HIS/RIS 소프트웨어에서 생성되어 HL7 메시지를 통해 Worklist Server로 전송되지만, 프로그램에서 새 Worklist 레코드를 처음부터 생성할 수도 있습니다.별표(*)가 있는 필드는 필수 필드입니다。

이 명령을 사용하면 텍스트 파일로 저장된 HL7 메시지를 데이터베이스에 삽입할 수 있습니다.

파일은 HL7 형식의 메시지를 포함하는 텍스트 파일이어야 합니다. 예:
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|||||
이 명령을 사용하면 네트워크의 다른 Worklist Server를 조회하고 해당 레코드를 프로그램의 데이터베이스로 가져올 수 있습니다.

모든 HL7 애플리케이션이 동일한 정보를 HL7 메시지의 동일한 필드에 저장하는 것은 아닙니다. 아래 예에서 두 메시지는 OBR 세그먼트의 서로 다른 위치에 모달리티를 저장합니다:
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|||||||||||||||||||||
第一条消息使用 OBR.18 字段에 모달리티(CT)를 저장하고, 두 번째 메시지는 필드 OBR.21。因此,用户必须将特定 HL7 服务器生成的 HL7 消息字段映射到 Sante Worklist Server 的数据库字段。可使用 데이터베이스-HL7 필드 매핑。此命令显示以下对话框,用户可在其中配置映射:

파일에서 가져오기 按钮
允许이전에 저장한 매핑을 디스크에서 불러올 수 있습니다.
파일로 내보내기 按钮
매핑을 디스크 파일에 저장하여 백업하거나 다른 프로그램 설치에서 사용할 수 있습니다.
Study UID 설정 按钮
일부 의료 스캐너는 Worklist 응답에 Study Instance UID가 없고 해당 필드가 비어 있으면 응답을 수락하지 않습니다. 이 버튼을 사용하면 프로그램이 해당 스캐너용 Study Instance UID를 자동으로 생성할 수 있습니다:

HIS/RIS 소프트웨어에서 수신한 HL7 메시지에 이 필드 값이 없고 대상 스캐너가 위 대화 상자의 목록에 있는 경우에만 프로그램이 Study Instance UID를 생성합니다.
HL7 샘플 파일 열기 按钮
使用此按钮,程序允许用户将一条 HL7 消息与 “데이터베이스-HL7 필드 매핑” 对话框并排打开。사용자는 HL7 메시지에서 필드의 위치를 확인하고 '데이터베이스-HL7 필드 매핑' 대화 상자의 해당 필드에 올바른 값을 입력할 수 있습니다.
이 명령을 사용하면 HL7 메시지를 작성하거나 파일에서 메시지를 불러와 편집한 다음 지정된 HL7 노드로 전송할 수 있습니다.

이 명령을 사용하면 두 HL7 메시지를 비교할 수 있습니다.当一条消息在程序当前字段映射下工作正常,而另一条不能正常工作,并且用户希望找出两条消息之间的差异时,此功能非常有用。

프로그램이 다른 DICOM 또는 HL7 노드와 통신할 수 없는 경우 다음 항목을 확인하십시오:
您可以使用 netstat 命令提示符中的实用程序来프로그램 포트 확인是否已打开,以及它绑定到哪个 IP 주소。
명령 프롬프트에서 다음 명령을 사용하십시오:
C:\>netstat -ano -p tcp |find "11131"
프로그램의 포트 11131이 열려 있는지와 해당 IP 주소를 확인합니다. 출력의 마지막 숫자는 해당 포트를 연 애플리케이션의 PID입니다.
명령 프롬프트에서 다음 명령을 사용하십시오:
C:\>tasklist |find "<PID>"
(其中 <PID> 是应用程序的实际编号,本例中为 25376)

이 명령을 사용하여 Worklist Server 모듈의 포트도 확인할 수 있습니다.
프로그램의 HL7 포트를 통해 네트워크 연결로 전송되는 HL7 메시지는 인쇄할 수 없는 문자 0B(16진수)로 시작하고 인쇄할 수 없는 문자 1C 및 0D(16진수)로 끝나야 합니다. 네트워크가 아닌 프로그램 인터페이스를 통해 삽입되는 메시지에는 이러한 문자가 필요하지 않습니다.
HL7 텍스트 메시지:

시작 및 종료 문자가 강조 표시된 메시지의 16진수 보기:

메시지의 시작 및 종료 문자
HL7 메시지를 소켓을 통해 전송할 때는 문자 0B(HEX)로 시작하고 문자 1C 0D(HEX)로 끝나야 합니다. 메시지에 이러한 문자가 포함되어 있는지 확인하십시오.
명령 프롬프트에서 netstat 유틸리티를 사용하여 프로그램 포트가 열려 있는지와 해당 IP 주소를 확인할 수 있습니다.
명령 프롬프트에서 다음 명령을 사용하십시오:
C:\>netstat -ano -p tcp |find "787"
프로그램의 HL7 포트 787이 열려 있는지와 해당 IP 주소를 확인합니다. 출력의 마지막 숫자는 해당 포트를 연 애플리케이션의 PID입니다.
명령 프롬프트에서 다음 명령을 사용하여 어떤 애플리케이션인지 확인하십시오:
C:\>tasklist |find "<PID>"
(其中 <PID> 是应用程序的实际编号,本例中为 25376)
