Mirth Connect中文手册资料

IMCIS集成引擎(Mirth)操作手册

目  录

  1. 概述…. 3
  2. 适用范围…. 3
  3. 参考资料…. 3
  4. 产品概述…. 3
  5. 产品运行环境…. 3
  6. IMCIS集成引擎操作介绍…. 3

6.1.       集成引擎管理服务… 4

6.2.       用户登录… 5

6.3.       用户管理… 8

6.4.       集成警报配置… 9

6.4.1.         添加警报… 11

6.4.2.         编辑警报… 13

6.5.       日志事件… 13

6.6.       通道的使用… 14

6.6.1.         关于编辑通道的接口… 14

6.6.2.         创建通道… 19

6.6.3.         编辑通道… 20

6.6.4.         编辑数据类型… 21

6.7.       关于消息… 25

6.7.1.         设置消息模板… 25

6.7.2.         关于过滤器… 28

6.7.3.         关于转换器… 30

6.8.       集成Dashboard.. 33

6.8.1.         通道消息… 35

 

 

 

 

IMCIS集成引擎(Mirth)操作手册

1.      概述

操作手册是为了客户使用系统提供依据,指导用户正确、有效的使用软件系统。

2.      适用范围

系统的操作手册简要地介绍本系统结构以及软件环境,然后说明本系统为使用者提供的各项功能及其详细的操作步骤。

本手册的使用者包括:这里罗列手册的使用者。

例如:工程人员、开发、测试

3.      参考资料

编写此文档参考的相关资料,MConn_v3_0_1_UserGuide.pdf。

4.      产品概述

eWorld集成引擎(简称为集成引擎)是以国际通用标准(医疗标准)为基础开发的医疗服务一体化引擎。集成引擎将标准的消息转换为系统可识别的消息格式。其作用如下:

▪ Filtering(过滤)-读取消息参数,并(传递或者阻止)它到转换阶段

▪ Transformation(转换)-将传入的消息标准转换成另一个标准(如HL7、XML)

▪ Extraction(提取)-可将数据从“拉”和“推”到数据库

▪ Routing(路由)-确保消息到达指定的目标

5.      产品运行环境

操作系统:Windows/Linux/Mac OS系统,主流的操作系统都支持

运行环境:Java运行环境(安装JDK-7)

6.      IMCIS集成引擎操作介绍

集成引擎采用的是组件式的集成架构,基于通道的集成模式以及SOA架构实现平台服务的可扩展,可以通过扩展或增加服务来进一步提高平台的处理能力,而不影响已有的功能,支持集成业务的持续优化和动态调整。

6.1.        集成引擎管理服务

完成集成引擎安装后,软件会自动启动集成引擎的服务,在任务栏右下角找到图标蓝色表示服务已启动,灰色表示服务停止,双击打开服务窗口如下。

6.2.        用户登录

需要有用户名、密码才能登录使用。管理员的用户名与密码一般默认为admin/admin;首次登录会建议管理员修改密码。安装后有两种登录方式,一种直接在安装的电脑上编辑,另一种通过网页访问。

需要确定Mirth服务是否已经启动,若是未启动请点击启动。

  • 本地安装Mirth,直接运行程序或者在服务窗口上点击【管理登录】。在登录界面输入用户名和密码,点击登录。进入Mirth操作界面。
  • 远程电脑安装Mirth,确认远程电脑上Mirth服务已经启动,在浏览器地址栏输入地址:http://远程电脑IP:WebStart端口/webadmin/Index.action

点击启动登录界面,会下载文件webstart.jnlp,并自动运行,在桌面上自动生成Mirth的快捷方式,并启动登录界面,输入用户名和密码(admin/admin)。下次登录时可以直接从桌面的快捷方式进入。

首次登录,会弹出修改管理员密码的窗口:

完成修改后,点击完成,正式进入集成引擎编辑的界面。

 

6.3.        用户管理

在集成引擎编辑页面,单击用户,进入用户管理界面。

单击New User或者空白处右键选择New User,弹出新建用户信息的编辑窗口。新建用户时,用户的用户名必须是唯一的(即已有的用户中不存在该用户名)。

