hl7接口开发商中文使用手册.doc

中心监护系统中心监护系统 HL7 接口 开发商中文使用手册 版权 HL7 接口开发商中文使用手册（V1.0）- 1 - 版权版权 深圳迈瑞生物医疗电子股份有限公司深圳迈瑞生物医疗电子股份有限公司. . 20032003 版本版本: : 1.01.0 发行日期发行日期: : 2004/3/12004/3/1 声明声明 深圳迈瑞生物医疗电子股份有限公司（简称迈瑞公司）拥有此非公开出版的手册的版权，并有权 将其作为保密资料处理。本手册只作为操作、保养和维修迈瑞产品的参考资料。 此手册及其全部知识产权（含著作权）归迈瑞公司所有。未经迈瑞公司预先书面许可，任何人不 得使用、披露或允许他人以任何不正当手段获取此手册的全部或部分信息。未经迈瑞公司预先书 面许可，任何人不得对本手册的全部或部分内容进行照相复制、复印或翻译成其它语言等。 迈瑞公司对于本资料不作任何形式的担保，包括（但不限于）为某种特定目的对其提出的暗含的 适销性和适合性的保证责任。迈瑞公司对于本资料内包含的错误或由于本手册的提供、实际表现 和使用所造成的偶发或间接损害不承担责任。 手册中所含的内容可以不予通知而做出变更。 目录 - 2 -HL7 接口开发商中文使用手册（V1.0） 目录目录 目录目录2 第第 1 章章 迈瑞迈瑞 HL7 接口概述接口概述3 1.1迈瑞 HL7 接口支持的消息 3 1.2HL7 底层协议 .3 1.3HL7 标准不符合项 .3 第第 2 章章 HL7 消息消息 主动发送主动发送.5 2.1介绍5 2.2消息传递间隔5 2.3消息语法5 2.3.1支持的 HL7 消息 6 2.3.2主动发送 Unsolicited Observation Reporting (ORU).7 2.4消息段7 2.4.1MSH Message Header8 2.4.2PID Patient Identification.8 2.4.3PV1 Patient Visit9 2.4.4OBR Observation Request.9 2.4.5OBX Observation.9 第第 3 章章 HL7 接口查询接口接口查询接口.13 3.1介绍13 3.2消息语法13 3.2.1支持的 HL7 消息 13 3.2.2QRY 消息 13 3.2.3ORF 消息.14 3.2.4ACK 消息 .15 3.3消息段15 3.3.1MSH Message Header15 3.3.2MSA Message Acknowledgement.16 3.3.3QRD Query Definition.16 3.3.4QRF Query Filter .17 3.3.5PID Patient Identification.17 3.3.6PV1 Patient Visit17 3.3.7OBR Observation Request.17 3.3.8OBX Observation.17 附录附录 A Mindray Code System.19 迈瑞 HL7 接口概述 HL7 接口开发商中文使用手册（V1.0）- 3 - 第第 1 章章 迈瑞迈瑞 HL7 接口概述接口概述 HL7 接口是迈瑞中央监护系统的软件可配置项。它为迈瑞监护网络和其他基于 IP 协议的网 络提供一个通道。使用 TCP/IP 连接，客户系统可以用主动发送和查询两种方式从接口取得数据。 除此之外提供一个基于 UDP 协议的广播模式，它也是一种主动发送接口，在 TCP/IP 服务的数量 超限时可以使用它。这三个接口都是可以独立工作的，在下面的具体描述中将分别描述它们。主 动发送接口把最新的病人的数据，床号和参数值以固定的时间间隔（缺省 30 秒）主动发送给客 户系统。查询接口则是通过响应客户系统在任何时候的请求来提供病人的数据，床号和参数。在 两种模式下数据的传输格式都是按照 HL7 版本 2.3.1 来创建的。 1.1 迈瑞迈瑞 HL7 接口支持的消息接口支持的消息 HL7 是一个为住院病人提供护理的电子数据交换标准。最初它由美国定义，现在已经被很多 国家采用。本接口基于 HL7 v2.3.1 来定义，详细内容请参考HL7 Interface Standards Version 2.3.1. 因为迈瑞 HL7 接口只用到很少的数据，所以只有很少的 HL7 中规定的消息类型，段类型和 其他数据在此接口中使用。 1.2 HL7 底层协议底层协议 TCP/IP 是一个字节流协议，它并不提供消息边界。HL7 作为上层协议是基于消息的，但它 也没有提供消息终止机制。为了确定消息边界，我们使用最小的底层协议（HL7 Interface Standards Version 2.3.1.对此也有相应的描述）。 通讯层通讯层 消息被以下面的格式传送： ddddd 其中: = Start Block character (1 byte) ASCII , 即, . 不要和ASCII中的字符SOH 或 STX混淆。 ddddd = Data (variable number of bytes) ddddd是 the HL7 消息. 只包括ISO 8859-1字符(十六进制值 20 - FF) 和 ，不包括其它控制 和不能打印的字符。外部系统也有责任不发送任何禁止的字符，对于这些字符迈瑞HL7接口也不 会有响应。 = End Block character (1 byte) ASCII , 即, . 不要和ASCII 字符 ETX 或 EOT混淆。 = Carriage Return (1 byte) ASCII 回车符， 即， . 1.3 HL7 标准不符合项标准不符合项 作为 CMS 的数据提供方，迈瑞 HL7 接口的查询模式并不完全符合 HL7 标准 2.3.1。有一个 不符合项： 迈瑞 HL7 接口概述 - 4 -HL7 接口开发商中文使用手册（V1.0） 查询接口：查询接口的回应消息ORF消息的段组织顺序为PID - PV1 - OBR OBX，这种方式中增 加了PV1段不符合HL7规定，但是迈瑞中央监护系统是通过床号来查询的，需要PV1段来提供相关信 息。 HL7 消息 主动发送 HL7 接口开发商中文使用手册（ V1.0）- 5 - 第第 2 章章 HL7 消息消息 主动发送主动发送 2.1 介绍介绍 本章描述迈瑞 HL7 主动发送接口的两个 HL7（版本 2.3.1）消息。 注意注意 HL7 支持许多消息类型，但在主动发送模式只用到一种消息。 下面将描述通用的语法规则。 2.2 消息传递间隔消息传递间隔 消息传递的间隔是可变的，由参数数据类型决定： 周期性参数周期性参数 周期性参数每 1-60 秒发送一次，在发送间隔设置中可以调整此时间值。 非周期参数，设置和配置非周期参数，设置和配置 非周期参数到达 HL7 服务器的时间间隔是变化的而且不可预知。每隔一个固定时间 （1，5，10 秒）迈瑞 HL7 接口检查是否有非周期数据到达，如果该数据到达，一个包含该数据 的 ORU 消息将被主动发出。 2.3 消息语法消息语法 这一节将对迈瑞 HL7 接口通用语法做一个介绍。 注意注意 如果需要对 HL7 消息语法的完全、详细的描述，请参看 HL7 标准委员会提供的 HL7 标准。 每一个 HL7 消息由一些段组成，段由结尾。 每个段由三个字符的段名和可变数目的域组成，域由组件和子组件构成，在每个消息的 MSH 段定义各个组成单元的分隔符。 例如： MSH| MSA 段包含一个确认码和相应的消息控制 ID，如果是错误有一个错误字符串。 QRD 段重复查询消息的定义。 QRF 段重复相应的查询滤波器定义。 PID 段包含病人 ID 和姓名。 PV1 段指出访问的床号。 OBR 段包随后的 OBX 参数的时间标识。 OBX 段包含 OBR 段指明时间的观察结果。 注意： ORF 消息中包括 PV1 段这不符合 HL7 的定义。但 PV1 段是必需的，因为它包括床定义。因 为从病人姓名或者病历号都不能正确确定数据来源，床标志当然是重要的和不可遗漏的。 HL7 接口查询接口 HL7 接口开发商中文使用手册（ V1.0）- 15 - ACK 消息消息 确认消息只有在只有当从外部系统得到的消息是不正确的或者不被支持（所以不能处理）的时 候才被发出。它的结构如下： MSH Message Header MSA Message Acknowledgement 其中： MSA 段包含一个确认码和相应的消息控制 ID，如果是错误有一个错误字符串。 MSH|&|ACK|Mindray0001|P|2.3.1 MSA|AE|Mindray0001|The format of QRY Filter isnt correct! 注意： 迈瑞 HL7 接口不发送 ERR 段（它在 ACK 消息中是可选项） 。 3.3 消息段消息段 本节中用表格描述每个段的各个组件： 域长度 数据类型 使用设备 表中列出了消息段中需要的所有域。 （不包括迈瑞 HL7 接口没有使用的域） MSH Message Header 所有的消息都是以 MSH 段开头。 MSH fields 迈瑞 HL7 接口的 MSH 段使用下列域： SequenceField NameDescription 1Field SeparatorContains the separator between segment ID and the first real field. Defines the characters to be used as separators for the rest of the message. 2Encoding Characters包含组件分隔符，重复分隔符，转义分隔符，和子组件分隔符 7Date/Time of Message 进入消息忽略，外出消息发送 9Message TypeQRY 表示消息，ORF表示查询响应，ACK表示错误 10Message Control ID消息唯一标示符，进入的QRY消息必需，它被随ORF消息发出 11Processing ID一直是P (表示产品). 12Version IDHL7协议版本：2.3.1. 18Character Set一直是 8859/1 例如： MSH|&|ORFR04|1,2|P|2.3.1 注意： QRY 消息的控制 ID 被 ORF 或 ACK 消息的 MSA 段发回。这个机制是让外部应用系统检查 哪个消息产生什么回应用的。迈瑞 HL7 接口没有采用检测控制 ID 是否是唯一的机制。 HL7 接口查询接口 - 16 -HL7 接口开发商中文使用手册（V1.0） MSA Message Acknowledgement MSA 段包括一些响应另一个消息的需要发送的信息，它被用在查询响应消息和确认消息中。 迈瑞HL7接口的MSA段使用下列域： SequenceField NameDescription 1Acknowledgement Code AA：应用接受（肯定确认） AE：应用错误（否定确认） 2Message Control ID包含QRY查询消息的控制消息。这可以让客户知道相应查询的响应消 息。 3Text Message出错或拒绝时，一个对事件的文本描述。典型的文本是： “Message type not supported” “Incorrect message syntax” 例如： MSA|AA|1,2 QRD Query Definition 每个 QRY 消息包括查询定义，查询响应也把它送回来： QRD fields 迈瑞HL7接口的QRD段使用下列域： SequenceField NameDescription 1Query Date/Time从进入消息取得值在响应消息中使用 2Query format code一直是 R （record-oriented） 3Query Priority一直是一直是 I （immediate） 4Query ID唯一标识符 7Quantity limited request 一直是空表示NO LIMIT 8Who subject filter只使用开始的3个组件，格式如下： 一个查询可能有三种匹配结果： 1. ID， 姓和名都匹配 2. ID匹配，但是没有姓或名 3. 姓和名匹配，但是没有ID 9What subject filterRES 表示查询和响应的结果 处理规则： Query date/time 对于迈瑞 HL7 查询接口是被忽略的，但它会在查询响应中被回送。外部 系统需要提供这个值。 查询的 query format code 是 “R”， query priority “I”，如果这个域是空或者别的内容，就 会被当作一个错误的条件。 Query ID 不能为空。虽然不处理但响应会把它回送。迈瑞 HL7 接口不控制 control ID 是 HL7 接口查询接口 HL7 接口开发商中文使用手册（ V1.0）- 17 - 否是唯一的。 Quantity limited 的值不会处理。 QRF Query Filter 查询滤波器在查询消息中，它在响应消息中被回送。它指出所需数据的床。如果 QRF 段没 有指明，表示需要所有床的数据，回送时无 QRF 段。 迈瑞HL7接口的QRF段使用下列域： SequenceField NameDescription 1Where subject filter一直是MON （monitoring data） 5Other query filter指明所要的床。 处理规则： 在响应消息中，除了 Other query filter 滤波器域以外，其他的滤波器域都没有保留。 Other query subject filter 由一串可重复的字符串组成，每一个表示一个床。床是由网络号 表示，用“， ”分开，例如： 1,2,3,4,63 如果一个床被提出多次，但响应只有一次。 PID Patient Identification 参看 0 PV1 Patient Visit 参看 0 OBR Observation Request 参看 0 OBX Observation 迈瑞 HL7 接口在 ORF 中使用 OBX 向外部系统发送参数，设置和设备配置。一个值用一个 OBX。不管参数值是否变化，每个查询响应包含所有参数的 OBX，因为最新的查询产生了。 参看 0 MSH|&|ORFR04|1,2|P|2.3.1 MSA|AA|1,2 QRD|20030928121009|R|I|MindrayQ0001|RES QRF|MON|1,2 PID|sz0001|Mindray|19770917|M PV1|I|1&1&1 OBR|20030928121009 HL7 接口查询接口 - 18 -HL7 接口开发商中文使用手册（V1.0） OBX|NM|110HR|60|bpm|11350|F OBX|NM|111RR|20|bpm|6150|F OBX|NM|112ST1|2|mv|-66|F OBX|NM|113ST2|4|mv|-66|F OBX|NM|114ST3|2|mv|-66|F OBX|NM|115PVCs|10|pm|060|F OBX|NM|150SPO2|98|%|1100|F OBX|NM|151PR|60|bpm|11350|F OBX|NM|161NIBP_S|110|mmHg|1300|F OBX|NM|162NIBP_D|70|mmHg|1300|F OBX|NM|163NIBP_M|84|mmHg|1300|F OBX|NM|170T1|374|c|0500|F OBX|NM|171T2|365|c|0500|F OBX|NM|172TD|9|c|-500500|F OBX|NM|190C.O.|312|1*100/min|50600|F OBX|NM|192TB|370|c|230450|F OBX|NM|201ART_S|121|mmHg|-9300|F OBX|NM|202ART_D|70|mmHg|-9300|F OBX|NM|203ART_M|95|mmHg|-9300|F OBX|NM|221ICP_S|121|mmHg|-9300|F OBX|NM|222ICP_D|81|mmHg|-9300|F OBX|NM|223ICP_M|95|mmHg|-9300|F 附录 HL7 接口开发商中文使用手册（ V1.0）- 19 - 附录附录 A Mindray Code System CODELabelDescriptionParameter 1REDRed Alarm, critical alarm, high levelalarm message 2ORANGEOrange Alarm, serious alarm, medium levelalarm message 3YELLOWYellow Alarm, general alarm, low levelalarm message 101ECGnon-specific label for ECG.wave 102ILead I - ECG specific label.wave 103IILead II - ECG specific labelwave 104IIILead III - ECG specific labelwave 105aVLAugmented lead aVLwave 106aVRAugmented leads aVRwave 107aVFAugmented leads aVFwave 108VChest lead Vwave 109CALone additional lead for 5 lead cablewave 110HRHeart Ratenumeric 111RRRespiration wave/ratenumeric 112ST1ST parameter - value ST1numeric 113ST2ST parameter - value ST2numeric 114ST3ST parameter - value ST3numeric 115PVCsPVC sum per minutenumeric 150SPO2Percent Oxyhemoglobin Saturation - Arterialnumeric 151PRPusle Ratenumeric 161NIBP SNon-invasive Blood Pressure Systolicnumeric 162NIBP DNon-invasive Blood Pressure Diastolicnumeric 163NIBP MNon-invasive Blood Pressure Meannumeric 170T1Non-specific temperature 1numeric 171T2Non-specific temperature 2numeric 172TD Delta Temperature between non-specific temperature labels numeric 190C.O.Cardiac outputnumeric 191C.I.Cardiac Indexnumeric 192TBBlood temperature - delivered by C.O.numeric 200ART Specific Pressure Label - Arterial Blood Pressure wave 201ART S Specific Pressure Label - Arterial Blood Pressure Systolic numeric 附录 - 20 -HL7 接口开发商中文使用手册（V1.0） 202ART D Specific Pressure Label - Arterial Blood Pressure Diastolic numeric 203ART M Specific Pressure Label - Arterial Blood Pressure Mean numeric 204PASpecific label - Pulmonary Artery Pressurewave 205PA S Specific label - Pulmonary Artery Pressure Systolic numeric 206PA D Specific label - Pulmonary Artery Pressure Diastolic numeric 207PA M Specific label - Pulmonary Artery Pressure Mean numeric 208CVP Specific pressure label - Central Venuous Pressure wave 211CVP M Specific pressure label - Central Venuous Pressure Mean numeric 212LAPSpecific label - Left Atrial Pressure wave 215LAP MSpecific label - Left Atrial Pressure Meannumeric 216RAP Specific Pressure Label - Right Atrial Blood Pressure wave 219RAP M Specific Pressure Label - Right Atrial Blood Pressure Mean numeric 220ICPSpecific label - Intra Cranial Pressurewave 223ICP MSpecific label - Intra Cranial Pressure Meannumeric 224P1non-specific label for Pressure 1wave 225P1 Snon-specific label for Pressure 1 Systolicnumeric 226P1 Dnon-specific label for Pressure 1 Diastolicnumeric 227P1 Mnon-specific label for Pressure 1 Meannumeric 228P2non-specific label for Pressure 2 wave 229P2 Snon-specific label for Pressure 2 Systolicnumeric 230P2 Dnon-specific label for Pressure 2 Diastolicnumeric 231P2 Mnon-specific label for Pressure 2 Meannumeric 232P3non-specific label for Pressure 3wave 233P3 Snon-specific label for Pressure 3 Systolicnumeric 234P3 Dnon-specific label for Pressure 3 Diastolicnumeric 235P3 Mnon-specific label for Pressure 3 Meannumeric 236P4non-specific label for Pressure 4wave 237P4 Snon-specific label for Pressure 4 Systolicnumeric 238P4 Dnon-s