Holarch

培訓 · 第 6 單元:移轉到 Holarch

第 6 單元:移轉到 Holarch:練習單

供從其他工具移轉的團隊使用。每章一項練習任務與幾個問題,在看完每支影片後練習。可從瀏覽器列印本頁,或在螢幕上作答。解答從最後新的一頁開始。

開始之前

先修
第 1 單元:入門,第 1.1 至 1.3 章。
方案
Free
專案
您自己的需求檔案,或從 EO-1 示範專案匯出以供練習的檔案。

6.1 規劃移轉

觀看第 6.1 章(3:00)

練習

在 CubeSat EO-1 示範專案上:

  1. 開啟您的 EO-1 示範專案(如果還沒有,請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程))。
  2. 在側欄中開啟設定 → 結構描述,按一下類別下的 需求,並列出需求試算表可以填入的屬性(例如 Priority、Owner、Verification Method)。
  3. 開啟結構描述的標籤頁面,找出 Performance Requirement 這類種類存放的位置。
  4. 假設供應商的追蹤表有一欄 Supplier Ref 找不到對應位置:在 需求 上按一下 + 屬性,將它命名為 Supplier Ref,選擇文字類型,然後按一下新增屬性。
  5. 開啟需要與需求 → 匯入和匯出,看看拖放區接受哪些格式,以及匯出卡片提供哪些選項。

當 Supplier Ref 位於 Requirement 屬性清單的最後,且您能說出典型追蹤表的每一欄應放在哪裡時,即完成。

常見問題

  1. 為什麼要在匯入前決定每種資料的去處?
  2. 某一欄沒有相符的屬性。您有哪些選擇?
  3. 匯入出錯了。要如何撤回?
  4. 什麼時候要使用「管理專案 → 匯入專案 (.json)…」而不是匯入頁面?

6.2 從 Excel 與 CSV 匯入需求

觀看第 6.2 章(2:32)

練習

在 CubeSat EO-1 示範專案上:

  1. 開啟您的 EO-1 示範專案(如果還沒有,請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程))。在資料庫中搜尋 class:Requirement,按一下匯出…,選擇表格 (CSV),勾選狀態與優先順序(保持勾選標籤),然後按一下匯出。
  2. 在試算表應用程式中開啟該檔案。保留標題列與第 1、2 節的列,然後在最上方新增兩列:1、Mission Imaging、Class Statement,以及 2、Attitude Determination and Control、Class Statement。將它儲存為 .xlsx 或 .csv。
  3. 在管理專案中按一下 + 新增專案,將它命名為 EO-1 Import Practice,然後按一下建立專案。
  4. 開啟需要與需求 → 匯入和匯出,拖放檔案,按一下繼續,並檢查每一欄的 Holarch 欄位(將不需要的欄設為略過)。
  5. 按一下繼續,保持勾選從這 N 個項目建立文件,然後按一下匯入 N 個項目。
  6. 在新文件中,確認 1.6.1 與 1.6.2 位於 1.6 之下,並選取 1.5 查看其標籤與狀態。

當新文件顯示第 1 與第 2 節,其需求依編號巢狀排列,且標籤與狀態完整保留時,即完成。

常見問題

  1. Holarch 如何重建試算表各列的階層?
  2. 有些列匯入後的類別不對。為什麼?
  3. 您想從試算表更新 50 個現有需求的負責人,而不是建立副本。要怎麼做?

6.3 從 Word 與 ReqIF 匯入需求

觀看第 6.3 章(2:22)

練習

在 CubeSat EO-1 示範專案上:

  1. 開啟您的 EO-1 示範專案(如果還沒有,請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程))。開啟文件 → EO-1 System Requirements Specification,然後按一下交付 ▾ → 規格書 (Word)。
  2. 在同一份文件中,按一下交付 ▾ → 需求 (ReqIF)…,然後按一下匯出。
  3. 在管理專案中按一下 + 新增專案,將它命名為 EO-1 Import Practice,然後按一下建立專案。開啟需要與需求 → 匯入和匯出,拖放 .docx,按兩次繼續,然後匯入。
  4. 將新文件與 SRS 比較:留意哪些標題成為 Statement、哪些 shall 句子成為 Requirement,以及它們如何命名。
  5. 將 .reqif 檔案匯入同一個專案,然後開啟它所建立的文件,選取 1.6 Revisit Time 檢查其子項目與標籤。

當專案包含兩份文件,一份來自 Word、一份來自 ReqIF,且您能說出哪一份保留了原始名稱與編號時,即完成。

常見問題

  1. Word 匯入會將什麼讀作章節,又將什麼讀作需求?
  2. 供應商可以傳送 Word 或 ReqIF。為什麼要求 ReqIF?
  3. ReqIF 關係的名稱是 Holarch 不認得的。會發生什麼事?

6.4 來自其他工具的模型

觀看第 6.4 章(2:44)

練習

在 CubeSat EO-1 示範專案上:

  1. 開啟您的 EO-1 示範專案(如果還沒有,請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程))。開啟需要與需求 → 匯入和匯出,在「匯出」卡片上按一下匯出 UML/SysML (XMI)…,將格式保持為 OMG XMI 2.5.1 (.xmi),然後按一下匯出。這個檔案代替從 Cameo 或 Enterprise Architect 等 SysML 工具匯出的檔案。
  2. 在管理專案中按一下 + 新增專案,將它命名為 EO-1 Import Practice,然後按一下建立專案。開啟需要與需求 → 匯入和匯出,拖放 .xmi 檔案,確認格式顯示 UML/SysML (.xmi, .uml, .mdzip),按兩次繼續,閱讀審查,然後按一下匯入 N 個項目。
  3. 在資料庫中搜尋 class:Asset,選取 Payload Camera,並在追溯中確認它是 EO-1 Spacecraft 的一部分,以及它執行哪些動作。
  4. 開啟圖,按一下 + 新增圖,選擇 Asset 圖,在圖的對象中選擇 EO-1 Spacecraft,然後按一下建立。
  5. 開啟執行的 Action,列出每個子系統的功能。

