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

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.编写目的本设计说明书描述LKOA6.0产品中某功能模块实现的详细说明，仅供开发及测试人员阅读。1.2.设计功能概述1.3.背景说明：

2、1.LKOA6.0产品某功能模块2.任务提出者：公司内部。1.4.定义列出本文件中用到专门术语的定义和外文首字母组词的原词组。1.5.参考资料1.联达动力开发规范1.6.编码注意事项本详设文档中涉及到数据逻辑描述的Sql语句仅作为数据获取逻辑准则，因未考虑其执行的性能及效率，不建议直接作为开发编码中实际的Sql语句进行使用，也不能作为衡量开发编码部分完成的标准。请开发人员根据实际情况以及涉及的数据量灵活变通。2. 程序系统的结构命名空间：LinkPower.PduOA6.Mod.TableManage程序集LinkPower.PduOA6.Mod.TableManage页面程序路径：PduOA

3、6TableManageVss路径：$/LKOA6/SourceCode/Module/Mod_TableManage/DotNet/LinkPower.PduOA6.Mod.TableManage3. 详细设计说明3.1. 表单应用数据表管理3.1.1.数据表分类列表3.1.1.1.功能描述本功能主要用于显示和管理数据表分类。判断操作用户的权限，具备权限的用户方可进行数据表分类的维护和管理。3.1.1.2. 输入311.3.界面3.1.131.数据表管理框架一分类图一分类B分类未分类回分类名称分类描述相关数据表操作回行政管理类行政管理适用1排序编辑删除回行文格式国标类（财务、审计、税务等适用

4、9排序",编辑删除显示在显示其他分类7之前F关闭数据表单分类列表3.1.1.4.页面操作说明1界面图一是由图二和图三组成。2 界面图一是（数据表管理框架）公用页面，界面图二是（数据表单导航）公用页面，界面图三是数据分类列表页面，以下界面操作及业务规则是针对界面图三来描述的。3 点击“新增”按钮以及列表上的“编辑”链接，页面转向到界面图四。4 点击“删除”按钮以及列表上的“删除”链接时，提示“您确定要删除分类吗？”，如果点击“删除”按钮时，列表上未选中任何一项分类，则提示“请选择要删除的分类”。5 界面上黄色背景区域为排序浮动层界面，默认不显示，点击列表上的“排序”链接时才显示，点击排

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

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

7、的数据源。调用接口时，'基本过滤条件XML'参数中构建“<IncludeCondXml>TvKindFlag>”条件节点，节点值设置为'0''权限过滤条件XML'参数值设置为空；4 点击列表上的“排序”链接，显示排序浮动层界面，浮动层界面装载时，首先清除浮动层界面中下拉框的所有数据，然后循环“所有数据表分类信息XML”中的所有数据表分类，将其绑定到下拉框中进行显示（绑定时，下拉框的选项名称为'分类名称'，选项值为'显示顺序'），循环绑定的过程中，如'分类序号'等于当前记录对应的分类

8、序号，则该项分类信息不能绑定到下拉框，该分类的下一个分类信息绑定到下拉框时设置为选中，如果当前记录对应的分类在“所有数据表分类信息XML”中的最后一项，则下拉框默认选中最后一个分类；5 点击排序浮动层界面的“确定”链接，调用（SJBFL-4）接口调整分类的显示顺序，调用接口时，'分类序号'参数设置为当前分类序号，'原顺序'参数设置为当前分类显示顺序，'新顺序'参数设置为排序浮动层界面下拉框选中的选项值，接口调用完毕后，重新装载列表数据和排序浮动层所需的数据源，即执行第1、2、3规则；6 点击列表上的“编辑”链接，将当前分类序号作为页面输入参数调用

9、界面<图四>，页面转向到数据表分类编辑；7 点击列表上的“删除”链接，调用（SJBFL-6）接口将当前分类删除，调用接口时，分类序号'参数设置为当前分类序号，并根据接口的返回值判断是否删除成功，如未删除成功，给出提示“分类删除未成功，请稍候重新操作”；8点击列表上方的“删除”按钮时，循环当前选中的分类序号，调用（SJBFL-6接口将选中的分类删除。调用接口时，分类序号'参数设置为当前循环的分类序号，并根据接口的返回值判断是否删除成功，如未删除成功，则记录未删除成功的分类序号，调用（SJBFL-2）接口获取到分类名称，拼出提示信息“以下分类删除未成功，请稍候重新操作。