信息填写完整后,单击完成,创建用户成功。可以在列表中查看新建的用户信息。

在列表界面可以对用户进行删除、修改。

6.4.        集成警报配置

在集成引擎编辑页面,单击警报,进入警报配置界面。

 

位置 名称 描述
A 警报名称 警告名称,选中Enabled表示警告在激活状态
B 错误 选中所有错误类型触发警告
C 正则表达式 (正则表达式)指定一个正则表达式(比如超时),如果需要,消息将会被过滤,只匹配正则表达式中的内容,才会触发错误
D 通道 过滤:输入的文本自动选择通道(目标或者源含有该文本)。

启用/禁用:在通道窗口中选中通道或者通道的源或目标,单击启用/禁用。

连续选择:选择一个项,按住Shift键,并选择组中的最后一项。

对于非连续选择:选择一个项,按住Ctrl键,并进行选择其他选项。

全部展开:单击,显示通道的源/目标。

全部折叠:单击,只显示通道名称。

通道窗口中的Filter中为空,则显示所有通道。

E 动作 协议:(在添加一个动作或者已经存在动作)单击菜单箭头,选择Email或Channel。

接收:输入Email地址或者点击Channel箭头选择已有的Channel。

添加:单击添加一个动作。

删除:单击删除被选中的动作。

F 主题 只用于邮件,即协议类型仅限Email,邮件的主题。
G 模板 将警报的变量拖动到文本框中,发送邮件时,邮件内容包含变量值,可在这里排版。
H 警报变量 在邮件主题或模板中可供拖动的变量。变量表示见下表

警告变量表

变量 输出函数
alertId 警告的唯一ID
alertName 警告的名称
serverId 服务的唯一ID
systemTime 系统的时间
date 系统时间格式
globalMapVariable 用户在全局范围内到的自定义变量
error 全错误文本,包括异常消息和全栈跟踪
errorMessage 仅仅错误消息
errorType 触发警告的错误类型
channelId 通道的唯一ID
channelName 通道名称
connectorName 连接器名称
connectorType 连接器类型

6.4.1.      添加警报

在添加警报之前一定要配置一个SMTP服务器,才可以发出警报。

添加警报的操作步骤:

  • 在集成引擎的编辑页面,单击警报
  • 在警报设置中单击新建警报或者在空白处右键,选择新建警报
  • 在警报名称的文本框中输入警告名称,选中启用激活警告
  • 配置其他一些需要的元素,最后单击保存警报。

如果没有配置SMTP服务器,会弹出警告窗口,要求你配置SMTP服务器。

单击确定,在集成引擎上单击设置,进入设置页面设置SMTP服务器。

  • 在集成引擎界面,单击警报查看新添加的警报。

6.4.2.      编辑警报

编辑警告的操作步骤:

1、在集成引擎界面,单击报

2、在警告列表中选中需要编辑的警告,单击警告任务选项中的编辑或者右键选择编辑。

3、在编辑页面根据需求修改,并保存。

6.5.        日志事件

在集成引擎中,系统事件(例,登录、错误、通道更新等)日志内部数据库,可以通过单击事件查看。

日志内容包括:事件的日期时间、事件描述名称(例,更新通道)、操作的实体(用户或系统)、事件的结果、操作人员的IP地址。

搜索事件,可以在“名称”栏中输入“事件名称”,单击“搜索”。事件;列表中就显示符合条件的事件。

要显示所有事件,单击“重置”或删除名称,单击“搜索”栏,事件列表中显示所有事件。

在“名称”字段下面有一个页面大小设置的字段,该值表示一个日志页含有多少条事件。可以在上面的各个类型筛选框(信息、警告、错误)中显示搜索事件的类型。如果需要显示所帅选的事件总数,单击“总计”,输入“页面号”,单击“…”,可以直接跳转到该页面。

 

6.6.        通道的使用

通道是一个源系统和多个目标系统的连接。

6.6.1.      关于编辑通道的接口

创建通道时,在编辑通道页面可以使用四个标签页面(概要、源、目标、脚本)来配置通道信息。

6.6.1.1.  概要

