登陆注册
13514600000039

第39章 物流信息系统维护与管理(4)

①文档需要覆盖整个物流信息系统的生命周期。在项目早期几个阶段就要求有文档,而且在系统开发过程中文档必须是可用的和可维护的。在开发完成后,文档应满足软件的使用、维护、转换或传输的需要。

②文档应是可管理的。指导和控制文档的编制和维护,管理者应准备文档产品、进度、可靠性、资源、质量保证和评审规程的详细计划大纲。

③文档应适合于它的读者。读者可能是管理者、分析员、无计算机经验的专业人员、维护人员、文书人员等。根据任务的执行,他们要求有不同的材料表示和不同的详细程度。针对不同的读者,文档编制者应设计不同类型的文档。

④文档效应贯穿到系统的整个开发过程中。在系统开发的整个过程中,应充分体现文档的作用和限制,即文档应指导开发全部过程。

⑤文档标准应被标识和使用。选择文档标准时,应尽可能地采纳现行的标准;若没有合适的标准,必要时应研制适用的标准或指南。

⑥应规定支持工具。工具有助于开发和维护系统产品,包括文档,因此尽可能地使用工具是经济的、可行的。

2.制定文档管理的标准和指南

在一个物流信息系统开发和运作项目组内,应采用一些标准和指南,包括系统生存期模型、文档类型和相互关系、文档质量。这些标准和指南决定了如何实现文档管理任务,提供一些准则以评价所产生的系统文档的完整性、可用性和适用性。应尽可能地采用现行的国家标准和国际标准,若现行的标准不适用或没有相应的国家标准和国际标准,那么各机构应制定自己的文档管理标准。

(1)选择系统生存期模型

现行的一些系统生存期模型,对于不同的阶段有不同的词汇,从系统文档的观点来看,采用哪种模型无关紧要,只要阶段和相应的文档是清晰定义的、已计划的,并且对于任何具体系统项目都是能遵循的。因此,管理者应选择一个系统生存期模型并保证该模型在机构内是适用的。

(2)规定文档内容和类型

系统文档一般应归入如下三种类别:开发文档——描述开发过程本身;产品文档——描述开发过程的产物;管理文档——记录项目管理和系统运行的信息。这个分类是比较粗略的,可以作为具体项目中定义文档类型的参考。

(3)确定文档的质量等级

仅仅依据规章、传统的做法或合同要求来制作文档是不够的,管理者还必须确定文档的质量要求以及如何达到和保证质量要求。质量要求的确定取决于可得到的资源、项目的大小和风险,可以对该产品每个文档的格式及详细程度作出明确的规定。每个文档的质量必须在文档计划期间就有明确的规定。文档的质量可以按文档的形式和要求划分为四个等级。

①最低限度文档(1级文档)。1级文档适合开发工作量较小的自用程序。该级别文档包含程序清单、开发记录、测试数据和程序简介。

②内部文档(2级文档)。2级文档可用于在精心研究后被认为似乎没有与其他用户共享资源的专用程序。除1级文档提供的信息外,2级文档还包括程序清单内足够的注释以帮助用户安装和使用程序。

③工作文档(3级文档)。3级文档适用于由同一单位内若干人联合开发的程序,或可被其他单位使用的程序。除2级文档提供的信息外,3级文档还包括共享程序结构和相应的注释说明,方便集成现有应用和工作成果共享。

④正式文档(4级文档)。4级文档适合那些要正式发行供普遍使用的系统产品。关键性程序或具有重复管理应用性质(如工资计算)的程序需要4级文档。4级文档遵守《计算机软件产品开发文件编制指南》(GB/T8567-1988)的有关规定。

质量方面需要考虑的问题还包括文档的结构和内容。文档结构由各个组成部分的顺序和总体安排的简单性来确定,文档内容可以根据正确性、完整性和明确性来判断。

3.文档编制计划

文档编制计划可以是整个项目计划的一部分,也可以是一个独立的文档。应该编写文档编制计划并把它发给全体开发组成员,作为文档重要性的具体依据和管理部门文档工作责任的备忘录。

对于小的、非正式的项目,文档计划可能只是一页纸;对于较大的项目,文档计划可能是一个综合性的正式文档,这样的文档计划应遵循各项严格的标准及正规的审批和批准程序。

文档计划一般包括以下几个方面的内容:列出应编制文档的目录;提示编制文档应参考的标准;指定文档管理员;提供编制文档所需要的文件,落实文档编写人员、所需经费以及编制工具等;明确保证文档质量的方法,为确保文档内容的正确性、合理性采取一定的措施,如评审、鉴定等;绘制进度表,以图表形式列出在软件生存期各阶段应产生的文档、编制人员、编制日期、完成日期和评审日期等。