10、”换行符未删除成功的分类名称（多个之间用逗号分隔）；9删除操作成功后，重新装载列表数据和排序浮动层所需的数据源，即执行第1、2、3规则3.1.1.6.输出3.1.1.7.调用说明3.1.1.8.程序文件程序路径：./PduOA6_TableManage/tbl_DataTableKind_List.aspx类名称tbl_DataTableKind_List平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage/tbl_DataTableKind_List.aspx3.1.2.数据表分类编辑3.1.2.1.功能描述新增数据表分类，或对指定的数据表分类进行编辑。完成操

11、作后保存3.1.2.2. 输入名称类型说明sKindldString分类序号，页面输入参数，为null或空时，表示数据表分类的新增。3.1.2.3. 界面3.123.1.数据表分类编辑图四3.1.2.4.页面操作说明1 点击“保存”按钮，需校验分类名称是否为空，如果为空，则需要提示“请输入分类名称”，并终止操作；2 点击“返回”按钮，转向到“数据表分类列表”页面（界面图三）；3.1.2.5.业务规则说明1 首先初始化编辑页面数据的显示。如果“分类序号”输入参数值不为空，则调用（SJBFL-1）接口获取当前分类的详细信息（包括“分类序号”、“分类名称”“分类描述”、“显示顺序”，调用接口时，&#

12、39;基本过滤条件XML'参数中只设置'分类序号'节点，节点值为当前分类序号，'权限过滤条件XML'参数设置为空；2 页面中'显示顺序'区域数据的显示。调用（SJBFL-1）接口获取“所有数据分类信息XML”，调用接口时，'基本过滤条件XML'参数中构建“vlncludeCondXmlvKindFlag>”条件节点，节点值设置为'0','权限过滤条件XML'参数设置为空，'显示顺序'区域对应的选项按照以下情况进行显示：2.1 如果“分类序号”输入参数值为空，则显示顺序&

13、#39;区域的选项选中为'显示在最后'，下拉框则绑定显示“所有数据分类信息XML”中的所有数据分类；2.2如果“分类序号”输入参数值不为空，则调用（SJBFL-3，接口获取最大顺序号，调用接口时，参数协作类型'设置为0'，参数获取标识'设置为'Z'。如当前分类的显示顺序等于最大顺序号，则'显示顺序'区域的选项选中为显示在最后'，下拉框则绑定显示“所有数据分类信息XML”中的所有数据分类；否则，显示顺序'区域的选项选中为'显示在xxxx之前'，循环“所有数据分类信息XML”中的所有数据分类绑定

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

15、39;、'显示顺序'、协作类型'等节点值，其中协作类型'节点值固定设置为0'；3.1.2.6. 输出xxxxString说明：3.1.2.7.调用说明3.1.2.8.程序文件程序路径：./PduOA6TableManage/tblDataTableKindEdit.aspx类名称tbl_DataTableKind_Edit平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage/tbl_DataTableKind_Edit.aspx3.1.3.数据表列表3.1.3.1.功能描述列出所有分类或某一分类下的数据表。具备权限的用户可

16、对列出的数据表进行增、删、改、查等操作。3.1.3.2. 输入界面图六】名称类型说明sKindIdString分类序号，页面输入参数，为null或空时，表示所有分类，为-1时显示未分类的数据表3133界面3.1.331.数据表管理框架一数据表列表图五3.1.3.32数据表列表图六-数据表名称所属分类表单类型数据属性生成标志工作表单操作数据表A分类A系统104已生成1编辑丿删1除回数据表B分类B成2心逗nmlizZ编辑删除非系统占击取謫生成未生T无占二击生成查询新增:数据表单列表输入表单名称删除AV共有xxx条记录第0/0页首页上一页下一页尾页跳转到页GO3.1.3.4.页面操作说明1界面图五是

17、由图二和图六组成。2 界面图五是（数据表管理框架）公用页面，界面图二是（数据表导航）公用页面，界面图六是数据表列表页面，以下界面操作及业务规则是针对界面图六来描述的。3 点击“新增”按钮以及列表上的“编辑”链接，页面转向到界面图八。4 点击“删除”按钮以及列表上的“删除”链接时，弹出确认提示“您确定要删除数据表吗？”，如果点击“删除”按钮时，列表上未选中任何一项分类，则提示“请选择要删除的数据表”。5 点击列表上的“已生成”链接时，弹出确认提示“您确定要取消生成该数据表单吗？”；点击列表上的“未生成”链接时，弹出确认提示“您确定要生成该数据表单吗？”3.1.3.5.业务规则说明1页面初始化时，

