文档信息管理·十五

     第17章 文档信息管理

     关键词：系统集成，项目文档编制和管理，可行性研究，软件需求说明书，概要设计说明书

信息管理（Information Management，IM）是人类为了有效地开发和利用信息资源，以现代信息技术为手段，对信息资源进行计划、组织、领导和控制的社会活动。简单地说，信息管理就是人对信息资源和信息活动的管理。信息管理是指在整个管理过程中，人们收集、加工和输入、输出的信息的总称。信息管理的过程包括信息收集、信息传输、信息加工和信息储存。

本章重点讨论的题目包括：信息系统项目相关信息文档含义、文档种类和文档编制规则和方法。

1 信息系统项目相关信息文档含义

信息系统相关信息文档是指某种数据媒体其中所记录的数据。

文档：一种数据媒体和其上所记录的数据。它具有永久性并可以由人或机器阅读。通常用于描述人工可读的内容。

文档与文档编制：一个或多个相关文档的集合。

文档计划：一个描述文档编制工作方法的管理用文档。该计划主要描述要编制什么类型的文档，这些文档的内容是什么，何时编写，由谁编写，如何编写以及什么是影响期望结果的可用资源和外界因素。

文档等级：对需要文档的一个说明，它指出文档的范围、内容、格式及质量，可以根据项目、费用、预期用途、作用范围或其它因素选择文档等级。

软件产品：软件开发过程的结果，并退出供用户使用的软件实体。

2 信息系统项目相关信息文档种类

软件开发过程申编下述14个文件：

可行性研究报告、项目开发计划、软件需求说明书、数据要求说明书、

总体设计说明书、详细设计说明、数据库设计说明书、用户手册、

操作手册          、模块开发卷    、测试计划          、测试分析报告、

开发进度表       、项目开发总结。

（1）可行性研究报告

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.可行性研究前提

2.1要求

2.2目标

2.3条件、假定和限制

2.4进行可行性研究的方法

2.5评价尺度

3.对现有系统的分析

3.1数据流程和处理流程

3.2工作负荷

3.3消费开支

3.4人员

3.5设备

3.6局限性

4.所建议的系统

4.1对所建议系统的说明

4.2数据流程和处理流程

4.3改进之处

4.4影响

4.4.1对设备的影响

4.4.2对软件的影响

4.4.3对单位机构的影响

4.4.4对系统运行的影响

4.4.5对开发的影响

4.4.6对地点和设施的影响

4.4.7对经费开支的影响

4.5局限性

4.6技术条件方面的可行性

5.可选择的其他系统方案

5.1可选择的其他系统方案1

5.2可选择的其他系统方案2

6.投资及收益分析

6.1支出

6.1.1基本建设投资

6.1.2其它一次性支出

6.1.3非一次性支出

6.2收益

6.2.1一次性收益

6.2.2非一次性收益

6.2.3不可定量的收益

6.3收益/投资比

6.4投资回收周期

6.5敏感性分析

7.社会条件方面的可行性

7.1法律方面的可行性

7.2使用方面的可行性

8.结论

****************************************************************************

（2）项目开发计划

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.项目概述

2.1工作人员

2.2主要参加人员

2.3产品及成果

2.3.1程序

2.3.2文件

2.3.3服务

2.3.4非移交产品

2.4验收标准

2.5完成项目的最迟期限

2.6本计划的审批者与批准者

3.实施总计划

3.1工作任务的分析

3.2接口人员

3.3进度

3.4预算

3.5关键问题

4.支持条件

4.1计算机系统支持

4.2需要用户承担的工作

4.3需由外单位提供的条件

5.专题计划要点

****************************************************************************

（3）软件需求说明书

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.任务概述

2.1目标

2.2用户特点

2.3假定的约束

3.需求规定

3.1对功能的规定

3.2对性能的规定

3.2.1精度

3.2.2时间特性要求

3.2.3灵活性

3.3输入输出要求

3.4数据管理要求

3.5故障处理要求

3.5其他专门要求

4.运行环境规定

4.1设备

4.2支撑软件

4.3接口

4.4控制

****************************************************************************

（4）数据要求说明书

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.数据的逻辑描述

2.1静态数据

2.2动态输入数据

2.3动态输出数据

2.4内部生成数据

2.5数据约定

3.数据库的采集

3.1要求的范围

3.2输入的承担者

3.3处理

3.4影响

****************************************************************************

（5）概要设计说明书

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.总体设计

2.1运行环境

2.2基本设计概念和处理流程

2.3结构

2.4功能需求与程序的关系

2.5人工处理过程

2.6尚未解决的问题

3.结构设计

3.1用户接口

3.2外部接口

3.3内部接口

4.运行设计

4.1运行模块组合

4.2运行控制

4.3运行时间

5.系统数据结构设计

5.1逻辑机构设计要点