7.3.3 文档的质量管理

质量差的文档不仅使读者难以理解,给使用者造成很多不便,而且会使管理人员难以确认和评价开发工作的进展,削弱对物流信息系统的管理,一些工作可能会被迫返工从而增加物流信息系统的开发成本,甚至会造成误操作等更加严重的后果。

造成物流信息系统文档质量不高的原因主要有以下几个方面:不重视文档的编写工作而造成文档质量较低;文档的编写很随意,不按照各类文档的规范写作;缺乏文档编写的实践经验,对文档编写工作的进度安排不科学;缺乏评价文档质量的科学标准,使文档管理的有些工作流于形式,缺乏真正执行的机制。

1.文档的内容质量

物流信息系统的建设在很大程度上是物流软件的开发,就软件的两大部分——程序和文档而言,程序是必须最终完成的,而且程序的好坏有很大一部分是可以通过运行来看出来的,而文档有一些是必须完成的,有些可能没有严格要求或可以事后补充,有时为了追求开发速度,一些文档常被忽略或粗制滥造。另外,文档经常是给别人看的,文档的作用很多是在事后才能体现出来的,所以物流信息系统开发和管理人员缺乏编写文档的动力和自觉性。

高质量的文档通常具有以下的一些特征:

①针对性。文档编制之前应分清楚读者对象,根据不同类型、不同层次的读者的要求,编制适合他们的不同的文档。例如,用户文档不能像开发文档那样使用过多的信息技术专业术语。

②精确性与统一性。文档的行文应当十分确切,避免一些歧义的措辞。同一项目的不同文档在描述同一内容时应当协调一致,不能相互矛盾。

③完整性。物流信息系统开发和运行过程中的任何一个文档都应当是完整的、独立的。

④可追溯性。物流信息系统开发和运作阶段的文档与各阶段需要完成的工作都有很紧密的关系,随着工作的逐步进展,前后阶段的文档也具有一定的继承关系,所以一个物流信息系统开发和运行管理阶段的文档必定也必须存在着可追溯性,必要时应能做到跟踪追查。例如,对某一项物流处理功能的需求,在用户需求说明书、系统分析报告、系统设计报告、测试计划和用户手册中都有所体现。

⑤易用性。文档的编制应充分考虑方便各个用户使用的要求,如文档便于读者检索,文档应力求简洁明了,适当地配以图表,使文档更加清晰。

2.文档编制的格式要求

高质量的文档不仅仅是指内容的高质量,也包含规范统一的格式要求。在编制文档时,要立足于读者的需要,格式规范、统一,文字准确、简单明了。

在文档编排时,要遵循以下原则:所有的文档都应该编排得便于迅速查到需要的内容;采用由一般到具体的层次结构,可能的情况下还可以采用词汇之间的互相链接;在可能的情况下,图表应放在它所解释的文字附近,以便用户阅读;可以适当采用不同的字体和版式,以增加正文的明晰度。

同类推荐
  • 世界500强企业顶尖用人之道

    世界500强企业顶尖用人之道

    “世界500强”,是人们对美国《财富》杂志每年评选的“全球最大五百家公司”排行榜的一种约定俗成的叫法。荣登“世界500强”排行榜,是无数搏击于商海中的英雄梦寐以求的目标。为了实现这个目标,他们殚精竭虑,夜以继日,有的甚至耗费了毕生心血。
  • 第一次销售就成功

    第一次销售就成功

    新入职的营销人员,对事业与人生有着美好的憧憬;有经验的营销人员,对成为销售专家有着强烈的渴望。
  • 手把手教你编制会计报表

    手把手教你编制会计报表

    本书用通俗易懂,老会计带新会计的师徒传授的方式讲述一些基本的会计理论知识、报账的工作内容以及报账员的工作职责等;报账工作中要利用的各种重要的财务报表的编制。
  • 销售金点子

    销售金点子

    当你站在销售的门外,踌躇满志地准备着是否踏入这个看上去低门槛、高收入的行业,开始建设自己的幸福人生时,手中应该握有什么利器?当你混迹于销售大军中,挣扎着想要得到机遇青睐、摆脱时间的湮没时,需要具备什么能力?当你成为销售精英、鼎足于一方时,又已经成就了怎样的造诣?
  • 利润加速器

    利润加速器

    《利润加速器(让企业利润倍增的14个新理念)》分组织管理、经营决策、客户管理和市场运作四个部分,详细讲述了企业如何加速盈利,如何在激烈的竞争中求得生存。每个企业都需要追求盈利,持续和高额的利润将为企业带来巨大的价值,所以,追求利润往往会成为企业的主要目标。尽管在企业中有许多事情都是非常重要的,但是,最核心问题还是要盈利,因此企业应该追求盈利。然而,却很少能有企业真正懂得如何实现盈利以及为什么能够实现盈利。《利润加速器(让企业利润倍增的14个新理念)》将是企业家创造高额利润、追求盈利的指南,是一本极有价值的参考书。
