控制與審查
變更請求
以變更請求提出對已核准或已建立基準線項目的變更、經審查與核准後,一步套用並保留完整記錄。
變更請求會提議一組對模型的編輯,說明原因,並在任何內容變更之前等待核准。請將變更請求用於組態控制:需求一旦核准或設定了基準線,變更就要透過由專案核准者審查的請求進行。變更請求位於控制與審查 → 變更請求下。
使用方式
建立變更請求
- 開啟控制與審查 → 變更請求,然後按一下頁首中的+ 新增變更請求,或在受組態控制項目的項目檢視頁首中按一下提議變更…(若該項目已有未結的變更請求,則會開啟它)。
- 為它指定標題和原因:為什麼需要此變更,以及它應達成什麼目的。
- 按一下建立,然後以新增項目…加入受影響的項目。Holarch 會列出追溯到它們的項目(需求、測試、介面和其他相關項目);在同樣會變更的項目上按一下+。
暫存變更
- 按一下新增變更 ▾並選擇要提議的內容:變更項目…(編號、名稱、在 RTF 編輯器中的說明,以保留其格式,或一個屬性)、新增項目…、刪除項目…、新增關係…、移除關係…、新增指向另一個專案的連結…或移除指向其他專案的連結…。在 SysML v2 專案中,編輯 SysML 文字…會提議對一個套件文字的編輯。
- 按一下暫存變更。每項暫存的變更都會列在提議的變更下,說明和文字變更會以逐字差異顯示,並附上其影響清單(請參閱影響)。模型此時尚未變更。
- 以移除移除暫存的變更。
提交、審查和核准
- 按一下提交審查。在託管服務上,核准者會收到通知,並在我的工作 → 待決定下看到一個項目,其中的核准…和拒絕…會開啟該請求及其投票對話方塊。
- 核准者開啟請求,檢查提議的變更及其影響清單,然後按一下核准…或拒絕…(拒絕需要理由)。當變更的需求在基準線中時,核准…對話方塊也會列出需要重新審查的驗證項目和文件。
- 審查卡片會顯示核准:M 中的 N。狀態變更有自己核准者的請求,也會列出每條規則及其計數,例如○ 所有指定核准者 (3):3 中的 1。當請求取得所需的核准時,其狀態會變成已核准。一次拒絕即會拒絕它;作者隨後可以編輯變更並再次提交。
撤回會在不變更模型的情況下關閉尚未套用的請求;其記錄會保留在記錄中。
套用變更
- 編輯者或擁有者開啟已核准的請求並按一下套用變更,然後以套用變更確認。
- 所有暫存的變更會一起套用,且一次復原即可全部撤回。每個變更項目的歷程記錄會記錄該變更「via CR-12」。
- 在此期間項目已被刪除的變更會被略過,並與結果一起列出。暫存的組態發行(新增變更 ▾ → 發行組態…)會連同請求的核准者一起記錄,或與未發行的原因一起列出;請參閱透過變更請求發行。
- 請求會保留每項變更在套用前一刻的影響清單,作為曾考量內容的記錄。其歷程記錄會顯示「已記錄影響」及計數,例如「4 個受影響,9 個待檢查」。套用永遠不會等待影響清單:如果幾秒後仍在讀取其他專案中的項目,請求會立即套用,並保留當時計算出的清單,在請求、其歷程記錄和匯出中標示「套用時影響分析尚未完成」。
在變更請求中工作
您不必在對話方塊中逐一暫存每項變更,而可以在草稿變更請求中工作:照常在任何頁面上編輯模型,您的編輯會進入該請求,而不是即時模型。即時模型只有在請求核准並套用後才會變更。
開啟此功能
在專案擁有者開啟之前,每個專案都不能在變更請求中工作:在變更請求頁面開啟設定,並勾選在變更請求中工作:在草稿中編輯,核准後套用。當草稿中仍有在其中所做的編輯時,關閉此功能會被拒絕;請先套用或撤回這些請求。在託管服務上,在變更請求中工作隨專案擁有者的 Team 方案提供,與核准規則相同(請參閱組態控制下的附註):已驗證的學術電子郵件地址或作用中班級組織的成員資格也包含此功能,而在 2.29.0 版之前就使用核准規則的專案會保留它。在其他方案中,此設定會顯示為停用。桌面應用程式沒有方案。
開始與離開
可從以下任一處開始在草稿請求中工作:
- 新增變更請求對話方塊中的立即在其中工作(預設勾選)。
- 草稿請求頁面上的在此變更請求中工作。
- 項目的項目檢視中的提議變更 ▾ → 在變更請求中工作…。清單會顯示指定該項目的草稿,以及新增變更請求…。
- 編輯受組態控制的項目時所顯示訊息中的在變更請求中工作。
- ⌘K / Ctrl+K → 在變更請求中工作…。
- 我的工作 → 我正在處理的變更請求下的繼續。
在請求中工作時:
- 頂端列下方的橫幅會顯示,例如正在 CR-12 Range upgrade 中工作。編輯會進入此變更請求,而非即時模型。3 項變更。並提供審查變更和離開。
- 儲存狀態會顯示,例如已於 14:02 儲存在 CR-12 中。
- 請求所變更的項目在表格和圖上帶有CR標記。
若要試用,請開啟 CubeSat EO-1 示範專案:CR-1 Shorten the planning cycle是一份已在其中做過編輯的草稿。在變更請求下開啟它,然後按一下在此變更請求中工作。在 Hybrid Car 示範專案中,CR-2 Clarify the charge time包含對某項需求文件說明的編輯。
按一下橫幅中的離開(或⌘K / Ctrl+K → 離開變更請求)即可回到即時模型。此模式屬於該瀏覽器分頁:另一個分頁可同時顯示即時模型,重新載入時分頁會留在請求中。
有哪些不同
- 復原會停在您進入請求的位置。
- 在您離開請求之前,結構描述變更、基準線、共用、請求核准和還原先前的版本都會被拒絕。
- 受組態控制的項目可以在請求中編輯;這正是它的用途。
- 提交審查會暫停編輯,直到請求被決定或撤回。被拒絕的請求在您編輯它時會再次成為草稿。
- 撤回會將請求的編輯作為一個項目移到垃圾桶,例如CR-12 的變更;還原會將它們放回請求中。
審查變更
有在其中做過編輯的請求,其頁面上有兩個分頁:詳細資料(請求、暫存的變更、審查、留言和歷程記錄)和變更,後者會比較請求之前的模型與請求將造成的模型。橫幅中的審查變更會開啟它。
- 計數圖塊會顯示新增、移除和變更的項目以及關係變更;其下方每項變更各有一列,變更的文字會逐字顯示。
- 品質結果、可疑關聯標記和其他審查記錄會被隱藏;按一下顯示審查資料即可一併列出。
- 文件會列出包含變更項目的每份文件。比較版本…會顯示請求之前與之後的文件,每個欄位並排顯示並標出變更的字詞;在欄位內移動的句子會在兩處以紫色顯示,並以連結相連。
- 圖會列出每個變更的圖及其變更內容,例如Asset Diagram 0 Drone Delivery System:新增 1 個圖形(Charger),移動 1 個。顯示前後對比會並排繪製兩個版本。
請求頁面上的在模型中預覽會以唯讀方式開啟請求套用後的模型。橫幅會顯示,例如正在預覽 CR-12(唯讀)。每個頁面都會就地顯示變更,因此您可以檢查產生的規格書、RVTM 或矩陣。在您按一下離開之前,編輯會被拒絕。審查者和檢視者也可以預覽。
投票涵蓋在請求中所做的編輯以及其暫存的變更:投票後所做的編輯會使該投票失效,核准者需再次決定。
套用您在其中工作的請求
對已核准的請求執行套用變更時,會先將其編輯與目前的即時模型比較,因為其他人可能在此期間變更了相同的項目。
- 沒有衝突:確認訊息會顯示,例如要將 14 項變更套用到即時模型嗎?一次復原即可全部撤回。按下套用變更後,提示訊息會顯示已套用 CR-12:14 項變更。新項目會保留其 ID,每個變更項目的歷程記錄會顯示「via CR-12」並列出請求的作者。
- 同一項目不同欄位的變更會直接合併而不詢問:如果請求重新命名了某個項目,而其他人在即時模型中變更了它的編號,兩項變更都會保留。
- 衝突:同一欄位在兩邊都被變更、項目在一邊被刪除而在另一邊被變更,或請求中的關聯指向在即時模型中已刪除的項目。請求頁面會計算它們,例如CR-12 與即時模型有 2 個衝突。,而套用變更會先開啟解決衝突 — CR-12。
在解決衝突中,每個衝突的項目都有一張卡片,顯示即時模型版本(在託管服務上附有變更者)和變更請求版本;顯示原始內容會加入兩邊變更之前的版本。圖會並排繪製。請選擇以下其中之一:
- 保持即時:項目保持即時模型中的樣子。對於指向已刪除項目的關聯,該關聯會被略去。
- 使用變更請求:請求所變更的每個欄位都採用請求的值;只有即時模型變更的欄位保留其即時值。對於刪除,採用請求的結果:項目被刪除,或連同請求的變更一起還原。對於指向已刪除項目的關聯,該項目會連同關聯一起從垃圾桶還原。
- 合併:每個變更的欄位一列,含即時和變更請求。只有一邊變更的欄位預設為該邊;兩邊都變更的欄位預設為變更請求。
在每個衝突都做出選擇之前(「請為 3 個衝突各選擇一個版本。」),套用變更會保持停用。只有可編輯的請求核准者才能解決衝突;其他人會看到,例如CR-12 與即時模型有 3 個衝突。由核准者在套用時解決。請求的歷程記錄會記錄每個選擇(「保留了 R.4.2 的即時版本」、「取代了 Ann 對 R.4.3 的即時變更」),在託管服務上,其即時變更被取代的人會收到通知。
一次復原即可撤回整個套用:它會還原即時模型,並將請求連同其編輯設回已核准,可再次套用。套用後,請求的變更分頁會保留已套用內容的清單。核准後又被編輯的請求,在再次提交並核准之前無法套用。請求套用時,任何正在其中工作或預覽它的人都會回到即時模型。在 SysML v2 專案中,確認訊息會列出請求將為模型新增的任何錯誤,在您選擇其他版本或請求被拒絕之前,套用變更會保持停用。
影響
每項暫存的變更都有影響清單:在任何人核准或套用變更之前找出的、追溯到它的項目。其標題會顯示計數,例如影響 3 個受影響 · 7 個待檢查。按一下標題可顯示或隱藏清單。超過三項變更的請求,一開始清單是收合的。
清單分組為需求、測試與驗證、介面、文件、圖、其他專案中的項目和其他項目。每一列都會標示:
| 標記 | 意義 |
|---|---|
| 受影響 | 變更觸及它:與變更項目相距一個關係的項目、顯示變更項目的文件或圖、新增或移除之關係的兩端,以及連結到變更項目的其他專案中的項目。 |
| 檢查 | 再進一步:追溯到受影響項目的項目、顯示這些項目的文件和圖,以及相距兩個連結的其他專案中的項目。 |
每一列會指出其類別以及如何到達,例如「verified by 1.1 Pump pressure」。指向另一個專案的連結,若其項目在上次審查連結後已變更,會顯示已變更。按一下列可開啟該項目、文件或圖。其他專案中的項目來自項目追溯,依您自己的存取權限:指向您無法開啟之專案的連結只會計數。
清單最多顯示 300 列,並說明還有多少列。只會讀取前 12 個變更項目指向其他專案的連結。
標題下方的附註會說明清單的依據:「影響分析依據已建模的關係;未關聯或距離較遠的相依關係可能不會出現。依 14:02 的修訂 1,204 計算。」此修訂是計算清單時專案的修訂(在託管服務上,每位編輯者看到的編號相同)。如果在您閱讀時模型變更,清單會保持計算時的樣子;重新開啟請求即可再次計算。已儲存的清單會保留其計算所依據的修訂。
套用請求時,清單會與它一起儲存並按原樣顯示,因此即使項目被重新命名或刪除,記錄仍會說明當時考量的內容。匯出 ▾ → Word (.docx)會包含它們,Excel 記錄則有包含計數的影響欄。
相同的清單也會出現在其他等待決定的變更處:
狀態
| 狀態 | 意義 |
|---|---|
| Draft(草稿) | 撰寫中;作者正在暫存變更。 |
| 已提交 | 等待核准者。 |
| 審查中 | 至少有一位核准者已投票。 |
| 已核准 | 核准數足夠;可以套用。 |
| 已拒絕 | 核准者拒絕了它;作者可以修訂後再次提交。 |
| 已撤回 | 在不變更模型的情況下關閉。 |
| 已實施 | 變更已套用。 |
組態管控
附註:在託管服務上,由專案擁有者的方案決定。組態控制(第一個設定)隨 Individual 和 Team 方案提供;下列核准規則(所需核准數、核准者、變更委員會、自我核准)隨 Team 方案提供。已驗證的學術電子郵件地址或作用中班級組織的成員資格保留兩者。在 2.29.0 版之前使用這些功能的專案和組織會保留它們。沒有核准規則時,變更請求只依一條規則運作:由專案擁有者的核准決定,且作者可以核准自己的請求,因此您獨自工作時可以核准並套用自己的變更。先前儲存的設定會保留但不套用,設定中會註明這點;此時已核准和已納入基準線的項目可直接編輯。核准記錄、投票和狀態都會保留。桌面應用程式沒有方案。
變更請求頁面頁首中的設定會開啟變更請求設定。它將設定分組在組態控制(哪些內容需要變更請求,以及編輯者是否在草稿中工作)和核准(核准數、核准者、自我核准)下;每項設定在您變更時即套用,完成會關閉對話方塊。清單上方的那一行會說明設定目前的作用,例如「已核准和已納入基準線的項目可直接編輯;需 1 位專案擁有者核准。」,並附有在設定中變更連結。
在設定中,專案擁有者可以開啟變更已核准和已納入基準線的項目需要變更請求。之後:
- 已核准的需求(Status 為 Approved)和最新專案基準線中的項目將無法再直接編輯、刪除或關聯。Holarch 會說明原因並指向變更請求。
- 其適用於、適用性和組態成員資格(產品線)也屬於它們的一部分:變更項目所適用的組態或單元需要變更請求。
- 留言、審查、需求核准、品質結果和關聯審查標記仍保持開放。
- 已核准的變更請求會將其變更套用到這些項目。
- REST API 和 MCP遵循相同的規則:指令碼對這些項目的直接變更會被拒絕(
409 change-control),AI 用戶端的提案也不能包含它們。請改為在變更請求中提議變更。 - 在託管服務上,伺服器會檢查到達它的每項變更,包括離線時所做的變更。在項目受控之前(離線時,或在其他人核准它時)對已核准或已納入基準線的項目所做的變更不會被儲存:Holarch 會指出是哪個項目,重新載入專案,並保留您的其他變更。請改為在變更請求中提議該變更。
附註:在託管服務上,組態控制由伺服器對每種編輯方式(應用程式、REST API 和 MCP)強制執行;編輯者無法透過其他用戶端繞過它。只有套用已核准的變更請求才會變更這些項目。在桌面應用程式和瀏覽器專案中,由應用程式強制執行,與項目鎖定相同。
核准與核准者
- 所需核准數:1、2 或 3。
- 核准者:專案擁有者、擁有者和編輯者,或由指定專案成員組成的變更委員會(託管服務;在桌面版中您核准自己的請求)。變更委員會可以指定審查者:他們可以核准、拒絕請求並留言,但無法編輯模型。每位能留言的專案成員(審查者或以上)都可以對變更請求留言。
- 作者可以核准自己的變更請求:預設關閉。
只有專案擁有者可以變更這些設定。
相同的設定也適用於工作流程建立的請求:在結構描述 → 工作流程中標示為核准的狀態變更會開啟請求核准,它會建立並提交只包含該項變更的變更請求。
工作流程轉換也可以改為指定自己的核准者,例如審查委員會的每位成員,或 4 位指定工程師中的 2 位(選擇轉換的核准者)。此時請求需要其狀態變更所屬每條規則的核准;沒有轉換涵蓋的變更則使用這些設定。在桌面應用程式中,核准者是姓名:您以偏好設定 → 您的姓名中的姓名核准。只包含狀態變更的請求,在最後一位核准者可以編輯時,會隨其核准一起套用。
在託管服務上,Holarch 只使用專案擁有者儲存的設定;其他任何人變更的設定都會被忽略,並套用預設值(由擁有者核准、一次核准、不能核准自己的請求)。
當 Holarch 沒有提交變更請求者的記錄時,例如在連同請求一起上傳或匯入的專案中,只有專案擁有者可以核准它。沒有儲存者記錄的設定,會以擁有者為核准者且不允許自我核准的方式套用,直到擁有者再次儲存它們。
核准記錄
在託管服務上,核准或拒絕時會要求輸入密碼(每 10 分鐘一次),並記錄決定者、時間、附註,以及該投票所針對的確切暫存變更。如果在投票後暫存的變更被編輯,該投票將不再計入,並會再次詢問核准者。在套用變更之前,伺服器會檢查請求是否已以其目前的變更獲得核准。每次投票也會寫入稽核記錄(請求、決定和附註的長度;不含附註本身)。
附註:核准記錄顯示誰在何時核准了什麼。它並不是受法律規範的電子簽章(例如 21 CFR Part 11 所規範的電子簽章)。
留言、通知和記錄
- 變更請求上的留言與項目上的留言運作方式相同。
- 在託管服務上,提交請求時會通知核准者,核准或拒絕時會通知作者,套用或撤回時會通知作者和投票者。
- 每個請求都會保留歷程記錄,記錄發生了什麼、由誰以及何時。
- 變更請求頁面上的匯出 ▾(有變更請求後才會顯示)會將變更請求記錄儲存為Excel (.xlsx)或Word (.docx),包含每個請求的變更和歷程記錄。