18、首先进行数据表信息的装载：调用（SJB-1）接口获取当前操作用户有权限维护的所有数据表信息（包括“表单序号”、“表单名称”、“表单描述”、“所属分类序号”、“显示顺序”、“系统标志”、“实际表名”、“生成标志”），将信息绑定到列表中进行显示。调用接口时，权限过滤条件XML'参数中的用户序号为当前操作用户序号（Session"UserGuid_LK"）,需返回的结果属性项XML'参数为空，如果“分类序号”输入参数为空，则'基本过滤条件XML'参数构建'协作类型'节点，节点值设置为0'否则，'基本过滤条件XML&#

19、39;参数构建'分类序号'节点，节点值为'分类序号'输入参数值；2在绑定列表数据显示时，数据表各列的数据按照以下规则显示信息：2.1 “列表选择”列（第一列）：根据“系统标志”和“生成标志”的值，当“系统标志”为1'，或者“生成标志”为1'时，列上的复选框设置为Disable；根据“工作表单”列的值，如果大于0,则列上的复选框也设置为Disable；2.2 “数据表名称”列：显示“表单名称”；2.3 “所属分类”列：根据“所属分类序号”调用（SJBFL-2）接口获取“分类名称”显示；2.4 “表单类型”列：根据“系统标志”的值，0'显示为

20、非系统'；1'显示为系统'；2.5 “数据属性”列：首先根据“表单序号”调用（SJB-2）接口获取到表单的“数据属性XML”,根据“数据属性XML”调用（SJBSX-1）接口获取“数据属性个数”进行显示；2.6 “生成标志”列：根据“生成标志”的值，0'显示为未生成'（文字以红色标识），1'显示为已生成'；2.7 “工作表单”列：根据“表单序号”调用（GZB-3）获取“相关工作表信息XML”，调用接口时，'数据表序号'参数设置为“表单序号”，'表单序号'参数设置为空。解析“相关工作表信息XML”内容中的工作

21、表节点个数作为结果进行显示；2.8 “操作”列（最后一列）：根据“系统标志”和“生成标志”的值，当“系统标志”为1'，或者“生成标志”为1'时，列上的删除'链接设置为Disable；根据“工作表单”列的值，如果大于0,则列上删除'链接设置为Disable；3点击列表上的“已生成”链接，将对应数据表进行取消生成操作，调用（SJB-6接口实现，调用接口时，表单序号'参数设置为对应数据表的“表单序号”。调用接口后，根据接口的返回值判断是否取消生成成功，如成功，则重新绑定列表数据的显示，如未成功，则弹出提示信息“数据表取消生成失败，错误信息如下：”换行符接口返回

22、信息；4 点击列表上的“未生成”链接，将对应数据表进行生成操作，调用（SJB-5接口实现，调用接口时，表单序号'参数设置为对应数据表的“表单序号”，'表单数据属性XML'设置为空。调用接口后，根据接口的返回值判断是否生成成功，如成功，则重新绑定列表数据的显示，如未成功（接口返回值为0），则弹出提示信息“数据表生成失败，请检查数据属性设置”；5 点击列表上的“编辑”链接，将当前数据表序号作为页面输入参数调用界面图八，页面转向到数据表编辑；6 点击列表上的“删除”链接，调用（SJB-7）接口将当前数据表删除，调用接口时，表单序号'参数设置为当前数据表对应的“表单序号

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

24、功，如未删除成功，记录未删除成功的数据表序号，调用（SJB-2）接口获取到数据表表单名称，拼出提示信息“以下数据表删除未成功，请稍候重新操作。”换行符未删除成功的数据表名称（多个之间用逗号分隔）；无论删除是否成功，重新绑定列表数据的显示；3.1.3.6.输出3.1.3.7.调用说明3.1.3.8.程序文件程序路径：./PduOA6TableManage/tblDataTableList.aspx类名称tbl_DataTable_List平台准备文件路径：$/LK0A6/平台准备文件/PduOA6_TableManage/tbl_DataTable_List.aspx3.1.4.数据表编辑3.1

25、.4.1.功能描述新增数据表，及对数据表的数据属性进行编辑对指定的数据表及其数据属性进行编辑。3.1.4.2. 输入界面图八】名称类型说明sDataTableldString数据表序号，的新增页面输入参数，为null或空时，表示数据表3143界面3.143.1.数据表管理框架一数据表编辑图七数据表名称:数据表说明:分类B8分类0未分类12<3.1.4.32数据表编辑图八数据表信息数据表名称：数据表说明：输入/显示所属分类：显示V输入/显示a|V嵌入数据属性编辑/浏览控件1保存I返回3.1.4.4.页面操作说明1 界面图七是由图二和图八组成。2 界面图七是（数据表管理框架）公用页面，界面图

