功能详细设计文档(参考模版)概要

1、LKOA6.0 表单管理表单管理表单管理应用功能表单管理应用功能详细设计说明书详细设计说明书所属项目：LKOA6.0项目类型新产品开发项目编号文档类型：设计文件/详细设计说明书类型编码文档编号：版本号：V1.0 最后更新人XXX最后更新时间2009-XX-XX拟 制 人：拟制日期：2009 年 XX 月 XX 日审 核 人：审核日期：2009 年 XX 月 XX 日批 准 人：批准日期： 2009 年 XX 月 XX 日文件历史版本纪录文件历史版本纪录变更序号日期版本变更说明修改人12009-xx-xx1.0新文件22009-xx-xx1.1修改文件1. 引言引言1.1.编写目的编写目的本设计

2、说明书描述 LKOA6.0 产品中某功能模块实现的详细说明，仅供开发及测试人员阅读。1.2.设计功能概述设计功能概述1.3.背景背景说明：1.LKOA6.0 产品-某功能模块2.任务提出者：公司内部。1.4.定义定义列出本文件中用到专门术语的定义和外文首字母组词的原词组。1.5.参考资料参考资料1.联达动力开发规范1.6.编码注意事项编码注意事项本详设文档中涉及到数据逻辑描述的 Sql 语句仅作为数据获取逻辑准则，因未考虑其执行的性能及效率，不建议直接作为开发编码中实际的 Sql 语句进行使用，也不能作为衡量开发编码部分完成的标准。请开发人员根据实际情况以及涉及的数据量灵活变通。2. 程序系统

3、的结构程序系统的结构命名空间：LinkPower.PduOA6.Mod.TableManage程序集LinkPower.PduOA6.Mod.TableManage页面程序路径：PduOA6_TableManageVss 路径：$/LKOA6/SourceCode/Module/Mod_TableManage/DotNet/LinkPower.PduOA6.Mod.TableManage3. 详细设计说明详细设计说明3.1.表单应用数据表管理表单应用数据表管理3.1.1. 数据表分类列表数据表分类列表3.1.1.1.功能描述功能描述本功能主要用于显示和管理数据表分类。判断操作用户的权限，具备权

4、限的用户方可进行数据表分类的维护和管理。3.1.1.2.输入输入无3.1.1.3.界面界面3.1.1.3.1. 数据表管理框架分类 数数据据表表单单管管理理数数据据表表单单管管理理数据表单分类列表行文格式国标类行政管理类分类名称9 91 1相关数据表排序 编辑 删除排序 编辑 删除操作删除数据表单导航 刷新数据表单导航类型A 1分类B 8分类 0分类管理未分类12（财务、审计、税务等适用）行政管理适用分类描述新增显示在 之前 确定 关闭显示其他分类-3.1.1.3.2. 数据表单导航 数据表单导航 刷新数据表单导航类型A 1分类B 8分类 0分类管理未分类123.1.1.3.3. 数据表分类列

5、表 数据表单分类列表行文格式国标类行政管理类分类名称9 91 1相关数据表排序 编辑 删除排序 编辑 删除操作删除（财务、审计、税务等适用）行政管理适用分类描述新增显示在 之前 确定 关闭显示其他分类3.1.1.4.页面操作说明页面操作说明1界面是由和组成。2界面是（数据表管理框架）公用页面，界面是（数据表单导航）公用页面，界面是数据分类列表页面，以下界面操作及业务规则是针对界面来描述的。3点击“新增”按钮以及列表上的“编辑”链接，页面转向到界面。4点击“删除”按钮以及列表上的“删除”链接时，提示“您确定要删除分类吗？” ，如果点击“删除”按钮时，列表上未选中任何一项分类，则提示“请选择要删除

6、的分类” 。5界面上黄色背景区域为排序浮动层界面，默认不显示，点击列表上的“排序”链接时才显示，点击排序浮动层界面以外的任一区域，排序浮动层界面则隐藏，点击排序浮动层界面上的“关闭”链接，排序浮动层界面隐藏；3.1.1.5.业务规则说明业务规则说明1页面初始化时，首先进行数据表分类数据的装载：调用（SJBFL-1）接口获取当前操作用户有权限维护的所有数据表分类信息（包括“分类序号” 、“分类名称” 、 “分类描述” 、 “显示顺序” ） ，将信息绑定到列表中进行显示。调用接口时， 基本过滤条件 XML参数中构建“”条件节点，节点值设置为0 ， 权限过滤条件 XML参数中的用户序号为当前操作用户

