数据配置模块 概要设计说明书 V100

TIANSU

NTS-9000E通用数据

配置模块

概要设计说明书

文件编号生效日期受控编号

保密级别一级版本号V1.00修改次数0

总页数18正文13附录无

编制苗升伍审核批准

南京天溯自动化控制系统有限公司

评审记录

对《NTS-9000通用数据配置模块概要设计说明书V1.00》的评审意见:

上述问题修改验证后，由验证后，本文件即可发布。

评审人员签字:

问题修改验证结果：

验证人签字：时间：年_月_日

变更日志

编号版本修改内容修改人修改日期

1V0.10草案。苗升伍110826

目录

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

1.1编写目的...................................................................1

1.2背景.......................................................................1

1.3定义.......................................................................1

1.4参考资料..................................................................1

2总体设计.......................................................................2

2.1需求规定...................................................................2

2.1.1功能边界...............................................................2

2.2运行环境...................................................................2

2.2.1硬件环境...............................................................2

2.2.2软件环境...............................................................2

2.3概要设计决策...............................................................2

2.3.1设计原则...............................................................2

2.3.2设计决策...............................................................3

2.4开发环境...................................................................3

2.5界面设计...................................................................4

2.6功能模块划分...............................................................4

2.7程序流程..................................................................4

3模块设计.......................................................................6

3.1工具栏功能区..............................................................6

3.2数据库初始化与自适应......................................................6

3.2.1数据库初始化...........................................................6

3.2.2自适应.................................................................7

3.3数据的增/册IJ/改.............................................................8

3.4重载/保存实时库............................................................8

3.5导出为EXCEL...............................................................8

3.6界面优化...................................................................9

，质量要求......................................................................10

4.1容量要求..................................................................10

4.2性能要求..................................................................10

4.3接口要求..................................................................10

4.3.1内部接口...............................................................10

4.3.2用户接口...............................................................10

4.3.3外部接口...............................................................10

5系统安全设计..................................................................12

5.1数据传输安全性设计........................................................12

5.2应用系统安全性设计........................................................12

5.3数据存储安全性设计.......................................................12

6尚未解决的问题................................................................13

6.1标签页切换时页面闪烁.....................................................13

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

1引言

1.1编写目的

本文档是根据NTS-9000E能源管理系统平台软件通用数据配置模块(以下简称本软件)进行详细分

析和讨论后得出的分析说明书，旨在明确本软件模块的功能需求。通过本说明书，可以了解到本软件的

开发背景、建设要求、功能需求等。各个模块的开发人员阅读此文档后，以各个模块的功能为基础，兼

顾配合服务器模块，完成各自模块的功能。

本文档面向的读者是：NTS-9000E综合监控系统平台软件各项目组成员.

1.2背景

软件名称：通用数据配置模块(TSConfig.exe)

通用数据配置模块，是NTS-9000E综合监控系统平台软件的一个子模块，主要负责整个平台软件的

所有配置工作，这就要求数据库与数据配置模块具有足够的灵活性、高可靠性、可复用性、可维护性，

但是原有的NTS-900系统的数据配置软件灵活性不够高，如有新的数据库表增加，则需要修改代码以实

现新表的配置，是远远小能满足平台软件配置的要求。因此，本软件在与数据库紧密配合的前提下，小

论是什么系统的数据配置，都可以通过本软件进行配置。

1.3定义

下表列出本报告中专门术语的定义、英文缩写词的原词组和意义、项目组内达成•致意见的专用词

汇，同时继承全部的先前过程中定义过的词汇。

词汇名称词汇含义备注

TSConfig通用数据配置模块

NTS-900系统原有的NTS-900D配电站后台监控系统、NTS-900T变电站

后台监控系统、NTS-900M集控站计算机监控系统

1.4参考资料

编号资料名称说明

1《NTS-9000能源管理系统平台软件VI.0通用数据配置模块需求

规格说明书VI.00.doc))

2«VC界面设计规范080812》

3《VC编程规范》

4《NTS-9000能源管理系统平台软件VI.0数据库设计说明书

VI.00.doc》

1

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

2总体设计

2.1需求规定

2.1.1功能边界

本软件可以方便工程技术人员或客户配置数据库，以实现平台软件的正常运行，其功能子模块主要

如下：

（1）数据的增/删/改功能：

<2）数据库初始化与自适应；

（3）重载/保存实时库：

（4）导出到Excel；

（5）界面优化及其它。

本软件的输入主要是从后台服务器读取到的数据，输出则是把修改后的数据保存至内存实时数据

库，并可把当前修改的数据导出至Excel文件。

