上海市闵行区医院信息集成平台-详细设计说明书 (数据采集)

编撰梅芝雨

[]初稿编撰日期2007-05-10

euup轨f牛[V]发布保密级别机密

[]修订文档版本2.0

文件编号Q/BS-QH-3-08

上海市闵行区医院信息集成平台

（数据采集）

详细设计说明书

创业软件股份有限公司

（版权所有，翻版必究）

EPG版本历史

日期版本说明作者

2007-05-10V0.1初稿EPG

2007-07-02VI.0公司审批，正式发布EPG

2008-05-27V2.0公司审批，正式发布EPG

2009-06-12V2.1修改EPG

2011-03-15V2.2修改EPG

将模块设计说明书、接口设计说明书、数据库设计说明书、

2011-10-15V2.3李定军

用户界面设计说明书合并成一份详细设计说明书

2013-02-04V2.4修改模块设计和接口设计的内容倪慧敏

项目组版本历史

日期版本说明作者

2013/9/11V0.1创建安冬冬

目录

1引言................................................................................7

1.1系统简述............................................................................7

1.2软件设计目标........................................................................7

1.3参考资料............................................................................7

1.4术语与缩写词........................................................................7

2规范和要求..........................................................................7

2.1命名规则............................................................................7

2.2界面设计规范........................................................................8

2.3接口规范............................................................................8

3模块汇总............................................................................8

3.1A100数据采集.......................................................................8

3.2A200门户升级.......................................................................8

3.3A500病历检索.......................................................错误!未定义书签。

4设计概述............................................................错误!未定义书签。

4.1系统总体设计........................................................错误!未定义书签。

4.1.1A100数据采集设计概述...............................错误!未定义书签。

4.1.2A200门户升级设计概述...............................错误!未定义书签。

4.1.3A500病历检索设计概述...............................错误!未定义书签。

4.2约束和假定..........................................................错误!未定义书签。

5A100数据采集的模块设计.............................................................9

5.1模块A101实时数据采集..............................................................10

5.1.1模块说明...........................................................10

5.1.2参考界面............................................错误!未定义书签。

5.1.3详细设计......................................................11

5.2模块A102解包程序升级..............................................................16

5.2.1模块说明...........................................................16

5.2.2参考界面............................................错误!未定义书签。

5.2.3详细设计...........................................................16

5.3模块A103数据集完善................................................................19

5.3.1模块说明...........................................................19

5.3.2参考界面............................................错误!未定义书签。

5.3.3详细设计...........................................................19

5.4模块A104采集程序扩展功能..........................................................20

5.4.1模块说明...........................................................20

5.4.2参考界面............................................错误!未定义书签。

5.4.3详细设计............................................错误!未定义书签。

5.5模块A105决策支持采集功能开发......................................................21

5.5.1模块说明..........................................................21

5.5.2详细设计..........................................................22

6A200门户升级的模块设计............................................................28

6.1模块B01名称.......................................................................28

6.1.1模块说明...........................................................28

6.1.2参考界面............................................错误!未定义书签。

6.1.3详细设计......................................................28

7A500病历检索的模块设计.............................................错误!未定义书签。

7.1模块B01名称........................................................错误!未定义书签。

7.1.1模块说明............................................错误!未定义书签。

7.1.2参考界面............................................错误!未定义书签。

7.1.3详细设计............................................错误!未定义书签。

8接口设计..........................................................................37

8.1接口汇总表..........................................................错误!未定义书签。

8.2接口A.............................................................................................................................错误!未定义书签。

8.3接口B..............................................................................................................................错误!未定义书签。

9数据库设计........................................................................37

9.1数据库汇总表........................................................错误!未定义书签。

9.1.1表汇总表...........................................错误!未定义书签。

9.1.2视图汇总表..........................................错误!未定义书签。

9.1.3存储过程汇总表.....................................错误!未定义书签。

9.1.4触发器汇总表........................................错误!未定义书签。

