指定产品

在本教程的这一部分，我们将走一遍 Requirements Portal 的主要用户流程之一，帮助你快速上手：

• 收集并编写需求

• 分解需求

• 审查并改进需求

• 批准并发布规范

创建新项目

1. 点击左上角的 Project 下拉菜单，然后点击  按钮。

   

2. 在打开的项目设置页面中，在 Project name 字段中输入一个合适（且唯一）的项目名称（例如 Valifan），然后点击  按钮。

   

定义干系人需求

大多数系统设计与开发遵循 V cycle。V cycle 的第一个过程是理解业务需求并识别干系人的需求。随后，这些干系人需求会被转换为干系人需求条目（stakeholder requirements），可直接创建、通过 CSV/XLSX 导入，或通过 AI 驱动的 ValiAssistant 创建。本教程这一部分将重点介绍导入方法。

1. 下载以下包含干系人需求的 CSV 文件：

   Valifan_stakeholder_Requirements.csv

2. 如果尚未进入 Requirements Module，请在左侧项目树中点击 Requirements 条目进行导航。

3. 在打开的页面中点击  按钮，并在出现的菜单中选择 Import Requirements。

   

4. 在打开的 Document Importer 窗口中，点击 open the legacy importer here 链接。

   

5. Import Requirements 向导将会打开。在 Create a specification 区域中，定义该规范的 Name（例如 Stakeholder_requirements），然后点击  按钮。

   

6. 下一步是上传 CSV，以便导入向导读取并导入文件。将下载的 CSV 文件拖放到 Import Requirements 向导的 Drop file 区域中（或点击该区域，通过对话框上传文件）。

   

    点击  继续。

7. 在下一步中，确认 CSV 文件中的数据列已正确映射到 Requirements Portal 中的列。如有需要，可使用表格顶部的 Map To 下拉选项。 

   

   点击  继续。

8. 向导的下一页会提示你导入成功。点击窗口顶部的 Check now 控件，将数值与单位转换为参数（valis），以遵循数据驱动的系统工程方法。

   

9. 在打开的 Valify Requirements 窗口中，你会看到提示：将对五条需求进行 valify。点击  继续，并会收到提示已找到两个 vali。 点击  继续，然后点击 。

   

10. 如你所见，50 dB 和 50 W 已从纯文本转换为 vali，后续我们可以使用它们。

    

    关闭 Valify Requirements 窗口以继续。所有需求都已添加，且检测到的数值都已转换为 vali。vali 会在需求中高亮显示。

    

添加系统需求

在典型的系统工程流程中，系统需求由干系人需求创建而来。大多数技术设计必须满足严格的约束，例如质量、功耗和成本等方面的需求。Requirements Portal 提供了一个全面视图，用于查看设计满足这些需求的程度。

现在，我们将手动创建一些系统需求。

1. 在左侧项目树中右键点击 Requirements 条目，并在出现的菜单中选择 Create Specification。在 Create new specification 窗口中，在 Name 字段输入 Fan_Specs ，然后点击 。

   

2. 在项目树中点击新创建的规范条目。进入该规范后，点击   按钮，并在出现的菜单中选择 Create Requirement 。

   

3. Create new requirement 窗口将会打开。在该窗口中：

   1. 在 Specification 字段中，确保选择了正确的规范（Fan_Specs）。

   2. 在 Identifier 字段中，输入一个唯一标识符，例如 R-Fan-001。

   3. 在 Requirement text 字段中，输入 The Mass of the fan shall not exceed 300g。

   4. 确保启用 Check for possible Valis 选项。

      启用该选项后，需求中的数值会被检查，并通过 Valify 功能直接转换为 vali。

   5. 点击  按钮。

   

4. 在出现的 Valify Requirements 窗口中，点击  按钮。系统会在该需求中找到一个 vali。点击  按钮将该数值转换为 vali，然后点击  按钮继续，最后点击  按钮完成流程。

5. 同样地，再添加一条需求，标识符为 R-Fan-002，需求文本为 The Mass of the propeller shall not exceed 50g，但这次请禁用 Check for possible Valis 选项（稍后将从该需求中的数值手动创建 vali）。

   

6. 当选择 Fan_Specs 规范时，将列出已添加的需求。注意：R-Fan-001 已包含一个 vali，而 R-Fan-002 目前还没有 vali。

   

在需求中创建需求 vali

现在，我们将在需求文本字段中手动创建一个新的 vali。

1. 双击需求 R-Fan-002 的 Text 列单元格，并删除 50g 文本。

   