2.2运行环境

2.2.1硬件环境

硬件环境

类别要求备注

CPU1.8GHz以上CPU

内存1GB或以上

主机硬盘至少80GB

2.2.2软件环境

软件环境

类别要求备注

操作系统Windows2000/2003或WindowsXPSP2及以上

数据库SQL2000SP3及以上

2.3概要设计决策

2.3.1设计原则

>要有一个良好的设计框架。

为了软件能适应未来几年的现场需要，通用数据配置模块应该根据实际需要保持一定的可扩展性、

可复用性，这就要求系统升级时对已基于该系统实施的系统兼容，软件设计必须有良好的设计框架。其

中包括：

2

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

第一、采用复用技术。

第二、底层业务模块相对独立，统一接口，做到高内聚、低耦合。

第三、良好的人机交互界面。

>系统的使用要考虑现场人员的易用性

本软件的最终用户为现场的运行维护人员，在设计软件时要考虑人员的使用习惯和方便使用；简单

易用的系统可以提高现场工程实施人员的效率，降低出错的几率。

>系统需要具有足够的灵活性与通用性

本软件作为一个通用数据配置，即对平台软件中的各个子模块的配置都可适用，即在不修改代码的

情况下，通过相关的数据库表内容的修改，即可完成工程配置。

2.3.2设计决策

本节记录对概要设计具有重要影响的软件需求和约束，描述相关的重要决策和决策的原因。这些决

策一般对设计有很大影响，它们的改变很难通过设计技巧来屏蔽，例如所选用的开发语言，所选用的平

台、组件和框架，对关键业务，类和方法的处理等。

决策1：多标签页功能

设计决策多标签功能标识号01

对于各表的配置，只在右侧显示一张表的数据，显得单一，操作起来

问题描述

不方便

假设条件

在右侧可通过多标签页来显示每张表的数据，在BCG中，存在以对话

可选方案

框为依托的多标签页，也有以多文档存在的多标签页

决策以多文档的多标签页来实现

1、以文档实现数据的编辑、视图实现数据的展现，更好的体现文档

理由类与视图类的分工；

2、多文档实现起来相对简单一些。

影响

相关决策采用多文档的方法

2.4开发环境

开发用机器

类别要求备注

CPU2.40GHzCPU

内存2G

主机硬盘25OG

网卡100Mb/s

操作系统WindowsXPProfessionalSP3

开发环境MicrosoftVisualStudio2008SPI

3

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

2.5界面设计

软件采用BCG界而库实现，默认使用Windows2007风格，界面如下:

S⑼8】

；文向DItk匕Ml）逑*W关于为

』口国」里士茎曷型基ere・

Qx"

,O系段配置

O

o・道信n泉TM«)UU・.••rXI•■•U«4Un(123)123-12-12

杓变型太

••••••••••.一

ox«*n*F«**vav4nx.wwby,L

-uur«i

w*vk«r•...⑼

yOTttl

一"1£li4«r<61*U1«60

casUVlalatCUckS«aq

小开关・

❸3冲*C«lwTH.OK”F»MFk<lM«Aritl

・设IP

FileME・FiU.3PU4«rfie：\

小开关*

B2・2O“*14Tta«ica

金脉冲修

Q厂站7

=91&2

fir«>冷I«e6

「

三I

oru4

：2

sr«3>

ortts三

，4

o厂站6二S

,0*力4*配置科#

◎等仅我

Akon7

o税需我

Q•依配片殳今kcn>。

.O・筝配置

O・加M*信意北

2.6功能模块划分

工具栏功能区：

数据库初始化与自适应;

2.7程序流程

本软件的流程如下图所示:

4

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

SQL数据库

3

本软件采用多文档实现，对二每张数据库表的编辑使用多标签完成。每新建一个标签，则新建一个

文档，由与该文档绑定的视图实现数据的展示、添加、编辑、修改、删除等，由文档类把修改后的数据

拼接成报文，实现与服务器间数据的存取。

对于数据的来源、数据的读取与保存，仍然采用原NTS-900系统的管道方式，即由文档类、应用程

序类完成与服务器间的管道建立、数据的存取。

对于表格中数据的各种表现形式，如下拉框（单选）、数据链接、表链接、多选、时间等情况，由程

序根据数据库表中的配置自适应。除表名表、域名表外，不出现其它表的结构体定义。

5

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

3模块设计

3.1工具栏功能区

该部分主要是对本软件中的列表控件进行操作的相关按钮，主要有“保存”、“添加数据”、“删除

数据”、“取消修改”、“全部取消”、“查看”、“修改”、“关于”、“退出”。