7、序号（SessionUserGuid_LK） ；2在绑定列表数据显示时，根据每个数据表分类的分类序号 ，调用（SJB-3）接口获取该数据分类表下的数据表数量显示到列表的相关数据表一列，调用接口时， 分类序号参数设置为当前分类序号， 权限过滤条件XML参数中的用户序号设置为当前操作用户序号（SessionUserGuid_LK） ；3调用（SJBFL-1）接口获取“所有数据表分类信息 XML” （包括“分类序号”、 “分类名称” 、 “分类描述” 、 “显示顺序” ） ，用于排序操作时浮动层数据装载的数据源。调用接口时， 基本过滤条件 XML参数中构建“”条件节点，节点值设置为0 ， 权限过滤条

8、件 XML参数值设置为空；4点击列表上的“排序”链接，显示排序浮动层界面，浮动层界面装载时，首先清除浮动层界面中下拉框的所有数据，然后循环“所有数据表分类信息 XML”中的所有数据表分类，将其绑定到下拉框中进行显示（绑定时，下拉框的选项名称为分类名称 ，选项值为显示顺序 ） ，循环绑定的过程中，如分类序号等于当前记录对应的分类序号，则该项分类信息不能绑定到下拉框，该分类的下一个分类信息绑定到下拉框时设置为选中，如果当前记录对应的分类在“所有数据表分类信息 XML”中的最后一项，则下拉框默认选中最后一个分类；5点击排序浮动层界面的“确定”链接，调用（SJBFL-4）接口调整分类的显示顺序，调用接

9、口时， 分类序号参数设置为当前分类序号， 原顺序参数设置为当前分类显示顺序， 新顺序参数设置为排序浮动层界面下拉框选中的选项值，接口调用完毕后，重新装载列表数据和排序浮动层所需的数据源，即执行第 1、2、3 规则；6点击列表上的“编辑”链接，将当前分类序号作为页面输入参数调用界面，页面转向到数据表分类编辑；7点击列表上的“删除”链接，调用（SJBFL-6）接口将当前分类删除，调用接口时， 分类序号参数设置为当前分类序号，并根据接口的返回值判断是否删除成功，如未删除成功，给出提示“分类删除未成功，请稍候重新操作” ；8点击列表上方的“删除”按钮时，循环当前选中的分类序号，调用（SJBFL-6）接

10、口将选中的分类删除。调用接口时， 分类序号参数设置为当前循环的分类序号，并根据接口的返回值判断是否删除成功，如未删除成功，则记录未删除成功的分类序号，调用（SJBFL-2）接口获取到分类名称，拼出提示信息“以下分类删除未成功，请稍候重新操作。 ” 换行符 未删除成功的分类名称（多个之间用逗号分隔） ；9删除操作成功后，重新装载列表数据和排序浮动层所需的数据源，即执行第 1、2、3 规则3.1.1.6.输出输出3.1.1.7.调用说明调用说明3.1.1.8.程序文件程序文件程序路径：./PduOA6_TableManage /tbl_DataTableKind_List.aspx类名称tbl_D

11、ataTableKind_List平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage /tbl_DataTableKind_List.aspx3.1.2. 数据表分类编辑数据表分类编辑3.1.2.1.功能描述功能描述新增数据表分类，或对指定的数据表分类进行编辑。完成操作后保存。3.1.2.2.输入输入名称名称类型类型说明说明sKindIdString分类序号，页面输入参数，为null或空时，表示数据表分类的新增。3.1.2.3.界面界面3.1.2.3.1. 数据表分类编辑 数数据据表表单单管管理理数数据据表表单单管管理理数据表单分类编辑分类名称输入/显示显示顺

