在业务需求文档中描述数据字段

Question

如何在业务需求文档中描述数据字段及其行为？

我有这样的业务需求文档设置：

1.4一般要求：

Req #   |   Ranking     |   Requirement  
1       |       H       |   The system shall be breaking into two sub-systems; one for the POS Admins and the other for the clients.
2       |       L       |   The system should automatically validates for the expected result in the user side before submitting to the server.

2.2用户特征：

System             |   Role Name      |   No. of Users  | Responsibility / Activity   

POS Admin system   |  Finance Manger  |        1        | Responsible for delivering financial reports

Client-side system |  General Client  |        N        | Applying  for ...etc  

3.2功能需求：

Req # | Ranking |       System       | Role |  Requirement  
1     |    H    | Client-side system | ALL  | The system should have two type of addresses one for local and the other for out of country 
2     |    H    | Client-side system | ALL  | The system should enforce local address only, if the user entered their social security number as the id

3.3用例:

3.3.1输入地址：

- Use Case ID:  00001
- Goal:    
- Pre-conditions:
- Post-conditions:
- Failure Outcomes:
- Flow of Events: 
- Alternative Scenarios:
- Inputs Summary:
- Output Summary:

在哪里写入用户要输入的所需数据字段？例如，地址应该有四个数据字段--国家、地区、城市、街道

假设我增加了新的部分，称为2.3数据字段，它包含了2.3.1地址的子部分，并在其中列出了所有需要的字段，在这种情况下，如何将数据字段链接到功能需求，以便文档能够保持一致和可以理解？

Answer 1

让我们首先消除与标准相一致的问题，理解为您当然可以根据您公司的需要和标准调用您的文档：

• 业务需求原则上应该从业务角度描述业务需求，例如业务流程、业务角色和责任以及业务规则。它可以引用商业信息(“地址”、“产品参考”)，但不指软件的字段。
• 您所描述的内容非常接近国际标准(当前的ISO 29148，以前的IEEE830)所称的软件需求规范(SRS)。

数据需求是软件需求，因此应该成为SRS的一部分。1998年版本的IEEE 830提到了“逻辑数据库需求”(包括对实体的描述)，并将它们放在功能描述之后(功能需求+文档中的用例)。

将数据描述放在用例之后的好处是，它鼓励将用例保持为高层次的需求，而不会丢失细节。这很好，因为用例并不是对用户界面的详细描述。

但这一秩序是不规范的，最终，我们都可以同意该标准的以下建议：

应仔细注意组织要求，以最大限度地提高可读性。