苏宁连锁发展业务需求中共通模块的概要设计说明书.docx

苏宁连锁发展业务需求中共通模块的概要设计说明书.docx

《苏宁连锁发展业务需求中共通模块的概要设计说明书.docx》由会员分享，可在线阅读，更多相关《苏宁连锁发展业务需求中共通模块的概要设计说明书.docx（17页珍藏版）》请在冰豆网上搜索。

苏宁连锁发展业务需求中共通模块的概要设计说明书

苏宁连锁发展业务需求中共通模块的概要设计说明书

1.1.文档目的

本文档是对苏宁连锁发展业务需求中共通模块的概要设计成果文档。

概要设计对术语解释、模块的基本功能、数据库结构、画面迁移、工作流及接口进行了概要性的描述，为详细设计及开发提供了初步理解基础。

1.2.文档范围

本文描述了苏宁连锁发展系统中共通模块的术语解释、模块的基本功能、数据库结构、画面迁移、工作流及接口，将作为详细设计及开发阶段的入口资料。

1.3.读者对象

本文档的阅读对象为详细设计人员、开发人员及测试人员。

1.4.参考文献

文档名

作者

出版单位/归属单位

版本

1.5.术语与缩写解释

缩写、术语

解释

2.模块功能概述

本模块是苏宁连锁发展2期项目的共通。

3.数据库逻辑结构

ER详细请参见《SNLF_2_Developer.pdm》

4.画面功能一览

大分类

ID

画面/功能名

功能说明

页面

GT0101

附件上传

根据分类上传附件，浏览附件。

GT0102

附件下载

下载附件

GT0103

图片浏览

根据类型浏览图片。

HTML关联

GT0201

动态表单

动态的新增一行表格及拷贝表格内的所有内容。

GT0203

提交域检查

检查text，textarea,redio,checkbox,select内容。

包括：

必输项，类型。

5.画面迁移图

无

6.画面功能说明

6.1.GT0101附件上传

图GT0101_1附件上传

图GT0101_2附件浏览

I．动作描述

动作

动作描述

关联数据表

初期化（init）

●根据传入的参数初始化附件分类和已上传附件列表。

参数一览：

1.附件主类型编号

参数：

form.attMainType

2.关联主键（最多5个）

参数：

form.referenceKey，以逗号分隔

3.附件子类型编号（可选）

参数：

form.attSubType

4.编辑模式（可选）

参数：

form.viewMode

值：

true：

查看模式；false：

编辑模式（默认值:

false）

附件表，附件分类明细表

上传（upload）

●判断必须输入项

●前台判断文件大小，如果操作1M（配置文件配置），报错。

●检查文件类型

判断上传的附件的后缀名与该附件类型都应的类型是否一致，如果不一致，报错。

●利用Struts2的文件上传机制，上传文件，保存数据库。

1.保存文件到服务器目录

文件路径：

文件基本路径+关键主键

文件名：

”F”+系统时间.后缀（如：

F20100825021311870.bmp）

2.如果是图片文件（如：

gif,jpg,png,bmp），利用jdk中的rt.jar包中的Image包生成缩略图。

缩略图的路径同上。

文件名：

”B”+系统时间+”PNG”。

（如：

B20100825021311870.PNG）

3.保存数据库。

附件表

返回

●关闭窗口

删除（delete）

●删除选择的文件。

●如果有缩略图，需要删除缩略图。

●删除DB中相应的数据。

附件表

文件名链接

●调用GT0102下载附件功能

6.2.GT0102附件下载

I．功能描述

功能

功能描述

关联数据表

下载附件

●下载页面：

根据附件表的主键下载附件。

利用Struts2的下载机制。

地址：

GT0102_download.do

参数：

form.rowId

附件表

6.3.GT0103图片浏览

I．动作描述

动作

动作描述

关联数据表

初期化

●根据传入的参数取得附件值并显示第一张图片。

参数一览：

1.附件类型（主）编号

2.关联主键（最多5个）

排序规则：

附件名称

显示内容：

图片，附件名，文件描述

附件表

左侧图片链接

●显示选择的图片及该图片对应的附件名，文件描述

使用说明

6.4.GT0201动态表单

利用JS实现表格的TR域的新增和内容的复制。

I．功能描述

功能

功能描述

关联数据表

