2017年6月22日星期四08:28

编写更好要求的7个技巧

撰写者

一个舞会森林的成功或失败在很大程度上取决于支撑工作的要求。

考虑到这些步骤,舞会森林经理很可能会更快地得到利益相关者的支持。此外,由于编写良好的要求,舞会森林团队将节省开发时间以及一套更全面的测试方案。无论是业务,功能还是性能要求,这些步骤都可以确保您的游戏成功,并让您成为更具影响力的业务分析师。

1.了解您的观众

坐下来开始撰写您的需求时,请花点时间考虑一下潜在的读者。在大多数情况下,领导,舞会森林涉众,开发人员和测试人员会阅读您的要求。在考虑公司的这些子部分时,请反思每个小组的集体技能。他们希望在需求文档中看到什么?您可以针对每个用户组抢先回答哪些问题?您如何才能满足这些不同群体的需求?

2.使用普通语言

在尝试使公司中的同事满意时,在您的业务需求中加入简单的专业语言将总是有益的。编写好的要求的关键是保持平衡。要求越技术性,就越需要对您的技术水平最低的成员明确提出要求。新员工应该能够在上班的第一天就阅读您的要求,并且对应该发生的事情有基本的了解。同时,您希望简洁地陈述要求,并包含开发人员和测试人员完成工作所需的所有必要技术信息。这种平衡的一个很好的例子可能是这样的:

要求9.0-在要求7.5概述的详细信息窗口中,存在“成员详细信息”部分。本节包含以下字段:

  1. 出生日期 –毫米/日/年
    A.当成员是主要订户时,将从返回的成员事务文件的1100F部分的DB712段填充此值。
    B.当成员是主要订户的从属者时,此值从重新调整的成员事务文件的1100G部分的DB712段填充

在此示例中,我为开发人员提供了必要的字段格式和特定​​的数据原始点,以允许进行映射,同时仍然清晰,简洁地说明执行此要求时应发生的情况。舞会森林利益相关者或新员工可以查看此要求,尽管他们可能不熟悉引用的文件,但他们可以准确地了解发生了什么需求以及预期的输出结果。

3.在要求1中陈述目的

在需求文档的每个部分中,第一个需求应始终提供与舞会森林的特定子部分相关的期望的整体图。例如,我可能正在编写创建新网页的要求。我的第一个要求将始终用单个描述性句子来概述页面上的每个元素,以表明该元素所起的作用。

这种方法使从测试人员到领导人员的每个人都可以一开始就把头放在预期的结果上,然后再深入研究每个要素的细节,并可能在深入研究杂草时迷失方向。此要求还为程序员和测试人员提供了试金石,为他们提供了最终产品的高级图片以及一个易于阅读的元素清单以供处理。

4.枚举,然后枚举更多

让我们再次来看示例需求。

要求9.0-在要求7.5概述的详细信息窗口中,存在“成员详细信息”部分。本节包含以下字段:

  1. 出生日期 –毫米/日/年
    答:当成员是主要订户时,将从返回的成员事务文件的1100F部分的DB712段填充此值。
    B.当成员是主要订户的从属者时,此值从重新调整的成员事务文件的1100G部分的DB712段填充

在这里,我们看到一个需求分解为几个要点。描绘此轮廓的唯一原因是:测试。

在编写测试方案时,当需求包含if / then语句时,这种枚举样式将非常有用。在这种情况下,我们会将成员的出生日期拉到字段中,具体取决于成员与主要订户的关系;我们有两个位置之一可从中提取此数据。

负责测试此要求的个人将希望确保考虑所有情况。基于这种枚举样式,测试人员可以如下编写测试脚本:

要求9.0.1.A-成员是订户,DOB从DB712在成员文件的1100F部分中拉出

要求9.0.2.B-成员相关,从成员文件1100G部分的DB712中提取DOB。

当我在一个需求中包含多个元素时,这可能会特别有用。例如,我可能有生日,身份证号,姓氏和名字。我将为这些元素中的每个元素分配一个数字,并为每个if / then语句分配一个字母,以帮助我的质量检查分析师确保其测试方案与您的要求保持一致。

5.具体化& Definitive

撰写要求时,没有多余的空间来表达愚蠢的语言或被动语调。这些要求是舞会森林的基础,必须绝对遵守。尽管从不建议告诉开发人员确切的工作执行方式,但必须明确并以零摆动空间陈述预期的结果。

请注意以下示例的基调和特殊性:

要求1.2-最终用户不能查询距查询日期(当前日期)超过15天的将来续订日期。此外,最终用户不能查询自查询之日(当前日期)起超过12个月的历史续订日期。

未来续约日期

  1. 在日期选择日历控件上将禁用超过15天的日期。
  2. 手动输入自查询之日起超过30天的将来续订日期时,以下错误将以红色文本显示:
    “服务日期从今天起不能超过30天。”
  3. 任何手动输入的,与MM / DD / YYYY格式不同的日期值都会产生要求1.1中记录的验证错误。
  4. 包含非数字字符的任何手动输入的日期值都会产生Req 1.1中记录的验证错误。
    历史更新日期
  5. 在日期选择日历控件上,超过12个月的日期被禁用。
  6. 手动输入自查询之日起超过12个月的历史更新,将以红色文本显示以下错误:
    “服务日期不得超过今天的36个月。”搜索资格按钮保持禁用状态。
  7. 任何手动输入的,与MM / DD / YYYY格式不同的日期值都会产生要求1.1中记录的验证错误。
  8. 包含非数字字符的任何手动输入的日期值都会产生Req 1.1中记录的验证错误。

此要求的措词是特定的,不会给开发人员和测试人员带来任何误解的机会。

6.边缘案例的说明

在任何舞会森林的范围内,总会有异常情况导致意外结果。其中一些可能需要发生几乎完美的一系列情况。尽管这些极端情况似乎不可能,但您的舞会森林始终要遵守墨菲定律。

现在,我考虑所有可能的边际案例,这通常包括与同事协商,以集思广益地讨论产品可能产生不良结果的所有方式。一旦完成了完整的方案列表,就将它们包括在您的需求中。一些利益相关者可能会觉得这太过分了。但是,您的开发人员和测试人员将不胜感激。

7.陈述明显

经验丰富的业务分析师和新业务分析师都可以显示出为所有舞会森林参与者假设基本知识的趋势。为简洁起见,我们经常避免记录所谓的“隐含要求”。在当今的签约雇员的专业文化中,我们再也不能省略明显的细节。考虑到舞会森林生命周期中的流失率,观众在产品开发和测试中忽略重要细节的风险要高得多。通过增加临时承包商,您可能会发现舞会森林团队的组成在开发时与开始时根本不同。

即使显而易见或不必要,也不要害怕陈述它。您不是在写虚构的短片;您正在组成一个至关重要的舞会森林工件,旨在回答每个问题,并且毫不动摇。
您是否发现任何其他提示在编写需求时有用?

请在评论部分分享。

达斯汀·斯奈德(Dustin Snyder)

第一贡献达斯汀·斯奈德(Dustin Snyder)是一位业务分析师,专门研究亚利桑那州Blue Cross Blue Shield的系统变更管理。在保险,IT和软件开发行业拥有20多年的经验,Dustin拥有ITIL和HDI管理认证,并坚定地致力于指导成功。

©BA Times.com 2020

麦格雷戈徽标白色网站