通道的基本属性在该页面进行配置。

6.6.1.1.1.   通道属性
功能 描述
名称 定义通道名称,只能输入英文名称。
数据类型 配置输入/输出的属性,并设置源/目标连接器的数据类型。
初始状态 设置第一次或下一次通道部署时的初始状态。(Started/Paused/Stopped)
附件 设置处理外部附件的处理机制类型。

(None/Regex/DICOM/javaScript/Custom)

附件属性 根据处理机制,设置连接属性(正则表达式/脚本/自定义)
存储附件 (选择附件类型)如果选中(默认选中),附件存储在数据库中,若是没有选中,附件在处理后不存储。
启用 如果选中(默认),通道可以被部署
开启全局通道部署 如果选中,在单个通道部署时,清除全局通道映射并重新配置

 

6.6.1.1.2.   消息存储
功能 描述
存储级别 根据需要选择存储级别存储消息和元数据的内容。
性能级别 存储级别越低,性能级别越高
加密消息内容 开发模式/产品模式/原始数据)如果选中,以加密的形式存储在数据库中,意味着该消息可以被查看,但内容不能被搜索
删除完成的内容 开发模式/产品模式/原始数据)如果选中,在消息处理完成之后(除去错误队列消息之外),删除消息内容。
删除完成的附件 开发模式/产品模式/原始数据)如果选中,在消息处理完成之后(除去错误队列消息之外),删除附件内容。

 

6.6.1.1.3.   消息修剪
功能 描述
元数据 无限期存储

数据保存几天

内容 元数据被删除时,删除内容

内容保存几天

 

6.6.1.1.4.   通道标签
功能 描述
标签 添加标签后,可以在部署后的界面(控制面板)根据标签进行过滤
添加或删除 添加或删除标签

 

6.6.1.1.5.   自定义元数据
功能 描述
添加或删除元数据 添加后,可以在通道消息中看到该列的映射值
还原 Revert 进行添加或删除,但是还未保存时,点击此按钮可以恢复到上一次保存的设置

 

6.6.1.1.6.   通道描述

 

功能 描述
通道描述 输入相关通道信息

 

6.6.1.2.  源

通道的源连接器属性在该页面配置。

 

功能 描述
连接器类型 设置源连接器的类型,反过来这里定义了通道接收数据的类型
轮询类型 该属性会由于连接器类型不同有所差异。

轮询类型– 读取器轮询通道以检测是否收到新信息;选择轮询类型,间隔时间或者轮询的时间;

轮询频率(ms) – 读取器每间隔n毫秒轮询一次;n由用户自定义。

轮询时间(每天)– 读取器每天在时间(HH:MM AM/PM)轮询一次

响应设置 源队列

关闭– 在发送响应前将处理该消息(可以使用目标响应)

开启– 将开启队列消息,发送即时响应消息(不能使用目标的响应消息)

响应消息Response

自动生成、处理前、源转换器、目标完成

读取器/监听器设置 根据连接器的类型不同设置也会有所不同,其他设置暂时不做描述。

 

6.6.1.3.  目标

通道的目标连接器的属性在该页面配置。

功能 描述
目标表 显示通道目标连接器;状态– 连接器的操作状态(Enabled/Disabled);目标– 目标名称;Id – 连接器的唯一标识;连接器类型:Channel Writer、DICOM Sender等
连接器类型 决定目标发送的数据类型
等待前一个目标 通道的原目标或通道只有一个目标时,该属性禁用。若是选中,则表示必须等前一个目标执行完成再执行该通道
队列/重试设置 队列消息。

从不–  消息不排队;可以在重试次数填写值n,若是出现错误最多重试发送n次。

重试一次– MC在排队之前尝试发送消息;然后根据设置重试多少次,并间隔多久重试一次。

始终– 消息总是排队;消息一直重试,根据间隔发送直至成功。

生成模板(如果Attempt First 或者Always被选中则启用)- 每一次重新尝试时,都重新根据现部署的通道生成模板。

交替–当通道重新启动时,所有的队列消息也会开始重试。若是循环被禁用,不使用多线程队列,队列消息将始终按顺序处理,即使通道停止或重新部署。

