「江苏开放大学软件文档形考三」.doc

江苏开放大学形成性考核作业 学 号: 20 姓 名: 课程代码: 110121 课程名称: 软件文档编写 评阅教师: 第 3 次任务共 3 次任务考试资料作业说明：1.做作业之前首先在封面填上自己的学号和姓名，做完作业后请写上作业完成时间。2.学习完第六、七、八单元知识后必须完成本次作业，并请在规定时间内通过学习平台提交Word文档形式的电子作业，本次作业占形成性考核总成绩的40%。作业内容：一、填空题（每题2分，共20分）1、软件产品文档包括软件用户手册、_软件操作手册_、软件产品规格说明书和软件版本说明。2、软件文档的管理过程分为文档的形成、标识文档类型、_文档的控制_和文档的修改管理这4个部分。3、文档修改活动大致可以分为建议、评议、_审核_、批准和实施这5个步骤：4、软件文档的管理，可以从技术角度和_管理_角度提出和形成各自有效的管理方法。5、从技术角度，文档的管理维护有两种方式：采用手工、静态的管理方式和_采用新方法、新工具_。6、由于软件文档的对象复杂性，将面向对象技术和分布式系统管理思想结合，作用在对分布式符合文档的对象管理上，产生了两个新的重要概念：域和_访问规则_。7、将系统中具有相似属性的成员集合，以形成_管理域_。8、_动态_文档是由各种文档元素对象(文字、图形、图像、工作表等)以及一些控制信息组成。9、Microsoft Visio是一款专业的关于图标解决方案的办公绘图软件，其具有_简单性_和便捷性等特性。10、Microsoft Visio提供了各种模板，包括业务流程的流程图、网络图、工作流图、_数据库模型图_和软件图等。二、问答题（每题5分，共30分）1、请简述编制产品文档的基本要求有哪些？产品文档面向的是软件产品的具体用户和维护人员等，因此编制的文档应该通俗易懂，避免使用生僻的专业术语。1、 描述规范准确2、 叙述简练生动3、 语言严密严实4、 内容系统完整2、请简述一般操作手册应包含哪些内容。操作手册是指导用户具体操作的文档手册，提供操作指定的计算机及其外部设备所需的信息操作手册的内容和形式也有不同，形式上有技术指导书、操作规程等类型，内容伸缩性较大。一般应包含下列内容：1、引言 2、操作原理 3、操作说明 4、注意事项 5、附录3、目前许多CASE系统都提供文档支持和管理工具，其中比较典型的原型系统有哪些？ HyperCASE、CONIC、SystemFactorroject、青鸟系统4、请简述软件文档的维护一般有哪些形式？改正性维护适应性维护完善性维护预防性维护5、 请简述动态文档包括哪些内容？动态文档是有各类文档元素对象（文字、图形、图像、工作表等）以及一些控制信息组成，包括以下内容：1、文档对象信息2、文档行为信息3、文档的附加信息4、链接6、请列举出现在市面上常见的项目管理软件。市面上常见的项目管理软件大致可以按照用户对象分为两个档次：1、专供项目管理人士使用的高档项目管理软件。售价一般在2000美元以上。如Primaver公司的P3、Gores公司的Artemis、ABT公司的WorkBench和Welcom公司的OpenPlan等.2、价格便宜的低档项目管理软件。这类软件功能一般不太齐全.适用于中小项目。如Time Line、ProjectScheduler、SureTrak、Prject2000等。三、操作编写题（每题25分，共50分）1、使用Microsoft Visio进行绘图，参照开放平台课程辅导中第八单元中所给的文档范例，编制并完善浙江省高评委专家库信息管理系统的概要设计说明书。（不能直接从PDF截图，要在PDF的基础上进行详细的扩充，并编写在此word文档中）。高评委专家库信息管理系统文档编制本附录以浙江省高评委专家库信息管理系统 (Expert 2002) 为实例介绍概要设计说明书和详细设计说明书的编制， 因篇幅有限， 不能提供详细文档， 仅供学习文档写作时参考。 本软件已获国家版权局计算机软件著作权 (登记号： 200217443) ， 并获第三届浙江省人事科研成果一等奖和第四次全国人事科研成果二等奖。 图 B1 为系统的启动界面。本系统文档编号由文档字母标志、 软件项目名称、 文档类型、 文档生成日期等组成，如概要设计说明书的编号为： W13_EXPERT_SSD_020830 ， 详细设计说明书的编号为：WD_EXPERT_DSD_020930 。图 B1 系统启动界面文档编号： WD_EXPERT_SSD_020830实用软件文档写作版 本 号： V1.0概要设计说明书项目名称 浙江省高评委专家库信息管理系统（ Expert 2002 ）项目负责人 张 元 鸣 项目开发单位 浙江工业大学、 杭州时空信息技术有限公司 2002 年 8 月 30 日高评委专家库信息管理系统文档编制概要设计说明书修改历史记录表如表 B1 所示。表 B1 概要设计说明书修改历史记录设计状态摘要设计人设计日期审核人审核日期批准人批准日期创建张元鸣2002.8.30实用软件文档写作目 录一、 引言1 目的2 背景3 参考资料二、 总体设计I 需求规定2 运行环境3 基本设计概念和处理流程4 结构5 功能需求与程序的关系三、 接口设计1 用户接口2 外部接口3 内部接口四、 系统数据结构设计五、 数据结构与程序的关系六， 系统出错处理设计1 出错信息2 补救措施高评委专家库信息管理系统文档编制1、 引言1 目的本文档将概要描述浙江省高评委专家库信息管理系统中的功能模块， 主要包括专家管理、 查询统计、 打印、 评委抽取、 系统维护、 用户管理。2 背景为进一步深化职称改革， 完善专业技术职务聘任制度， 建立健全公开、 公平、 公正的人才评价机制， 推进评审工作社会化， 按照专业技术资格评价和管理办法要求， 浙江省人事厅决定组建全省跨行业、跨地区、 跨部门的高级专业技术职务任职资格评审委员会专家库。 浙江工业大学、 杭州时空信息技术有限公司受浙江省人事厅委托开始研制浙江省高级专业技术职务任职资格评审委员会专家库信息管理系统(以下简称浙江省高评委专家库信息管理系统 )， 系统主要用于高评委专家库专家的管理和每年度的评审委员会和评议组专家的随机抽取。3 参考资料需求说明书 。系统功能说明书 o浙江省人事厅关于组建高级专业技术职务任职资格评审委员会专家库有关事项的通知 (浙人专(2002)148 号)。项目委托书 。S二、 总体设计1 需求规定本系统完成高评委专家库中专家的信息管理、 每年度评审委员会及评议组的随机抽取以及相关的辅助功能， 包括数据上报、 专家查询统计、 工作证打印、 聘书打印、 高评委以及专业组的新建等， 如表B2 所示。表 B2 高评委专家库信息管理系统内容系 统 名 称模 块功 能 浙江省高评委专家库信息管理系统专家管理信息浏览、 专家录入、 专家删除、 数据导入、 数据导出查询统计简单查询、 综合查询、 综合统计打印花名册打印、 工作证打印、 专家聘书打印评委抽取委员会抽取、 评议组抽取系统维护高评委的新增、 删除和修改； 评议组的新增、 删除和修改；代码维护， 专家历史任职维护用户管理用户设置、 修改密码2 运行环境(1) 硬件平台硬件最低要求： CPU P 500 以上 PC 服务器， 内存 128MB 以上， 硬盘 4GB 以上。(2) 软件平台操作系统： Windows98 、 Windows NT 、 Windows 2000 、 Windows XP 。数据库系统： SQL Server 7 0、 SQLServer2000( 企业版、 个人版 )。(3)开发环境Delphi 5 5。实用软件文档写作3 基本设计概念和处理流程本系统主要的业务处理流程如图 B2 所示。4 结构系统功能结构如图 B3 所示。(1)系统维护模块本子系统主要完成专家库中高评委的新建、 修改、 撤销； 每个高评委下专业组的添加、 修改、 撤销； 数据库代码维护， 专家历史任职维护以及树视图定制。新建高评委有两种方式： 按专业(学科)组建； 按现有专业技术职务系列和所设的职务类别或相近专业(二级学科)类别组建。 在第一种组建方式中下设若干专业审议组： 在第二种组建方式中不设专业审议组， 其委员人选应在 60 人以上。新建专家组用于在高评委下设置新的专家组， 为了数据维护和数据交换方便， 专家组统一编码，设置新的专家组时需要从专家组代码库中选取。代码维护是对数据库中使用的代码表进行添加， 删除以及修改， 以保证系统正确有效地运行。任职维护是对专家的历史任职进行维护， 主要包括浏览、 删除等。树视图定制是实现专家人员动态分类管理的途径， 通过该模块用户可以定制树视图， 方便用户管理。高评委专家库信息管理系统文档编制(2)专家管理模块信息浏览模块是专家管理的主要部分， 通过信息浏览模块可以浏览系统的主要信息， 包括高评委信息、 高评委下专家组信息以及人员的基本信息和历史任职信息等， 此外， 通过信息浏览可以修改专家的基本信息和照片， 可以彻底删除专家成员： 另外还提供人员查找功能和打印功能。专家录入模块包括专家基本信息录入和照片获取， 该模块要提供良好的用户交互界面， 如采用代码树方便用户选择基本选项， 出生年月和性别可以从身份证自动读出。 为了提高输入效率， 模块采用自动记忆功能， 基本信息自动记忆上一个人的基本信息， 提高录入效率。专家删除模块根据实际需要设置两种删除方式： 专家移入历史库和从数据库中彻底删除。 该模块要提供集合操作方式。数据导出、 数据导入模块提供数据交换功能， 以 Access 为中间文件， 可以用于数据备份， 也可用于数据报盘系统。(3)查询统计模块简单查询； 首先选择查询的范围 (当前专家库、 历史专家库和所有专家库 )， 然后指定单个信息项进行查询。综合查询： 多字段联合查询。 可以对专家库中的专家的多个信息项进行联合查询， 该模块提供模板功能， 可以把常用的查询保存为模板， 方便用户以后使用。综合统计： 为了实现较灵活的统计， 本统计分为一维统计和二维统计。 所谓的一维统计就是统计结果是一维的， 只有水平方向。 二维统计分为水平统计项和垂直统计项， 使用时， 用户要先规划好统计的表格， 然后先形成水平统计项， 再形成垂直统计项。 另外本模块还提供了模板功能， 把常用的统计方案保存为统计模板。(4)评委抽取模块人员抽取是本系统的重点。 在当前的某高评委专家库中随机抽取若干人组成高级专业评审委员会。本模块强调抽取的随机性。 抽取的原则是：主任委员从 3 名主任委员候选人中抽取， 副主任委员从未抽到的两名主任委员和 3 名副主任委员候选人中抽取， 委员从未抽取到的主任委员候选人和副主任委员候选人及委员候选人中抽取。专业评议组从专业评议候选人中抽取， 其中组长是本年度委员， 委员和专家组成员可重复。正副高级合一的评委会， 正高级的专家应占 2 3。评委会中 45 周岁以下的评委占 1 3。评审对象为本单位或系统范围内以本单位为主的评委会， 外单位同行专家应大于 1 2。上一年度执行评委应随机保留 1 2， 另 1 2 从专家库其他成员中随机抽取。抽取结果为： 主任委员一名， 副主任委员 12 人， 委员约 23 名， 每个评议组约 7 人。抽取算法如下。Step1 ： 随机抽取上一年度执行评委的 1 2 作为该次的评审委员。Step2： 抽取主任委员一名。Step3 ： 抽取副主任委员一名或两名 (或数字由用户输入 )。Step4： 抽取委员 10 名(或数字由用户输入 )。Step5 ： 循环抽取每个专业组成员 7 名(或数字由用户输入 )。Stcp6： 输出该次抽取名单。Step7 ： 结束抽取。(5)用户管理模块用户管理模块包括两部分。设置用户： 主要功能包括增加用户， 设置相应的用户账号和登录密码， 删除用户， 修改用户名。该模块只有系统管理员权限的用户才能够操作。修改密码： 针对每个用户来设置； 每个用户都可以修改自己的登录密码。(6)打印模块打印模块的设置主要考虑专家管理的特殊性， 主要设置花名册打印、 委员聘书打印、 工作证打印 3个模块。5 功能需求与程序的关系功能需求与程序的关系如表 B3 所示。三、 接口设计1 用户接口本系统采用图形用户接口， 以鼠标和键盘为用户接口， 方便用户对专家数据的操作， 此外采用动态树视图技术， 满足不同用户对专家库中专家的分类管理需求。2 外部接口本系统提供基于 Access 的数据导入和导出功能， 方便各高评委单位和人事厅专技处的数据交换。3 内部接口系统基于 C S 模式开发， 系统与数据库服务器之间以 BDE 连接。 保证数据库系统的物理独立性。四、 系统数据结构设计限于篇幅， 这里仅给出本系统设计主要表的逻辑结构， 其他相关代码表结构在此从略。(1) 基本信息（ expert_baseinfo ） (见表 B4)(2) 高评委专家照片信息 (expert_picture) ( 见表 B5)表 B5 高评委专家照片信息表(7) 专家成员历史任职情况表 (expert_history) ( 见表 B10)表 B10 专家库成员历史任职情况表五、 数据结构与程序的关系说明各个数据结构与访问这些数据结构的形式， 如表 B12 所示。表 B12 功能模块与相应数据表之间的关系表六、 系统出错处理设计1 出错信息系统应对以下错误做出正确处理：无法与数据库连接时， 若不能够正确连接， 则应做出正确处理。专家入库前必须建立相应的高评委和专业时， 若不满足条件， 则应做出正确处理。随机抽取委员会及评议组时， 必须对抽取结果的各种可能状态以及无法满足抽取条件时做出正确处理。2 补救措施提示数据库无法连接信息。若要把专家加入某个高评委下， 则必须先新建高评委， 以及新建高评委下的专业组， 若不满足该条件， 则提示用户必要的信息。提示无法抽取的各种情况， 以使用户明确无法抽取的原因。2、使用Microsoft Visio进行绘图，参照开放平台课程辅导中第八单元中所给的文档范例，编制并完善浙江省高评委专家库信息管理系统的详细设计说明书。（不能直接从PDF截图，要在PDF的基础上进行详细的扩充，并编写在此word文档中）。文档编号： WD_ EXPERT _DSD_020930版 本 号： V1.0详细设计说明书项目名称 浙江省高评委专家库信息管理系统（ Expert 2002 ）项目负责人 张 元 鸣 项目开发单位 浙江工业大学、 杭州时空信息技术有限公司 2002 年 9 月 30 日详细设计说明书修改历史记录表如表 B13 所示。表 B1 3 详细设计说明书修改历史记录设计状态摘要设计人设计日期审核人审核日期批准人批准日期创建张元鸣2002.9.30目 录一、 引言1 编写目的2 背景3 定义4 参考资料二、 程序系统的结构三、 程序设计说明1 程序描述2 功能3 性能4 输入项5 输出项6 算法7 流程逻辑8 接口9 存储分配10 注释设计11 限制条件12 测试计划一、 引言1 编写目的本文档是程序员代码编写的基础。 本文档的读者是设计人员和程序员。2 背景待开发的软件系统的名称： 浙江省高评委专家库信息管理系统。本项目的任务提出者： 浙江省人事厅专业技术人员管理处。开发者： 浙江工业大学、 杭州时空信息技术有限公司。用户： 浙江省各高评委单位。3 定义高评委： 高级专业技术职务任职资格评审委员。4 参考资料浙江省人事厅关于组建高级专业技术职务任职资格评审委员会专家库有关事项的通知 (浙人专(2002) 148 号) 。项目委托书系统功能说明书 。需求说明书 。概要设计说明书 。二、 程序系统的结构本系统屏幕功能区域设计如图 B4 所示。 图 B4 屏幕功能区域设计本系统每个子系统所包含的单元文件名称及其程序层次结构如表 B14 所示， 对于特别简单的程序模块， 其程序层次结构非常简单， 在此从略， 仅给出较为复杂的程序层次结构。表 B1 4 程序层次结构图三、 程序设计说明1 程序描述限于篇幅， 本程序设计说明仅以“新建高评委模块” 为例说明如何书写程序设计说明， 其他模块可参考本设计说明。“新建高评委模块” 用于