9.2数据库详细设计.....................................................错误!未定义书签。

9.2.1表详细设计.........................................错误!未定义书签。

9.2.2视图详细设计.......................................错误!未定义书签。

9.2.3存储过程详细设计....................................错误!未定义书签。

9.2.4触发器详细设计.....................................错误!未定义书签。

10非功能性设计.......................................................................37

10.1性能方面设计....................................................................37

10.2易用性方面设计..................................................................38

10.3其它非功能性设计................................................................38

10.4错误处理........................................................................38

10.4.1出错类别...........................................................38

10.4.2出错处理...........................................................38

10.4.3系统调整及再次开发问题...........................................38

11关键技术...........................................................................38

11.1关键技术的一般说明..............................................................39

11.2关键技术的实现方案..............................................................39

12其他..............................................................................39

1引言

1.1系统简述

本设计是建立在前期的总体集成方案的基础上的。本方案是平台集成下一阶段编码工

作的一个基础，也是各公司的人员相互交流的一个基础。

本文档的预期读者是与项目有关的软件技术设计人员、开发人员、业务规范设计人员

及用户代表。

1.2软件设计目标

［这部分论述整个系统的设计目标，明确地说明哪些功能是系统决定实现而哪些时不准备实现

的。同时，对于非功能性的需求例如性能、可用性等，亦需提及。需求规格说明书对于这部分的内

容来说是很重要的参考，看看其中明确了的功能性以及非功能性的需求。

这部分必须说清楚设计的全貌如何，务必使读者看后知道将实现的系统有什么特点和功能。在

随后的文档部分，将解释设计是怎么来实现这些的。］

1.3参考资料

无

1.4术语与缩写词

术语缩写词说明

2规范和要求

2.1命名规则

程序命名规范：

采用驼峰法命名规则，类名首字母大写；属性名，局部变量名，方法名首字母小写；常量

和静态属性，全部大写，下划线区分单词；

Package命名：

Package的名字应该都是由小写单词组成，已com.bsoft开头例如：com.bsoft.test

Class命名：

Class的名字必须由大写字母开头而其他字母都小写的单词组成，对于所有标识符，其中包

含的所有单词都应紧靠在一起，而且大写中间单词的首字母。

例如：publicclassThisAClassName{}

Class变量命名：

变量的名字必须用一个小写字母开头，后面的单词用大写字母开头，

例如：userName,thisAClassMethod

StaticFinal变量的命名：

staticFinal变量的名字应该都大写，并且指出完整含义。

数据库命名规范：

参考《ORACLE命名规范.doc》

2.2界面设计规范

无

2.3接口规范

无

3模块汇总

3.1A100数据采集

编号模块名称功能简述

A101实时数据采集采集医院业务的实时数据

A102解包程序升级完成数据集的自动解包工作

A103数据集完善完善检查，麻醉，入院评估等数据集

A104采集程序扩展功能提供第三方的采集扩展功能

A105决策支持采集功能开发完成决策支持采集功能开发

3.2A200门户升级

编号模块名称功能简述

A201门户升级到22版本升级目前的门户版本。

A202单点登录升级获取当前登录用户的详细信息

A203账户信息共享可以同HIS进行账号信息共享

4A100数据采集的模块设计

本次数据采集升级主要是BS-CDR2Q基础上进行升级，主要包括：实时数据采集，解包程

序升级，数据集完善，采集程序扩展功能等的升级。

主要应用：

Config:采集配置和控制。

Compress：采集后台线程类，通过接口采集，SQL采集，病历采集等方式将数据组

装成BSXML各式，调用adapter接口

Decompress：将adapter处理后的数据进行解包，根据相应的规则将数据保存到cdr

中心库。

Adapter：主要功能用来进行schema校验，字典翻转，mpi调用等。

Empi：用户主索引。

其中adapter,empi由平台组提供。

config功能:

功能大类功能子类状态功能描述

采集标准管理采集标准管理已开发数据集标准选择，可以选择不同的数

据集。

采集方式配置采集方式配置已开发根据已经选择的数据集标准，配置数

据集对应的采集方式。目前支持：

SQL采集，病历采集，接口采集。

采集配置一SQL数据源管理已开发数据库连接池管理。

业务模型映射已开发配置SQL采集数据集对应的采集模

型。

采集SQL配置已开发配置采集SQL

采集配置一接口接口注册未开发接口注册，主要是第三方采集接口注

册。

接口配置未开发配置数据集对应的采集接口

采集控制任务管理未开发采集任务管理，包括：注册，修改，

删除等操作。

采集任务控制：包括：任务启动，任

务停止等操作。

扩展功能校验配置已开发数据校验规则配置

数据校验已开发业务库和中心库数据校验，主要用来

校验数据是否一致，是否丢失数据。

字典生成已开发主要用来生成客户端字典。

CDR分析已开发分析CDR目前数据情况。

Compress功能：

1.根据config的调度执行采集任务。

2.将数据拼装成BSXML.

3.调用adapter接口

Decompress功能：

1.解析BSXML

2.将BSXML保存到CDR。

4.1模块A101实时数据采集

4.1.1模块说明

名称数据采集（接近实时）

根据定义的数据集（根据卫生部标准和创业的业务生成），从业务系统（HIS,EMR,PACS,

功能描述RIS等）中采集业务数据，根据BSXML格式进行组装，并且将数据存储CDR（临床数据中

心）库中。

接口与属

数据集

性

处理流程参考下图

流程说明参考下图

数据字典无

复用说明无

备注无

4.1.2详细设计

a）功能说明

临床数据中心对数据的采集主要是两种方式：

1.接口方式（主要是在已经部署过集成平台的医院或者是his,emr等系统是第三方的医院），

业务系统通过临床数据中心暴漏的接口，通过调用接口进行数据的采集。

2.通过直连数据库主动采集。

本期数据采集主要是准对第二种情况。

b）业务流程

采集流程：

监控：主要用来监控业务库中CDR需要采集的相关信息的变更情况，通过触发器记录

业务库的操作日志。例如：保存，修改，删除等操作。用于后续的数据采集。

调度：主要是通过定时器容器根据每个采集任务（job）设置的采集频率，执行相关的job。

采集：当定时器执行某个采集任务时，首先需要获取该任务对应的操作日志，如果该条

操作日志操作类型是册U除操作，直接删除CDR库中对应的数据。如果是保存，修改操作通过

调用adapter接口来是实现数据采集。

监控子流程:

监控流程说明：

监控是对CDR需要采集的业务数据进行监控，主要是监控insert,update,delete等操作。

等发生以上操作时，需要保存业务库的操作记录。

1.按照病案首页采集为例子进行说明，病案首页采集涉及到病案首页主表

(zy_brry,ba_brsy,ba_brda,ba_brzd),病案首页诊断(ba_brqt),病案首页手术(ba_brss),病案首

页费用(ba_brfy)四个业务。但是采集的主表为BA_BRSY

2.当主表BA_BR表进行insert,delete操作时,cdr会同步进行insert,delete操作。其他情

况cdr会进行update操作。一般情况下单个数据集通过SQL进行采集只涉及到一个主表。

3.日志表明细详见BS-CDR2.1.PDM中01-CDR中心库-》99接口表单。

调度子流程:

调度流程说明：

1.调度主要是通过定时器来对各个人任务进行控制，主要操作为：启动任务，停止任务。

2.任务的状态：启动（该任务已经已经启动为运行），运行（该任务目前在运行中），停止

（该任务未启动）。

3.当任务停止时，需要判断下当前任务的状态，如果为运行，则需要等任务运行结束后，执

行停止操作。

采集子流程：

整体采集流程:

病案首页采集流程:

采集任务开始

