在DOORS里整理需求时,模块主列看起来像一篇带章节编号的文档,标题和正文却分别存放在对象的两个属性里。比如“启动自检”可以是章节标题,“设备应在上电后5秒内完成自检”则是一条可以验证的需求。两段文字在主列里挨得很近,粘贴时却可能进了同一个字段。以DOORS 9.7桌面客户端的正式模块为例,区分这两个属性,有助于把需求的内容和章节结构都理顺。
一、DOORS对象标题和对象文本有什么区别
对象标题用于给章节或对象命名,对象文本用于保存具体内容。模块主列可以同时显示这两个属性,要判断一段文字实际存在哪里,可以打开对象属性核对。
1、对象标题用于标记主题和章节
①在正式模块中选中一个已有的章节对象,右击选择【属性】,打开【常规】选项卡。
②查看【对象标题】中的内容,再回到模块主列,核对这段文字前是否带有标题编号。
③对照父对象和子对象的位置,确认该标题管理的是哪一组需求。
对象标题适合填写“启动自检”“通信故障处理”这类简短名称。DOORS可以根据对象在层级中的位置生成标题编号,移动对象后,编号也会随位置变化。章节名称中一般可以省去手工输入的编号,省得调整章节顺序时还要逐个修改文字。
2、对象文本用于记录可验证的要求
对象文本可以承载完整的需求描述。条件、系统行为和判定标准放在这里,评审人员看到单条需求时,就能判断它具体要求什么。
①选中模块中的一条需求,打开【属性】→【常规】,查看【对象文本】。
②核对正文有没有写清触发条件、执行动作和判定标准。例如,检查“设备应在上电后5秒内完成自检,并显示自检结果”是否完整保存在【对象文本】中。
③如果模板还包含【对象短文本】,按项目约定检查它存放的摘要或简写,并以【对象文本】核对完整要求。
二、DOORS需求标题与正文如何分别填写
对象标题和对象文本可以在同一个对象上同时填写,也可以分给不同对象。已有模板要求每条需求带标题时,可以采用前一种方式。需要用一个章节管理多条需求时,可以建立标题对象,再把各条正文放进子对象。
1、在属性窗口中分别填写两个字段
①以【互斥编辑】方式打开正式模块,选中要修改的对象,右击选择【属性】。
②在【常规】选项卡中,将简短名称填入【对象标题】,例如“自检完成时限”。
③在【对象文本】中填写完整要求,例如“设备应在上电后5秒内完成自检,并显示自检结果”。
④将修改范围设为【当前对象】,点击【确定】,按【Ctrl+S】保存模块。
这种方式适合模板要求每条需求同时提供名称和正文的情况。改完以后,两段内容仍属于同一个对象,正文可以和这条需求的状态、验证信息及链接放在一起维护。通过属性窗口编辑时,需要对对象及相应属性拥有修改权限。
2、用快捷键直接编辑当前对象
①在可编辑的模块中选中目标对象,按【Ctrl+H】进入【对象标题】,录入或修改标题。
②按【Ctrl+M】接受当前编辑,再按【Ctrl+T】进入【对象文本】,输入或修改正文。
③再按【Ctrl+M】接受编辑,最后按【Ctrl+S】保存模块。
3、建立章节标题和正文子对象
如果一个主题下有多条要求,分开建对象更便于逐条评审。例如,“启动自检”下面可以分别记录完成时限、结果显示和失败处理。
①在模块中建立章节对象,按【Ctrl+H】填写【对象标题】,将【对象文本】留空。
②选中该章节对象,使用【插入】→【下方对象】创建下一层对象。英文界面的对应命令为【Insert】→【Object Below】。
③选中新建的子对象,按【Ctrl+T】填写【对象文本】。后续新增同一章节的需求时,选中已有子对象,通过【插入】→【对象】创建同级对象。
④在模块主列核对各条正文是否归在预期的章节下,按【Ctrl+S】保存。
三、DOORS标题和正文填错后怎么检查
从Word粘贴内容或接手旧模块时,只看主列的排版容易漏掉字段错位。遇到标题过长、章节下混入整段文字等情况,可以先分列检查,再针对有问题的对象修正。
1、把标题和正文分别显示为两列
①在模块窗口选择【插入】→【列】。
②在【内容】区域选择【属性】,指定【对象标题】,点击【插入】。
③按相同方式添加【对象文本】列,点击【关闭】。对照两列,检查章节名称和完整需求是否落在预期的字段中。
分列查看适合集中检查一批刚录入的需求。章节行的正文为空、纯需求行的标题为空,都可能是项目原有的组织方式。判断是否漏填时,可以抽查同类对象,按模块模板核对。后续还要用这套列布局时,可以将其保存为模块视图。
2、逐项纠正填错的内容
DOORS提供交换标题与文本的命令,但对象标题容纳的字符少于对象文本,直接交换可能截断长正文。只改个别对象时,可以按属性分别修正。
①右击目标对象,打开【属性】→【常规】,核对【对象标题】和【对象文本】的现有内容。
②将完整需求复制到【对象文本】。如果正文里已有其他内容,先核对两段文字,再保留需要的部分。
③按项目约定,在【对象标题】中填写简短名称或清空误填内容,将修改范围设为【当前对象】,点击【确定】。
④对照分列视图检查修改结果,确认正文完整、章节位置正确,再按【Ctrl+S】保存。
总结
在DOORS中,标题承担导航和归类的作用,正文承载可评审、可验证的要求。两者放在同一个对象还是拆成父子对象,可以由模块模板和评审方式决定。团队内采用一致的填写规则,后续查看单条需求、追踪变更或导出文档时,就更容易找到完整的要求,也能看清它属于哪个章节。
