控制與審查
產品線與組態
在單一專案中以特性和組態建立多項產品的模型,以 Applies To 和適用性指出哪些項目適用於哪些產品,以單一組態檢視和編輯模型,並依組態產生文件、RVTM 和基準線。
本頁內容
概觀
產品線是共用大部分同一設計的一系列產品。將共用的設計建模一次,標示產品之間的差異,並將每項產品定義為一個組態。之後每個頁面都可以將模型顯示為單一組態,而對共用設計的每項變更都會套用到每項產品。
您會在以下位置使用產品線:
- 控制與審查 → 產品線:特性、其規則,以及由特性組成的組態。
- 屬性面板的產品線群組:所選項目的適用於和適用性。
- 頂端列中的檢視方式 ▾:以單一組態顯示和編輯模型。
- 文件、RVTM、測試中心、基準線和版本以及變更請求:依組態的輸出與控制。
產品線屬於 Individual 和 Team 方案。各組態的基準線、組態擁有者,以及變更請求所影響的組態屬於 Team 方案。請參閱方案。
概念
功能
特性是產品之間不同的選擇,例如「X-band Downlink」或「Propulsion」。特性構成一棵樹:父特性將相關的選擇歸為一組。
每個特性具有:
- 種類:必要(每個具有父特性的組態也都具有它)或選用(依組態選擇)。新特性為選用。
- 子項:對其子特性的規則。任意數量(自由選擇)、擇一(每個組態恰好一個子項)或至少選一(一個或多個)。新特性為任意數量。
- 規則:一個特性需要另一個特性,或排除它。排除是雙向的。
- 約束:選用的規則,在任何選取該特性的組態中都必須成立,寫法與適用於相同。
組態
組態是一項產品:特性的一組選擇。每個組態具有:
- 編號和名稱,例如CFG-2 EO-1 Lite。
- 狀態:草稿、已發行或已淘汰。新組態為草稿,已發行組態的副本(複製、複製貼上、匯入到開啟的專案)也是:它沒有自己的發行記錄。已淘汰的組態可以檢視但無法編輯。組態以發行組態…發行(請參閱發行組態)。
- 階段(選用):它所處的生命週期階段,例如初步設計或CDR。階段決定適用哪些完整性規則。
- 擁有者(選用,Team 方案):必須核准變更它的變更請求的人員或團隊。
- 適用性(選用):依它製造的單元的序號或製造日期。
組態的有效選擇不只是您勾選的特性:
- 已選取的特性;
- 其父特性,一直到根;
- 每個已選取特性的必要子項;
- 樹根層的必要特性。
判定
Holarch 會依特性規則檢查每個組態,並顯示判定:
- 有效:選擇符合每條規則。
- 違反:…:違反了某條規則,例如「違反:Encrypted Downlink 需要 X-band Downlink。」
- 不完整:…:缺少某個選擇,例如「不完整:請選擇一個 Downlink(擇一)。」
多條規則不符時,判定會依以下順序指出第一條:被另一個已選取特性排除的必要特性、沒有選擇或選擇超過一個的擇一群組、沒有選擇的至少選一群組、未滿足的需要、違反的排除、不成立的約束。
完整性
有效判定只涵蓋特性規則。完整性則檢查組態所包含的項目:
- 其中每個末端需求都由其中的某個項目驗證(適用於它的測試案例);
- 其中每個連接(Conduit)的兩端都在其中,且每個有自己適用於的關係,其兩端都在它所適用的組態中;
- 其中每個項目的父項都在其中。
每個組態顯示完成或缺口數,例如「3 個缺口」。已淘汰的組態不受檢查。完整性忽略適用性:項目適用於某組態時,即屬於該組態。
各階段的完整性
組態的階段決定要檢查多少內容。每個階段使用五個等級之一:
| 層級 | 預設階段 | 檢查 |
|---|---|---|
| 1 | 概念 | 每個項目的父項都在組態中。 |
| 2 | 初步設計 | 等級 1,每個連接的兩端都在其中,且每個末端需求都由其中的某個項目滿足。 |
| 3 | 詳細設計 | 等級 2,且每個末端需求都由其中的某個項目驗證。 |
| 4 | Test | 等級 3,每個驗證用的測試案例都有程序(說明或測試步驟)以及此組態的結果。 |
| 5 | 生產 | 等級 4,每個驗證用的測試案例在此組態都為 Passed,且沒有未解決的問題連結到其項目。 |
有 SE 流程時,階段清單改為其審查關卡(SRR、PDR、CDR、TRR 等),各有一個等級:SRR 為 1、PDR 為 2、CDR 為 3、TRR 為 4,生產和營運審查為 5。沒有階段時,完整性使用上文完整性下的規則(需求已驗證、連接兩端、父項)。
若要變更階段的等級,請開啟產品線頁面的⋯ → 設定…,並在階段下選擇等級。一次復原即可撤回此變更。
完整性列會分別顯示模型完整性和驗證,例如「在 CDR 已完整 · 12/40 已驗證」:第一部分是該階段的檢查,第二部分是在此組態中有 Passed 結果的需求。驗證從等級 3 起以及沒有階段時顯示。
發行組態
組態以發行組態…發行:在產品線頁面開啟該組態欄的⋯,或按 ⌘K / Ctrl+K 並輸入「發行」。在屬性面板或資料庫中將狀態設為已發行也會開啟同一個對話方塊。
對話方塊顯示:
- 階段:發行所針對的階段。會依該階段檢查完整性。
- 特性規則和修訂:違反規則,或同時有兩個修訂生效的組態無法發行:「CFG-2 無法發行。違反:Wallbox 需要 Large pack。請先在產品線頁面變更其選擇。」
- 該階段的完整性,含顯示缺口,以及驗證(其中有多少需求已驗證)。
- 未關閉的高風險,僅在完整性等級 5(生產)的階段:組態中處於高等級(有設定殘餘等級時以殘餘等級為準)且尚未關閉的風險和危害,例如「Risk RSK-1 Battery fire:High、Open」。這只是警告:它不會阻擋發行,也不需要理由。Risk 只要其 Status 為 Open 且不是 Opportunity 就會計入;Hazard 在成為 Accepted 或 Closed 之前都會計入。
- 發行條件,僅在組態不完整時:原因(10 到 2,000 個字元)和核准者。兩者都填寫之前,發行版本會保持停用。
按一下發行版本。組態的 Status 會變成 Released,Holarch 會保留一份發行記錄:階段、發行時的完整性和驗證、接受的缺口、原因和核准者,以及已發行的定義(請見下文)。一次復原即可同時撤回發行及其記錄。
完整性和驗證會依 Holarch 在發行時於您的瀏覽器中計算的結果記錄。線上版 Holarch 會檢查已發行的定義是否符合其 SHA-256 摘要,並拒絕檔案不符的發行;目前還不會再次檢查完整性。
由誰核准:
- 桌面應用程式:輸入核准者的姓名。它會記錄為依姓名輸入;這份 Holarch 沒有帳戶。
- 線上版 Holarch,Individual 方案:您核准自己的發行;伺服器會記錄您的帳戶和時間。
- 線上版 Holarch,Team 方案:由組態的擁有者核准,沒有擁有者時則由專案擁有者核准。不完整的發行會以待核准狀態等候,直到核准者在其上開啟發行組態…並按一下核准發行(Holarch 會要求輸入其密碼)。只有在專案允許自我核准時(變更請求 → 設定),您才能核准自己的請求。完整的發行不需要核准。
伺服器會拒絕不附發行記錄、將 Status 變更為 Released 的操作,因此 API 用戶端或舊版頁面無法略過此對話方塊。它也會拒絕移除或變更發行記錄的專案儲存,即使來自專案擁有者也一樣。
撤回發行…(欄的 ⋯,或將 Status 改回 Draft 或 Retired)會要求填寫原因。發行記錄會保留,其記錄中會加入撤回;發行記錄永遠不會被刪除。再次發行會成為第 2 次發行。
記錄發行…(欄的 ⋯)提供給在發行記錄功能推出前就已發行的組態。它會將組態今天的狀態記錄為其發行,並標示為「後來記錄」。
- 一次為多個組態設定狀態(資料庫 → 屬性…)時,會列出違反規則而保持草稿的組態,並為其餘每個組態依序開啟發行組態…。
- 請在即時模型中撤回發行,而非在變更請求中。若要透過變更請求發行組態,請暫存該發行(請參閱透過變更請求發行)。只將組態的 Status 設為 Released 的變更請求,在套用時並不會發行它;組態保留其 Status,變更請求的其餘部分照常套用。
- AI 或 MCP 提案無法發行組態:其審查會顯示「需要發行記錄」並提供發行組態…;套用提案時會套用其其他變更。
SysML v2 專案的組態目前還無法發行。
透過變更請求發行
發行可以是變更請求的一部分,讓核准變更的委員會同時核准發行。在變更請求中工作(或開啟它)時,請暫存發行:
- 在變更請求上,選擇新增變更 ▾ → 發行組態…,然後選擇組態。
- 在產品線頁面,選擇該組態欄的⋯ → 以 CR-12 發行…。
- 在屬性面板或資料庫中,將狀態設為已發行。
對話方塊相同,標題為「以 CR-12 發行 CFG-2」。它會依變更請求套用後的模型,檢查所選階段的完整性,並在等級 5 列出未關閉的高風險;當階段報告的結果低於上次發行,或在下一個階段留有缺口時會發出警告。組態不完整時,請輸入原因;請求的核准者取代核准者欄位。按一下加入 CR-12:發行會暫存為一項變更(「在 CDR 發行 CFG-2」),組態在此之前保持草稿(其欄的狀態標籤顯示「發行已暫存於 CR-12」),且該組態會被視為受此請求影響,因此在適用核准規則時需要其擁有者核准。
套用已核准的請求時,Holarch 會發行該組態並保留其發行記錄,其中的階段、原因和接受的缺口與暫存時相同,並附上請求的核准者和via CR-12。一次復原即可同時撤回已套用的請求與發行。若在套用時組態已被刪除或淘汰、已發行或正在等候核准、違反特性規則,或有請求未接受的缺口,Holarch 不會發行它。請求的其餘部分仍會套用,請求的記錄和結果會說明原因。修正後請再次暫存發行。
線上版 Holarch 會依請求的投票(帳戶和時間來自伺服器)記錄核准,絕不使用頁面中輸入的姓名。由請求核准的不完整發行不需要另外核准發行。只有套用請求的人才能記錄其發行,且須在核准檢查後一小時內;專案儲存或 API 用戶端無法透過變更請求新增發行。
已發行的定義
每份發行記錄都會保留發行時的組態:其項目和關係及其值、選擇、所使用的庫特性和組態、發行時讀取的其他專案中的連結項目,以及驗證結果。它以附 SHA-256 摘要的壓縮檔儲存在專案中。
在基準線和版本上,發行卡片列出每次發行及其組態、階段、完整性、核准者、日期和狀態。其⋯選單提供:
- 開啟已發行的定義:已發行的項目及其發行時的值(例如組態自己的 Mass),唯讀。
- 驗證:檢查紀錄是否符合其摘要(完整無損),並以紀錄本身的輸入重建組態(精確重現):其快照、它凍結的庫特性和組態,以及解析時使用的結構描述。之後的編輯、新的庫發行、變更的連結項目,以及重新命名的類別、屬性或關係都不會改變結果。
- 與今天比較:組態現在顯示的內容與發行時相比,包括移到另一次發行的庫(以其發行標籤命名)和之後變更的連結項目。
- 匯出(JSON):紀錄及其定義。
- 撤回…
適用於與適用性
任何項目或關係上的兩個欄位指出它屬於哪些產品:
- 適用於指出哪些組態包含該項目。它是由特性和組態組成的運算式,例如
F-4 and not F-5。空白表示每個組態。 - 適用性指出項目從哪個單元或日期起生效:序號如
1-20, 25, 40-、日期範圍,或兩者兼有。空白表示一律生效。
兩者彼此獨立且會結合:項目適用於該組態且在檢視的序號或日期生效時,才會出現在檢視中。
共用的身分與組態值
項目在每個組態中都是同一個項目。其名稱、編號、類別、標籤和負責人在各處都相同,其在階層中的位置、文件順序和圖的版面配置也相同。
其說明和屬性值可以不同。組態值是項目針對某個組態的自有值,例如 EO-1 Lite 中的 Daily Data Volume 為 1 GB,而其他組態保持 3 GB。沒有自有值的組態會使用項目的基礎值。
150 % 檢視
所有組態(未選擇組態)會顯示整條產品線:每項產品的每個項目,以基礎值顯示。依組態而不同的欄位會標示為不同。這是用來重新編號、還原基準線和在各處刪除項目的檢視。
使用方式
使用時機與原因
當多項產品共用大部分需求、功能和架構時,請使用產品線:飛行單元和較輕的變體、出口版本、客戶選項、批次升級。單一模型讓共用部分保持同步。每個組態仍有自己的規格書、RVTM 和基準線。
建議的工作順序:
- 照常建模共用的設計。
- 將產品之間的差異點列為特性,並附上其規則。
- 為每項產品新增一個組態,並檢查每個組態是否有效。
- 以適用於標示只有部分產品具有的項目,並以組態值標示不同的值。
- 產生文件並驗證每個組態。
如果您的產品只有製造日期或序號不同,請建立單一組態(例如「Production」),並只使用適用性。
開始產品線
- 按 ⌘K / Ctrl+K 並選擇開始產品線…:它會開啟該頁面和新增特性對話方塊。或在資料庫中以+ 新增項目建立特性或組態項目。導覽列中會出現控制與審查 → 產品線,每個項目的屬性面板中會出現產品線群組。
- 在產品線頁面上,按一下+ 新增特性並輸入特性的名稱,例如「Downlink」。按 Enter。名稱會被儲存,並開始新的同層列。
- 輸入下一個特性的名稱。若要將其設為上一列的子項,請按 ⌥⇧→ / Alt+Shift+→。⌥⇧← / Alt+Shift+← 會將它移回外層。
- 在屬性面板中設定每個特性的種類和子項(在其列上按 Enter)。
- 從列的⋯選單新增規則:規則…用於需要和排除,約束…用於約束。
在專案有第一個特性或組態之前,產品線頁面、屬性面板群組和適用於欄都會保持隱藏。刪除最後一個時會再次隱藏,但仍持有適用於或適用性值的項目除外。
建立組態
- 在產品線頁面上,按一下+ 新增組態。輸入名稱,例如「EO-1 Lite」。組態中會出現新的一欄。
- 勾選此產品具有的特性。在擇一群組中,儲存格是選項按鈕:選擇一個會取代另一個。標示為隱含的儲存格是因其他特性(父特性或必要子項)而被納入;它們無法變更。
- 查看欄下方的判定列。修正選擇,直到它顯示有效。
- 查看完整性列。將指標移到缺口數上即可查看缺口。
- 按一下檢查組態,一次檢查每個組態。
若要從現有產品開始,請開啟該組態欄標題的⋯選單並選擇複製副本。副本具有相同的選擇和相同的組態值。
指出哪些項目屬於哪些產品
- 選取一個項目(例如需求),然後開啟屬性面板的產品線群組。
- 在適用於中輸入特性或組態編號,例如
F-4。以 ↓ 和 Enter 從建議清單中選取。欄位下方的那一行會顯示,例如「適用於 2 個組態中的 1 個:CFG-1」。 - 以
and、or、not和括號組合條件:F-3 and not F-5。 - 或按一下選擇…,從清單中選取組態或特性。
每項產品都有的項目,其適用於保持空白。大多數項目都保持空白。
檢視和編輯單一組態
- 按一下頂端列中的檢視方式 ▾並選擇一個組態。您會看到橫幅:「正在檢視組態 CFG-2 EO-1 Lite。新項目僅適用於 CFG-2;變更的值歸 CFG-2 所有。」現在每個頁面只顯示 CFG-2 的項目,並使用 CFG-2 的值。
- 照常工作。新項目適用於 CFG-2。當其他組態也有該項目時,變更的說明或屬性會成為 CFG-2 的自有值。
- 按一下橫幅中的離開,即可再次查看所有組態。
此選擇屬於該瀏覽器分頁。其他人和其他分頁保有各自的檢視。所有規則請參閱在組態檢視中編輯。
為組態指定自己的值
- 在檢視方式 ▾中選擇組態。
- 選取項目,並在屬性面板中變更屬性。編輯時,欄位下方的提示會顯示,例如「僅為 CFG-2 儲存。其他組態保留 3 GB。」變更後,欄位會顯示CFG-2 值標籤。
- 若要取消差異,請開啟該標籤的選單並選擇使用基礎值。
為單一組態產生規格書
- 開啟文件,按一下交付 ▾並選擇 Word 範本,例如規格書(Word)。您會看到匯出至 Word對話方塊。
- 將組態設為該產品,並將適用性設為任意單元、序號或日期。
- 匯出文件。文件會略去不適用的章節,其餘章節依顯示的方式編號,並在標題頁、頁尾和檔案名稱中寫明組態。
實例演練:CubeSat EO-1 示範
CubeSat EO-1 示範專案有兩項產品:EO-1 Flight,具有 X-band 下行鏈路和加密;以及EO-1 Lite,具有 S-band 下行鏈路。在「管理專案」中以專案檔案 ▾ → 新增示範專案建立示範專案。
- 開啟控制與審查 → 產品線。您會看到特性Downlink(必要、擇一),含S-band Downlink和X-band Downlink;Encrypted Downlink(選用,需要 X-band Downlink);以及Propulsion(選用,需要 X-band Downlink)。
- 查看組態CFG-1 EO-1 Flight(X-band 和 Encrypted Downlink,序號 1–2)和CFG-2 EO-1 Lite(S-band,序號 3 及以後)。兩者的判定都顯示有效。
- 在 CFG-2 欄中勾選Encrypted Downlink。判定會變更為「違反:Encrypted Downlink 需要 X-band Downlink。」按 ⌘Z / Ctrl+Z。
- 開啟需求4.4 Downlink Encryption。其適用於是 Encrypted Downlink 特性(F-4),因此它只在 EO-1 Flight 中。1.5.2 S-band Transmitter、其介面IF-08和IF-12,以及5.1 S-band Downlink Rate適用於 F-2;1.5.3 X-band Payload Radio、其介面IF-08.1和IF-12.1、5.5 X-band Downlink Rate及其測試案例TC-21 X-band Link Test適用於 F-3。
- 選擇檢視方式 ▾ → CFG-2 EO-1 Lite,然後開啟需求5.4 Daily Data Volume。其說明顯示「at least 1 GB」,並帶有CFG-2 值標籤。在 EO-1 Flight 中,它保留基礎文字「at least 3 GB」。
- 開啟測試案例TC-11 UHF Command Test。它在每個組態各有一個結果:在 EO-1 Flight 中為 Passed,在 EO-1 Lite 中為 In Progress。
- 開啟1.3.2 Battery Pack,查看其特性值Thermostat Heater Power(2 W,適用性 SN 1)和Software-Controlled Heater Power(3 W,SN 2 及以後):加熱器從第二具太空船起變更。
- 開啟控制與審查 → 基準線和版本。EO-1 Flight PDR是 CFG-1 的基準線(Team 方案)。
- 在所有組態中開啟驗證 → 模型檢查。產品線規則會警告Propulsion未被任何組態選取(ProductLine.4)。示範專案刻意不選取它,作為該檢查的範例。
提示與良好做法
- 特性應描述產品,而非文件:用「X-band Downlink」,而非「Section 5 option」。
- 在適用於中優先使用特性條件。當您新增第三項具有 X-band 下行鏈路的產品時,
F-3仍然正確;CFG-1則否。 - 將許多相關選項歸到一個父特性下,而不要寫冗長的運算式。
- 只為真正不同的值指定組態值。其他一切都保持共用。
- 受控的組態使用已發行,不再製造的產品使用已淘汰。
- 將從某個序號起的零件變更建模為兩個項目,即舊的和新的,各有自己的適用性。
常見錯誤
- 項目在編輯後從檢視中消失。其適用於或適用性已不再包含該組態。提示訊息會指出它;按一下復原,或在所有組態中找到它。
- 組態一直顯示不完整。某個擇一或至少選一群組沒有選擇。請勾選該群組的一個子項。
- 項目不在任何組態中。其適用於指定的特性沒有任何組態選取。模型檢查會回報它(ProductLine.2)。
- 移動會變更每項產品。結構是共用的:在組態檢視中移動或重新排序項目,會在所有組態中移動它。
與其他功能的關聯
- 文件:依組態和序號或日期產生。
- RVTM 和測試中心:依組態記錄結果;「已驗證」表示已針對該產品驗證。
- 模型檢查:產品線規則集會檢查運算式、判定、適用性和修訂(supersedes)。
- 基準線和版本(Team):為單一組態建立基準線並比較組態。
- 變更請求(Team):查看請求會變更哪些組態;由擁有者核准。
- 搜尋:
appliesto:CFG-2和varies:yes可依組態尋找項目。 - REST API 和 MCP:以單一組態讀取模型。
產品線頁面
控制與審查 → 產品線在左側顯示特性,右側顯示組態。寬度小於 1,100 px 時,兩個區域會上下堆疊。
頁首
| 控制項 | 功能 |
|---|---|
| + 新增特性 | 以下一個編號(F-1、F-2、…)在樹的末端新增特性。 |
| 檢查組態 | 列出每個組態,顯示有效或其第一個問題,以及完成或其缺口。 |
| + 新增組態 | 以下一個編號(CFG-1、CFG-2、…)新增組態欄。 |
| ⋯ | 匯出 CSV(特性對組態,含已選取或隱含以及判定)和說明。 |
功能
樹狀格線,欄有特性(編號和名稱)、種類、子項和使用者(在適用於中指定該特性的項目數)。規則會以小標籤顯示在列中,例如「需要 F-3」。
在屬性面板中設定特性的種類和子項:在列上按 Enter 即可在屬性面板中開啟它。
列的⋯選單:
- 新增子特性…
- 重新命名(F2)
- 規則…:需要和排除核取清單
- 約束…:選取該特性時必須成立的適用於運算式
- 顯示使用它的項目
- 刪除…
組態
每個特性一列(依樹狀順序)、每個組態一欄的格線。每個欄標題顯示編號、名稱和狀態,在 Team 方案中還會顯示擁有者。
儲存格:
- 可自由選擇的特性顯示核取方塊。
- 擇一特性的子項顯示選項按鈕。
- 因另一個特性而被納入的特性顯示隱含標記。工具提示會指出該特性,例如「因已選取 F-1 而包含。」
底部的判定列顯示有效或第一個問題(特性規則)。其下方的完整性列顯示完成或缺口數;其工具提示會列出缺口(請參閱完整性)。
欄標題的⋯選單:
- 以此組態檢視
- 重新命名…
- 適用性…
- 擁有者…(Team):在屬性面板中開啟該組態。
- 為 CFG-2 建立基準線…(Team):儲存此組態的基準線(請參閱各組態的基準線)。
- 複製副本:複製選擇和每個組態值,一次復原即可全部撤回。副本為草稿,名稱為「<name> (copy)」。
- 淘汰,或在已淘汰的組態上選還原為草稿。已淘汰組態的檢視為唯讀。
- 刪除…:將組態移到垃圾桶。項目會保留其值,因此還原會將它完整地復原。
空白狀態
- 沒有特性:「尚無特性。新增第一個特性:產品之間不同的選擇。」
- 沒有組態:「尚無組態。一個組態就是一項產品:特性的一組選擇。」
鍵盤
| 按鍵 | 位置 | 作用 |
|---|---|---|
| Tab | 頁面 | 在標題動作和兩個格線之間移動。它永遠不會縮排。 |
| Home / End | 功能 | 第一列或最後一列。 |
| ↑ / ↓ | 功能 | 上一列或下一列。 |
| ← / → | 功能 | 摺疊或展開。 |
| Enter | 功能 | 命名時:儲存名稱並在下方開始新的同層列。在選取的列上:在屬性面板中開啟該特性。 |
| F2 | 功能 | 就地重新命名特性。按 Esc 或讓名稱保持空白,則不會新增任何內容。 |
| ⌥ / Alt+↑ / ⌥ / Alt+↓ | 功能 | 在同層特性之間上移或下移該特性(兩個特性互換編號)。 |
| ⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+← | 功能 | 縮排或凸排該特性,與文件大綱相同。 |
| Delete | 功能 | 確認後刪除該特性。 |
| 方向鍵 | 組態 | 在儲存格之間移動。 |
| Space | 組態 | 勾選或清除儲存格。 |
| Enter | 組態 | 在欄標題上:開啟其選單。 |
| Home / End | 組態 | 第一欄或最後一欄。 |
螢幕閱讀器
特性是名為「特性」的樹狀格線。組態是名為「依特性列出的組態」的格線;每個儲存格會讀出,例如「CFG-1 EO-1 Flight 中的 F-3 X-band Downlink:已選取」。變更會播報:「已為 CFG-1 選取 X-band Downlink。」、「CFG-2 違反規則:Encrypted Downlink 需要 X-band Downlink。」、「CFG-2 有效。」
適用於
適用於指出哪些組態包含某個項目。它位於屬性面板的產品線群組(在屬性群組之後)、項目檢視中,以及資料庫的一欄。目前還不支援:在關係面板中編輯關係的適用於。
欄位
- 適用於:運算式。空白時顯示「所有組態」。
- 選擇…:從清單中選取組態或特性,而不必輸入。
- 其下方的預覽行:「適用於 4 個組態中的 2 個:CFG-1、CFG-3」或「適用於每個組態」。
- 當組態檢視已新增或移除該項目時,會顯示已從 CFG-2 移除和已新增至 CFG-4等標籤。按一下其中一個上的✕即可清除:該項目在該組態中會再次依循適用於。
- 當運算式指定已刪除的特性或組態時(以其舊編號顯示),會顯示警告。
特性和組態項目沒有適用於。
在資料庫中,只要有任何項目使用適用於,就會出現適用於欄(可從其 ▾ 隱藏,並從欄加回)。在儲存格上按兩下,或按 Enter 或 F2,即可以相同的欄位編輯它。
輸入時會開啟符合的特性和組態清單,接著是運算子。↓/↑ 移動,Enter 或 Tab 插入,Esc 關閉清單,第二次按 Esc 會還原欄位。Enter 儲存;運算式有效時,離開欄位也會儲存。
選擇… 對話方塊
適用於 — <item>提供三種選擇:
- 每個組態:清除運算式。
- 這些組態:勾選組態;寫入
CFG-1 or CFG-3。 - 特性:勾選特性並選擇全部(寫入
F-2 and F-5)或任意(寫入F-2 or F-5)。
產生的運算式會顯示在下方。以運算式編輯會將它放入文字欄位但不儲存。套用會儲存它,一次復原即可全部撤回。
適用於運算式
| 輸入內容 | 含義 |
|---|---|
F-3 或 "X-band Downlink" | 特性,以編號或以引號括住的名稱表示。當組態的有效選擇包含它時為真。 |
CFG-2 或 config "EO-1 Lite" | 組態。僅對該組態為真。 |
and, or, not, ( ) | 組合條件。&、| 和 ! 也可使用,並會顯示為文字。not 最先結合,其次是 and,然後是 or。 |
all, none | 每個組態,或一個也沒有。 |
不區分大小寫。Holarch 以項目的 ID 儲存運算式,因此重新命名或重新編號特性永遠不會破壞它。它會顯示編號,沒有編號的項目則顯示以引號括住的名稱。
已刪除或未知的特性為假,模型檢查會將其回報為錯誤。
運算式訊息
無效的運算式永遠不會被儲存。欄位會保留您的文字並標示錯誤,最後一個有效值仍然生效。位置從 1 起計算字元。
| 訊息 | 處理方式 |
|---|---|
| 沒有名為「F-9」的特性或組態。請從清單中選擇一個,或先建立該特性。 | 檢查編號,或建立該特性。 |
| 「and」之後應為特性或組態(第 12 個字元)。 | 在運算子之後新增一個條件。 |
| 第 1 個字元應為特性或組態。 | 以條件、not 或 ( 開頭。 |
| 「F-5」之前應為「and」或「or」(第 9 個字元)。 | 以運算子連接兩個條件。 |
| 第 5 個字元的「(」缺少「)」。 | 補上右括號。 |
| 第 9 個字元的「)」沒有對應的「(」。 | 移除多餘的括號。 |
| 第 4 個字元的名稱缺少結束引號。 | 補上名稱的結束引號。 |
| 「Wallbox」符合 2 個特性(F-3、F-11)。請使用編號。 | 兩個特性同名;請輸入編號。 |
| 適用於太長。最多使用 200 個特性和組態;請改以父特性將它們分組。 | 縮短運算式。 |
以組態檢視
檢視方式 ▾會將整個模型顯示為單一組態。專案有組態後,它就會出現在頂端列中儲存狀態的左側。
選單
- 所有組態:整條產品線。
- 每個組態一個項目,含其狀態,以及違反規則或不完整時的標記。
- 適用性 ▸:任意單元、序號…、日期…或序號和日期…。請參閱依序號或日期檢視。
- 管理產品線:開啟產品線頁面。
按 Enter、Space 或 ↓ 開啟選單;方向鍵移動,Enter 選擇,Esc 關閉。⌘K / Ctrl+K 提供依組態檢視…、檢視所有組態、設定適用性…、前往產品線、新增特性…、新增組態…,在檢視中還有將現有項目加入 CFG-2…。
橫幅
選擇組態後,頂端列下方的橫幅會顯示,例如「正在檢視 SN 23 時的組態 CFG-2 EO-1 Lite。新項目僅適用於 CFG-2;變更的值歸 CFG-2 所有。」它會顯示檢視中有多少項目(「1,350 個項目中的 1,204 個」),並提供:
- 變更 ▾:與檢視方式 ▾ 相同的選單。
- 離開:回到所有組態。
當您同時在變更請求中工作時,變更請求的橫幅在前,組態的橫幅在後。
各頁面顯示的內容
- 不適用於該組態,或在檢視的時點未生效的項目和關係會被略去。
- 具有組態值的項目會顯示這些值。
- 計數、彙總、預算、模擬、品質分數和模型檢查都會針對該組態計算。
- 文件大綱、產生的文件和 RVTM 會依顯示的方式為項目編號。儲存的編號不會變更;匯出內容會註明「編號依 CFG-2 中的顯示。」
- 搜尋和查詢會在該檢視上執行。
此選擇屬於該瀏覽器分頁,重新載入時會保留。切換檢視不算編輯,因此復原會略過它。
螢幕閱讀器
按鈕顯示「檢視方式:CFG-2 EO-1 Lite」。橫幅是名為「組態檢視」的區域。進入、離開和變更時點都會播報,例如「正在檢視組態 CFG-2 EO-1 Lite。1,350 個項目中有 1,204 個適用。」和「正在檢視所有組態。」
在組態檢視中編輯
在組態檢視中編輯的方式與其他地方相同。Holarch 會將每次編輯轉換為整條產品線的變更,讓其他組態保留原有內容。每個動作都能以一次復原撤回。
建立和變更項目
| 您的操作 | 結果 |
|---|---|
| 建立項目(任何方式:+ 新增、圖、文件、資料庫列、貼上、複製副本、範本、匯入、已套用的 AI 或 MCP 提案) | 該項目僅適用於此組態。只有一個組態時,適用於保持空白。 |
| 複製副本,或連同子項複製 | 每個副本都適用於此組態,並以顯示的值作為其基礎值。 |
| 變更名稱、編號、類別或標籤 | 會為每個組態變更它們。欄位會顯示已共用圖示;變更會播報為例如「已為所有組態變更名稱。」 |
| 變更其他組態也有的項目的說明或屬性 | 儲存為此組態的自有值。等於基礎值的值會移除自有值。已淘汰的組態算作其他組態,因此會保留其值。 |
| 變更只有此組態才有的項目的說明或屬性 | 儲存為基礎值。 |
| 變更適用於或適用性 | 會為每個組態變更它們。欄位會顯示已共用圖示,編輯時的提示為「會為每個組態變更適用於,而不只是 CFG-2。」當項目不再屬於此檢視時,它會離開檢視:「R-4.2 不再適用於 CFG-2。」並提供復原。 |
| 新增關係 | 新增到產品線。當其兩端也同時存在於另一個組態時,它會被限制在此組態。 |
| 變更關係的屬性 | 與項目的屬性相同。 |
| 移動、重新排序、縮排、凸排或變更父項 | 為每個組態變更共用的結構:「已為所有組態移動。」 |
| 變更圖的版面配置 | 由每個組態共用。 |
| 記錄測試結果 | 儲存為此組態的結果,即使沒有其他組態具有該測試案例也一樣。執行套件會顯示「正在記錄 CFG-2 的結果。」 |
| 編輯結構描述、專案設定、共用或庫訂閱 | 共用,與所有組態中相同。 |
移除與刪除
| 您的操作 | 結果 |
|---|---|
| 刪除其他組態也有的項目 | 確認對話方塊會詢問,例如「要從 CFG-2 移除 R-4.2 嗎?它會保留在 CFG-1 和 CFG-3 中。」從 CFG-2 移除只將它從此組態中移出;全部刪除…則將它刪除到垃圾桶。 |
| 移除這類有子項的項目 | 同時從 CFG-2 移除其 3 個子項(預設開啟)。關閉時:子項保留在組態中,並顯示在上一層。 |
| 刪除只有此組態才有的項目 | 照常刪除到垃圾桶。 |
| 移除其他組態也有的關係 | 只從此組態移除:「已從 CFG-2 移除關聯。它保留在其他 2 個組態中。」 |
| 移除只有此組態才有的關係 | 照常刪除。 |
| 從圖中移除 | 為此組態移除該項目與圖的關係。在只列出其圖形的圖上,對話方塊會顯示「在每個組態中從此圖移除該圖形。」 |
| 從垃圾桶還原 | 將項目還原到產品線。如果它不適用於該組態:「已還原 R-4.2。它不適用於 CFG-2。」 |
當編輯使所選項目離開檢視時,焦點會移到同一清單中的下一個項目,提示訊息會說明該項目去了哪裡。
新增現有項目
用於將現有項目加入圖、文件或關係的選取器,會列出檢視中的項目。若要加入不適用於該組態的項目,請使用 ⌘K / Ctrl+K 中或橫幅變更 ▾選單中的將現有項目加入 CFG-2…:「已將 Battery 加入 CFG-2。」
檢視中無法使用的功能
- 重新編號…、從此處重新編號…和重新編號子項…:編號由所有組態共用。請在所有組態中重新編號。
- 還原基準線和還原舊版本:「請離開組態檢視以還原基準線。」
- 在已淘汰組態中的每次編輯:「CFG-1 已淘汰。請複製它以進行變更。」已發行的組態仍可編輯,除非組態控制將它鎖定。
已發行和已淘汰的組態會保留其值
其他地方的編輯永遠不會變更已淘汰組態所顯示的內容,而且只會透過變更請求變更已發行的組態。當您變更項目的基礎值時(在所有組態中、以設為基礎值,或透過匯入或已套用的 AI 或 MCP 提案),每個具有該項目且沒有自有值的已淘汰組態,以及變更請求之外的每個已發行組態,都會作為同一個變更的一部分取得舊值作為其自有值。原本為空白的基礎值不會被保留。
鎖定、庫掛載和受控的項目,在組態值方面也遵循其一般規則。
復原與歷程記錄
- 復原可跨檢視切換使用。當該步驟是在另一個檢視中進行時,提示訊息會指出它:「已復原在 CFG-2 中所做的變更:Battery 的 Mass。」
- 歷程記錄會在該檢視中所做的每項變更旁顯示「在 CFG-2 中」。
與他人協作
位於不同組態的兩個人永遠不會覆寫彼此的值或移除。基礎編輯和組態值永遠不會衝突。兩個人為同一組態變更同一欄位時:與任何欄位一樣,較晚的變更為準。
當有人刪除您正在檢視的組態時,您的分頁會回到所有組態:「CFG-2 已刪除。正在顯示所有組態。」
組態值
組態值是項目針對某個組態的自有說明或屬性值。
哪些欄位可以不同
| 欄位 | 可依組態而不同 |
|---|---|
| 說明、每個屬性、關係屬性 | 是 |
| 名稱、編號、類別、標籤、負責人 | 否:它們用於識別項目 |
| 適用於、適用性、特性和組態屬性、selects、requires、excludes | 否:它們定義組態 |
| 具有核准工作流程的屬性(例如受核准管理的 Requirement Status) | 否:每個項目一份核准記錄 |
| 品質結果、審查資料和計算值 | 否:針對每個檢視計算 |
| 圖的版面配置和文件設定 | 否 |
在組態檢視中
- 具有此組態自有值的欄位會顯示CFG-2 值標籤。其選單:
- 使用基礎值(3 GB):移除自有值。
- 設為基礎值:將此值設為基礎值;其他組態的自有值保持不變。
- 所有組態中的值…
- 永遠不會不同的欄位會顯示已共用圖示(「由所有組態共用。」)。
- 編輯其他組態也有的項目欄位時,提示為「僅為 CFG-2 儲存。其他組態保留 3 GB。」
在所有組態中
具有自有值的欄位會顯示不同(2)。其選單有所有組態中的值…和清除組態值。
編輯可以不同的欄位時,提示會說明變更會影響哪些組態,例如「變更 CFG-2 和 CFG-3。CFG-1(已發行)保留 1,400。CFG-4 保留其自有值。」
所有組態中的值…先列出基礎值,接著列出每個組態及其值和來源(「自有值」或「基礎」)。就地編輯一列,然後按 Enter 儲存。
在資料庫中,具有自有值的儲存格有角落標記。歷程記錄、變更清單和比較會將組態值命名為例如「Mass (CFG-2)」,將成員資格變更命名為「在 CFG-2 中」。
適用性
適用性指出項目、關係或組態從哪個單元或製造日期起生效。專案有組態後,就會出現適用性欄位。
欄位
在屬性面板的產品線群組中適用於的下方,以及組態的適用性…對話方塊中:
- 序號:例如
1-20, 25, 40-的清單。40-表示 40 及以後。保持空白表示每個單元。 - 生效起始:它適用的第一個製造日期(YYYY-MM-DD)。
- 截至(不含):它不再適用的第一個製造日期。
欄位下方的摘要會顯示,例如「適用於 SN 1–20 和 25,以及 SN 40 起。」其他地方的標籤顯示「SN 1–20, 25, 40– · From 2027-03-01」。同時設定序號和日期時,兩者都必須成立。
序號會排序並合併後儲存。最多 200 個範圍,數字最大 1,000,000,000,000。目前還不支援:專案序號前置字元,用於輸入如 SN-0021 的編號。
組態的適用性指出依它製造的單元。它不會篩選該組態的項目。
依序號或日期檢視
- 選擇檢視方式 ▾ → 適用性 ▸ → 序號…(或日期…,或序號和日期…),或在 ⌘K / Ctrl+K 中選設定適用性…。
- 輸入序號、製造日期或兩者。橫幅會加上該時點:「正在檢視 SN 23 時的組態 CFG-3 Block 2。」
序號和製造日期一起描述一個單元:「SN 75 built 2027-06-15」。此時項目在兩者都成立時才會顯示,各自依項目設定的部分判斷。序號…會保留已選擇的日期,日期…會保留序號;任意單元會清除兩者。文件(匯出對話方塊中的序號和日期)、RVTM 和 API(effectivity=sn:75,date:2027-06-15)都使用相同的時點。
| 項目具有 | 依序號檢視 | 依日期檢視 |
|---|---|---|
| 僅序號 | 編號在其清單中時顯示 | 顯示,並附上其標籤 |
| 僅日期 | 顯示,並附上其標籤 | 日期在其範圍內時顯示 |
| 兩者 | 編號在其清單中時顯示 | 日期在其範圍內時顯示 |
| 兩者皆無 | 顯示 | 顯示 |
在所有組態中選擇序號時,會選出序號包含它的組態。有多個時,選單會列出它們(「SN 23 位於 CFG-2 和 CFG-3 中。請選擇一個。」)。當時點超出所選組態本身的適用性時,橫幅會警告:「SN 23 超出 CFG-2 的適用性(SN 1–20)。」
適用性訊息
| 訊息 | 處理方式 |
|---|---|
| 「x」不是序號或範圍。請使用數字和範圍,例如 1-20, 25, 40-。 | 修正所指出的部分。 |
| 範圍「20-1」是倒序的。請先寫較小的數字。 | 對調兩個數字。 |
| 最多使用 200 個序號範圍。 | 合併範圍。 |
| 序號最大為 1000000000000。 | 使用較小的數字。 |
| 「x」不是日期。請使用 YYYY-MM-DD。 | 修正日期。 |
| 生效截止必須晚於生效起始。 | 變更其中一個日期。 |
| 請將序號寫成範圍,例如 1-20, 25, 40-。 | 顯示在欄位下方;修正範圍。 |
| 截至必須晚於起始。 | 顯示在欄位下方;變更其中一個日期。 |
| SN 12–30 與 CFG-3(SN 21–40)重疊。 | 組態上的警告,不會阻擋:兩項產品共用序號。 |
項目的修訂
當零件從某個序號或日期起變更時,請將舊零件和新零件建模為兩個項目,各有自己的適用性,並以supersedes(反向為superseded by)將新項目關聯到舊項目。如 rev C supersedes rev B supersedes rev A 的鏈,會使它們成為同一位置的修訂。Holarch 永遠不會在修訂之間做選擇:它會回報其適用性重疊之處,或沒有任何修訂的單元。
- 橫幅:當兩個修訂在檢視的時點同時生效時,橫幅會警告:「修訂重疊:A-20 Cooling unit 在 SN 75 有 2 個生效(A-20A、A-20B)。」
- 模型檢查:在兩個修訂上各報告同時生效的修訂(ProductLine.13),並附上它們共用的序號和日期;在修訂所分解的項目(或最舊的修訂)上報告沒有生效修訂的單元(ProductLine.14),並附上第一個與最後一個修訂之間沒有任何修訂的單元,例如「SN 1–49 from 2027-07-01」。
- 發行與基準線:當組態的兩個修訂重疊時,無法將它設為已發行或建立基準線:CFG-1 無法發行:A-20A 和 A-20B 在 2027-06-01 至 2027-07-01 期間對 SN 50–99 同時生效。請變更其中一個修訂的適用性,然後再發行。
重疊和缺口會在兩個修訂都適用的每個組態內、在該組態本身的適用性範圍內檢查。
文件、RVTM 與驗證
匯出單一組態的文件
在至少有一個組態的專案中,交付 ▾下的 Word 範本(例如規格書(Word))和 ⌘K / Ctrl+K 中的將文件匯出至 Word會先開啟簡短的匯出至 Word對話方塊。沒有組態的專案照舊一鍵匯出。
- 組態:所有組態或單一組態(「CFG-2 EO-1 Lite」)。已淘汰的組態列在最後,並標示「(已淘汰)」。初始選擇為您的分頁正在檢視的組態。
- 適用性:任意單元、序號(例如 23;「SN 23」也可以)或日期。初始值為檢視的時點。
- 顯示適用範圍(僅限所有組態,預設開啟):在只有部分組態具有的每個章節下加上「適用於:CFG-1、CFG-3」。已淘汰的組態不計入。
所有匯出… → 文件(Word)在其產品線群組中有相同的選擇(基準線匯出除外)。
組態的文件包含:
- 只有適用於該組態且在所選單元或日期生效的章節,並使用該組態的自有值。
- 位於被略去章節下的章節,會上移到最近被保留的章節。
- 檢視編號:位於被略去同層項目之後的項目,會以相同樣式重新編號(4 變成 3,4.1 變成 3.1)。儲存的編號不會變更。檔案會在標題下註明「編號依 CFG-2 中的顯示。」
- 在標題頁和頁尾中:「組態 CFG-2 EO-1 Lite · 序號 23」(或「· 生效日 2027-03-01」)。公司的 Word 範本可以用欄位
{{Configuration}}放置它。 - 檔案名稱會寫明組態:「SRS – CFG-2 EO-1 Lite.docx」。
- 沒有單元或日期時,具有適用性的章節會在標題下顯示其標籤,例如「SN 21 及以後生效」。
在組態檢視中列印或儲存 PDF 時,也會將組態和時點放入列印的頁尾。
文件大綱
- 在組態檢視中,大綱會顯示檢視編號。重新編號…和從此處重新編號…會停用:「編號由所有組態共用。請在「所有組態」中重新編號。」在檢視中,新增和移動後的自動重新編號會關閉。
- 專案使用適用於和適用性欄後,檢視 ▾ → 欄就會提供它們。
- 文件的 ReqIF 匯出會將適用於和適用性寫成字串屬性。對話方塊會顯示「Applies To 和適用性以字串屬性匯出。組態值不會匯出。」
RVTM
- 在組態檢視中:該組態的需求和結果,因此「已驗證」表示已針對該產品驗證。#欄顯示檢視編號。匯出 ▾會在檔案名稱(「RVTM – CFG-2 EO-1 Lite.csv」)和 Word 標題中寫明組態。
- 在所有組態中:組態欄群組,為每個未淘汰的組態顯示一個彙總狀態。「—」表示該需求不屬於該組態(工具提示「不適用於 CFG-1」)。CSV 和 Excel 匯出會為每個組態加入一欄「CFG-1 中的狀態」(不屬於該組態時為「不適用」)。
- 適用性欄:切換開關,預設隱藏,依分頁保留。
- 只有組態自己的結果才算數。沒有組態而記錄的結果(在組態存在之前,或在所有組態中)不會驗證任何組態。在組態中,該測試案例會顯示為未執行,需求的狀態會顯示「沒有組態的結果(TC-1)不計入 CFG-2。」組態欄的工具提示、匯出和為組態產生的文件中也有相同的附註。若要驗證該組態,請在檢視它時再次執行測試。
- 在某個序號時:狀態來自在所檢視組態中為該序號記錄的最新一次執行(Test Article「23」、「SN 23」或「SN-0023」),並附註「優先顯示為 SN 23 記錄的結果」。沒有這類執行的測試案例保留其狀態。匯出使用相同的狀態。
測試中心
- 在組態檢視中,執行套件會顯示「正在記錄 CFG-2 的結果。」並以「CFG-2 EO-1 Lite」填入組態 / 版本。在某個序號時,它也會填入受測件。結果會儲存為該組態的值,因此一個測試案例在每個組態各有一個結果。
- 在檢視中,匯入結果…會顯示相同的附註並填入相同的欄位。
- 在所有組態中,執行套件和匯入結果… 會詢問記錄結果:選擇測試執行時所用的組態,或無組態(不驗證任何組態)。一開始沒有任何選擇,在您選擇之前不會記錄任何結果。組態的結果會儲存為其值,與在其檢視中相同;不在所選組態中的測試案例不會被記錄,並會說明原因。無組態的結果會儲存為測試案例在所有組態的值;組態檢視會將它們顯示為測試案例狀態下方的附註,而非其結果。
- 結果檔案可以有組態欄。一列的值(組態的編號、名稱或兩者)會將該列記錄到該組態;未指出任何組態的值會略過該列,並在對話方塊中列出它。
- 重複使用結果…(在測試案例的狀態下方):當您能提出理由時(例如因為測試過相同的單元設計),將另一個組態的結果計入未執行該測試的組態。選擇要重複使用的結果(某個組態的結果,或沒有組態的結果)、其適用的組態(在組態檢視中為所檢視的組態;在所有組態中,則為包含該測試案例且沒有自己結果的任何組態),並輸入理由(必填)。結果會連同您的姓名、日期和理由複製到該組態,一次復原即可全部撤回(提示訊息「已將 CFG-1 的結果重複用於 CFG-2。」,並提供復原)。
- 重複使用的結果永遠不會無聲無息。在該組態中,測試案例的狀態下會顯示已重複使用,並附上「from CFG-1 by Ann Lee on 2026-10-28: same motor and cooler」;該組態的 RVTM 會在需求的狀態下顯示「結果重複使用自 CFG-1(TC-1):…」;在所有組態中,組態欄會顯示「已重複使用」(理由為其工具提示);匯出和為該組態產生的文件會加上相同的附註;模型檢查會將它列為 ProductLine.17。停止重複使用會將它收回(測試再次顯示 Not Run),而在該組態中執行測試會以該組態自己的結果取代它。
- 測試案例的組態屬性在您編輯時(屬性面板、項目檢視、執行套件、匯入結果)會建議專案的組態。它仍是自由文字:如「Build 2.4.1」的版本仍然可用。
圖與權衡研究
- 顯示適用範圍(圖工具列,LML 專案,在所有組態中):為具有適用於或適用性的項目圖形著色,並在其下方寫出其適用範圍,例如「適用於 F-4 · SN 30 及以後生效」。此設定依分頁保留,在組態檢視中不提供。
- 權衡研究 → + 從組態…(在替代方案下)會將產品線的組態新增為替代方案,一次復原即可全部撤回。已淘汰的組態一開始不勾選。提示訊息:「已新增 2 個替代方案。」
基準線與變更請求
這些屬於 Team 方案。沒有此方案時,命令會停用並顯示「依組態建立基準線屬於 Team 方案。由專案擁有者的方案決定。」
各組態的基準線
- 開啟控制與審查 → 基準線和版本。
- 按一下為組態建立基準線…。檢視某個組態時,按鈕會顯示為 CFG-2 建立基準線…並略過選擇。
- 選擇組態並輸入名稱(初始為「CFG-2 baseline 1」)。按一下儲存基準線。提示訊息顯示「已儲存 CFG-2 的基準線。」表格的文件欄會顯示,例如「組態 CFG-2 EO-1 Lite」。
基準線會記錄整條產品線,並標上該組態;在某個適用性時點檢視時,也會記錄該時點。您可以像任何基準線一樣比較和還原它。目前還不支援:組態判定、選擇和核准的已發行定義記錄。
每個基準線也會記錄專案從其他專案使用的內容:使用中每個庫的發行,以及連到其他專案中項目的每個關聯及該項目當時的最後變更。當特性來自顯示的庫時,比較 → 組態 ▾會依基準線所記錄的庫發行來解析,而非目前使用中的發行,因此因較新發行而離開組態的項目會顯示為變更。在基準線開始記錄庫發行之前儲存的基準線,會依目前使用中的發行來解析,頁面也會註明這點。還原基準線不會變更專案所使用的庫發行。
比較針對產品線有兩種選擇:
- 組態 ▾:比較單一組態所顯示的內容。它會選出該組態最新的兩個基準線,或其最新的基準線與目前的模型。
- 比較對象 ▾:在來源版本內比較兩個組態,例如「EO-1 Flight PDR 中 CFG-2 與 CFG-1 的差異」。
在組態檢視中建立的專案基準線仍會記錄整條產品線。
變更請求
- 變更請求頁面有組態卡片:「變更 4 個組態中 2 個的項目:CFG-2、CFG-3」,並提供依組態顯示(各組態變更的項目)。對基礎值的變更不計入具有自有值的組態。
- 差異會將組態值命名為「Mass (CFG-2)」、「Description (CFG-2)」和「在 CFG-2 中」,並列出「適用於」和「適用性」的變更。
- 擁有者作為核准者:當變更的組態的擁有者指定了專案成員時,請求也需要該人員核准。規則行顯示「CFG-2 的擁有者(Lee)必須核准:此請求會變更 CFG-2。」,螢幕閱讀器會聽到「CFG-2 需要 Lee 核准」。未指定專案成員的擁有者不會新增規則。
- 組態控制:開啟變更控制時,已發行且在最新基準線中的組態受到控制。其在項目上的自有值只能透過變更請求變更(「… 已發行,在最新基準線中」)。
- 受控項目的適用範圍:已核准或已建立基準線的項目,其適用於、適用性,以及在組態檢視中將它放入或移出組態,都和其他欄位一樣只能透過變更請求變更。來源受控的關係也是如此。在託管服務上,伺服器也會檢查離線時所做的變更。
- 庫:已掛載的庫發行中的特性和組態,會計入適用於、組態和檢視。它們是唯讀的。
模型檢查
專案有特性或組態後,驗證 → 模型檢查會執行內建規則集產品線。
| 規則 | Heading | 嚴重性 |
|---|---|---|
| ProductLine.1 | 適用於指定了不存在的特性或組態 | 錯誤 |
| ProductLine.2 | 不在任何組態中的項目 | 警告 |
| ProductLine.3 | 違反規則或不完整的組態 | 錯誤 |
| ProductLine.4 | 沒有任何組態選取的特性 | 警告 |
| ProductLine.5 | 所在組態中沒有其父項的項目 | 警告 |
| ProductLine.6 | 兩端從未同時在一個組態中的關係 | 警告 |
| ProductLine.7 | 序號重疊的組態 | 警告 |
| ProductLine.8 | 超出項目所屬組態的適用性 | 警告 |
| ProductLine.9 | 針對項目不在其中的組態的值 | 警告 |
| ProductLine.10 | 在某個組態中未驗證的需求 | 警告 |
| ProductLine.11 | 在某個組態中缺少一端的連接 | 警告 |
| ProductLine.13 | 同時生效的修訂 | 警告 |
| ProductLine.14 | 沒有生效修訂的單元 | 警告 |
| ProductLine.15 | 沒有組態的測試結果 | 警告 |
| ProductLine.16 | 含有未在其中驗證之需求的已發行組態 | 錯誤 |
| ProductLine.17 | 從另一個組態重複使用的測試結果 | 警告 |
完整性規則會從所有組態檢查每個組態,不需切換檢視。ProductLine.10 會指出需求未在其中驗證的組態,例如「未在 CFG-2、CFG-3(已發行)中驗證」。ProductLine.11 會指出組態和缺少的一端,例如「在 CFG-2 中:A-11 Coolant pump 不在該組態中」。ProductLine.3 對已發行的組態顯示「已發行的組態。」,對草稿則顯示「修正之前無法發行。」ProductLine.16 會列出已發行組態未驗證的需求。
ProductLine.13 和 14 會檢查以supersedes連結的修訂(請參閱項目的修訂):在兩個重疊的修訂上各顯示「在 2027-06-01 至 2027-07-01 期間對 SN 50–99 與 A-20B 重疊」,在它們所分解的項目上顯示「自 2027-07-01 起 SN 1–49 沒有生效的修訂」。
ProductLine.15 會列出其 Status 是在沒有組態時記錄的測試案例,以及該結果不計入的組態,例如「在沒有組態時為 Passed;不計入 CFG-2」。請在檢視每個組態時再次執行測試。
ProductLine.17 會列出結果透過重複使用結果…計入某組態的測試案例,並附上理由,例如「CFG-2:由 Ann Lee 於 2026-10-28 從 CFG-1 重複使用:same motor and cooler」。請審查該理由,或在檢視該組態時執行測試,以取代重複使用的結果。
對於 ProductLine.9,修正 → 移除值會列出這些值,例如「Mass (CFG-2):1,520」,並將它們移除,一次復原即可全部撤回。
在 CubeSat EO-1 示範專案中,特性Propulsion是刻意不選取的:它是 ProductLine.4 的範例。
搜尋、匯入與匯出
- 搜尋與查詢:
appliesto:CFG-2會找出適用於 CFG-2 的項目;varies:yes會找出具有組態值的項目。 - JSON:保留每個欄位。
- CSV:專案使用產品線後,資料庫匯出會在其他欄之後加入四欄:適用於(與您輸入的寫法相同)、序號適用性、生效起始和生效截止。匯入會讀取相同的欄標題(對應步驟:產品線群組)。未知的特性或組態、錯誤的序號範圍或錯誤的日期會針對該列回報,且該欄位會被略去。
- ReqIF:適用於和適用性以字串屬性匯出;組態值不會匯出。
- 匯入檔案中無效的適用於或適用性值會被略去。
REST API 與 MCP
list_configurations(MCP)和GET …/configurations(REST)會列出特性、規則以及組態及其判定。- 讀取路由和 MCP 讀取工具接受
configuration(編號、名稱或 ID)和effectivity(sn:23或date:2027-03-01)。回應為該組態的檢視。沒有這些參數時,項目會帶有appliesTo、effectivity及其組態values。 - 目前還不支援:透過 API 在模型檢查中執行產品線規則(ProductLine.1–9)(
run_model_checks、GET …/model-checks)。請在驗證 → 模型檢查中執行它們。 - 寫入接受
appliesTo和effectivity。帶有configuration時,寫入會如同在該組態的檢視中進行;以此方式產生的 AI 用戶端提案會顯示「在 CFG-2 中套用:新項目適用於 CFG-2;變更的值成為 CFG-2 的值。」
每個欄位和訊息請參閱REST API:產品線。
方案
| 特性 | Free | Individual | Team |
|---|---|---|---|
| 透過 API 以單一組態讀取專案 | ✓ | ✓ | ✓ |
| 產品線頁面、檢視方式 ▾、適用於、組態值和適用性,唯讀 | ✓ | ✓ | ✓ |
| 編輯產品線:特性、組態、選擇、適用於、組態值、適用性、依組態的文件和 RVTM、透過 API 寫入 | — | ✓ | ✓ |
| 依組態的基準線、依組態比較、變更請求所變更的組態、組態擁有者 | — | — | ✓ |
由專案擁有者的方案決定。學術電子郵件地址或班級組織保留所有列。
沒有該方案時,產品線為唯讀,且不會刪除任何內容:
- 產品線頁面會顯示特性、組態、矩陣和判定。檢查組態、匯出 CSV和欄的以此組態檢視可以使用。+ 新增特性、+ 新增組態、矩陣,以及會變更內容的列和欄命令都會停用。頁面會顯示「唯讀:編輯產品線屬於 Individual 和 Team 方案。由專案擁有者的方案決定。」並提供選擇方案…。
- 檢視方式 ▾會以唯讀方式顯示單一組態。橫幅會顯示同一句話。
- 屬性面板會以唯讀方式顯示適用於、適用性和組態值。特性和組態項目為唯讀。
- ⌘K / Ctrl+K 中的新增特性…、新增組態…和開始產品線…仍會列出,並說明它們無法執行的原因。
- 匯出會保留每個欄位。新的使用會被拒絕,並顯示「產品線屬於 Individual 和 Team 方案。由專案擁有者的方案決定。」沒有 Team 方案的組態擁有者:「組態擁有者屬於 Team 方案。由專案擁有者的方案決定。」
SysML v2 專案
SysML v2 在語言中內建了變異性:變化點、變體和組態(@HolarchConfiguration 用法)。SysML v2 專案使用相同的產品線頁面和檢視方式 ▾控制項:
- 產品線頁面:變化點樹、帶有判定列的組態矩陣、規則(產品線的 assert 約束,唯讀,附在編輯器中開啟)、插入變化點…(開啟編輯器)、檢查組態和+ 新增組態。選擇變體時會在組態中寫入,例如
part :>> charger = charger::wallbox;。 - 檢視方式 ▾:列出每條產品線的組態及其判定。每個檢視、資料庫、屬性面板和產品線頁面都會跟隨它。
- 在 Free 方案中,產品線頁面與 LML 專案一樣為唯讀:插入變化點…、+ 新增組態和矩陣的選擇都會停用,瀏覽器、屬性面板和 ⌘K / Ctrl+K 中的新增組態…會說明原因。模型的文字在編輯器中仍可編輯。
- 在組態檢視中編輯(Individual 和 Team;在 Free 中為唯讀):每次編輯都是經檢查器檢查的 SysML v2 文字編輯,一次復原即可全部撤回。變更的屬性會成為該組態的自有值;新的零件屬於該組態;刪除繼承的選用元素會寫入
part :>> roofBox[0];。 - 模型旁的 Holarch 資料(例如風險和任務)適用於每個組態,但在顯示某個組態時建立的項目除外:它們適用於該組態。在 SysML v2 專案中,目前還無法編輯它們的適用於。適用性設定在模型元素和組態上(屬性面板的適用性區段)。
- 目前還不支援:對 LML 專案執行建立 SysML v2 副本…時,會略去其特性和組態(報告會將它們列在未轉換下)。請在副本中重新建模變體。
請參閱SysML v2 變體與組態。
限制
- 適用於:最多 2,000 個字元、200 個條件和 32 層括號。
- 序號:最多 200 個範圍,數字最大 1,000,000,000,000。
- 名稱、編號、類別、標籤、負責人和結構不能依組態而不同。
- 每個結構(父項和順序)由每個組態共用。目前還不支援:每個組態有自己的結構。
- ReqIF 匯出會略去組態值。
- 目前還不支援:專案序號前置字元,以及在關係面板中設定關係的適用於。
- 目前還不支援:區分核准、生效、竣工和改裝日期的適用性。適用性是一份序號範圍清單和一個製造日期範圍。
- 目前還不支援:作為已發行定義的組態基準線。它記錄的是標上該組態的產品線,而非將組態的判定、選擇和核准作為單獨的記錄。
- 目前還不支援:建立 LML 專案的 SysML v2 副本時轉換特性和組態。
- 運算式不包含序號或日期;這些請使用適用性。