检验结果WebService服务接口协议

### 检验结果WebService服务接口协议 #### 一、编制目的 本文档旨在详细介绍如何通过第三方系统获取晶奇LIS系统中的检验结果。这里既包括结构化的检验数据也包括非结构化的PDF报告。文档全面地阐述了接口的调用方式、各个功能函数及其参数定义，并提供了开发实例等内容，为软件开发工程师、项目实施工程师等相关人员提供技术支持。 #### 二、调用方法 为了通过WebService获取检验结果，开发者需要遵循以下步骤： 1. **接口地址**: 首先访问服务供应商提供的WebService地址，例如 `http://192.168.88.27:6677/LisReportService.asmx`。实际项目中的地址可能会有所不同，请以供应商提供的为准。 2. **查看可用函数**: 在浏览器中打开上述地址后，可以看到一系列可调用的函数，如 `Login`, `GetReportList`, `GetReportDetailByBarcode`, `ExistsReport` 等。 3. **调用流程**: - **登录验证**: 需要首先调用 `Login` 函数来获取用户的授权码，这是后续所有操作的基础。 - **获取报告**: 根据需求调用相应的函数来获取结构化或非结构化的检验报告。 - **回执打印状态**: 如果获取到的报告已经被打印，需要调用特定函数来更新其打印状态。 #### 三、函数说明 ##### 3.1 Login 用户验证获取授权码 - **函数名称**: `Login` - **函数描述**: 用于获取用户授权码，需要用户提供由服务供应商提供的用户名与密码。 - **入参**: - `Logid`: 用户名 (`string`) - `Password`: 密码 (`string`) - **返回值**: - 成功时返回一个授权码 (`string`)。 ##### 3.2 SetPrintStatus 回执打印状态 - **函数名称**: `SetPrintStatus` - **函数描述**: 根据检验条码号回执报告打印状态。 - **入参**: - `Key`: 授权码 (`string`) - `Barcode`: 检验报告条码号 (`String`) - **返回值**: - 成功返回 `"success"`，否则返回错误提示信息。 ##### 3.3 GetReportList 获取指定条件报告列表 - **函数名称**: `GetReportList` - **函数描述**: 根据指定条件获取报告列表。 - **入参**: - `Key`: 授权码 (`string`) - `Type`: 查询类型，标识通过什么途径查询报告 (int, 默认为0表示身份证号) - `CardNo`: 卡号(身份证号或者一卡通号) (`string`) - `StartDate`: 报告查询起始时间 (`string`, 格式: `yyyy-MM-dd hh:mm:ss`) - `EndDate`: 报告查询结束时间 (`string`, 格式: `yyyy-MM-dd hh:mm:ss`) - `Status`: 报告类型标识，标识报告是否已经打印过 (int, 0表示下载全部报告) - **返回值**: JSON类型的结果集，示例如下: ```json { "reports": [ { "barcode": "1810120001", "patientName": "张三", "reportDate": "2018-10-12", "status": "未打印" }, { "barcode": "1810120002", "patientName": "李四", "reportDate": "2018-10-12", "status": "已打印" } ] } ``` ##### 3.4 GetReportDetailByBarcode 根据LIS条码号获取报告结果明细 - **函数名称**: `GetReportDetailByBarcode` - **函数描述**: 根据LIS系统的条码号获取结构化报告结果。 - **入参**: - `Key`: 授权码 (`string`) - `Barcode`: 检验报告条码号 (`String`) - **返回值**: JSON类型的结果集，示例如下: ```json { "barcode": "1810120001", "patientName": "张三", "reportDate": "2018-10-12", "items": [ { "itemName": "白细胞计数", "result": "5.2", "referenceRange": "4.0-10.0" }, { "itemName": "红细胞计数", "result": "4.5", "referenceRange": "4.0-5.5" } ] } ``` ##### 3.5 GetByteReport 返回字节流PDF报告单 - **函数名称**: `GetByteReport` - **函数描述**: 根据LIS条码号获取PDF格式检验报告。 - **入参**: - `Key`: 授权码 (`string`) - `Barcode`: 检验报告条码号 (`String`) - **返回值**: Base64编码的PDF报告。 #### 四、开发示例 尽管文档中没有提供具体的开发示例，但根据上述函数说明，可以构建出相应的代码逻辑。例如，在Java中调用 `Login` 函数获取授权码: ```java URL url = new URL("http://192.168.88.27:6677/LisReportService.asmx/Login"); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setRequestMethod("POST"); // 设置请求参数 String params = "Logid=1001&Password=Jqkj123456"; OutputStream os = conn.getOutputStream(); os.write(params.getBytes()); os.flush(); os.close(); // 读取响应 BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream())); String inputLine; StringBuilder response = new StringBuilder(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); // 解析返回的授权码 String key = response.toString(); ``` 以上示例展示了如何通过HTTP POST请求调用 `Login` 函数并获取授权码的过程。针对其他函数，可以采用类似的方法构建调用逻辑。 通过本文档的详细介绍，开发者可以清楚地了解如何使用LIS系统-检验结果WebService服务接口协议来实现第三方系统与晶奇LIS系统的集成，进而获取检验结果数据。