12、序保存分类描述输入 / 显示返回显示在最后显示在 之前显示除该分类外的其他分类3.1.2.4.页面操作说明页面操作说明1点击“保存”按钮，需校验分类名称是否为空，如果为空，则需要提示“请输入分类名称” ，并终止操作；2点击“返回”按钮，转向到“数据表分类列表”页面（界面） ；3.1.2.5.业务规则说明业务规则说明1首先初始化编辑页面数据的显示。如果“分类序号”输入参数值不为空，则调用（SJBFL-1）接口获取当前分类的详细信息（包括“分类序号” 、 “分类名称” 、 “分类描述” 、 “显示顺序” ） ，调用接口时， 基本过滤条件XML参数中只设置分类序号节点，节点值为当前分类序号， 权限过

13、滤条件 XML参数设置为空；2页面中显示顺序区域数据的显示。调用（SJBFL-1）接口获取“所有数据分类信息 XML” ，调用接口时， 基本过滤条件 XML参数中构建“”条件节点，节点值设置为0 ， 权限过滤条件 XML参数设置为空， 显示顺序区域对应的选项按照以下情况进行显示：2.1如果“分类序号”输入参数值为空，则显示顺序区域的选项选中为显示在最后 ，下拉框则绑定显示“所有数据分类信息 XML”中的所有数据分类；2.2如果“分类序号”输入参数值不为空，则调用（SJBFL-3）接口获取最大顺序号，调用接口时，参数协作类型设置为0 ，参数获取标识设置为Z 。如当前分类的显示顺序等于最大顺序号，

14、则显示顺序区域的选项选中为显示在最后 ，下拉框则绑定显示“所有数据分类信息 XML”中的所有数据分类；否则， 显示顺序区域的选项选中为显示在 xxxx 之前 ，循环“所有数据分类信息XML”中的所有数据分类绑定到下拉框中进行显示，循环中，如分类序号等于当前分类序号，则该分类信息不能装载到下拉框，且该分类的下一个分类信息绑定到下拉框时设置为选中； 3显示顺序区域对应的下拉框在绑定数据时，显示名称为绑定分类的分类名称 ，对应值为绑定分类的显示顺序 ；4显示顺序区域选项设置为显示在最后时，对应值为 0，选项设置为显示在 xxxx 之前时，对应值为下拉框当前选中的值；5点击“保存”按钮，调用（SJBF

15、L-5）接口保存分类信息，调用接口时，分类保存信息 XML参数构建分类序号 、 分类名称 、 分类描述 、显示顺序 、 协作类型等节点值，其中协作类型节点值固定设置为0 ；3.1.2.6.输出输出xxxx String说明： 3.1.2.7.调用说明调用说明3.1.2.8.程序文件程序文件程序路径：./PduOA6_TableManage /tbl_DataTableKind_Edit.aspx类名称tbl_DataTableKind_Edit平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage /tbl_DataTableKind_Edit.aspx3.1.3

16、. 数据表列表数据表列表3.1.3.1.功能描述功能描述列出所有分类或某一分类下的数据表。具备权限的用户可对列出的数据表进行增、删、改、查等操作。3.1.3.2.输入输入【界面】名称名称类型类型说明说明sKindIdString分类序号，页面输入参数，为null或空时，表示所有分类，为-1时显示未分类的数据表3.1.3.3.界面界面3.1.3.3.1. 数据表管理框架数据表列表 数数据据表表单单管管理理数数据据表表单单管管理理数据表单列表数据表B数据表A数据表名称21工作表单编辑 删除编辑 删除操作删除无分类B分类A所属分类未生成已生成生成标志510数据属性输入表单名称查询点击生成非系统系统表

17、单类型新增共有xxx条记录 第0/0页 首页 上一页 下一页 尾页 跳转到 页 GO 点击取消生成数据表单导航 刷新数据表单导航类型A 1分类B 8分类 0分类管理未分类12-3.1.3.3.2. 数据表列表 数据表单列表数据表B数据表A数据表名称21工作表单编辑 删除编辑 删除操作删除无分类B分类A所属分类未生成已生成生成标志510数据属性输入表单名称查询点击生成非系统系统表单类型新增共有xxx条记录 第0/0页 首页 上一页 下一页 尾页 跳转到 页 GO 点击取消生成3.1.3.4.页面操作说明页面操作说明1界面是由和组成。2界面是（数据表管理框架）公用页面，界面是（数据表导航）公用页面

