需求
計畫群地圖
查看您的專案彼此如何關聯,顯示每對專案的關聯數,並追蹤某一項目跨其他專案的關聯鏈。
本頁內容
概觀
橫跨多個專案(系統專案、子系統專案、測試專案、庫)的計畫群是由指向其他專案的關聯串連起來的。每個關聯都儲存在建立它的專案中,因此沒有任何單一專案能顯示全貌。計畫群地圖可以:它為您能開啟的每個專案繪製一個方框,為每一對專案繪製一個箭頭,並標上關係和關聯數。
此頁面有兩種檢視:
- 專案:您能開啟的每個專案及其之間的關聯,以圖形或表格呈現。
- 項目追溯:一個項目位於中央,其他專案中與其關聯的項目一圈一圈向外排列,最多六步。
計畫群地圖對所有已登入的人開放。關聯本身在 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)的內容與頁面顯示的完全相同。
色彩
| 色彩 | 意義 |
|---|---|
| 藍色箭頭 | 您能開啟的專案之間的關聯 |
| 琥珀色箭頭 | 部分目標已刪除(在垃圾桶中或已不存在) |
| 灰色箭頭 | 指向您無法開啟之專案或庫發行版的關聯,或儲存在其擁有者方案不包含指向其他專案之關聯的專案中 |
使用方式
查看您的專案如何關聯
- 按一下管理專案,然後按計畫群地圖。專案檢視會開啟,顯示每個保存或接收關聯的專案。
- 閱讀箭頭。指向方框可使所有未與其連接的內容變暗。
- 按一下箭頭。屬性面板會列出其關聯,每次 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 專案及其成像需求,然後按一下Add Link(新增關聯)。
- 建立第三個專案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 及其電池組
- 在管理專案上,按一下Project Files ▾ → New Demo Project → Hybrid Car (SysML v2)(專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2))。
- 接著建立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 專案時,電池組示範沒有關聯。
- 開啟管理專案 → 計畫群地圖。地圖會顯示兩個 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(請參閱連結到其他專案) |