2. 输入 $，以弹出一个列表，显示项目内的 vali/对象。 在弹窗右上角，点击  按钮以创建一个 vali。

   

3. 在打开的 Create new 窗口中，在窗口的 Vali 选项卡里，为新 vali 输入以下数据：

   1. Name： Req_Mass_Propeller

   2. Formula and unit： 50g

   3. Display unit： g

      Display unit 字段为可选项。若留空，将从 Formula and unit 字段获取单位。

   

4. 点击  按钮创建新的 vali，并将其插入到需求的 Text 字段中。

5. 现在，50g 文本的显示方式与普通文本不同，这表明它是一个 vali。该 vali 现在可在项目的不同部分使用（例如报告、Blocks Module、验证等）。

   

通过父子关系分解需求

1. 点击表格右侧的 Columns 控件，并确保勾选 Parents 和 Children 列的条目，使其显示在表格中。

   

   再次点击 Columns 控件以隐藏列表。

2. 双击需求 R-Fan-002 的 Parent 列单元格，并在弹窗中选择需求 R-Fan-001 以链接两条需求。 注意：R-Fan-002 会自动添加到 R-Fan-001 的 Children 列中。

   

   

    

3. 点击需求表格顶部的 Connections 选项卡，打开连接图，以显示所选规范的父子关系。

   需求周围的蓝色框表示它们所属的规范。

   

使用 ValiAssistant 生成需求

为了加速需求管理流程，你可以使用 AI 的 ValiAssistant 功能来生成需求/分解需求。我们将用它为本教程项目创建两条安全需求。

1. 点击右上角的  按钮以打开 ValiAssistant - Generate Requirements 窗口。确保在下拉列表中选择了 Generate Requirements 选项，然后点击  按钮。

   

2. 在下一页中，你可以描述你的产品、系统、子系统，并尽可能提供更多信息，以便 AI 根据你的描述生成最合适的需求。由于我们关注安全需求，请在 Generate Description 标题下方的字段中输入 Create 2 safety requirements for designing a fan 文本，为我们的风扇提出两条安全需求。

   在 Prompt Extension 标题下方的文本字段中，您可以进一步自定义提示词。我们要查找的是以 INCOSE 方式编写的需求，请将 Apply the INCOSE guide to writing requirements 文本输入到该字段中。

   

   单击  继续。

3. 在下一页中，将显示 AI 的输出，您可以查看、修改，并接受或拒绝任何建议。

   

   单击  继续。

4. 关闭提示需求已成功生成的对话框。生成的需求将显示在 Fan_Spec 规范的表格中。

   

更新、管理与审查需求

在整个开发过程中，需求随着各种因素（例如干系人输入和设计约束）而演进并更新是很常见的。在 Requirements Portal 中，您可以通过双击列字段或在需求的详细信息区域内直接更新需求，所有更改都会记录在历史记录中，便于查阅。

1. 在 Text 列中双击其单元格，即可进入需求文本 R-Fan-003 或 R-Fan-004 的编辑模式。将文本更改为 The fan shall include a protective guard with openings no larger than inches to prevent accidental contact with moving parts.，然后按 Enter，或在表格中单元格外的任意位置单击以完成编辑。

   

   

   

    

2. 单击已更改需求的标识符以打开其详细视图，在其中您可以调整其他字段、订阅、定义负责人、添加理由、创建父/子关系等。

   

3. 可追溯性是 Requirements Portal 的关键概念，所有更改都会在需求及其他对象的历史记录中被跟踪。单击 History 可打开一个视图，查看版本信息、谁在何时进行了更改，以及涉及的字段与操作。

   

验证需求

在产品生命周期的早期阶段，在进入设计流程之前验证需求至关重要。Requirements Portal 通过 State 列提供了便捷的方式来管理需求状态。默认包含 Draft、In Review 和 Final 等状态，但您也可以根据具体需求添加更多状态。

在本教程的这一部分，您将把 Draft 状态分配给新添加的需求，以确保工作流结构化且有序。

1. 在 Fan_Spec 规范中，单击表格右侧的 Columns 控件，并确保 State 列的条目被勾选，以便在表格中显示该列。

   

2. 勾选 Identifier 列标题左侧的复选框，以选择该规范内的所有需求。

   

3. 双击任意需求在 State 列中的单元格（如有需要，将表格向右滚动以看到该列），打开包含可用状态选项的下拉列表。选择下拉列表中的 Draft 并确认更新。所有需求都将处于 Draft 状态。