热门推荐
  • 忘川清河

    忘川清河

    试问爱为何物?佛曰:看不透,逃不开,一情既定,万劫不复,在所不辞。何解?佛曰:无解,世间能真正抛弃情爱的,又有几人?可惜造化弄人,到最后只不过是落得故人殇罢了。和为情?何为爱?佛曰:如此之问,唯有心解……承诺,化为灰烬。血一般的曼珠沙华填满了整个小屋。为她,杀人如麻的他,最终入了魔障。泪水落下,别无它话……“凌儿,等到来世我们再做一对恋人怎样?”他流着泪问早已死去的她,屋外的曼珠沙华随着风摇曳着,就如她最后一次留下的血泪。一念心生,一念心死……爱情,不过如此……到现在,我才知道。这一切,只不过是我一厢情愿而已……罢了,罢了……
  • 魂尽今生

    魂尽今生

    一剑烟火渡平生,七窍丹心尽英魂。——桃蹊烽火狼烟,兵荒马乱。他有一身华丽的武技,有洞悉天下的睿智,却因角色是一个无用的隐藏职业而无处施展抱负。他背负上一切,开始了冒险的旅途,刀光与剑影、阴谋与计略,高傲如他,是泯为众人还是剑指天涯,又在谁的枯冢之上青草离离魂尽今生……
  • 二战那些事

    二战那些事

    本书力争完整重现二战全过程,详细解读前因后果,解开历史迷雾,还原真相,为读者呈现出不同的二战历史。
  • 天穹盗主

    天穹盗主

    传说,大陆的尽头,云层的峰顶上,有各种强大的存在,而有这样一个少年,曾经天赋横溢,一场席卷云天的灾祸却他从九天入凡尘,破碎的的丹田,被夺的灵源,少年那颗不甘的心,如何重拾过往的荣耀,如何重临云天,找回那曾经的过往。
  • 等待千年,却依旧无法挽回

    等待千年,却依旧无法挽回

    一次次的封印,一次次的解封,都是为了一个与她对立的人。这次,是依旧历史重演,还是结局逆转?这次,他们依旧不能在一起,还是相爱一生?这次,她终于认清了他们,还是依旧印象模糊?
  • 大晋之皇

    大晋之皇

    一个常常酒后失忆的中年男子,终于在一次大醉后假死而坠入阴间,却因为大闹森罗殿,骂阎王,打判官,而遭到报复,去到了一千多年前的朝代,当了个最悲惨的白痴皇帝,整日里提心吊胆,在权势中艰难求存,勾心斗角,只想捡一条命,寻觅回家的道路,再次享受家人的拥抱。
  • 善良的牧师

    善良的牧师

    当所有的人都在为一个游戏议论的时候,所有的工作都会朝游戏扩展,作为全球唯一一款虚拟网游《暗黑议会》理所当然的成为了这样的存在,不管是咖啡厅还是餐馆,如果没有《暗黑议会》的边幅,就等于out了,要想临时工?面试问题:你在《暗黑议会》了解哪些?当有客人和你谈起游戏中的某件事你又知道多少?什么?你什么都不知道?对不起,我们这里需要对暗黑议会有足够了解的人才能担任。在原工作被辞退后,林凡作为一名仅仅初中毕业的差等生,再也找不到任何工作,只得再次进入那款被他放弃了的游戏当中。
  • 旺妻难逑

    旺妻难逑

    张侍郎府的二爷已经是两个小女孩儿的爹爹,他做梦都想有个儿子。可是,夫人又生下一个小女儿。合家失望。张二爷的小女儿侍郎府的五小姐满月时,有高僧曰:“此女旺相,实是罕见。”旺弟旺姐旺爹娘旺家族,旺人旺财旺仕途事事旺。旺夫,是理所当然的。这女子,能旺夫益子耶。于是,众男想把张侍郎府的五小姐旺儿娶回家,旺儿撇嘴:哼,休想!
  • 我在灯下等你

    我在灯下等你

    开始的逃离,命运枷锁的逼迫;后来的迫不得已,深爱骨髓。你有你的选择,我有不可言说的秘密,你的身份终是迷。开始的救赎是否是孽缘的开始。狼的野性可为我收敛?你在哪里?我们说好的白头,我在灯下等你。
  • 蓝色备胎

    蓝色备胎

    主角是一个普通得不能再普通的学生,三年前的一天接到一个离奇的短信,陷入了一个离奇的三角恋,这么多年他能找到事情的真相么