采集任务结束

采集流程说明：

1.采集任务主要是根据日志表的记录进行采集。由于多个触发器的产生的操作日志准对的是

同一个数据集，所以在采集实时数据时，为了避免数据死锁。不考虑使用多线程处理。只

准对历史数据（原来）使用多线程处理。

2.为了提高采集效率，adapter■采用集群部署，可以根据实际情况调整ADAPTER服务器的数

量。同时每个数据集也可以动态的调整对应使用哪个adapter服务。

3.同时decompress也支持集群部署。可以根据实际情况调整decompress服务器的数量。

c）功能模块

该模块升级涉及到config,compress两个应用。

Config：

1.任务管理

>主要是用来进行任务的注册，修改，删除等操作。在进行任务的修改，删除等

操作时.，需要判断当前任务的状态是否为停止，否则需要将该任务停止后才能

进行后续操作。

>任务项：任务ID,任务类型，任务代码，任务名称，回调函数，合并函数，

数据集，操作日志表，采集服务器，adapter服务器，执行频率，执行方式（同

步，异步）等。

>任务控制：全部启动，全部停止，单个任务启动，单个任务停止等操作。

Compress：

>定时器容器开发。需要作为一个工具类以jar包的形式发布，供数据采集，决

策支持采集使用。

接口：添加任务，修改任务，删除任务，批量添加任务，批量修改任务，批量

删除任务，查询所有任务状态，查询单个任务状态。

>采集任务，修改目前的采集任务，支持读取业务操作日志进行数据采集，支持

动态配置adapter接口。

d）表结构

详见BS-CDR2.1.PDM中01-CDR中心库

e）注意事项

1.监控环节中当触发器监控到业务系统执行update操作时，需要特别处理，如果不是CDR需要

采集的相关信息不需要将该信息写入到操作日志表中。

4.2模块A102解包程序升级

4.2.1模块说明

名称解包程序升级

在BS-CDR2.0解包程序基础上进行升级，完成数据集的自动保存功能，通过数据集的配置，

功能描述

自动将BSXML保存到CDR中心库中，优化解包程序性能。

接口与属

无

性

处理流程参考业务流程

流程说明参考业务流程

数据字典无

复用说明无

备注无

4.2.2详细设计

a）功能说明

解包程序(decompress)主要目的是解析BSXML,并且将数据插入到CDR中心库中。BS-CDR2.0

的解包程序是手动，每次增加新的数据集需要重新进行编码，不利于实施人员维护，所以本次升级

基于2.0的基础上完成BSXML的自动保存。

主要功能：

＞BSXML解析

＞根据数据集和CDR的对应关系，动态生成SQL。

＞执行SQL

＞调用回写类

b)业务流程

数据集对应CDR1

表信息

说明:

1.数据集跟CDR表之间关系。可以通过数据库表进行维护。

2.生成SQL,默认数据集中的数据源跟CDR表中的列名称一致，通过数据库的dml语句

获取表的列明进行sql组装。

3.回写类主要用来执行，某个数据集中信息向其他数据集回写。例如：卫生事件摘要中

的诊断手术次数等信息需要从病案首页中获取，所以在保存病案首页数据时，需要将

诊断，手术次数等信息回写到卫生事件摘要表中。

4.需要定义数据集跟回写类之间的关联关系。

c）表结构

详见BS-CDR2.1.PDM中01-CDR中心库

d）注意事项

1.执行SQL语句时，需要能保证数据的完整性，特别是在执行更新操作时需要注意。

2.执行SQL注意效率问题，以及oracle对sql的长度的限制等。

4.3模块人103数据集完善

4.3.1模块说明

名称数据集完善

功能描述完善BS-CDR2Q目前的缺少的数据集，并将之纳入到标准版中，并提供标准的采集程序。

接口与属

无

性

处理流程无

流程说明无

数据字典无

复用说明无

备注无

4.3.2详细设计