當新專案的 Asset 圖顯示太空船的子系統及其執行的動作時,即完成。

常見問題

  1. Holarch 可以匯入 SysML v1 工具的哪些檔案?要如何取得?
  2. 為什麼匯入後可以快速重建圖?
  3. 您匯入同一模型較新的匯出檔。為什麼不會產生副本?

6.5 匯入後的整理

觀看第 6.5 章(2:40)

練習

在 CubeSat EO-1 示範專案上:

  1. 開啟您在前面章節中的 EO-1 Import Practice 專案(或依第 2 章的做法匯入 EO-1 需求的 CSV)。
  2. 開啟需要與需求 → 品質,在範圍列中選擇其中一份匯入的文件,然後按一下檢查品質。
  3. 如果您將相同的需求匯入了兩次(Word 與 ReqIF),請在資料庫中勾選重複項目的列,並以批次列中的刪除項目…將其刪除。改寫 2.5 Safe Mode Recovery 使其可量測,然後再次檢查品質。
  4. 開啟驗證 → 模型檢查,並開啟規則 Requirement.8「沒有任何設計實體滿足的末端需求」。
  5. 如果您也匯入了資產(第 4 章),請選取 2.1 Pointing Accuracy,並在追溯中以 + → 關聯現有… 對 ADCS 新增 satisfied by。再次執行模型檢查。

當 2.5 的分數比之前高,且 Requirement.8 不再列出 2.1 時,即完成。

常見問題

  1. 品質檢查檢視什麼,而模型檢查又檢視什麼?
  2. 為什麼自動品質分數永遠不會超過 78%?
  3. 為什麼要在移轉後立即連接需求與零件?

解答

6.1 規劃移轉

  1. 進入正確類別、標籤、屬性與關係的資料,可立即用於追溯、品質檢查與報告。在匯入後才修正,就得手動編輯許多項目。
  2. 在匯入前於「設定 → 結構描述」中新增屬性,或在「對應」步驟中將該欄對應到「新屬性(已新增到結構描述)」。
  3. 按一次 ⌘Z / Ctrl+Z:從匯入頁面進行的匯入是單一復原步驟。
  4. 用於將整個專案還原為一個新的獨立專案。匯入頁面則會將檔案中的項目合併到目前開啟的專案。

6.2 從 Excel 與 CSV 匯入需求

  1. 如果有對應 Parent Row ID 或 Parent Number 欄,就依據該欄,否則依據大綱編號:1.2 放在 1 之下。如果缺少父項,則使用最近的現有上層項目。
  2. Class 欄中若有結構描述不認得的名稱,會退回使用「無類別的列所用的類別」,並顯示警告。請使用結構描述編輯器中的類別名稱。
  3. 連同 ID 欄一起匯出,編輯檔案,然後在匯入時將 ID 欄對應到「全域 ID」,並將「現有實體的比對依據」設為「全域 ID」。「審查」接著會將它們列在「已更新的項目」下。

6.3 從 Word 與 ReqIF 匯入需求

  1. 使用 Word 標題樣式的段落會成為 Statement(章節)。含有 shall、must、will 或 should 的段落會成為 Requirement,並以動詞後的前幾個字命名。以一般粗體文字輸入的標題會被當作普通文字。
  2. ReqIF 帶有每個需求的識別碼、階層、屬性與關係。當供應商傳送較新的檔案時,匯入它會更新相同的項目,而不是新增副本。
  3. 它會以 traced to 匯入。如果結構描述不允許這兩個類別之間有 traced to,該關係會被略過並顯示警告。

6.4 來自其他工具的模型

  1. 來自 Cameo/MagicDraw、Enterprise Architect、Rhapsody 或 Papyrus、帶有 SysML 1.x 設定檔的 XMI 2.x(從工具匯出),直接匯入的 Cameo 或 MagicDraw .mdzip 專案,以及 Papyrus .uml 檔案。單純的需求也可以用 ReqIF 匯入,表格則可用 Excel 或 CSV。
  2. 其他工具的圖面配置不會匯入,但關係會。Holarch 會依據這些關係繪製 Asset 圖、階層圖與其他圖。
  3. 每個匯入的項目都保留其 XMI id,而對 XMI 檔案而言,「現有實體的比對依據」預設為 XMI ID,因此後續的匯入會更新這些項目。已存在的關係不會重複新增。

6.5 匯入後的整理

  1. 品質檢查依照良好需求應有的品質,為每個需求的用語評分。模型檢查則檢視整個模型中的缺口,例如沒有任何東西滿足的需求、孤立的項目,或沒有人執行的動作。
  2. Correct 與 Feasible 需要人的判斷,因此檢查永遠不會將它們標為已達成。您在審查需求後自行標記它們。
  3. 它們來自不同的檔案,彼此之間沒有關聯。從那時起,每個 satisfied by 關聯都會提供給可追溯性、涵蓋率與模型檢查。

由 Holarch發布