（1）保存：当用户保存修改时.，可能会出现没有完全保存的情况，导致这种问题的原因一般是

修改了列表中的某•列，而此列在数据库表中是主短，主键是不允许修改的。

（2）添加数据：用户点击“修改”，弹出密码验证对话框.密码验证通过后，才允许用户添加

数据。

（3）删除数据：用户点击“修改”，弹出密码验证对话框，密码验证通过后，才允许用户删除

数据。删除数据时一般不会出现（1）中提到的问题。

（4）取消修改：当软件处丁•“修改”状态且对列表中的数据进行了修改，致使数据处丁•修改状

态时，点击“取消修改”，可以取消之前所做的最后一步操作。

（5）全部取消：当软件处于“修改”状态且对列表中的数据进行了多次修改，致使多个数据处

于修改状态，点击“全部取消”，可以取消之前所做的所有没保存的操作。

（6）查看：使软件处于“查看”状态，不允许用户修改.此时列表中的所有字段均处于显示状

态，避免用户修改重要数据造成不必要的错误：此状态下可以实时显示服务器端的各变量

的值，程序中默认为3秒钟向服务然端取•次数据.

（7）修改：点击“修改”按钮，弹出密码验证对话框，密码验证通过后，允许用户修改列表控

件中的数据。列表处丁•可修改状态时，根据不同的侍况，列表中的某个或多个字段处于隐

藏状态，避免用户修改重要数据导致软件出错。

（8）关于：本软件的相关信息，包含软件名称及版本、NTS-9OOM系统名称及版本、公司版权

声明等。

（9）退出：退出本软件，不需密码验证。

3.2数据库初始化与自适应

3.2.1数据库初始化

数据库初始化主要是指本软件从服务器读取的数据库信息并在软件中建立相应的树结构。读取数据

时，是以管道的形式从服务器读取数据，管道的建立、重连与删除放在应用程序类里进行，以方便其它

视图类或文档类进行调用。

对于左侧的树结构，可按数据库中的配置来生成。数据库中默认BASENO>=1000为树的根结点，在

数据库配置时，该结点为虚拟点，有表号，但无真正意义上的数据库表，主要是用来建立树形结构：其

它表有一个对应的PARENTID,指明该表的父结点，通过该字段信息来建立子结点。

对于原NTS-900系统的树结构，在此做一些更改，由原来的“厂站•设备-遥测/信/脉量”改为“工程-

6

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

厂站•设备-模拟/开关/脉冲量”，目前根据模拟量/开关/脉冲量表中是否有附属于某个设备的数据点来决定

是否在设备结点下显示“模拟量”、“开关量”、“脉冲量”结点。

3.2.2自适应

主要是从服务器读取数据并实现数据展示后，每张表的各个字段可能不一样，而软件要做到自适应

配置，如时间域、整型域、下拉域（单选）、链接域等。在此，使用两个链表保存表名表和域名表的内

容，树结构的形成通过遍历链表内容来建立。

0,定长字符型域，软件自动判断当前字符串长度，并与SQLServer里配置的进行比较，以做相应的

判断与限制；

2,数字整型域，软件自动判断当前输入是字符还是数字型，如非数字，则给出限制或提示：

3,浮点型域，软件自动判断当前输入是否是浮点型，如不是，则给出提示：

4,日期时间域，软件判断是否为日期时间域，如是，则给出可编辑日期、时间的界面；

6,布尔型域，软件判断为真，则初始化下拉框为“是"、“否”两个选项：

7,菜单型域（单选），主要是开关量用来报警的信息提示，如为该类型，则默认加载MSSQLServer

中配置的字符串到下拉框中；

8,菜单型域（多选），主要是相对于以前NTS-900系统中可勾选的多选对话框而言，在此以弹出对

话且对话框中设置列表框实现多选的方式实现，这样勾选起来更直观；

9,数据链接域，软件自动判断，如是，则调用接口函数弹出链接对话框，如该域已经链接数据，则

自动定位到已经配置的表、字段上：

10,外键字域，软件根据数据库中的配置判断，如是，则根据配置从相应的数据库表读取名称字段

并填入F拉框中。

-Bci~~—.J

TotMa】。，W4T14IH.kdBdit:023)123-12-12

FMiverdVKL

33”68*u»b«r♦...831

Slid”铺Doobl.239eo

Ch«ckBox,7

Pte.C654FwitPidwr:Arial

f11«加6rMr>i«jFoXd«rFi...e:\

20H-e-14力”16SO

151

