LIS-HL7(网口通讯协议).doc

CS-1600/CS-6400全自动生化分析仪LIS网络接口使用说明书V1、002011/07/04前言使用本系统前，请仔细阅读并理解本接口手册得内容，以便正确使用该系统。本使用说明书得读者对象为进行LIS（实验室信息系统）开发得人员以及需要了解HL7 接口得其她相关人员。本接口手册用于指导LIS系统开发商开发LIS接口，目得就是使LIS系统能够同生化分析仪系统进行通信。开发者需要具备一定得LIS、HL7标准相关知识以及网络编程得能力。网络层通讯协议为TCP/IP，应用层协议为HL7，版本2、3、1。建议在Windows平台下使用Visual C+、Delphi等开发工具进行接口开发。本使用说明书为CS-1600/CS-6400全自动生化分析仪HL7接口使用说明书。目录1、 接口概述- 1 -1、1 HL7消息结构- 1 -1、2 HL7底层协议- 1 -2、 通讯格式- 3 -2、1 支持得HL7消息- 3 -2、2 消息段- 6 -3、 通迅示例- 22 -3、1发送检测数据过程- 22 -3、2发送查询请求过程- 25 -1、 接口概述HL7就是标准化得卫生信息传输协议，就是医疗领域不同应用之间电子传输得协议。HL7汇集了不同厂商用来设计应用软件之间界面得标准格式，它将允许各个医疗机构在异构系统之间，进行数据交互。最初它由美国定义，现在已经被很多国家采用。本接口下数据得传输格式都就是按照HL7版本2、3、1来创建得。1、1 HL7消息结构在HL7通讯协议中，消息(Message)就是数据在系统之间交换得基本单元，每条消息都有各自得消息类型，用于定义消息目得消息类型中有触发事件。一个消息由多个段(Segment)组成，每一段都有相应得名称，用于界定其内容或功能。而一个段又由多个数据字段(Data Field)组成。一个消息中得第一个段总就是消息头段(Message head segment)，它指明了发送与接收得程序名、消息类型、以及一个唯一得消息ID号码等，接下去段得构成由消息得类型决定。如，PID段(Patient Identification Data)包括姓名、地址、社会保险号等。一个数据字段又有可能由多个组件组成。有些消息可进一步由事件码(event code)细分。本接口基于HL7 v2、3、1来定义，详细内容请参考HL7 Interface Standards Version 2、3、1。1、2 HL7底层协议TCP/IP就是一个字节流协议，它并不提供消息边界。HL7 作为上层协议就是基于消息得，但它也没有提供消息终止机制。为了确定消息边界，我们使用最小得底层协议（HL7 Interface Standards Version 2、3、1、对此也有相应得描述）。消息开始采用一个单字符，结束采用双字符。消息被以下面得格式传送： data ，其中： = Start Block character (1 wide char)，ASCII ，即0x0B。data = Data (variable number of wide chars)，data就是HL7消息，只包括ISO 8859-1字符(十六进制值20 - FF)与，不包括其它控制与不能打印得字符。 = End Block character (1 wide char)，ASCII ，即0x1C。 = Carriage Return (1 wide char)，ASCII回车符，即0x0D。 备注：本协议采用Unicode编码，所有发送、接收字符串均为Unicode编码格式得字符串。2、 通讯格式本接口通讯包括测试结果得传输与样本信息申请两个方面。测试结果得传输主要实现生化分析仪传输样本信息及其检测结果、质控结果至外部系统（如LIS）。数据传输得方式有测试时得实时传输与对历史结果得批量传输。样本信息申请就是指生化分析仪从LIS获取所需得样本信息至本地进行测试。2、1 支持得HL7消息本接口使用得所有HL7消息有ORU、ACK、QRY、DSR。测试结果得上传示意图如下：从LIS 服务器获取样本申请信息示意图如下：ORU/ACK：非请求观察报告/响应。ORUR01消息得主要得作用就是在HL7中用于传递实验室结果，我们用来传输样本信息及其检测结果、质控结果到LIS系统。对于传输信息及其检测结果，包括以下信息：患者信息（病人姓名、样本编号等）医嘱信息（样本类型，送检医生，检验医生，临床诊断等）检验结果它就是一组消息，每一个消息对应一个样本信息（可能有多个项目得测试结果）。LIS系统可以根据需要选用这些内容。具体得结构如下：ORU Observational Results (Unsolicited)描述MSH消息头PID病人信息OBR观察报告OBX检测结果对于传输测试结果，包括以下信息：项目信息（项目编号、项目名称）质控液相关信息（质控次数、质控名称、质控批号等）质控日期，检测结果一个消息将发送一个质控测试。质控结果得发送结构如下：ORU Observational Results (Unsolicited)描述MSH消息头OBR质控观察报告ACKR01：消息用于对ORU消息得响应。具体得结构如下：ORU Observational Results (Unsolicited)描述MSH消息头MSA消息确认QRY/QCK：查询观察结果/响应。QRYQ02消息查询当前数据，用来向LIS系统查询所需得样本信息。具有如下结构：QRY Query描述MSH消息头QRD查询定义QRF查询筛选DSR/ACK：对QRY消息得响应、对观察结果显示/响应。DSRQ03消息得一个作用就是对QRY消息得响应，另一个作用时查询结果得发送显示，即让LIS把所需样本申请信息发送到生化分析仪。具体结构如下：DSR Display Response描述MSH消息头MSA消息确认DSP显示数据ACKQ03：消息用于对DSR消息得响应。具体结构如下：ACK Acknowledgment描述MSH消息头MSA消息确认2、2 消息段本节将详细介绍消息段中所有使用得域。其中，序号后有#得为HL7规定得必选字段。为以后可能得扩充需要，我们不省略消息段中得未用字段。1. MSH Message Header HL7消息得首消息段，所有得消息都就是以MSH段开头，一般位于消息得最前面。该消息段用于定义消息得意图、来源、目得与消息语法得某些细节。本接口得MSH段使用下列各域： 序号字段名长度说明1# Field Separator 1 包含段ID与第一个真正得域之间得分隔符，定义消息剩下部分得域分隔符（|）。2# Encoding Characters 4 包含组件分隔符，重复分隔符，转义分隔符，与子组件分隔符（&）。 3 Sending Application 180 发送端应用程序。 4 Sending Facility 180 置空，保留。发送端设备。 5 Receiving Application 180 接收端应用程序。6 Receiving Facility 180 置空，保留。接收端设备。7 Date/Time Of Message 26 当前消息得时间。调用系统得时间信息。8 Security 40 置空，保留。安全性9# Message Type 7 消息得类型，如：ORUR01。 10# Message Control ID 20 消息控制ID，唯一标识一个消息，随消息数目增加从1 递增。11# Processing ID 3 处理ID，一直取P （表示产品）。12# Version ID 60 版本ID，HL7 协议版本：2、3、1。 13 Sequence Number 15置空，保留。序列号。14 Continuation Pointer 180置空，保留。连续指针。15 Accept Acknowledgment Type 2 置空，保留。接收应答类型。16 Application Acknowledgment Type 2 应用程序应答类型，作为发送得结果类型。0-病人样本测试结果；1-校准结果；2-质控结果；其中”1-校准结果”暂不支持。17 Country Code 2 置空，保留。国家代码。18 Character Set 10 字符集，取UNICODE。19 Principal Language Of Message 60 置空，保留。消息主要语言。20 Alternate Character Set Handling Scheme 20 置空，保留。交替字符集处理方案。备注：该段在所有消息中都会出现。LIS系统发送给生化分析仪得HL7消息中，该段得第3、4字段值由LIS开发商制定，第5、6字段由用户在生化分析仪软件上设置。第10、16字段使用整型；其她所有字段均使用字符串类型。2、 MSA - message acknowledgment segment 本接口得MSA段使用下列各域： 序号字段名长度说明1# Acknowledgment Code 2 确认代码，AA表示接受；AE表示错误；AR表示拒绝，OK表示查询到数据，NF表示没有找到数据，OK与NF仅在DSRQ03中有效。2# Message Control ID 20 消息控制ID，与发送方得MSH-10相同。3 Text Message 80 文本消息，出错或拒绝时，一个对事件得文本描述。与第6字段对应，可用于写入错误日志。4 Expected Sequence Number 15 置空，保留。预期得序列号。5 Delayed Acknowledgment Type 1 置空，保留。延迟得确认类型。6 Error Condition 100 错误条件（状态代码）。MSA-6 字段得取值见下表：状态代码（MSA-6） 状态文本（MSA-3） 描述/备注成功AA 0 Message accepted 成功。查询成功OK0Data found, not errors查询成功。查询没有找到数据NF0No data found, not errors查询没有找到数据。错误状态代码AE 100 Segment sequence error 消息中段得顺序不正确，或者丢失必须得段。101 Required field missing 一个段中丢失必须得字段。102 Data type error 字段得数据类型错误，如数字得成了字符。103 Table value not found 表值未找到，暂不用。拒绝状态代码AR 200 Unsupported message type 消息类型不支持。201 Unsupported event code 事件代号不支持。202 Unsupported processing id 处理ID不支持。203 Unsupported version id 版本ID不支持。204 Unknown key identifier 不明关键字标识，如传输一个不存在得病人信息。205 Duplicate key identifier 已存在重复得关键字。206 Application record locked 事务在应用程序存储级不能执行，如数据库被锁。207 Application internal error 不明得应用程序内部其它错误。备注：该消息段可出现在ACKR01、DSRQ03、ACKQ03消息中。第4、6字段使用整型；其她字段都使用字符串类型。3、 PID Patient Identification PID段主要用来构建病人信息。本接口得PID段使用下列各域：序号字段长度说明1 Set ID PID 10 确定不同得病人消息段。2 Patient ID 20 置空，保留。病人得住院号。3# Patient Identifier List 16 病历号。4 Alternate Patient ID PID 10 床号。5# Patient Name 30 病人得姓名。6 Mothers Maiden Name 61 病区与病房。病区与病房之间用分隔，其中病区长度30，病房长度30。7 Date/Time of Birth 26 置空，保留。病人出生日期。8 Sex 1 性别男，发送M；女，发送F；其它，发送O。9 Patient Alias 48 置空，保留。血型。10 Race 80 置空，保留。置空，保留。种族。11Patient Address 106 置空，保留。病人地址。12 County Code 4 置空，保留。郡县代码（邮编）。13 Phone Number -Home 40 置空，保留。电话号码。14 Phone Number -Business 40 置空，保留。置空，保留。电话号码-公司。15 Primary Language 60 置空，保留。置空，保留。主要语言。16 Marital Status 80 置空，保留。置空，保留。婚姻状况。17 Religion 80 置空，保留。置空，保留。宗教。18 Patient Account Number 30 病人类别。19 SSN Number -Patient 16 置空，保留。以医保账号。20 Drivers License Number Patient 25 置空，保留。收费类型。21 Mothers Identifier 20 置空，保留。母亲标识符。22 Ethnic Group 30 民族。23 Birth Place 60 置空，保留。出身地（籍贯）。24 Multiple Birth Indicator 1 置空，保留。置空，保留。多胞胎指示符，就是为Y，否为N 。25 Birth Order 2 置空，保留。出生次序，大于0得整数。26 Citizenship 100 备注。27 Veterans Military Status 60 置空，保留。退伍军人状态28 Nationality 80 置空，保留。国家。29 Patient Death Date and Time 26 置空，保留。病人死亡时间。30 Patient Death Indicator 1 置空，保留。病人死亡指示符，就是为Y，否为N。31Patient Age5年龄与年龄单位。年龄与年龄单位之间用分隔。其中年龄为整数，长度3。年龄单位为字符串，长度为1，岁发送Y，月发送M，天发送D，小时发送H。备注：该消息段仅用于ORUR01消息中。第1、25字段，31字段中得年龄字段使用整型数据类型；其她字段使用字符串数据类型。4、 OBR Observation Request OBR段用于传输关于检验报告相关得医嘱信息。在传输得就是病人样本测试结果信息时（MSH-16取0时），本接口得OBR段使用下列各域：序号字段长度说明1 Set ID OBR 10 确定不同得OBR字段。2 Placer Order Number 22 请求者医嘱号，用作样本条码号。3 Filler Order Number 5 执行者医嘱号，用作样本编号。4# Universal Service ID 200 通用服务标识符。 5 Priority 2 就是否急诊，就是为Y，否为N。6 Requested Date/time 26 置空，保留。请求时间/日期。7 Observation Date/Time 26 观察日期/时间，用作检验日期/时间。8 Observation End Date/Time 26 置空，保留。观察结束日期/时间。9 Collection Volume3 用作重复测试次数，取1。10 Collector Identifier 8 采集者标示。用作样本与位置。样本架与位置之间用分隔。样本架长度为4，位置长度为3。如果仪器就是CS-1600则此字段表示样本盘盘号与样本位置。11Specimen Action Code 1 置空，保留。样本处理代码。12 Danger Code1 危险代码。用作就是否稀释，就是为Y，否为N。13 Relevant Clinical Info、 100 相关临床信息，用作病人临床诊断信息。14 Specimen Received Date/Time 26 送检日期/时间。15 Specimen Source 1 样本来源，用作样本类型，如血清、血浆、尿液等。0-血清，1-尿液，2-血浆，3-脑脊液，4-胸腹水，5-其她。16 Ordering Provider 30 医嘱提供者，用作送检医生。17 Order Callback Phone Number 30 用作送检科室。18 Placer Field 1 60 置空，保留。样本性状（黄疸、溶血、脂血）。 19 Placer Field 2 60 置空，保留。血袋编号。20 Filler Field 1 30 主治医生，用作检验医生。21 Filler Field 2 60 置空，保留。治疗科室。22 Result Rpt/Status Change Date/Time 26 结果报告日期/时间。23 Charge to Practice 40 置空，保留。实行费用。24 Diagnostic Serv Sect ID 10 置空，保留。诊断部分ID。 25 Result Status 1 置空，保留。结果状态。26 Parent Result 200 置空，保留。父医嘱结果。27 Quantity/Timing 200 置空，保留。数量/时间。28 Result Copies To 150 置空，保留。结果抄送。29 Parent 150 置空，保留。父医嘱。30 Transportation Mode 20 置空，保留。传输模式。31 Reason for Study 300 置空，保留。研究原因。32 Principal Result Interpreter 30 结果主要解释者，用作审核医生。33 Assistant Result Interpreter 200 置空，保留。结果辅助解释者。34 Technician 200 置空，保留。技术员。35 Transcriptionist 200 置空，保留。转录。36 Scheduled Date/Time 26 置空，保留。预定日期/时间。37 Number of Sample Containers 4 置空，保留。样本容器数量。38 Transport Logistics of Collected Sample 60 置空，保留。采集样本得运输后勤。39 Collectors Comment 200 置空，保留。采集者注释。40 Transport Arrangement Responsibility60 置空，保留。运输安排负责。41 Transport Arranged 30 置空，保留。运输就是否安排。42 Escort Required 1 置空，保留。需要护送。43 Planned Patient Transport Comment 200 置空，保留。已安排得病人运输注释。44 Ordering Facility Name 60 置空，保留。请求者名字。45 Ordering Facility Address 106 置空，保留。请求者地址。46 Ordering Facility Phone Number 48 置空，保留。请求者电话号码47 Ordering Provider Address 106 置空，保留。请求者提供者地址。备注：该消息段仅用于ORUR01消息中。第1、3、9、10段中得样本位置字段、15、37字段使用整型数据类型；其她字段均使用字符串数据类型。如果传输得就是项目质控测试结果时（MSH-16为2）。其字段定义如下：序号字段长度说明1 Set ID OBR 10 确定不同得OBR字段。2 Placer Order Number 22 请求者医嘱号，用作样本条码号。3 Filler Order Number 5 执行者医嘱号，用作样本编号。4# Universal Service ID 200 通用服务标识符。 5 Priority 2 就是否急诊，就是为Y，否为N。6 Requested Date/time 26 置空，保留。请求时间/日期。7 Observation Date/Time 26 观察日期/时间，用作质控日期/时间。8 Observation End Date/Time 26 置空，保留。观察结束日期/时间。9 Collection Volume20 置空，保留。10Collector Identifier8 采集者标示。用作样本架与位置。样本架与位置之间用分隔。样本架长度为4，位置长度为3。如果仪器就是CS-1600则此字段表示样本盘盘号与样本位置。11Specimen Action Code 5用作质控次数。12 Danger Code3用作模块与内外圈标示。模块与内外圈标示之间用分隔。其中1表示外圈，2表示内圈，3表示内外圈。13 Relevant Clinical Info、 20 用作质控名称。14 Specimen Received Date/Time 26 置空，保留。15 Specimen Source 1 样本来源，用作样本类型，如血清、血浆、尿液等。0-血清，1-尿液，2-血浆，3-脑脊液，4-胸腹水，5-其她。16 Ordering Provider 15用作质控批号。17 Order Callback Phone Number 10 用作平均值。18 Placer Field 1 10 用作标准差。 19 Placer Field 2 10 用作质控结果。20 Filler Field 1 12 用作结果单位。21 Filler Field 2 10 用作结果标志。如果结果与平均值得绝对值之差大于等于SD，且小于2SD,则返回+1SD(或-1SD)；如果结果与平均值得绝对值之差大于等于2SD，且小于3SD,则返回+2SD(或-2SD)；如果结果与平均值得绝对值之差大于等于3SD,则返回+3SD(或-3SD)。22 Result Rpt/Status Change Date/Time 26 置空，保留。结果报告日期/时间。23 Charge to Practice 10 用作质控规则。如果结果与平均值得绝对值之差大于等于SD，且小于2SD,则返回空；如果结果与平均值得绝对值之差大于等于2SD，且小于3SD,则返回1-2s；如果结果与平均值得绝对值之差大于等于3SD,则返回1-3s。24 Diagnostic Serv Sect ID 10 置空，保留。诊断部分ID。 25 Result Status 1 置空，保留。结果状态。26 Parent Result 200 置空，保留。父医嘱结果。27 Quantity/Timing 200 置空，保留。数量/时间。28 Result Copies To 150 置空，保留。结果抄送。29 Parent 150 置空，保留。父医嘱。30 Transportation Mode 20 置空，保留。传输模式。31 Reason for Study 300 置空，保留。研究原因。32 Principal Result Interpreter 30 置空，保留。结果主要解释者。33 Assistant Result Interpreter 200 置空，保留。结果辅助解释者。34 Technician 200 置空，保留。技术员。35 Transcriptionist 200 置空，保留。转录。36 Scheduled Date/Time 26 置空，保留。预定日期/时间。37 Number of Sample Containers 4 置空，保留。样本容器数量。38 Transport Logistics of Collected Sample 60 置空，保留。采集样本得运输后勤。39 Collectors Comment 200 置空，保留。采集者注释。40 Transport Arrangement Responsibility60 置空，保留。运输安排负责。41 Transport Arranged 30 置空，保留。运输就是否安排。42 Escort Required 1 置空，保留。需要护送。43 Planned Patient Transport Comment 200 置空，保留。已安排得病人运输注释。44 Ordering Facility Name 60 置空，保留。请求者名字。45 Ordering Facility Address 106 置空，保留。请求者地址。46 Ordering Facility Phone Number 48 置空，保留。请求者电话号码47 Ordering Provider Address 106 置空，保留。请求者提供者地址。备注：该消息段仅用于ORUR01消息中。第1、10段中得样本位置段、11、12段中得模块字段与内外圈标示字段、15字段使用整型数据类型；第17、18、19用浮点数；其她字段均使用字符串数据类型。5、 OBX Observation OBX主要用于在报告消息中传递观察得信息。如果传输得就是样本信息（MSH-16为0时），一个病人可能有多个OBX。本接口得OBX段使用下列域：序号字段长度说明1 Set ID OBX 10 确定不同得OBX字段。2 Value Type 3 值类型，用作标识测试结果得类型NM (numeric)表示数字值，用于定量项目ST (string)表示字符串值，用于定性项目。3# Observation Identifier 5 观察标识符，用作项目ID号。4 Observation Sub-ID 16 观察Sub-ID，用作项目名称与重复测试次数。项目名称与重复测试次数用分隔，项目名称长度12，重复测试次数长度3。5 Observation Value 16 观察值，用作检验结果值（结果浓度或阴性、阳性等）。6 Units 12 单位，用作检验结果值得单位。7 References Range 30 参考范围，检验结果值正常范围。8 Abnormal Flags 5 异常标志，检验结果就是否正常（描述）L-偏低H-偏高N-正常。9 Probability 5 置空，保留。可能性。10 Nature of Abnormal Test 5 置空，保留。用作结果标志。F-检测结果，C-复查结果。11# Observe Result Status 1 置空，保留。观察结果状态。 12 Date Last Observe Normal Values 26 置空，保留。最后观察正常值日期。13 User Defined Access Checks 16 用户自定义访问检查，用作原始结果。14 Date/Time of the Observation 28 观察日期/时间，用作检测日期/时间。15 Producers ID 30 结果生成者ID。16 Responsible Observer 30 负责观察者，用作检验医生。17 Observation Method 60 置空，保留。观察方法。备注：该消息段仅出现在ORUR01消息中。第1、3、4字段得重复测试字段使用整型数据类型；第5、13字段使用浮点数据类型；其她字段均使用字符串数据类型。6、 QRD - query definition segment 本接口得QRD段使用下列域：序号字段长度说明1# Query Date/Time 26 本次查询产生时间，取系统时间2# Query Format Code 2 查询格式代码，查询方式，取SN（表示样本编号方式）与BC（表示样本条码方式）。3# Query Priority 1 查询优先权，取D（deferred）。 4# Query ID 10 查询ID，表征不同得查询，随查询数目由1 递增。5 Deferred Response Type 1 置空，保留。延迟响应类型。6 Deferred Response Date/Time 26 置空，保留。延迟响应日期/时间。7# Quantity Limited Request 10 数量限制要求，取RD（Records）。 8# Who Subject Filter 30 查询人过滤符，如果QRD-2为SN此字段用作样本编号，如果QRD-2为BC则此字段用作样本条码。9# What Subject Filter 60 置空，保留。查询内容过滤符。10# What Department Data Code 8 用作样本架与位置。样本架与位置用分隔，样本架长度4，样本位置长度为3。样本架与位置需要LIS在DSRQ03消息中按原值返回。如果仪器就是CS-1600则此字段表示样本盘盘号与样本位置。11 What Data Code Value Qual、1 用作就是否稀释，稀释为Y，不稀释为N。就是否稀释需要LIS在DSRQ03消息中按原值返回。12 Query Results Level 1 置空，保留。查询结果水平，取T（Full results） 备注：该消息段出现在QRYQ02消息中。第4字段为整型数据类型；其她字段均使用字符串数据类型。7、 QRF - query filter segment QRF段与QRD配合使用，进一步精炼原始查询内容。本接口得QRF段使用以下各域：序号字段长度说明1# Where Subject Filter 20 查询者地点过滤符。2 When Data Start Date/Time26 记录开始日期/时间，用作查询时得样本接收时间之始。3 When Data End Date/Time 26 记录结束日期/时间，用作查询时得样本接收时间之末。4 What User Qualifier 60 置空，保留。使用者合格标志。5 Other QRY Subject Filter 60 置空，保留。其它QRF 接受过滤符。6 Which Date/Time Qualifier 12 目标类型，取RCT。7 Which Date/Time Status Qualifier 12 目标状态，取COR。 8 Date/Time Selection Qualifier 12 日期/时间选择限定符，取ALL。9 When Quantity/Timing Qualifier 60 置空，保留。时间间隔段。备注：该消息段出现在QRYQ02消息中。第3与第4字段分别为查询当日零点与查询发生时得时间，用来作为查询得时间区间条件。所有字段均使用字符串类型。8、 DSP - display data segment DSP段用来给出显示查询得到得样本信息与检测项目，可重复。DSP共重复3次；第1个DSP段传输得就是患者信息，此时DSP段使