26、二是（数据表导航）公用页面，界面图八是数据表编辑页面，以下界面操作及业务规则是针对界面图八来描述的。3 点击“保存”按钮，需校验数据表名称输入是否为空，如果为空，则需要提示“请输入数据表名称”，并终止操作；4 点击“保存”按钮保存成功后，转向到“数据表列表”页面（界面图六）；5 点击“返回”按钮，弹出确认提示“您确定要不保存返回吗？”，确定后转向到“数据表列表”页面（界面图六）；3.1.4.5.业务规则说明1首先初始化编辑页面数据的显示。如果“数据表序号”输入参数值不为空，则调用（SJB-1）接口获取当前数据表的详细信息（包括“表单序号”、“表单名称”、“表单描述”、“所属分类序号”、“系统标

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

28、的“分类序号”，另外，下拉框的第一项的名称固定设置为文字无分类'，对应选项值设置为空。在调用接口时，基本过滤条件XML'参数中构建“vlncludeCondXmlvKindFlag>”条件节点，节点值设置为'0','权限过滤条件XML'参数设置为空，'所属分类'下拉框的选项值按照以下情况进行显示：2.1 如果“数据表序号”输入参数值为空，则所属分类'下拉框的选项值固定选中为第一项，即无分类'选项；2.2 如果“数据表序号”输入参数值不为空，则将所属分类'下拉框中选项值等于该数据表的“所属分类序号”的选

29、项设置为选中；3 页面中红色标识区域为数据表数据属性编辑区，该区域数据由（数据属性编辑）控件来装载，控件的初始化根据以下情况来进行：3.1如果“数据表序号”输入参数值为空，则控件的'数据属性XML'参数设置为空，'只读标志'设置为false，'已生成标志'设置为false；3.2如果“数据表序号”输入参数值为空，则控件的'数据属性XML'参数设置为“数据属性XML”，'只读标志'参数设置为false，根据“实际表名”的值，如果非空，则'已生成标志'参数设置为true，如果为空，则已生成标志'

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

31、的属性获取;4.8 协作类型'节点：固定设置为0'；3.1.4.6. 输出3.1.4.7.调用说明3.1.4.8.程序文件程序路径：./PduOA6_TableManage/tbl_DataTable_Edit.aspx类名称tbl_DataTable_Edit平台准备文件路径：$/LK0A6/平台准备文件/PduOA6_TableManage/tbl_DataTable_Edit.aspx3.2. 公用页面3.2.1. 数据表管理框架3.2.1.1. 功能描述数据表管理框架公用页面主要用来载入数据表单导航公用页面以及在数据表单导航页面中指向的各功能页面。任何与数据表管理相关的

32、功能操作都在此框架页面中进行。3.2.1.2. 输入无3213界面32131.数据表单管理框架分类0未分类12数据表名称所属分类数据表A分类A数据表B分类B输入表单名称表单类型数据属性生成标志工作表单操作系统10A已生成非系统-点击取消生成未生成删除1击生成编辑删除编辑删除共有XXX条记录第0/0页首页上一页下一页尾页跳转到页GO3.2.1.4.页面操作说明1 页面分为左中右两个区域，左区载入数据表单导航公用页面，中间区域为框架控制功能条，右区载入导航页面所指向的功能页面，右区默认载入的为（3.1.3数据表列表）功能页面。2 点击中间区域为框架控制功能条，将左区框架隐藏，再次点击，将左区框架显

33、示。3左区框架宽度为120像素。中间框架宽度为5像素。4左区中的链接目标框架为右区框架。3.2.1.5.业务规则说明3.2.1.6.输出3.2.1.7.调用说明3.2.1.8.程序文件主框架页面】程序路径：./PduOA6TableManage/tblDataTableMgrFrame.aspx类名称tblDataTableMgrFrame平台准备文件路径：$/LK0A6/平台准备文件/PduOA6_TableManage/tbl_DataTableMgr_Frame.aspx中间框架页面】程序路径：./PduOA6_TableManage/tbl_DataTableMgr_Middle.as

34、px类名称tblDataTableMgrMiddle平台准备文件路径：$/LKOA6/平台准备文件/PduOA6_TableManage/tbl_DataTableMgr_Middle.aspx3.2.2.数据表单导航3.2.2.1.功能描述该页面列出所有数据表单分类以及固定的未分类'节点，在每个表单分类下列出当前操作用户有权限进行维护的数据表单。通过该导航页面，根据当前操作用户的权限，可以通过点击不同的导航节点转向数据表分类管理、数据表编辑以及数据表字段属性编辑等功能页面。3.2.2.2. 输入3.2.2.4.页面操作说明1点击弹出菜单中的“分类管理”，目标框架中的页面转向“数据表分类列表”页面（图三）。2点击导航树上的分类链接，目标