发布适配器管理
业务流程
功能说明
发布者定义
定义发布者的编码,与中心定义的发布者编码一致,如下图:
发布用户定义
定义发布用户信息,发布用户在Oracle指数据库用户,Sql Server指数据库,并且数据库访问用户与数据库名称一致,如下图:
定义发布用户时,需要维护用户名、别名、描述信息,别名系统设定为一个英文字符,如下图:
发布标准下载
中心标准有变化后,通过发布标准下载功能进行发布适配器标准更新,如下图:
发布表配置
确定发布用户哪些表用于数据发布,在源表信息子页面双击发布表,在发布表子页双击取消发布表。如下图:
发布配置
建立数据集中的数据子集与源表的对应关系,如下图:
在中心数据集子页面选择最未级的数据子集;
确定发布表,在发布表子页面中双击发布表进行数据子集与发布表的对应,形成订阅数据视窗;
配置订阅数据视窗相关信息:如订阅数据视窗激活顺序,原则上是数据子集的顺序要大于数据主集,因为数据上传到中心分发给各订阅者时,需要对数据子集与主集进行数据组装,所以要求数据子集优先上传到中心;订阅数据视窗主键配置,系统自动会根据发布表的主键生成订阅数据视窗主键,如果需要调整,则手工调整;有发布表主键是组合主键,此时配置订阅数据视窗主键为发布表主键的拼接。
发布接口配置
实现数据子集各数据元与发布表字段的匹配,如下图:
在中心数据集子页面选择数据集下的订阅数据视窗;
在字段匹配子页面选择要匹配的数据元;
在订阅数据视窗中选择匹配的列信息,双击实现数据元与订阅数据视窗的列对应;
如果订阅数据视窗的字段需要进行代码转换,则需要进行订阅数据视窗数据字段的代码查询信息配置,在订阅数据视窗列信息中选中列,点击修改功能,在配置时,代码编码别名用item_code,代码名称别名取item_name,查询代码信息只允许有上述两个列,并且查询表Oracle带上用户信息,、Sql Server带上数据库、用户名信息(一般为dbo),如下图:
基础数据代码匹配数据元:在完成第4步工作后,选择要代码匹配字段,点击修改功能进行数据元值转换标志更改,更改为“值域值转换”如下图:
基础数据代码匹配:在完成5、6步工作后,就可以进行代码匹配,选中要代码匹配的列,点击“代码匹配”功能,在弹出的代码匹配窗口完成代码匹配功能,如下图:
基础数据转换:基础数据转是数据子集中的数据元需要的名称,但订阅数据视窗中的字段是代码,对应的名称信息在一些基础数据表中,此时通过基础数据转换配置实现数据上传是编码到名称的转换。在字段匹配子页选择要进行基础数据转换列,点击“修改”功能,弹出字段匹配窗口,选择值转换标志为基础数据转换。如下图:
计算列配置:如果数据子集的数据元与订阅数据视窗的列不是一一对应关系,而是订阅数据视窗多个列对应数据子集的数据元,则需要进行计算列配置,值转换标志选择计算公式,列名称按照数据库的特点进行拼接,如下图:
发布启停
在完成上面的工作后,通过“发布适配”下的“发布启停”功能进行数据上传工作,如下图:
发布初始配置举例
场景描述
医院的HIS系统没有条件进行改造,现在需要用适配的方式获取HIS系统科室信息。
流程分析
系统实现
中心端定义发布者HIS,如下图:
2、中心端配置HIS发布科室数据集,如下图:
3、 适配端定义发布者HIS,如下图:
4、配置用户,用户在Oracle指数据库用户,Sql Server指数据库,并且数据库访问用户与数据库名称一致。如下图:
5、 下载标准,如下图:
6、配置发布表(HIS系统中科室表),如下图:
7、发布配置,如下图:
8、配置发布接口。如下图:
9、发布启停,如下图:
加配一个数据集举例
场景描述
HIS系统需要把员工表的数据适配到中心端。
流程分析
系统实现
1、中心端配置发布人员数据集,如下图:
2、下载标准,如下图:
3、配置发布HIS人员表,如下图:
4、发布配置,如下图:
5、发布接口配置。如下图:
6、发布启停,如下图:
已适配数据集中更改数据元更新适配举例
场景描述
个人信息数据集性别代码数据元更新,适配需要随之变化。
流程分析
系统实现
1、下载标准,选中性别代码,更新标准,如下图:
2、配置发布接口,如下图:
订阅适配器管理
业务流程
功能说明
订阅者定义
定义订阅的编码,与中心定义的订阅者编码一致,如下图:
订阅用户配置
定义订阅用户信息,如果发布用户与订阅用户是一个,则不需要重要定义。订阅用户在Oracle指数据库用户,Sql Server指数据库,并且数据库访问用户与数据库名称一致,如下图:
定义订阅用户时,需要维护用户名、别名、描述信息,别名系统设定为一个英文字符,如下图:
标准下载
中心标准有变化后,通过订阅标准下载功能进行订阅适配器标准更新,如下图:
订阅表配置
建立数据子集与源表的匹配关系,如下图:
在中心数据集子页面,选择数据子集;
在订阅表中选择与数据子集匹配表;
双击进行数据子集与订阅表匹配;
如果表备注中文含义不明确,可以通过订阅视窗中修改功能进行订阅表中文修改,如下图:
订阅接口配置
订阅接口配置实现对订阅表的字段与数据子集的数据元的匹配,如下图:
对于订阅接口配置的操作方法参考发布接口配置中的相关方法,操作上有细微区别。
源表列键标志:这个字段十分重要,他有以下几个值:主键字段、外键字段、主键外键、普通字段、索引字段。如果为主键字段,则表示订阅表中的主键列,可以是组织主键;如果是外键字段,则表示此表业务形态是一子表;主键外键,表示此字段即是主键也是外键。系统通过主键来判断推送过来的数据的操作类型是增加或修改,如下图:
初始化数据存储逻辑,通过对订阅数据表与数据子集的数据元进行对应后,通过对主外键配置,点击生成存储逻辑生成对订阅表的增加、修改、删除逻辑,如下图
订阅接口扩展
通过订阅接口配置只能生成对单表操作的增加、修改、删除操作逻辑,对于比较复杂的存储逻辑需要通过订阅接口扩展来扩充,如下图:
关于序号:序号是某一类操作的执行序号,比如说,接收的数据是增加操作,有三个执行动作,此序号代表他们的执行顺序,如下图:
如果是调用存储过程,存储过程的执行顺序需要根据业务确定,因为接收数据是一笔业务数据,在系统中是一个数据集来表示,一个数据集有一个主集和几个子集构成,每个子集可能有多条数据,如果存储过程只是执行一次并且是一开始就执行,则配置为第一条执行;如果在接收完成后执行,则配置为最后一条执行,如果每接收一条都执行(接收一条数据完成后),则配置为第条执行,如下图:
调用存储过程输出参数只支持两个固定参数:prm_AppCode|prm_ErrorMsg,用|分隔,第一个为执行结果代码,都是字符串,为0表示执行成功,为非0表示执行失败;
调用存储过程,编辑语句为执行的存储过程名称,调用存储过程输入参数为数据元作标识,用|分隔,系统会自动传入接收数据中的数据元作为存储过程传入参数,如下图:
订阅数据初始配置举例
场景描述
LIS系统通过适配的方式获取科室数据。
流程分析
系统实现
1、中心端定义订阅者LIS,如下图:
2、中心端配置订阅数据集(科室信息),如下图:
3、配置订阅者编码,如下图:
4、配置用户,如下图:
5、下载标准,如下图:
6、配置订阅表,如下图:
7、配置订阅接口,如下图:
8、有需要可以扩展存储逻辑,如下图:
适配订阅新数据集举例
场景描述
LIS系统通过适配器订阅科室数据集。
流程分析
系统实现
中心端配置订阅数据集(科室信息),如下图:
下载标准,如下图:
配置订阅表,如下图:
配置订阅接口,如下图:
有需要可以扩展存储逻辑,如下图:
已订阅适配数据集变更数据元跟新适配举例
场景描述
中心端医疗卫生人员信息中性别代码数据元更改,适配更新。
流程分析
系统实现
下载标准,如下图:
配置订阅接口,如下图:
特殊模式(视图)注意事项
数据库链接配置
用户配置
发布表配置
查询条件字段一共有五种模式:
无条件:不需要根据时间字段或自增序号字段采集的选择无条件;
本表时间字段:需要根据时间字段采集的源表且本表有时间索引字段的选择本表时间字段;
关联他表时间字段:需要根据时间字段采集的源表且本表没有时间索引字段需要关联他表时间的选择关联他表时间字段;
本表自增序号:需要根据自增序号字段采集的源表且本表有自增序号字段的选择本表自增序号;
关联他表自增序号:需要根据自增序号采集的源表且本表没有自增序号字段的需要关联他表自增序号字段的选择关联自增序号字段;
查询条件字段配置如下图:
无条件
本表时间字段
不需要填写查询表名和关联条件,填写对应源表中查询时间字段;
关联他表时间字段
需要填写查询条件表、查询条件字段、关联条件;
本表自增序号
不需要填写查询表名和关联条件,填写对应源表中查询时间字段;
他表自增序号
需要填写查询条件表、查询条件字段、关联条件;
最后采集时间
可以查看采集已经到某个时间的数据,也能设置从某个时间开始采集。如下图采集2017年之后的数据:
分页时间间隔
看数据量大小设置分页时间间隔,数据量大可设置一小时、一分钟,一般设置一天,如图:
常见问题处理
系统登录默认的密码
用户名/密码1:client/data
用户名/密码2:test2/test2
公共值域匹配
在适配端有些值域代码在不同的数据集上出现,在出现的地方都需要进行值域转换,这样无形中增加了工作量,系统提供对这种多处使用的值域代码进行统一转换在的功能叫“公共代码转换”。
代码转换在系统中有两种不同的转换方式:
私有转换:在各自的数据集上进行值域转换定义;
公共转换:在“公共代码转换”模块统一转换。
初始化清库
有时安装部署直接把别的地方的数据库进行导入后需要对系统进行初始化,此时需要对导入数据进行清库,采用平台提供的“系统清库”功能来实现此业务需求。
注:系统正式运行后,千万不要使用这个功能,后果十分严重,廖氏软件不对使用这个功能产生的后果进行负责。
清除错误匹配
在某些极端情况下匹配信息的完全搞错了或中心端清除了发布者某个数据集的发布权限,此时可以通过“清除错误匹配”功能进行匹配信息清除。
历史数据上传
在启用平台时,有时需要对某些数据集对应的历史数据上传到数据中心,
使数据中心的数据完全。
使用“历史数据采集”功能对历史数据上传,使用此功能前提是:数据集已经进行了发布接口匹配并已经启用的数据集上传功能。
初始化数据中心物理模型
有些情况下,对于标准要求不很高,直接采用某个系统的物理表生成数据中心的数据集来快速生成数据中心。此时可采用“初始化数据中心数据模型”功能把某个系统的一个或多个表生成数据中心物理模型。