书写/发送设置 根据不同的连接器类型,这些设置都会有所不同,其他设置暂时不做描述。。

6.6.1.4.  脚本

功能 描述
脚本 决定通道脚本类型(Deploy/Undeploy)/Preprocessor/Postprocessor。
类别 确定函数方法类别,例转换函数、通道函数等,在下面的窗口中显示被选中类别的函数。
过滤 窗口中根据过滤条件进行搜索

6.6.2.      创建通道

创建新通道的操作步骤:

1)在集成引擎页面,点击通道。

2)在通道页面空白处,单击鼠标右键,选择新建通道,或者在通道设置中中,点击新建通道。

导入导出已有通道的XML操作步骤:

1)在集成引擎页面,点击通道。

2)在通道页面空白处,单击击鼠标右键,单击导入通道或者导出全部通道,选择通道xml文件/命名XMl文件,导入导出通道文件,或者在通道设置中内容,单击导入通道或者导出所有通道来导入导出通道文件。

6.6.3.      编辑通道

操作步骤:

1)在集成引擎页面,点击通道。

2)在通道页面选中需要编辑的通道,单击鼠标右键,选择编辑通道,或者在通道设置中,单击编辑通道,或者直接双击选中的通道进入编辑页面。详细设置内容可以查看关于编辑通道的接口

 

6.6.4.      编辑数据类型

描述在一个连接器或者多个连接器中数据类型的编辑(称为“批量”编辑过程)。

6.6.4.1.  编辑一个连接器的数据类型

操作步骤:

  • 在集成引擎页面,点击通道。
  • 选中通道,并且进入编辑通道页面。
  • 在概要页面,点击设置数据类型。
  • 在设置数据类型页面中连接器列表选择连接器。
  • 在入站属性部分,编辑它的属性(DICOM和ROW类型没有属性)。
  • 在出站部分重复编辑数据类型的步骤设置相关属性,点击OK按钮完成设置。
  • 在通道设置中点击保存。

6.6.4.2.  编辑多个连接器的数据类型

  • 在集成引擎页面,点击通道。
  • 选中通道,并且进入编辑通道页面。
  • 在概要页面,点击设置数据类型。
  • 在设置数据类型的界面左上角选择批量编辑按钮。
  • 选择全部选择所有连接器或者在连接器列表中选择需要的连接器。
  • 选择输入输出的数据类型,并根据需要编辑相关的属性,点击确定按钮完成设置。

 

6.6.4.3.  改变通道状态

可以在控制面板中停止/启动/暂停通道。没有部署的通道不会出现在控制盘的通道列表中,并且它们的状态不能改变直到重新部署。一个暂停的通道不能接收消息,但是可以持续处理已经在源/目标中的队列消息。停止或者中止的通道都不能接收消息。

  • 在控制面板页面,选择通道。
  • 在控制面板框中,点击需要的任务。

注:部署通道后,启动通道出错时,通道的状态就会一直为启动中,直到用户中止通道。

6.6.4.4.  部署通道

只有启用的通道可以进行部署,若是通道页面上为禁用,通道不能被部署在控制面板的通道页面上。

单独部署通道,若是通道状态为禁用,通道设置中没有部署通道的选项。

批量部署通道,若是含有禁用的通道,将会弹出窗口提示,禁用通道不能被部署,确定后,启用的通道完成部署。

部署通道的步骤:

  • 在集成引擎页面,点击通道。
  • 选择通道,在通道设置框中点击部署通道(若是需要部署所有的通道,可直接点击重新部署所有通道)

取消部署通道的操作步骤:

  • 在集成引擎页面,点击控制面板。
  • 选择通道,在控制面板中点击取消部署通道

6.7.        关于消息

6.7.1.      设置消息模板

每个通道的转换器或过滤器,出入站的消息模板。

6.7.1.1.  设置入站消息模板

入站的模板主要用于接收到消息解析数据,并使用拖放的函数创建过滤器和转换器的步骤。

