需求
关联到其他项目
将条目追溯到另一个项目中的需求、功能或测试;每个人只有在能打开被关联条目所在的项目时才能看到该条目。
本页内容
概述
到其他项目的关联是从此项目中的条目到另一个项目中条目的追溯关系,例如traced from系统规范中某条需求的子系统需求,或verifies另一个团队所维护需求的测试程序。
该关联属于此项目。它只存储两个条目的 ID 和关系。每次查看时,关联条目的编号、名称、类和状态都会以您自己的访问权限从其所属项目中读取:
- 当您可以打开另一个项目时,您会看到该条目并可以点击跳转到它。
- 当您无法打开时,您会看到您无法打开的项目中的条目。无论是在应用中、导出中、通过 API 还是通过 AI 工具,名称都不会传给您。
到其他项目的关联属于 Team 方案。由项目所有者的方案决定。在其他方案中,现有关联仍然可见且可以移除,但不能添加新关联。Hybrid Car 和 Hybrid Car Battery Pack 演示项目之间的关联在所有方案中均可使用。
概念
关联包含的内容
| 组成部分 | 含义 |
|---|---|
| 来源 | 此项目的一个条目 |
| 关系 | 此项目架构中的一种关系,例如 traced from、satisfies 或 verified by |
| 目标 | 一个项目的 ID 及其中一个条目的 ID |
系统会根据源的类检查关系。创建关联时不检查目标的类,因为关联从不读取另一个项目的内容。当目标的类与关系不符时,追溯部分会显示 ⚠ 和“此关系通常不指向 …”。
谁能看到什么
每个人都以自己在该项目中的角色查看每个关联条目:
| 您对另一个项目的访问权限 | 您看到的内容 |
|---|---|
| 任意角色(所有者、编辑者、评审人、查看者) | 编号、名称、项目,以及打开该条目的链接 |
| 无,或该项目已不存在 | 您无法打开的项目中的条目 |
不存在的项目和您无法打开的项目看起来相同,因此关联永远不会向您透露某个项目是否存在。
关联状态
| 显示内容 | 含义 | 应采取的行动 |
|---|---|---|
| 编号和名称 | 该条目存在,且您可以打开其项目 | 无 |
| 已在 <项目> 中删除 | 该条目在其项目的回收站中 | 请可以编辑该项目的人恢复它,或移除该关联 |
| 已删除 | 该条目已不存在 | 移除该关联(移除已损坏的关联) |
| 您无法打开的项目中的条目 | 您无权访问该项目,或该项目已不存在 | 如有需要,请向项目所有者申请访问权限 |
| 正在加载… | 正在读取该条目 | 请稍候 |
名称在页面显示关联时读取,在一分钟后返回该标签页时再次读取,并且每五分钟读取一次。重命名的条目会显示其新名称,而此项目无需任何更改。
已更改的目标
当关联条目在创建关联或上次评审之后在其项目中被编辑过时,行会显示已更改。指向它可查看日期。检查该关联是否仍然成立,然后:
- 点击行上的 ✓,将该关联标记为已评审。
- 点击其他项目旁边的 ⋯,然后点击全部标记为已评审 (n),处理该条目所有已标记的关联。
- 或打开需要与需求 → 待审查的关联:在其他项目中已更改卡片列出项目中每个已标记的关联,每行有 ✓,并提供全部标记为已评审。
标记为已评审会显示在条目的历史记录和活动中,一次撤销即可撤回。评审人和查看者能看到标记,但不能清除它们。到库发布的关联不会被标记(发布不会更改)。
如何使用
何时使用及原因
当一个模型过大或由不同团队负责时,请使用到其他项目的关联:系统规范及其子系统规范、产品线的共享需求及各个产品,或客户的需求与您的设计。将关联保存在较低层级的项目中,并指向上层:每个子系统都从系统需求追溯其需求(from)。
在一个项目内部使用普通关系。追溯部分中的关联现有…用于关联同一项目的条目;到其他项目的关联用于位于其他地方的条目。
添加关联
- 选择该条目,例如一条子系统需求。
- 在属性面板中打开追溯部分。在其他项目下,点击 +(添加到其他项目的关联…)。
- 选择关系,例如 traced from。
- 选择项目。其条目按编号列出。
- 对于库,选择版本:当前(工作副本)或某个发布,例如发布 1.1。到发布的关联显示其标签而不是当前,并且其名称不会打开页面。
- 在搜索中输入编号或名称以查找条目。选择一个类可只列出该类。
- 点击该条目,然后点击添加关联。提示消息显示“已添加关联。”,该条目出现在其他项目下。
一次撤销即可移除该关联。再次添加相同的关联会保留现有关联。
打开关联的条目
点击关联条目的名称。其项目会在该条目处打开。
移除关联
- 点击关联行上的 × 可移除一个关联。
- 当关联指向已删除的条目时,点击其他项目旁边的 ⋯,然后点击移除已损坏的关联 (n)。
移除关联只会更改此项目。另一个项目永远不会因关联而更改。
实例:载荷子系统与 CubeSat EO-1 演示
- 创建一个名为 EO-1 Payload 的项目,其中包含需求 PL.1 Detector pixel pitch shall be at most 5.5 µm。
- 选择 PL.1,打开追溯 → 其他项目 → +。
- 选择 traced from 和项目 CubeSat EO-1,搜索 ground sample,然后点击 1.2 Ground Sample Distance。点击添加关联。
- 该行显示 traced from 1.2 Ground Sample Distance CubeSat EO-1 · 当前。只能打开 EO-1 Payload 的同事在同一行上会看到您无法打开的项目中的条目。
提示和良好做法
- 从较低层级关联到较高层级,这样添加子系统时系统项目无需更改。
- 将较高层级的项目以查看者身份共享给处理较低层级项目的人员,使他们能看到名称。
- 在较高层级的项目重新组织后,运行移除已损坏的关联。
常见错误
| 问题 | 原因 | 修正 |
|---|---|---|
| “此条目位于此项目中。请改用“关联现有条目…”。” | 目标在同一个项目中 | 在该关系的组中使用关联现有… |
| 其他项目下没有 + | 您只能查看该项目,或该条目已锁定 | 申请编辑者角色,或解锁该条目 |
| “关联到其他项目中的条目属于 Team 方案。” | 项目所有者不在 Team 方案中 | 在账户设置 → 方案与账单中升级 |
| 选择器显示“无法读取此项目。请选择其他项目。” | 您失去了对该项目的访问权限 | 向其所有者申请访问权限 |
与其他功能的关联方式
- 可追溯性矩阵:来自各行、使用所选关系的关联列在网格下方的其他项目下;导出…会包含它们(请参阅可追溯性)。
- Spider 图:关联条目显示为其条目周围的虚线框;用选项 → 其他项目关闭它们。
- 项目群地图:管理项目 → 项目群地图显示您的所有项目如何相互关联,其他项目 ⋯ → 在项目群地图中显示则跨其他项目追溯此条目(请参阅项目群地图)。
- 项目群覆盖:您关联到的项目在验证 → 项目群覆盖中按条目和项目列出这些关联(请参阅项目群覆盖)。
- 历史记录和活动:添加和移除关联会记录在条目上。
- 回收站:删除条目会将其关联一起移入回收站;恢复该条目会恢复这些关联。
- 变更请求:添加更改 ▾ → 添加到其他项目的关联…和移除指向其他项目的链接…会暂存关联;它们在应用请求时添加或移除。
- 库:使用版本选项关联到库发布中的条目(请参阅库)。
导出和报告
导出以导出者的访问权限命名关联条目。该人员无法读取的任何内容都写为“其他项目中的条目”。
| 导出 | 到其他项目的关联会怎样 |
|---|---|
| 项目 JSON(数据库导出) | 按存储内容保留:仅 ID。导入该文件会保留它们 |
| ReqIF(数据库和文档) | 每个关联条目上的External links属性:关系、项目 ID 和条目 ID,以及在您可读取时的编号和名称 |
| XMI | 不包含;导出报告将它们计为“Link to another project” |
| 可追溯性矩阵(Excel) | 单独的其他项目工作表 |
| 可追溯性矩阵(CSV) | 一个其他项目列 |
| 需求追溯矩阵(RTM)报告 | 一个 Other Projects 列 |
API 与 MCP
API 和 MCP 以 ID 形式返回关联。要读取名称,请调用解析操作;它使用令牌自身的访问权限和项目列表。项目群地图和条目追溯可通过 GET /api/v1/program-map、GET /api/v1/projects/<project>/items/<item>/trace 以及 MCP 工具 program_map 和 trace_chain 获取。请参阅API 和 MCP。
应用中的 AI 功能只以 ID 形式接收关联。
消息
| 留言 | 含义 |
|---|---|
| 已添加关联。 | 关联已保存 |
| 此条目位于此项目中。请改用“关联现有条目…”。 | 所选条目在同一个项目中 |
| 选择一个条目,然后添加关联。 | 未选择条目就点击了添加关联 |
| 没有可关联的其他项目。请先创建或打开另一个项目。 | 您只有此项目 |
| 关联到其他项目中的条目属于 Team 方案。 | 项目所有者不在 Team 方案中 |
| 一个项目最多包含 20,000 个到其他项目的关联。请先移除一些。 | 项目已达到上限 |
限制
| 限制 | 值 |
|---|---|
| 每个项目的关联数 | 20,000 |
| 每个请求读取的条目数 | 500 |
| 选择器中列出的条目数 | 每次搜索 100 个(缩小搜索范围可查看其他条目) |
关联指向另一个项目的当前版本,或指向库发布中条目的副本(请参阅库)。