18、，界面是数据表列表页面，以下界面操作及业务规则是针对界面来描述的。3点击“新增”按钮以及列表上的“编辑”链接，页面转向到界面。4点击“删除”按钮以及列表上的“删除”链接时，弹出确认提示“您确定要删除数据表吗？” ，如果点击“删除”按钮时，列表上未选中任何一项分类，则提示“请选择要删除的数据表” 。5点击列表上的“已生成”链接时，弹出确认提示“您确定要取消生成该数据表单吗？” ；点击列表上的“未生成”链接时，弹出确认提示“您确定要生成该数据表单吗？”3.1.3.5.业务规则说明业务规则说明1页面初始化时，首先进行数据表信息的装载：调用（SJB-1）接口获取当前操作用户有权限维护的所有数据表信息（

19、包括“表单序号” 、 “表单名称” 、“表单描述” 、 “所属分类序号” 、 “显示顺序” 、 “系统标志” 、 “实际表名” 、“生成标志” ） ，将信息绑定到列表中进行显示。调用接口时， 权限过滤条件 XML参数中的用户序号为当前操作用户序号（SessionUserGuid_LK）， 需返回的结果属性项 XML参数为空，如果“分类序号”输入参数为空，则基本过滤条件 XML参数构建协作类型节点，节点值设置为0 ；否则， 基本过滤条件 XML参数构建分类序号节点，节点值为分类序号输入参数值；2在绑定列表数据显示时，数据表各列的数据按照以下规则显示信息：2.1“列表选择”列（第一列）：根据“系统

20、标志”和“生成标志”的值，当“系统标志”为1 ，或者“生成标志”为1时，列上的复选框设置为 Disable；根据“工作表单”列的值，如果大于 0，则列上的复选框也设置为 Disable；2.2“数据表名称”列：显示“表单名称” ；2.3“所属分类”列：根据“所属分类序号”调用（SJBFL-2）接口获取“分类名称”显示；2.4“表单类型”列：根据“系统标志”的值， 0显示为非系统 ；1显示为系统 ；2.5“数据属性”列：首先根据“表单序号”调用（SJB-2）接口获取到表单的“数据属性 XML” ，根据“数据属性 XML”调用（SJBSX-1）接口获取“数据属性个数”进行显示；2.6“生成标志”列

21、：根据“生成标志”的值， 0显示为未生成（文字以红色标识） ， 1显示为已生成 ；2.7“工作表单”列：根据“表单序号”调用（GZB-3）获取“相关工作表信息 XML” ，调用接口时， 数据表序号参数设置为“表单序号” ，表单序号参数设置为空。解析“相关工作表信息 XML”内容中的工作表节点个数作为结果进行显示；2.8“操作”列（最后一列）：根据“系统标志”和“生成标志”的值，当“系统标志”为1 ，或者“生成标志”为1时，列上的删除链接设置为 Disable；根据“工作表单”列的值，如果大于 0，则列上删除链接设置为 Disable；3点击列表上的“已生成”链接，将对应数据表进行取消生成操作，

22、调用（SJB-6）接口实现，调用接口时， 表单序号参数设置为对应数据表的“表单序号” 。调用接口后，根据接口的返回值判断是否取消生成成功，如成功，则重新绑定列表数据的显示，如未成功，则弹出提示信息“数据表取消生成失败，错误信息如下：” 换行符 接口返回信息；4点击列表上的“未生成”链接，将对应数据表进行生成操作，调用（SJB-5）接口实现，调用接口时， 表单序号参数设置为对应数据表的“表单序号” ， 表单数据属性 XML设置为空。调用接口后，根据接口的返回值判断是否生成成功，如成功，则重新绑定列表数据的显示，如未成功（接口返回值为 0） ，则弹出提示信息“数据表生成失败，请检查数据属性设置”

