### 集成平台接口文档知识点解析
#### 一、文档基本信息
- **文档名称**：集成平台接口文档_V1.72
- **描述**：该文档详细介绍了集成平台接口的设计与使用方法，适用于那些希望了解如何编写接口文档或者需要参考实际案例的技术人员。文档内容全面且详细，便于理解与应用。
#### 二、接口交互方式概述
- **实时接口**：主要采用基于SOAP协议的WebService方式进行交互，支持两种消息格式：
- **HL7V3标准**：医疗领域常用的标准格式，确保消息的一致性和可读性。
- **自定义消息格式（基于XML）**：适用于特定业务需求，提供更灵活的数据交换方式。
- **非实时接口**：采用MQ（Message Queue）异步消息传递的方式，同样支持HL7V3标准和自定义XML格式的消息。
#### 三、消息传输方式适用场景
- **WebServcie适用场景**：
- 需要实时同步数据的服务接口。
- 请求方需等待应答方返回消息的服务接口。
- 查询数据的服务接口。
- **MQ适用场景**：
- 不需要实时等待对方应答的服务接口。
- 系统间的异步消息传递。
#### 四、异常处理机制
- **系统异常**：提供方直接反馈异常信息，如通信异常等。
- **业务异常**：
- **WebService传输方式**：错误消息由消费方与提供方协商自定。
- **MQ传输方式**：异常处理由消费方与提供方协商确定。消费方必须在本地保存错误日志，并可以通过平台服务向提供方发送错误消息。
#### 五、报文格式说明
- **非HL7V3标准**：报文格式根据具体场景定制，每个场景的报文由平台提供。
- **HL7V3标准**：报文格式根据具体场景定制，每个场景的报文由平台提供。
#### 六、接口概述
- **测试服务器配置信息**：
- 平台服务器地址：172.16.95.40
- WebService服务端口：7800
- MQ服务地址：172.16.95.40
- MQ服务端口：14501
- 通道：SVRCONN01.CHL
- 队列管理器：BRK01.QM
- **正式服务器配置信息**：待定。
#### 七、WebService接口详解
- **开发说明及要求**：
- 对外发布的服务请求参数包括两个string型参数（flag、message），返回一个String型参数(return)。
- flag用于区分消息所属的业务类型；message中包含具体的交互消息；return中包含返回的消息。
- 每个系统只发布一个服务接口地址。
- **服务提供方**：
- 提供WSDL文件或服务地址，由平台完成具体发布工作。
- **服务消费方**：
- 厂商可自行选择适合的方式访问平台提供的WebService服务。
#### 八、MQ接口详解
- **开发环境**：
- C#连接MQ：需要安装MQ客户端并引用amqmdnet.dll库。
- Java连接MQ：使用特定的jar包进行连接。
- **开发说明及要求**：
- 为了实现负载均衡和解决单点故障问题，院内部署了MQ集群。
- 消息发送方只需对应一个队列管理器（MASTER.QM）发送消息，该消息会被自动分发到完全存储的队列管理器之一。
- 完全存储消息的队列管理器至少有两个（例如BRK01.QM、BRK02.QM），以确保消息的安全存储和分发。
#### 总结
该文档详细介绍了集成平台中的接口设计和使用指南，涵盖了实时接口和非实时接口的交互方式、适用场景、异常处理机制、报文格式等方面的内容。无论是对于正在学习接口文档编写的新手还是已经熟悉接口设计的专业人士，这份文档都能提供宝贵的参考价值。特别是针对医疗领域的开发人员来说，了解HL7V3标准及其应用场景尤为重要。此外，文档还提供了具体的测试服务器配置信息以及开发环境中使用的工具和技术，帮助开发者更好地理解和应用这些接口。
