信息化文档编制指南(包括信息化项目建设整个生命周期内所有阶段的文档说明-很有用).ppt

信息系统的文档，是系统建设过程的“痕迹”，是系统维护人员的指南，是开发人员与用户交流的工具。标准的文档意味着系统是按照工程化开发的，意味着信息系统的质量有了形式上的保障。文档的欠缺、文档的随意性和文档的不标准，极有可能导致原来的开发人员流动以后，系统不可以维护、不可以升级，变成一个没有扩展性、没有生命力的系统。所以，为了建立一个良好的信息系统，不仅要充分利用各种现代化信息技术和正确的系统开发方法，同时还要做好文档的管理工作。

本节主要讨论的内容：

一、信息系统文档的作用与类型

二、信息系统各类文档的内容

三、信息系统文档的编制与管理;一、信息系统文档的作用与类型;l、信息系统文档的作用;文档在系统开发人员、工程管理人员、系统维护人员、系统评价人员以及用户之间的多种桥梁作用可从图

8-1中看出。图8-1中列出???文档在信息系统建设和运行过程中的七种典型沟通作用：;〔1〕用户与系统分析人员在系统规划和系统分析阶段通过文档进行沟通。

〔2〕人员与工程管理人员通过文档在工程期内进行沟通。

〔3〕前期开发人员与后期开发人员通过书面文档进行沟通。

〔4〕系统测试人员与系统开发人员通过文档进行沟通。

〔5〕系统开发人员与用户在系统运行期间进行沟通。

〔6〕系统开发人员与系统维护人员通过文档进行沟通。

〔7〕用户与维护人员在运行维护期间进行沟通。

上述七个方面是文档在沟通方面的主要作用，其实，文档还可以作为监理和审计的对象，作为开发其他信息系统的参照。;如果发生合同纠纷，文档还能表达出证据的作用。因为每份文档都是工程建设中有关成员的一种书面承诺。绝大多数文档都是需要签名的。而签名就表示对自己所签署的那局部文档内容的认可和承担责任。特别是用户提出的需求变更申请书必须妥善保管，这些文件在发生纠纷时往往能成为保护自己甚至索赔的重要依据。

显然，文档的编制在信息系统的开发工作中占有突出的地位和相当的工作量。高效率、高质量地写作、分发、管理和维护文档对于充分发挥信息系统的效益有着重要意义。;2、信息系统文档的类型;〔2〕按照信息系统生命周期的阶段不同，可以划分为：系统规划阶段文档，如系统可行性研究报告、工程开发方案书等；系统分析阶段的文档，如系统分析说明书等；系统设计阶段的文档，如系统设计说明书、需求变更申请书等；系统实现阶段的文档，如程序设计报告、系统测试报告、开发总结报告等；系统运行与维护阶段的文档，如用户手册、操作手册与维护修改建议书等。

本书的附录——国家标准《计算机软件产品开发文件编制指南》根本上是按照软件的生命周期进行讲解的，可以作为信息系统文档的参照。;〔3〕按照文档不同的效劳目的，可以将信息系统的文档分为三类：用户文档、开发文档与管理文档。用户文档主要是为用户效劳的，开发文档主要是为开发人员效劳的，管理文档主要是为工程管理人员效劳的。上述三种文档的内容参见图8-2。

当然，图中的分类不是绝对的，比方工程开发方案对于开发人员来讲很重要；测试方案和测试报告对于管理人员来讲也很重要。这里要强调工程管理文档的重要性。工程管理文档是对工程方案、费用和问题进行监督的管理手段和工程建设过程进行记录的工具。这能使各级管理部门对工程的进展保持预见性，以便能及时发现和处理系统开发及维护过程中出现的问题。;信息系统

的文档;二、信息系统各类文档的内容;本节内容:

1、系统各类文档的内容简介

2、系统分析说明书编写指南

3、系统设计说明书内容指南;l、系统各类文档的内容简介;〔1〕系统开发立项报告

在信息系统的正式开发前。用户单位必须提出要开发的新系统的目标、功能、费用、时间、对组织机构的影响等。如果是本单位独立开发或联合开发，这些内容形成的文档称做立项报告，用于向领导申请经费及支持等；如果是委托开发，那么以任务委托或开发协议(合同)方式进行说明。立项报告主要包括以下内容：

①概述：概述现行系统的组织结构、功能、业务流程以及存在的主要问题。

②新系统的目标：开发新系统的意义和新系统实现后的功能、技术指标、平安和保密性、新系统运行环境等。

③经费预算和经费来源。

④工程进度和完成期限。

⑤验收标准和方法。

⑥移交的文档资料。

⑦开始可行性研究的组织队伍、机构与预算。

⑧其他有关需要说明的问题。;〔2〕可行性研究报告

可行性研究阶段的文档是可行性研究报告。在可行性研究报告中要说明待开发工程在技术上、经济上和社会因素上的可行性，评述为了合理地到达开发目标可供选择的各种可能实施的方案，说明并论证所选定实施方案的理由。可行性研究报告主要包括以下内容：

①概述。

②新系统的目标、要求和约束。

③可行性研究的根本准那么。

④现行系统描