Holarch

需求

项目群地图

查看您的项目之间如何相互关联,显示每对项目之间的关联数,并跟踪一个条目跨其他项目的关联链。

使用方法 →

本页内容
  1. 概述
  2. 概念
    1. 地图显示的内容
    2. 谁能看到什么
    3. 颜色
  3. 如何使用
    1. 查看您的项目如何关联
    2. 从一个项目开始
    3. 在项目群中追溯一个条目
    4. 实例:CubeSat EO-1 演示和一个载荷项目
    5. 实例:Hybrid Car 及其电池组
    6. 提示和良好做法
    7. 常见错误
    8. 与其他功能的关联方式
  4. 项目群地图页面
    1. 栏
    2. 图形
    3. 表格
    4. 属性面板
  5. API 与 MCP
  6. 消息
  7. 限制
  8. 相关内容

概述

跨越多个项目(系统项目、子系统项目、测试项目、库)的项目群通过到其他项目的关联联系在一起。每个关联都存储在创建它的项目中,因此没有哪个项目能显示全貌。项目群地图可以:它为您能打开的每个项目绘制一个框,为每对项目绘制一个箭头,并标注关系和关联数量。

该页面有两个视图:

  • 项目:您能打开的每个项目及它们之间的关联,以图形或表格显示。
  • 条目追溯:一个条目位于中心,其他项目中与它关联的条目一圈一圈地向外排列,最多六步。

项目群地图向所有已登录的用户开放。关联本身在 Team 方案中创建;存储在所有者方案不包含关联的项目中的关联显示为灰色。Hybrid Car 和 Hybrid Car Battery Pack 演示项目之间的关联在所有方案中均可使用。

概念

地图显示的内容

元素含义
框一个您能打开的项目:其名称、项目类型和条目数;其无障碍名称还会说明它持有和接收的关联
箭头存储在箭尾项目中、指向箭头端项目中条目的关联
箭头标签关系 · 关联数 · 已删除,例如 traced from · 12 · 1 deleted
您无法打开的项目(N 个关联)一个虚线框,统计指向您无法打开的项目的所有关联
库发布框您可以读取、且被您的项目关联的库发布

箭头通常指向上方:子系统项目存储到系统项目的 traced from 和 satisfies 关联,测试项目存储 verifies 关联。地图将持有关联的项目放在它们所指向的项目下方。

谁能看到什么

地图只根据您能打开的项目构建:您以任意角色作为成员、不在回收站中,并且您满足其组织两步登录规则的项目。

  • 指向您无法打开的项目的关联计入您无法打开的项目(N 个关联)。该框从不显示项目或条目的名称,无论该项目存在、在回收站中还是从未存在,看起来都一样。
  • 存储在您无法打开的项目中的关联不会计入任何地方,即使它们指向您的项目。
  • 组织管理员身份不会增加任何内容:地图使用项目成员资格。
  • 导出(CSV、SVG、PNG)的内容与页面显示的完全一致。

颜色

颜色含义
蓝色箭头您能打开的项目之间的关联
琥珀色箭头部分目标已删除(在回收站中或已不存在)
灰色箭头指向您无法打开的项目或库发布的关联,或存储在所有者方案不包含到其他项目的关联的项目中的关联

如何使用

  1. 点击管理项目,然后点击项目群地图。项目视图会打开,显示每个持有或接收关联的项目。
  2. 阅读箭头。指向一个框可将所有与其不相连的内容变暗。
  3. 点击一个箭头。属性面板会列出其关联,每次 100 个:持有每个关联的条目、关系和目标条目。点击任一条目可在其项目中打开它,或点击显示更多查看接下来的 100 个。
  4. 点击属性面板中的导出 CSV保存该箭头的关联,或点击栏中的导出 ▾将整个地图保存为 CSV、SVG 或 PNG。

从一个项目开始

  1. 打开项目,然后打开验证 → 项目群覆盖,并点击打开项目群地图。
  2. 地图只显示该项目以及直接或通过其他项目与其关联的项目。
  3. 点击显示所有项目可查看您能打开的所有内容。

您也可以点击一个框并选择仅显示关联的项目。

在项目群中追溯一个条目

  1. 选择该条目。在属性面板的追溯部分,打开其他项目 ⋯并选择在项目群地图中显示。也可以在箭头的关联列表中点击追溯此条目。
  2. 条目追溯视图将条目显示在中心,与其关联的条目排列成环:第一环相距一步,第二环相距两步。关联沿两个方向追踪。
  3. 选择步数(1 到 6,默认 3),以追踪得更远或更近。
  4. 条目按项目着色,每个项目的条目周围有一个虚线框。取消勾选按项目分组可移除这些框。
  5. 点击一个条目可使用打开条目和从此处追溯,后者会将它置于中心。

实例:CubeSat EO-1 演示和一个载荷项目

  1. 创建 CubeSat EO-1 演示,然后创建第二个项目 EO-1 Payload,其中包含需求 PL.1 Imager resolution。
  2. 在 EO-1 Payload 中选择 PL.1。在追溯 → 其他项目中点击 +,选择 traced from、CubeSat 项目及其成像需求,然后点击添加关联。
  3. 创建第三个项目 EO-1 Test Campaign,其中包含测试用例 TC.4 Resolution test,并用 verifies 将其关联到 EO-1 Payload 中的 PL.1。
  4. 打开管理项目 → 项目群地图。地图在底部显示 EO-1 Test Campaign,其上方是 EO-1 Payload,顶部是 CubeSat 项目,箭头为 verifies · 1 和 traced from · 1。
  5. 点击 PL.1 → 追溯 ⋯ → 在项目群地图中显示:测试用例和 CubeSat 需求分别位于两侧,相距一步。

实例:Hybrid Car 及其电池组

  1. 在管理项目上,点击项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)。
  2. 然后创建项目文件 ▾ → 新建演示项目 → Hybrid Car Battery Pack (SysML v2)。电池供应商的电池组需求 PackCapacity、PackMass 和 ChargeAcceptance 用 traced from 关联到您最新的 Hybrid Car 演示中的整车需求 VR-3、VR-6 和 VR-5,无论这两个演示中哪个先创建;再次创建 Hybrid Car 演示会将这些关联移到新演示。这些演示关联在所有方案中均可使用。没有 Hybrid Car 项目时,电池组演示没有关联。
  3. 打开管理项目 → 项目群地图。地图显示这两个 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(请参阅关联到其他项目)