23、；5点击列表上的“编辑”链接，将当前数据表序号作为页面输入参数调用界面，页面转向到数据表编辑；6点击列表上的“删除”链接，调用（SJB-7）接口将当前数据表删除，调用接口时， 表单序号参数设置为当前数据表对应的“表单序号” ，并根据接口的返回值判断是否删除成功，如未删除成功，给出提示“数据表删除未成功，请稍候重新操作” ；如删除成功，重新绑定列表数据的显示；7点击列表上方的“查询”按钮时，调用（SJB-1）接口获取当前操作用户有权限维护的所有数据表信息，同第 1 步操作规则，不同的是，如果输入的查询条件不为空，则调用接口时， 基本过滤条件 XML参数需增加构建表单名称节点，节点值为查询条件文本

24、框中输入的文字；8点击列表上方的“删除”按钮时，循环当前选中的数据表序号，调用（SJB-7）接口，调用接口时， 表单序号参数设置为当前循环的数据表序号，并根据接口的返回值判断是否删除成功，如未删除成功，记录未删除成功的数据表序号，调用（SJB-2）接口获取到数据表表单名称，拼出提示信息“以下数据表删除未成功，请稍候重新操作。 ” 换行符 未删除成功的数据表名称（多个之间用逗号分隔） ；无论删除是否成功，重新绑定列表数据的显示；3.1.3.6.输出输出3.1.3.7.调用说明调用说明3.1.3.8.程序文件程序文件程序路径：./PduOA6_TableManage /tbl_DataTable_

25、List.aspx类名称tbl_DataTable_List平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage /tbl_DataTable_List.aspx3.1.4. 数据表编辑数据表编辑3.1.4.1.功能描述功能描述新增数据表，及对数据表的数据属性进行编辑。对指定的数据表及其数据属性进行编辑。3.1.4.2.输入输入【界面】名称名称类型类型说明说明sDataTableIdString数据表序号，页面输入参数，为null或空时，表示数据表的新增3.1.4.3.界面界面3.1.4.3.1. 数据表管理框架数据表编辑 数数据据表表单单管管理理数数据据表表单

26、单管管理理数据表信息数据表名称：输入/显示保存数据表说明：输入 / 显示嵌入数据属性编辑/浏览控件返回所属分类：显示数据表单导航 刷新数据表单导航类型A 1分类B 8分类 0分类管理未分类12-3.1.4.3.2. 数据表编辑 数据表信息数据表名称：输入/显示保存数据表说明：输入 / 显示嵌入数据属性编辑/浏览控件返回所属分类：显示3.1.4.4.页面操作说明页面操作说明1界面是由和组成。2界面是（数据表管理框架）公用页面，界面是（数据表导航）公用页面，界面是数据表编辑页面，以下界面操作及业务规则是针对界面来描述的。3点击“保存”按钮，需校验数据表名称输入是否为空，如果为空，则需要提示“请输入

27、数据表名称” ，并终止操作；4点击“保存”按钮保存成功后，转向到“数据表列表”页面（界面） ；5点击“返回”按钮，弹出确认提示“您确定要不保存返回吗？” ，确定后转向到“数据表列表”页面（界面） ；3.1.4.5.业务规则说明业务规则说明1首先初始化编辑页面数据的显示。如果“数据表序号”输入参数值不为空，则调用（SJB-1）接口获取当前数据表的详细信息（包括“表单序号” 、 “表单名称” 、 “表单描述” 、 “所属分类序号” 、 “系统标志” 、 “实际表名” 、 “数据属性 XML” ） ，调用接口时， 基本过滤条件 XML参数中只构建表单序号节点，节点值为“数据表序号”输入参数值， 权限

28、过滤条件XML参数设置为空。 需返回的结果属性项 XML参数构建“表单序号” 、“表单名称” 、 “表单描述” 、 “所属分类序号” 、 “系统标志” 、 “实际表名” 、“数据属性 XML”等标识；2页面中所属分类区域的下拉框数据调用（SJBFL-1）接口获取“所有数据分类信息 XML” （包括“分类序号” 、 “分类名称” ）进行绑定显示，在绑定数据时，下拉框的显示名称为“分类名称” ，对应值为绑定分类的“分类序号” ，另外，下拉框的第一项的名称固定设置为文字无分类 ，对应选项值设置为空。在调用接口时， 基本过滤条件 XML参数中构建“”条件节点，节点值设置为0 ， 权限过滤条件 XML参

