需求
项目群地图
查看您的项目之间如何相互关联,显示每对项目之间的关联数,并跟踪一个条目跨其他项目的关联链。
本页内容
概述
跨越多个项目(系统项目、子系统项目、测试项目、库)的项目群通过到其他项目的关联联系在一起。每个关联都存储在创建它的项目中,因此没有哪个项目能显示全貌。项目群地图可以:它为您能打开的每个项目绘制一个框,为每对项目绘制一个箭头,并标注关系和关联数量。
该页面有两个视图:
- 项目:您能打开的每个项目及它们之间的关联,以图形或表格显示。
- 条目追溯:一个条目位于中心,其他项目中与它关联的条目一圈一圈地向外排列,最多六步。
项目群地图向所有已登录的用户开放。关联本身在 Team 方案中创建;存储在所有者方案不包含关联的项目中的关联显示为灰色。Hybrid Car 和 Hybrid Car Battery Pack 演示项目之间的关联在所有方案中均可使用。
概念
地图显示的内容
| 元素 | 含义 |
|---|---|
| 框 | 一个您能打开的项目:其名称、项目类型和条目数;其无障碍名称还会说明它持有和接收的关联 |
| 箭头 | 存储在箭尾项目中、指向箭头端项目中条目的关联 |
| 箭头标签 | 关系 · 关联数 · 已删除,例如 traced from · 12 · 1 deleted |
| 您无法打开的项目(N 个关联) | 一个虚线框,统计指向您无法打开的项目的所有关联 |
| 库发布框 | 您可以读取、且被您的项目关联的库发布 |
箭头通常指向上方:子系统项目存储到系统项目的 traced from 和 satisfies 关联,测试项目存储 verifies 关联。地图将持有关联的项目放在它们所指向的项目下方。
谁能看到什么
地图只根据您能打开的项目构建:您以任意角色作为成员、不在回收站中,并且您满足其组织两步登录规则的项目。
- 指向您无法打开的项目的关联计入您无法打开的项目(N 个关联)。该框从不显示项目或条目的名称,无论该项目存在、在回收站中还是从未存在,看起来都一样。
- 存储在您无法打开的项目中的关联不会计入任何地方,即使它们指向您的项目。
- 组织管理员身份不会增加任何内容:地图使用项目成员资格。
- 导出(CSV、SVG、PNG)的内容与页面显示的完全一致。
颜色
| 颜色 | 含义 |
|---|---|
| 蓝色箭头 | 您能打开的项目之间的关联 |
| 琥珀色箭头 | 部分目标已删除(在回收站中或已不存在) |
| 灰色箭头 | 指向您无法打开的项目或库发布的关联,或存储在所有者方案不包含到其他项目的关联的项目中的关联 |
如何使用
查看您的项目如何关联
- 点击管理项目,然后点击项目群地图。项目视图会打开,显示每个持有或接收关联的项目。
- 阅读箭头。指向一个框可将所有与其不相连的内容变暗。
- 点击一个箭头。属性面板会列出其关联,每次 100 个:持有每个关联的条目、关系和目标条目。点击任一条目可在其项目中打开它,或点击显示更多查看接下来的 100 个。
- 点击属性面板中的导出 CSV保存该箭头的关联,或点击栏中的导出 ▾将整个地图保存为 CSV、SVG 或 PNG。
从一个项目开始
- 打开项目,然后打开验证 → 项目群覆盖,并点击打开项目群地图。
- 地图只显示该项目以及直接或通过其他项目与其关联的项目。
- 点击显示所有项目可查看您能打开的所有内容。
您也可以点击一个框并选择仅显示关联的项目。
在项目群中追溯一个条目
- 选择该条目。在属性面板的追溯部分,打开其他项目 ⋯并选择在项目群地图中显示。也可以在箭头的关联列表中点击追溯此条目。
- 条目追溯视图将条目显示在中心,与其关联的条目排列成环:第一环相距一步,第二环相距两步。关联沿两个方向追踪。
- 选择步数(1 到 6,默认 3),以追踪得更远或更近。
- 条目按项目着色,每个项目的条目周围有一个虚线框。取消勾选按项目分组可移除这些框。
- 点击一个条目可使用打开条目和从此处追溯,后者会将它置于中心。
实例:CubeSat EO-1 演示和一个载荷项目
- 创建 CubeSat EO-1 演示,然后创建第二个项目 EO-1 Payload,其中包含需求 PL.1 Imager resolution。
- 在 EO-1 Payload 中选择 PL.1。在追溯 → 其他项目中点击 +,选择 traced from、CubeSat 项目及其成像需求,然后点击添加关联。
- 创建第三个项目 EO-1 Test Campaign,其中包含测试用例 TC.4 Resolution test,并用 verifies 将其关联到 EO-1 Payload 中的 PL.1。
- 打开管理项目 → 项目群地图。地图在底部显示 EO-1 Test Campaign,其上方是 EO-1 Payload,顶部是 CubeSat 项目,箭头为 verifies · 1 和 traced from · 1。
- 点击 PL.1 → 追溯 ⋯ → 在项目群地图中显示:测试用例和 CubeSat 需求分别位于两侧,相距一步。
实例:Hybrid Car 及其电池组
- 在管理项目上,点击项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)。
- 然后创建项目文件 ▾ → 新建演示项目 → Hybrid Car Battery Pack (SysML v2)。电池供应商的电池组需求 PackCapacity、PackMass 和 ChargeAcceptance 用 traced from 关联到您最新的 Hybrid Car 演示中的整车需求 VR-3、VR-6 和 VR-5,无论这两个演示中哪个先创建;再次创建 Hybrid Car 演示会将这些关联移到新演示。这些演示关联在所有方案中均可使用。没有 Hybrid Car 项目时,电池组演示没有关联。
- 打开管理项目 → 项目群地图。地图显示这两个 SysML v2 项目,箭头为 traced from · 3。
提示和良好做法
- 约定子项目使用的关系(需求用 traced from 或 satisfies,测试用 verifies),使各处的箭头读起来一致。
- 关闭分组关系可每种关系显示一个箭头,例如用于区分相同两个项目之间的需求关联和测试关联。
- 拖动框来排列地图。位置会按范围保存在此浏览器中。
- 使用表格视图按关联数或已删除目标数对项目对排序。
- 琥珀色箭头表示需要修复的关联:打开其关联列表,然后在条目的追溯 → 其他项目中修复或移除这些关联。
常见错误
| 问题 | 原因 | 修正 |
|---|---|---|
| 缺少某个项目 | 您不是其成员、它在回收站中,或它没有关联 | 向其所有者申请访问权限;勾选显示未关联的项目可列出没有关联的项目 |
| 所有内容都归入您无法打开的项目 | 这些关联指向您不是成员的项目 | 向项目所有者申请访问权限 |
| 地图中间出现灰色箭头 | 持有这些关联的项目的所有者没有 Team 方案 | 所有者在账户设置 → 方案与账单中升级 |
| 新关联尚未显示 | 地图仍在读取最近的更改 | 一分钟后点击刷新 |
与其他功能的关联方式
- 到其他项目的关联:地图读取它们,不添加或更改任何内容。在条目的追溯 → 其他项目中创建关联(请参阅关联到其他项目)。
- 项目群覆盖:按条目查看指向一个项目的关联及其缺口(请参阅项目群覆盖)。在那里点击打开项目群地图会从该项目开始显示地图。
- 库:到库发布中条目的关联显示为指向该发布框的箭头(请参阅库)。
- Spider 图:项目内部的追溯,其他地方的关联条目显示为虚线框。条目追溯使用相同的环形布局。
- API 和 MCP:为工具提供相同的地图和追溯(请参阅API 和 MCP)。
项目群地图页面
栏
| 控件 | 功能 |
|---|---|
| 项目 / 条目追溯 | 切换视图 |
| 范围 | 我的所有项目、一个组织(当您属于某个组织时),或一个文件夹及其子文件夹(当您有文件夹时;请参阅项目文件夹) |
| 显示所有项目 | 从项目打开地图后显示;离开该项目的关联集合 |
| 显示未关联的项目 | 同时显示没有关联的项目 |
| 分组关系 | 每对项目一个箭头(标签列出每种关系),或每种关系一个箭头 |
| 步骤 | 条目追溯:向外 1 到 6 步 |
| 按项目分组 | 条目追溯:每个项目的条目周围的虚线框 |
| 图形 / 表格 | 图或可排序的表格;在窄屏上先打开表格 |
| 刷新 | 重新读取关联 |
| 导出 ▾ | 导出 CSV、导出 SVG、导出 PNG |
图形
- 点击一个框可在属性面板中显示其项目:打开项目和仅显示关联的项目。双击一个框,或在其上按 Shift+Enter,可打开该项目。
- 点击一个箭头可在属性面板中列出其关联。
- 拖动框可移动它们;滚动或捏合可缩放;拖动背景可平移。
- 按 Tab 进入地图,然后用方向键在框和箭头之间移动;Enter 进入属性面板。每个框和箭头都有屏幕阅读器可朗读的名称,例如“EO-1 Payload,LML 项目,1 个关联指出,1 个指入”。
表格
| 视图 | 列 |
|---|---|
| 项目 | 源项目、关系、目标项目、关联、已删除 |
| 条目追溯 | 项目、编号、名称、类、距该条目的步数、状态 |
点击列标题可排序。
属性面板
| 所选内容 | 内容 |
|---|---|
| 项目框 | 名称、类型、条目数、指出和指入的关联;打开项目、仅显示关联的项目 |
| 箭头 | 源项目和目标项目、每种关系的关联数、关联列表(每次 100 个,显示更多)、导出 CSV,每行有追溯此条目 |
| 条目(条目追溯) | 编号和名称、类、项目、距被追溯条目的步数、状态;打开条目、从此处追溯 |
| 您无法打开的项目 | “到您无法打开的项目的关联。请向项目所有者申请访问权限。” |
API 与 MCP
REST API 和 MCP 以令牌自身的访问权限和项目列表给出相同的结果。已关闭 API 访问的组织的项目会被排除,与您无法打开的项目一样。
| 调用 | 返回 |
|---|---|
GET /api/v1/program-map | 项目、发布、箭头(from、to、relation、links、deleted、plan)和隐藏计数;from、unlinked、org 与页面中相同 |
GET /api/v1/projects/<project>/items/<item>/trace | 条目追溯:包含项目、编号、名称、类和步数的节点、它们之间的关联以及隐藏计数;steps 为 1–6(默认 3) |
MCP program_map | 与 GET /program-map 相同 |
MCP trace_chain | 与追溯调用相同;带有受管制数据密级标识的项目中的条目返回 withheld |
请参阅API 和 MCP。
消息
| 留言 | 含义 |
|---|---|
| 您的项目之间没有关联。请从条目的“追溯”部分添加一个。 | 您的项目都没有持有或接收您可见的关联 |
| 此项目没有到其他项目的关联。请从条目的“追溯”部分添加一个。 | 地图是从没有关联的项目打开的 |
| 此条目没有与其他项目的关联。请从其“追溯”部分添加。 | 被追溯的条目没有关联 |
| 部分项目仍在读取中。请一分钟后刷新。 | 大型项目中最近的更改仍在读取;地图显示已就绪的内容 |
| 显示前 500 个条目。请减少步数。 | 条目追溯已达到上限 |
| 来自所有者方案不包含到其他项目的关联的项目中的 N 个关联未被追踪。 | 条目追溯跳过了在不包含关联的方案下存储的关联 |
| 无法读取项目群地图。请重新加载页面。 | 请求失败 |
限制
| 限制 | 值 |
|---|---|
| 条目追溯步数 | 1 到 6 |
| 条目追溯中的条目数 | 500 |
| 箭头列表中每页列出的关联数 | 100 |
| 每个项目的关联数 | 20,000(请参阅关联到其他项目) |