设置入站消息模板的步骤:

  • 进入通道编辑页面,点击源或目标选项卡
  • 在通道设置框中点击编辑过滤器
  • 在页面的右上角,点击消息模板的标签
  • 根据需要选择数据类型,并输入相应的示例模板
  • 点击消息树标签,右键单击击根节点,选择Expand展开消息
  • 点击Message Trees标签,右键点击子节点,选择Filter By Value会将该值作为过滤条件显示左边窗口中。

单击过滤值会发生三件事:

  • 左边的窗口出现一些新的功能
  • 添加一个新的规则
  • 选中的节点值会添加到字段中

 

6.7.1.2.  设置出站消息模板

出站模板用于当源或目标已经接收了消息,需要转换出站消息的格式的示例模板。只能在转换器中从一个协议的消息转换成另一个消息类型。若是没有出站模板的设置,那么输出的消息则是接收到的消息,若是设置出站的模板,并只解析入站消息的一个消息段,那么出站的消息也只包含解析的消息段。

设置输出模板的操作步骤:

  • 进入通道编辑页面,点击源或目标选项卡
  • 在Channel Tasks框中点击Edit Transformer(Filter不含输出模板)
  • 在页面的右上角,点击Message Template的标签
  • 根据需要选择数据类型,并输入相应的示例模板
  • 点击消息树标签,右键点击根节点,选择展开消息
  • 点击消息树标签,右键点击子节点,选择消息映射会将该值作为需要赋值的变量出现在左边框内。

点击消息映射会执行三件事:

  • 左边的窗口出现一些新的功能
  • 添加一个新的Step
  • 选中的节点或节点值会出现在Message Segment中

6.7.2.      关于过滤器

过滤器是有一系列的bool表达式规则,若是为true则消息进入连接器,被连接器处理,若是false则消息过滤,不进入连接器。

集成引擎具有内部的功能可以直接拖放输出的模板值到左边的规则编辑器中,选择规则的类型(外部脚本、脚本、规则编辑器),若是规则编辑器,则选择相应的判断条件。

编辑器的操作步骤:

  • 根据1 设置入站消息模板设置消息的输入模板,并点击消息树标签
  • 创建一个新的规则
  • 选择编辑器类型

外部脚本类型:

脚本类型:

规则编辑器:

 

6.7.3.      关于转换器

转换器是为了解析接收的消息数据,提取有用的内容,以便后期调用或组成新的消息。每一个连接器都有一套私有的转换器。

转换器中映射的变量使用范围:

Connector   适用于同一个连接器

Channel适用于整个通道(包含源连接器以及目标连接器)

Global      适用于所有的设置页面上,包括通道、脚本等

Response    适用于源连接器中ACK消息响应(所有目标连机器的响应都会自动映射到Response这个映射中)

将模板树中的节点或者节点值直接拖放在转换页面内,转换器会自动生成映射。映射范围的定义,决定了映射变量使用的范围。

转换器的操作步骤:

  • 根据1 设置入站消息模板设置消息的输入模板,并点击Message Trees标签
  • 创建一个新的Step

3)转换器的类别

外部脚本:

脚本:

消息创建器:

映射:

XSLT Step:

注意:这里需要设置不选去掉命名空间,要不然XML的命名空间被去掉,会导致XML不能识别

 

6.8.        集成Dashboard

在集成引擎编辑页面,单击Dashboard(登录后默认显示页)。列表中会显示已部署的通道。展开通道,可以看到该通道的源和目标连接器。

选中一个通道,单击“发送消息”可以给通道发送消息

选中一个通道,单击“清空统计”,弹出清除的窗口,选择需要清除的消息类型。

 

选中一个通道,单击“查看消息”(或者双击通道)即可查看消息。

6.8.1.      通道消息

在通道消息的页面,可以选择一条消息,并使用选项卡查看消息的详细信息。

6.8.1.1.  消息标签

内容选择(Row/Transformed/Encoded/Sent/Response),基于消息类型处理各个过程中消息的内容。

6.8.1.2.  映射标签

选择该标签可以查看该消息的映射值。

6.8.1.3.  错误标签

只有在消息出错的情况下,这个标签才会存在。

 

 

 

 

打赏
此条目发表在我的笔记分类目录。将固定链接加入收藏夹。

发表评论