Holarch

需求

連結到其他專案

將項目追溯到另一個專案中的需求、功能或測試;每個人只有在能開啟該專案時,才會看到被關聯的項目。

使用方式 →

本頁內容
  1. 概觀
  2. 概念
    1. 關聯保存的內容
    2. 誰能看到什麼
    3. 關聯狀態
    4. 已變更的目標
  3. 使用方式
    1. 使用時機與原因
    2. 新增關聯
    3. 開啟關聯的項目
    4. 移除關聯
    5. 實作範例:酬載子系統和 CubeSat EO-1 示範
    6. 提示與良好做法
    7. 常見錯誤
    8. 與其他功能的關聯
  4. 匯出和報告
  5. API 與 MCP
  6. 訊息
  7. 限制
  8. 相關內容

概觀

指向其他專案的關聯是從此專案中的項目到另一個專案中項目的追溯關係,例如子系統需求 traced from 系統規格中的需求,或某個測試程序 verifies 另一個團隊維護的需求。

該關聯是此專案的一部分。它只儲存兩個項目的 id 和關係。關聯項目的編號、名稱、類別和狀態會在您每次檢視時,以您自己的存取權從其所屬專案讀取:

  • 當您可以開啟另一個專案時,您會看到該項目,並可按一下前往。
  • 當您無法開啟時,您會看到您無法開啟的專案中的項目。名稱絕不會傳送給您,無論是在應用程式中、匯出中、透過 API 或透過 AI 工具。

指向其他專案的關聯屬於 Team 方案。由專案擁有者的方案決定。在其他方案中,現有的關聯仍可見且可移除,但無法新增。Hybrid Car 和 Hybrid Car Battery Pack 示範專案之間的關聯在每個方案中都可使用。

概念

組成意義
來源此專案的項目
關係此專案結構描述中的關係,例如 traced from、satisfies 或 verified by
目標專案的 id 及其中項目的 id

關係會依來源的類別檢查。建立關聯時不會檢查目標的類別,因為關聯絕不讀取另一個專案的內容。當目標的類別不符合該關係時,追溯區段會顯示 ⚠ 和「This relation does not usually point to …」(此關係通常不會指向 …)。

誰能看到什麼

每個人都以其在該項目所屬專案中的角色檢視每個關聯項目:

您對另一個專案的存取權您會看到的內容
任何角色(Owner、Editor、Reviewer、Viewer)編號、名稱、專案,以及開啟該項目的連結
無,或專案已不存在您無法開啟的專案中的項目

不存在的專案和您無法開啟的專案看起來相同,因此關聯絕不會透露某個專案是否存在。

顯示意義處理方式
編號與名稱該項目存在,且您可以開啟其專案無
已在 <project> 中刪除該項目在其專案的垃圾桶中請可編輯該專案的人還原它,或移除該關聯
已刪除該項目已不存在移除該關聯(Remove Broken Links,移除失效的關聯)
您無法開啟的專案中的項目您沒有該專案的存取權,或專案已不存在如有需要,請向專案擁有者要求存取權
載入中…正在讀取該項目請稍候

名稱會在頁面顯示該關聯時讀取,在您離開一分鐘後返回分頁時再次讀取,並且每五分鐘讀取一次。重新命名的項目會顯示其新名稱,此專案不需任何變更。

已變更的目標

當關聯的項目在建立關聯或上次審查後於其專案中被編輯,該列會顯示已變更。指向它可查看日期。確認關聯仍然成立,然後:

  • 按一下該列上的✓,將該關聯標記為已審查。
  • 按一下其他專案旁的⋯,然後按Mark All Reviewed (n)(全部標記為已審查),處理該項目所有被標示的關聯。
  • 或開啟需要與需求 → 待檢查的連結:卡片在其他專案中已變更會列出專案所有被標示的關聯,每列有✓,另有全部標記為已審查。

標記為已審查會顯示在項目的歷程記錄和活動中,一次復原即可撤回。審查者和檢視者可以看到標示,但無法清除。指向庫發行版的關聯不會被標示(發行版不會變更)。

使用方式

使用時機與原因

當一個模型會太大或由不同團隊擁有時,請使用指向其他專案的關聯:系統規格及其子系統規格、產品線的共用需求和各個產品,或客戶的需求和您的設計。將關聯保存在較低層級的專案中,向上指向:每個子系統都從系統需求追溯其需求 (from)。

在單一專案內請使用一般關係。追溯區段中的關聯現有…會關聯同一專案的項目;指向其他專案的關聯則用於位於他處的項目。

  1. 選取項目,例如子系統需求。
  2. 在屬性面板中開啟追溯區段。在其他專案下按一下+(新增到其他專案的關聯…)。
  3. 選擇Relation(關係),例如 traced from。
  4. 選擇專案。其項目會依編號列出。
  5. 對於庫,請選擇版本:目前(工作複本)或發行版,例如Release 1.1。指向發行版的關聯會顯示其標籤而不是目前,且其名稱不會開啟頁面。
  6. 在搜尋中輸入以依編號或名稱尋找項目。選擇類別以只列出該類別。
  7. 按一下該項目,然後按一下Add Link(新增關聯)。快顯通知顯示「已新增關聯。」,該項目會出現在其他專案下。

一次復原即可移除該關聯。再次新增相同的關聯會保留現有的關聯。