a）功能说明

完善BS-CDR2Q缺少的相关数据集，以及纳入到临床数据中心标准版中，并完成相应的采集程

序。

1.完善数据集，主要是创建数据元，数据集，cdr表结构。主要数据集为：检查（大部分），

麻醉记录，护理记录（一部分），治疗记录，助产记录（一部分），可能根据实际情况进行调整。

2.提供相应的数据采集程序。

3.整理目前BS-CDR2.0已有数据集采集程序的完善并纳入到标准版中。对外发布。

4.提供针对hrp,emr某个版本的标准采集程序。

b）业务流程

无

c）表结构

详见BS-CDR2.1.PDM中01-CDR中心库

d）注意事项

无

4.4模块A104采集程序扩展功能

4.4.1模块说明

名称采集程序扩展功能

目前的采集程序只提供两种采集方式:SQL采集，病历采集（只适用创业的病历系统）。

功能描述但是实际情况会比较复杂，目前的采集方式并不一定适用所有的情况。所以需要支持自定义的

采集方式，实施人员准对特殊情况可以自己开发相应的采集程序。

接口与属

参加详细设计

性

处理流程无

流程说明无

数据字典无

复用说明无

备注无

4.4.2详细设计

a）功能说明

该功能主要用来支持第三方数据集采集。目前数据采集支持SQL采集，病历采集两种方式，但是

可能客户环境是千变万化的，目前标准版并不一定适应所有情况，需要提供预留接口，供实施人员进行

扩展。目前只支持java的扩展接口，后续可能会提供其他语言的扩展接口，进行扩展时，需要实现

ICompressExtend接口的execute方法。

流程：

1.实现icompressExtend接口。

2.通过配置界面添加第三方采集实现类。

3.配置数据集采集方式。

主要功能：

1.接口注册。第三方接口注册，注册信息为。接口名称，接口描述，接口类路径。主要操作

为：接口注册，接口修改，接口删除。

2.采集配置：为数据集选择相应的采集接口。主耍操作为：接口选择。

b）接口设计

publicinterfaceICompressExtend{

List<Map<String,Object»execute（CycleEntityentity）

throwsCompressException;

CycleEntity：采集实体类

c）表结构

详见BS・CDR2.1.PDM中03■决策支持

d）注意事项

无

45横块A10,决第支持菜隹功能开汾

1.u.X

浊•第守持渤捉采隹

d—1

功能根据决策支持中定义的模型可以同步的通过配置界面采集业务数据，同时可以对每个模型的状

描述木可1'」匕井彳〒脏捽“

7Ci«,""y»CAALL|JlLLLj.T.0

熔口

牲

决策支持采集流程主要分成三部分：

L—决策支持中指标和模型的配置。

«2.针对配置的模型进行采集配置，配置采集模型，配置采集SQL,启动采集“

W3.—可以对每个模型进行采集定时配置°例如A模型采集周期为10分钟一次，B模型每天12:00

开始采集。

4.—对采集模型进行监控，例如：采集状态，采集数据量，每秒数据传输量0

>5X.j/n无

秒

25C7TT目前公司莫他项目组的决策支持数据采集也不是很灵活u这次考虑做成通用的，可以为其他顶

iim

VzuVJ目组提供支持。

1H前山笛土特中曲］罟的怕标你府楼则笑什日舁以XMI格di牛行俾"的事再懈相杆如:

■t•HUJ/k.>44.J'JIHLtJ=LIIJ」口TJ、，|天_UAIVIL1iT111ALLIJ1小1JIIJ。EJ_xd'JJBPJ、，

CM1-J-

度，模型等佶息保存在数据库表中，便于决策支持数据采集。

该模块主要分为数据源配置，采集模型配置，采集SQL配置，采集周期配置，采集监控等功能

45.2.1数据源配置

a)功能说明:

该功能主要用来对数据库连接池的管理，包括：新增数据库连接，修改数据库连接,

