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 關聯。地圖會將保存關聯的專案放在它們所指向的專案下方。

誰能看到什麼

地圖只由您能開啟的專案建立:您以任何角色身為成員、不在垃圾桶中,且您符合其組織兩步驟登入規則的專案。

  • 指向您無法開啟之專案的關聯會計入Projects you can't open (N links)(您無法開啟的專案)。該方框絕不會指出專案或項目的名稱,而且無論專案存在、在垃圾桶中或從未存在,看起來都一樣。
  • 儲存在您無法開啟之專案中的關聯不會在任何地方計入,即使它們指向您的專案也一樣。
  • 身為組織管理員並不會增加任何內容:地圖使用專案成員資格。
  • 匯出(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 專案及其成像需求,然後按一下Add Link(新增關聯)。
  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. 在管理專案上,按一下Project Files ▾ → New Demo Project → Hybrid Car (SysML v2)(專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2))。
  2. 接著建立Project Files ▾ → New Demo Project → Hybrid Car Battery Pack (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 專案時,電池組示範沒有關聯。
  3. 開啟管理專案 → 計畫群地圖。地圖會顯示兩個 SysML v2 專案,箭頭為traced from · 3。

提示與良好做法

  • 協議子專案使用的關係(需求用 traced from 或 satisfies,測試用 verifies),讓各處的箭頭讀起來一致。
  • 關閉分組關係即可每種關係顯示一個箭頭,例如用來區分同兩個專案之間的需求關聯和測試關聯。
  • 拖曳方框以排列地圖。位置會依每個範圍保留在此瀏覽器中。
  • 使用表格檢視依關聯數或已刪除目標數排序專案對。
  • 琥珀色箭頭表示需要修復的關聯:開啟其關聯清單,然後在項目的追溯 → 其他專案中修正或移除關聯。

常見錯誤

問題原因修正方式
某個專案不見了您不是其成員、它在垃圾桶中,或它沒有關聯向其擁有者要求存取權;勾選顯示未關聯的專案以列出沒有關聯的專案
所有內容都歸入您無法開啟的專案關聯指向您不是成員的專案向專案擁有者要求存取權
地圖中間出現灰色箭頭保存這些關聯之專案的擁有者沒有 Team 方案擁有者在Account Settings → Plan & Billing(帳戶設定 → 方案與帳單)中升級
新的關聯尚未顯示地圖仍在讀取最近的變更一分鐘後按一下重新整理

與其他功能的關聯

  • 連結到其他專案:地圖讀取它們;不會新增或變更任何內容。請在項目的追溯 → 其他專案中建立關聯(請參閱連結到其他專案)。
  • 計畫群涵蓋範圍:指向一個專案之關聯的逐項檢視,包含缺口(請參閱計畫群涵蓋範圍)。在那裡按開啟計畫群地圖會從該專案開始顯示地圖。
  • 庫:指向庫發行版項目的關聯會顯示為指向該發行版方框的箭頭(請參閱庫)。
  • Spider 圖:專案內的追溯,以虛線方框表示位於他處的關聯項目。項目追溯使用相同的環狀版面配置。
  • API 與 MCP:供工具使用的相同地圖和追溯(請參閱API 與 MCP)。

計畫群地圖頁面

工具列

控制項功能
專案 / 項目追溯切換檢視
範圍我的所有專案、一個組織(當您屬於某個組織時),或一個資料夾及其子資料夾(當您有資料夾時;請參閱專案資料夾)
顯示所有專案從專案開啟地圖後顯示;離開該專案的關聯集合
顯示未關聯的專案也顯示沒有關聯的專案
分組關係每一對專案一個箭頭(標籤列出每種關係),或每種關係一個箭頭
步驟項目追溯:向外 1 至 6 步
依專案分組項目追溯:每個專案的項目周圍加上虛線方框
圖形 / 表格圖或可排序的表格;在窄螢幕上會先開啟表格
重新整理重新讀取關聯
匯出 ▾匯出 CSV、匯出 SVG、匯出 PNG

圖形

  • 按一下方框即可在屬性面板中顯示其專案:開啟專案和僅顯示關聯的專案。按兩下方框,或在其上按 Shift+Enter,即可開啟該專案。
  • 按一下箭頭即可在屬性面板中列出其關聯。
  • 拖曳方框以移動它們;捲動或雙指縮放以縮放;拖曳背景以平移。
  • 按 Tab 移至地圖,然後用方向鍵在方框和箭頭之間移動;Enter 會移至屬性面板。每個方框和箭頭都有螢幕閱讀器會讀出的名稱,例如「EO-1 Payload, LML project, 1 link out, 1 in」。

表格

檢視欄
專案來源專案、關係、目標專案、連結、已刪除
項目追溯專案、編號、名稱、類別、Steps from the item(與項目相隔的步數)、狀態

按一下欄標題即可排序。

屬性面板

選取項目內容
專案方框名稱、類型、項目數、向外和向內的關聯;開啟專案、僅顯示關聯的專案
箭頭來源和目標專案、每種關係的關聯數、關聯清單(每次 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(請參閱連結到其他專案)