開啟關聯的項目

按一下關聯項目的名稱。其專案會在該項目處開啟。

  • 按一下關聯列上的×即可移除一個關聯。
  • 當關聯指向已刪除的項目時,請按一下其他專案旁的⋯,然後按Remove Broken Links (n)(移除失效的關聯)。

移除關聯只會變更此專案。另一個專案絕不會因關聯而變更。

實作範例:酬載子系統和 CubeSat EO-1 示範

  1. 建立名為EO-1 Payload的專案,其中有需求PL.1 Detector pixel pitch shall be at most 5.5 µm。
  2. 選取PL.1,開啟追溯 → 其他專案 → +。
  3. 選擇 traced from、專案CubeSat EO-1,搜尋ground sample,然後按一下1.2 Ground Sample Distance。按一下Add Link(新增關聯)。
  4. 該列顯示traced from 1.2 Ground Sample Distance CubeSat EO-1 · current。只能開啟EO-1 Payload的同事會在同一列上看到您無法開啟的專案中的項目。

提示與良好做法

  • 從較低層級關聯到較高層級,這樣新增子系統時系統專案不必變更。
  • 將較高層級的專案以 Viewer 身分共用給處理較低層級專案的人員,讓他們能看到名稱。
  • 在較高層級的專案重新組織後,執行Remove Broken Links(移除失效的關聯)。

常見錯誤

問題原因修正方式
「此項目在此專案中。請改用關聯現有…。」目標在同一個專案中使用該關係群組中的關聯現有…
其他專案下沒有+您只能檢視該專案,或該項目已鎖定請要求 Editor 角色,或解除鎖定該項目
「指向其他專案中項目的關聯屬於 Team 方案。」專案擁有者不是 Team 方案在Account Settings → Plan & Billing(帳戶設定 → 方案與帳單)中升級
選擇器顯示「無法讀取此專案。請選擇其他專案。」您已失去該專案的存取權請向其擁有者要求存取權

與其他功能的關聯

  • 可追溯性矩陣:列透過所選關係建立的關聯會列在格線下方的其他專案下;匯出…會將它們加入(請參閱可追溯性)。
  • Spider 圖:關聯的項目會以虛線方框顯示在其項目周圍;以Options → Other projects(選項 → 其他專案)將其關閉。
  • 計畫群地圖:Manage Projects → Program Map(管理專案 → 計畫群地圖)顯示您所有專案之間的關聯方式,Other projects ⋯ → Show in Program Map(其他專案 ⋯ → 在計畫群地圖中顯示)則會透過其他專案追溯此項目(請參閱計畫群地圖)。
  • 計畫群涵蓋範圍:您關聯到的專案會在驗證 → 計畫群涵蓋範圍上依項目和專案列出這些關聯(請參閱計畫群涵蓋範圍)。
  • 歷程記錄和活動:新增和移除關聯會記錄在該項目上。
  • 垃圾桶:刪除項目會將其關聯一併移至垃圾桶;還原該項目會還原這些關聯。
  • 變更請求:Add Change ▾ → Add a Link to Another Project…(新增變更 ▾ → 新增到其他專案的關聯…)和移除指向其他專案的連結…會暫存關聯;在套用請求時新增或移除。
  • 庫:以版本選項關聯到庫發行版的項目(請參閱庫)。

匯出和報告

匯出會以匯出者的存取權來指出關聯項目的名稱。該人員無法讀取的任何內容都會寫成「Item in another project」(其他專案中的項目)。

匯出指向其他專案之關聯的處理方式
專案 JSON(資料庫匯出)依儲存方式保留:僅 id。匯入檔案時會保留它們
ReqIF(資料庫和文件)每個關聯項目上的External links(外部關聯)屬性:關係、專案 id 和項目 id,可讀取時另加編號和名稱
XMI省略;匯出報告將其計為「Link to another project」(指向其他專案的關聯)
可追溯性矩陣 (Excel)獨立的其他專案工作表
可追溯性矩陣 (CSV)一個其他專案欄
需求可追溯性矩陣 (RTM) 報告一個Other Projects(其他專案)欄

API 與 MCP

API 和 MCP 以 id 傳回關聯。若要讀取名稱,請呼叫 resolve 操作;它使用權杖自己的存取權和專案清單。計畫群地圖和項目追溯可透過 GET /api/v1/program-map、GET /api/v1/projects/<project>/items/<item>/trace 以及 MCP 工具 program_map 和 trace_chain 取得。請參閱API 與 MCP。

應用程式中的 AI 功能只會以 id 接收關聯。

訊息

訊息意義
已新增關聯。關聯已儲存
此項目在此專案中。請改用關聯現有…。所選項目在同一個專案中
請選擇項目,然後新增關聯。按了Add Link(新增關聯)但未選擇項目
沒有其他專案可關聯。請先建立或開啟另一個專案。您只有此專案
指向其他專案中項目的關聯屬於 Team 方案。專案擁有者不是 Team 方案
一個專案最多保存 20,000 個指向其他專案的關聯。請先移除一些。專案已達上限

限制

限制值
每個專案的關聯數20,000
每次請求讀取的項目數500
選擇器中列出的項目數每次搜尋 100 個(縮小搜尋範圍以查看其他項目)

關聯指向另一個專案的目前版本,或指向庫發行版中項目的副本(請參閱庫)。