增加行

●函数：

functionaddLine（tableId）

内容：

1.根据传入的表格编号，取得表格对象。

2.新增一个表格行并拷贝第一行的所有单元格到该行。

删除行

●函数：

functiondeleteLine（tableId,checkboxName）

内容：

1.根据checkbox名取得checkboxlist的值。

2.遍历该list，删除选中的行。

保存

●利用Struts2的表单上传。

使用说明

动态表单JS：

根目录\resource\js\autoTr.js

项目中引用时放在body中

......

resource/jsautoTr.js">

//添加行操作

functionaddLine（a,b,c,d,e）{

具体实现省略，JS中有完备注解

}

为了方法更全面，灵活性更高，参数需要设定5个a:

需要被插入table对象的ID；b:

需要插入的数据（数据按照”,”作为分隔符。

）；c:

子checkbox的name；d:

主checkbox的ID号；e:

每行SELECT标签的个数

//删除行操作

functiondeleteLine（a,b,c）{

具体实现省略，JS中有完备注解

}

a:

table对象的ID；b:

子checkbox的name；c：

主checkbox的ID号

//全选行

functioncheckAllbox（a,b,c）{

具体实现省略，JS中有完备注解

}

a:

table对象的ID；b:

子checkbox的name；c：

主checkbox的ID号

//置换select方法

functionselect_id（a,b）{

具体实现省略，JS中有完备注解

}

a:

定义第一数字参数项目的select数目；b:

table对象的ID

selectid改写标准select_[同行同数]_[同行唯一数]

建议使用时参阅示例程序，示例程序在目录SUNINGLF2\SVNSUNINGLF2_DOC\02DesignDoc\02BasicDesign\共通和系统框架下

6.5.GT0203提交域检查

通过配置输入表单的属性，检查表单内容是否符合规范。

包括：

必输项，类型。

支持表单：

text，textarea,redio,checkbox,select

I．功能描述

功能

功能描述

检查输入域规范

●增加表单的属性

canNull

1：

可空；0：

不可空。

typeValue

1：

数字；2：

浮点型；3：

英文；4：

英文和数字；

messageName

表单名称（报错时使用）

●遍历整个document，根据各个表单域的属性配置，检查必输项，类型。

如果不符合规范，更改表单的class为错误样式并报第一个表单域的错误信息。

Message内容如下：

必输项：

表单域（表单名称）是必须填写项，请确认是否填写。

类型：

表单域（表单名称）只能输入英文，请确认是否填写正确。

以上蓝色内容，请换成属性配置内容。

注意：

后一次检查正确时，需要把前一次错误的class恢复。

注意：

（1）.对于Text,TextArea表单，canNull，messageName，typeValue均有效。

（2）.对于redio,checkbox,select表单，只有canNull，messageName有效。

并且，这3个表单的上级表单，必须为

6.6.导航栏

导航栏是通过JS实现导航栏的初始化，增加链接等操作。

I．功能描述

功能

功能描述

初始化

函数：

functioninitNavigation（navigList）

功能说明：

1.遍历参数navigList，取得画面编号，画面名，URL并存入导航栏数组中

2.生成导航栏。

增加

函数：

functionaddNavigation（navig）

功能说明：

1.遍历导航栏数组，查找传入的画面是否存在。

如果存在，则删除该数组后面的所有值。

如果不存在，则增加传入参数到导航栏数组最后。

2.生成导航栏。

生成导航栏

函数：

functionmakeNavigation（）

功能说明：

1.遍历导航栏数组，拼出导航栏的HTML代码。

2.将拼出的导航栏HTML代码射到导航栏的Table域中。

使用说明

在jsp页面添加以下代码：

1.导入js

src="<%=request.getContextPath（）%>/resource/js/guide.js">

2.初始化navigation,方法名可自定义，方法体必须调用updateNavigation（）,传入4个参数，前两个为固定值，navigat，navigatStr，第三个为该页面中文名，第四个访问改页面的url,例如以下：

//初始化Navigation

functioninitKF0511Navigation（）{

updateNavigation（'navigat','navigatStr','备选址信息编辑','KF0511_init.do'）;

}

3.添加页面隐含域

hiddenname="form.navigatStr"id="navigatStr"/>

4.添加以下table

style="margin-top:

5px"align="center">