ICM(uIconList

」Iconl

Akm3

Sken4

二icons

抖Icon6

AIC87

Icon8

Icon9

。Icon10

塞

7

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

3.3数据的增/删/改

在软件界面右侧以表格形式显示已经配置的数据，用户在通过密码验证处于修改状态时，在表格中

即可修改数据，或实现增加/删除数据功能。

在数据修改过程中，软件支持按单元格、按行进行复制、粘贴的功能，同时，在显示的数据行中间

可插入空行，类似于MicrosoftOfficeWord里的插入行功能。

3.4重载/保存实时库

本功能主要是对实时库的操作，包含重载实时库和保存实时库。

(1)重载实时库：当点击“重载实时库”时，弹出密码验证对话框，当密码验证通过时，系统把磁

盘数据库里的数据重新加载至实时库中，相关联的服务器软件退出所有已打开的服务，并重新初始化各

参数。此功能的主要作用是：当有些参数在磁盘数据库中修改，实时库中仍然是旧数据，系统退出时，

实时库会自动更新至磁盘数据库口，以致于把修改过的数据覆盖掉。重载实时库后，磁盘数据库与实时

库的数据保持一致，且不用重启整个后台系统。

(2)保存实时库：此功能可在配置文件中配置，即当数据库退出时，默认把内存实时数据库中的内

容保存至磁盘数据库中，但此功能是当整个后台系统退出时才会执行，而“保存实时库”功能，当点击

“保存实时库”时，弹出密码验证对话框，当密码验证通过时，系统把实时数据库中的数据更新至磁盘

数据库中，以保持两者的同步。

(3)进行重载或保存操作时，软件以对话进度条的形式给出进度提示。

3.5导出为EXCEL

此功能主要是把当前表格中已经配置的数据，按照表格的格式导出到EXCEL中，方便用户或配置人

员对数据进行核对、确认，软件默认导出到MicrosoftWindowsOffice2(X)3EXCEL中。

8

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

3.6界面优化

（1）界而风格

采用BCG界面库的Windows2007的蓝色调风格，默认不支持其它界面风格的设置。

（2）表格控件采用BCG界面库中封装的GridCtrl控件类，并通过此类设置单元格格式，如单元格是

否为FI期类型、密码类型、下拉框类型、颜色选择类型、目录选择类型、文件选择类型、超级能接类

型、多选框类型等。

（3）采用BCG界面库中封装的多文档类，并基于TAB页来实现多标签功能；是否使用多标签页，

用户可灵活配置。

（4）图标优化，默认使用浅蓝色调的图标，详见“TSView系统最终图标”。

9

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

4质量要求

4.1容量要求

(1)系统可用率：99.98%

(2)系统MTBF：30000小时

(3)CPU负荷率：<=25%

4.2性能要求

系统在7*24小时运行过程中：连续稳定运行，平均无故障时间大于等于3OOOO小时。

4.3接口要求

4.3.1内部接口

无。

4.3.2用户接口

无。

4.3.3外部接口

函数名称函数参数描述

以下函数以AFX_EXT_API开头，在此此省略

本软件与服务器进行通讯时，用

HANDLEWINAPIOpenRealDataPipeBOOLbRetry=TRUE

来打开管道

启动对本软件的监控，加有报文

BOOLWINAPIMonitorlnitHWNDhWnd

信息，则发送至报文监视程序

voidWINAPIMonitorExit—退出对本软件的监控

HANDLEhPipe,BYTE*本软件与服务器通过管道进行数

void*WINAPIGetNetMessage

pWrite,DWORDcbWrite据读取

HANDLEhPipe.IndexDet*通过结构体获取索引中各量的描

BOOLWINAPIGetMessage_RIndexNameplndexJndexDefExt*

述名

plndexExt

通过结构体获取对应模拟量、开

HANDLEhPipe,IndexDef*关量或脉冲量点的描述名，以

BOOLWINAPIRtdblndexToStringNameplndex.char*ptrBuf.WORD[T程名.厂站名.取值表

BufLen名.XXVALUE]数据点名称的格

式返回

WORDwDataType,WORD

voidWINAPIConvertStrToRtdbdatawDataLen,BYTE*通过字符串返回字节流

pltem,CString*constpStr

LPCTSTRTableName,int

LPTSTRWINAPIGetFieldChineseName通过表名、字段号获取中文名

Fieidld

void*WINAPIGetMessage_TableIrfHANDLEhPipe,WORD通过命名管道、库号、表号获取

IO

TIANSUNTS-900DE通用数据配置模块概要设计说明书VI.00

BaseNo,WORDTableNo指定表的相关信息，主要是域名