29、数设置为空， 所属分类下拉框的选项值按照以下情况进行显示：2.1如果“数据表序号”输入参数值为空，则所属分类下拉框的选项值固定选中为第一项，即无分类选项；2.2如果“数据表序号”输入参数值不为空，则将所属分类下拉框中选项值等于该数据表的“所属分类序号”的选项设置为选中；3页面中红色标识区域为数据表数据属性编辑区，该区域数据由（数据属性编辑）控件来装载，控件的初始化根据以下情况来进行：3.1如果“数据表序号”输入参数值为空，则控件的数据属性 XML参数设置为空， 只读标志设置为 false， 已生成标志设置为 false；3.2如果“数据表序号”输入参数值为空，则控件的数据属性 XML参数设置为

30、“数据属性 XML” ， 只读标志参数设置为 false，根据“实际表名”的值，如果非空，则已生成标志参数设置为 true，如果为空，则已生成标志参数设置为 false；4点击“保存”按钮，调用（SJB-4）接口保存分类信息，调用接口时， 数据表保存信息 XML参数按照如下规则构建各节点及各节点的值：4.1表单序号节点：“数据表序号”输入参数值；4.2表单名称节点：界面上“数据表名称”的输入值；4.3表单描述节点：界面上“数据表说明”的输入值；4.4所属分类序号节点：界面上“所属分类”选中的选项值；4.5系统标志节点：固定设置为0 ；4.6实际表名节点：之前获取的“实际表名”值；4.7 数据属

31、性 XML：通过（数据属性编辑）控件的属性获取；4.8协作类型节点：固定设置为0 ；3.1.4.6.输出输出3.1.4.7.调用说明调用说明3.1.4.8.程序文件程序文件程序路径：./PduOA6_TableManage /tbl_DataTable_Edit.aspx类名称tbl_DataTable_Edit平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage /tbl_DataTable_Edit.aspx3.2.公用页面公用页面3.2.1. 数据表管理框架数据表管理框架3.2.1.1.功能描述功能描述数据表管理框架公用页面主要用来载入数据表单导航公用页面

32、以及在数据表单导航页面中指向的各功能页面。任何与数据表管理相关的功能操作都在此框架页面中进行。3.2.1.2.输入输入无3.2.1.3.界面界面3.2.1.3.1. 数据表单管理框架数数据据表表单单管管理理数数据据表表单单管管理理数据表单列表数据表B数据表A数据表名称21工作表单编辑 删除编辑 删除操作删除无分类B分类A所属分类未生成已生成生成标志510数据属性输入表单名称查询点击生成非系统系统表单类型新增共有xxx条记录 第0/0页 首页 上一页 下一页 尾页 跳转到 页 GO 点击取消生成数据表单导航 刷新数据表单导航类型A 1分类B 8分类 0分类管理未分类12-3.2.1.4.页面操作

33、说明页面操作说明1页面分为左中右两个区域，左区载入数据表单导航公用页面，中间区域为框架控制功能条，右区载入导航页面所指向的功能页面，右区默认载入的为（3.1.3 数据表列表）功能页面。2点击中间区域为框架控制功能条，将左区框架隐藏，再次点击，将左区框架显示。3左区框架宽度为 120 像素。中间框架宽度为 5 像素。4左区中的链接目标框架为右区框架。3.2.1.5.业务规则说明业务规则说明3.2.1.6.输出输出3.2.1.7.调用说明调用说明3.2.1.8.程序文件程序文件【主框架页面】程序路径：./PduOA6_TableManage /tbl_DataTableMgr_Frame.aspx

34、类名称tbl_DataTableMgr_Frame平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage /tbl_DataTableMgr_Frame.aspx【中间框架页面】程序路径：./PduOA6_TableManage /tbl_DataTableMgr_Middle.aspx类名称tbl_DataTableMgr_Middle平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage /tbl_DataTableMgr_Middle.aspx3.2.2. 数据表单导航数据表单导航3.2.2.1.功能描述功能描述该页面列出所有数据表单分类以及固定的未分类节点，在每个表单分类下列出当前操作用户有权限进行维护的数据表单。通过该导航页面，根据当前操作用户的权限，可以通过点击不同的导航节点转向数据表分类管理、数据表编辑以及数