删除数据库连接等。主要是为后续SQL采集提供服务k

b)—参考界面：

数据源管理:

施源名称:「知I阚

数据通锚数据库类驾数据姓名称数据库IP用户名阕E

ilfflARHissoracleord16config_etl

广西人民HIS库oradeord31GXRM_HE

公司前孟机贝©it族oradeord172.16,200.216bscdr.adapter

公司醴峰oradeord16config_eti柩赊

cdrg调旅oracleord16bscdr脚余

cdr_testsqteervercdrsa护赊

公司230em（库sqlserverwjyy_enr30S3删除

公司230h瞬sqteerverwjYY-his30sa何除

emr2.4sqlserverdev_emrS3删除

hi$2.4sqlserverdev_h«s53

首页上一页『曰下一页末贡

显示第1-1。条记录，共10^记录Ji/i||戊到

新增数据源:

编辑数据源:

详见~BSqR2.1.PDM中03-决策支持

dH意事项

由于该模块是从数据采集迁移过来，有些地方需要注意

1.表名称需要修改U

4.5.2.2采集.SQL配置

--功能说明：

根据在决策支持中配置的模型配置对应的采集SQL.一个指标对应一个采集SQL.

提供采集前的那却有■存T改等功能广

保存：保存配置SQL,保存前需要对必填项进行校验（主要是:维度和指标）i组保

存前需要选择该SQL对应的数据库连接池。

测试：测试该SQL是否合法「在测试前，需要选择对应的数据库连接池和输入

修改：修改该SQL的配置「

点击下图中的左侧菜单，右侧展示当前指标的采集SQL酿置界面。目录结构分

别是目录一》..模型一》“指标，.

B医疗服务SELECT

B门急诊动态科室*:SY.KSMC

门诊人次浜生*:SY.YSMC

急诊人次时日*:SY.TIME

B门急诊处方疾病*:SY.JBMC

处方总载门诊人次*:COUNT(SY.ID)

抗菌药物总数

B住院床位

开放总床日数

B基本药物FROMBA_BRSYSY

B药品金额

药品金额WHERESY」D='123'

B抗菌药物

抗菌药物数里

抗菌药物频次

LIS▼

详见BS-CDR2.1.PDM中03-决策支持

1.本次只支持一个指标一个SQL的采集方式，暂不支持多个指标一个SQL的采集方

2.—考虑二次桢型的问题，本次要支持二次模型的采集。

4.5.2.3采

a）—功能说明：

该功能模块主要用来启动刘琳控模型的采集0主要包含的功能：

编辑：可以编辑单个模型和所有模型的采集信息，例如：采集开始日期，采集结

束日期，采集周期，采集频率等（查看模型采集编辑界面原型）。

启动可以准对单伞模型和所有模型启动采集业务L启动■的业务流■程参考斗图

停止：可以也对单个模型和所有模型停止采集业务。将某个模型停止时，如果

该模型正在采集数据.，需要等该模型执行完毕后体质该模型的采集口

查看日志：可以查看横蛰的采集日志信息.一般日志信息保存30天的数据u单击每

个模型可以查看该模型相关的日志信息，日志信息包括：采集开始时间,

采集结束时间，采集数据条数，查询耗时，保存耗时，这个模型采集耗

时等信息（查看日志界面原型）。

b）—后台业务流程：

将模型的聚集

任务放到定时

器容器中后，

定时器会按照

设计的信息，

启动该任务

e）参考界面

采集管理界面:

采隼周期配置：

目录凝采集开始日期采集结束时间采选周期采隼频率爆

医疗服务门急诊动态2010-01-012013-10-01沃每天12:00颊

SM启动停止I

医疗服务住赫位2010-02-032013-10-01沃每五分钟启动

言启动］［停止］

医疗服务门急诊防每分钟粉启动］［停止］

2010-02-032013-10-01沃10编辑

医疗服免手木蟠每个月一