5.2物理构设计要点

5.3数据结构设计要点

6.系统出错处理设计

6.1出错信息

6.2补救措施

6.3系统维护设计

****************************************************************************

（6）详细设计说明书

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.程序系统的组织结构

3.程序1（结构符）设计说明

3.1程序描述

3.2功能

3.3性能

3.4输入项

3.5输出项

3.6算法

3.7流程逻辑

3.8接口

3.9存储分配

3.10注释设计

3.11限制条件

3.12测试设计

3.13尚未解决的问题

4.程序2（标识符）设计说明书

****************************************************************************

（7）数据库设计说明书

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.外部设计

2.1标识符和状态

2.2使用它的程序

2.3约定

2.4专门指导

3.结构设计

3.1概念结构设计

3.2逻辑

3.3物理结构设计

3.4运用设计

4.1数据字典设计

4.2安全保密设计

****************************************************************************

（8）用户手册

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.用途

2.1功能

2.2性能

2.2.1精度

2.2.2时间特性

2.2.3灵活性

3.运行环境

3.1硬环境

3.2支撑软件

3.3数据结构

4.使用过程

4.1安全与初始化

4.2输入

4.2.1输入数据的现实背景

4.2.2输入格式

4.2.3输入举例

4.3输出

4.3.1输出数据的现实背景

4.3.2输出格式

4.3.3输出举例

4.4文卷查询

4.5出错处理与恢复

4.6终端操作

****************************************************************************

（9）操作手册

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.软件的结构

2.2程序表

2.3文卷表

3.安装与初始化

4.运行说明

4.1运行表

4.2运行步骤

4.3运行1（标识符）说明

4.3.1运行控制

4.3.2操作信息

4.3.3输入文段

4.3.4输出文段

4.3.5输出文段的控制

4.3.6启动恢复过程

4.4运行2（标识符）说明

……

5.非常过规程

6.远程过程

****************************************************************************

（10）模块开发卷宗

模块开发卷宗是在模块开发过程中逐步编写出来的。每完成一个模块或一组密切相关的模块，复审时编写出一份，应该把所有的模块开发卷宗汇集在一起。编写的目的是记录和汇总低层次开发的进度结果；以便于对整个系统开发工作进行管理的复审，并未将来的维护提供有用的信息。

****************************************************************************

1.标题

2.模块开发情况表

3.功能说明

4.设计说明

5.源代码清单

6.测试说明

7.复审的结论

****************************************************************************

（11）测试计划

测试指的是整个软件系统的组装测试和去人测试，本文件的便只是为了提供一个对该软件的测试计划。包括对每项测试活动的内容、进度安排、设计考虑、测试数据的整体性方法及评价准则。

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.计划

2.1测试说明

2.2测试内容

2.3测试1（标识符）

2.3.1进度安排

2.3.2条件

2.3.3测试资料

2.3.4测试培训

2.4测试2（标识符）

……

3.测试设计说明

3.1测试1（标识符）

3.1.1控制

3.1.2输入

3.1.3输出

3.1.4过程

3.2测试2（标识符）

……

4.评价准则

4.1范围

4.2数据整理

4.3尺度

****************************************************************************

（12）测试分析报告

测试分析报告的母的是为了吧组装测试he确认测试的结果、发现的问题以及分析结果写出成文件形式加以保存。

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.测试概要

3.测试结果及发现

3.1测试1（标识符）

3.2测试2（标识符）

……

4.对软件功能的结论

4.1功能1（标识符）

4.2能力

4.3限制

4.2功能2（标识符）

……

5.分析摘要

5.1能力

5.2缺陷和限制

5.3建议

5.4评价

6.测试资源消耗

****************************************************************************

（13）开发进度月报

****************************************************************************

1.标题

2.工程进度与状态

2.1进度

2.2状态

3.资源耗用与状态

3.1资源耗用

3.1.1工时

3.1.2机时

3.2状态

4.经费支出与状态

4.1经费支出

4.1.1支出性费用

4.1.2设备购置费

4.2状态

5.下个月的计划

6.建议

****************************************************************************

（14）项目总结报告

****************************************************************************

1.引言

1.1编写目的

1.2背景

1.3定义

1.4参考资料

2.实际开发结果

2.1产品

2.2主要功能和性能

2.3基本流程

2.4进度

2.5费用

3.开发工作评价

3.1对生产效率的评价

3.2对产品质量的评价

3.3对技术方法的评价

3.4出错原因的分析

4.经验与教训

***************************************************************************

3 信息系统项目相关信息文档规则和方法

文档编制是开发过程的有机组成部分，也是一个不断努力的工作过程，是一个从形成最初轮廓、经反复检查和修改。直至程序和文档正式交付使用的完整过程。

参考文献

薛大龙，刘春淼.系统集成项目-管理工程师教程[M].电子工业出版社2012.7:1-382