入門
首頁
專案的起始頁面:需要處理的事項、各生命週期群組的進度,以及兩欄面板,呈現您追蹤的工作、檢查與狀態,從後續動作和流程關卡,到風險、自基準線以來的變更以及 AI 專案摘要。
本頁內容
首頁是專案開啟的地方。頂端顯示需要處理的事項,以及各生命週期群組的進度。下方的兩欄面板顯示您追蹤的工作與狀態:後續動作、目前的 SE 流程關卡、模型檢查發現事項、需求品質、驗證、風險、里程碑、自上次基準線以來的變更、未解決的討論、已儲存的檢視、細分圖表、筆記,以及 AI 專案摘要。
每個面板都直接讀取模型,因此只要有人變更它所顯示的項目,它就會立即更新。面板版面配置儲存在專案中:每位成員看到的首頁都相同,且對它的每項變更都可以復原。
概念
- 標頭:專案名稱(位於頂端列)與專案描述的第一行,附編輯描述。
- 需要處理:計算問題數的健康狀態卡片:待審查的關聯、逾期的 TBD、失敗的測試、TPM 超限、高風險、模型檢查與儲存狀態。只顯示計數大於零的卡片;若都沒有,則會有一張卡片顯示沒有需要處理的內容。請參閱入門。
- 生命週期:每個導覽列群組一張卡片,含其主要數字。
- 導覽建議:新的或幾乎空白的專案(少於 25 個項目)會在需要處理上方顯示 ▶ 觀看 4 分鐘導覽。× 會在此瀏覽器中隱藏它。
- 欄道:一欄面板。主欄道約佔寬度的三分之二,側欄道佔其餘部分。在窄視窗中,側欄道會移到主欄道下方。
- 面板:欄道中的一個方塊,含名稱、⋯ 選單與其內容。面板分為矮(最高約 300 px,超過則捲動)或高(最高約 600 px)。
- 單一面板:大多數面板為整個專案顯示一項內容,且在首頁上只能有一個:後續動作、我的工作、SE 流程關卡、模型檢查、需求品質、驗證、風險、里程碑、自基準線以來的變更、未解決的討論、模型內容、專案摘要與最近的工作。已儲存的檢視、細分、Note、已釘選的項目與圖庫則可依需要新增多個。
- 預設面板:新專案會取得符合其階段的面板。早期(SE 流程各階段的前半段,或尚無專案基準線):主欄道中為後續動作、SE 流程關卡與需求品質;側欄道中為最近的工作、里程碑、未解決的討論與專案摘要。之後:後續動作、驗證與自基準線以來的變更;最近的工作、風險、里程碑與專案摘要。
使用方式
使用時機與原因
在每次工作階段開始時以及審查前使用首頁。需要處理會告訴您哪些地方有問題;面板則顯示您選擇追蹤的內容。
- 進行需求工作期間:以 SE 流程關卡查看階段檢查、以需求品質查看最弱的陳述,以及需求狀態的細分。
- 在 SRR 或 PDR 等審查之前:以里程碑查看審查日期、以未解決的討論查看仍未結的留言、以自基準線以來的變更查看自上次審查以來的變更,以及以專案摘要開始撰寫審查摘要。
- 整合與測試期間:驗證、測試案例狀態的細分,以及模型檢查。
- 適用於課堂或新團隊:SE 流程關卡會引導每個人逐一完成所選流程的階段檢查。
排列面板
- 按一下主欄道或側欄道末端的 + 新增面板。(或選擇首頁 ▾ → 新增面板…,會新增到主欄道。)
選單會列出尚未在首頁上的面板。
- 按一下某個面板。
大多數面板會立即出現在欄道末端。已儲存的檢視、已釘選的項目與圖庫會先開啟簡短的表單;填寫後按一下新增面板。
- 拖曳面板的標頭,將其移到同一欄道或另一欄道中的其他位置。
會有一條線顯示它將放置的位置。放開滑鼠時就會儲存版面配置。
- 若要變更面板,請按一下其標頭上的 ⋯:
- 設定…會開啟其表單(只有具備設定的面板才有)。
- 重新命名…會設定其名稱。按兩下名稱即可就地重新命名:Enter 儲存,Esc 取消。名稱留空會恢復面板原本的名稱。
- 調高或調矮會變更其高度。
- 上移、下移與 Move to Side lane(或 Move to Main lane)會移動它。
- 匯出…會下載其內容(只有具備匯出的面板才有)。
- 從首頁移除會立即移除它。快顯通知會提供復原。
以鍵盤移動面板
- 以 Tab 移到面板上(周圍會顯示焦點框),或按一下其標頭。
- 按 Alt+↑ 或 Alt+↓,可在其欄道中上移或下移。
- 按 Alt+→ 將它移到側欄道,或按 Alt+← 將它移到主欄道。
每次移動後,面板會保留焦點。
以已儲存的檢視追蹤查詢
- 按一下 + 新增面板並選擇已儲存的檢視。
- 在已儲存的查詢下,選擇資料庫中已儲存的查詢,或保留在此輸入的查詢並輸入查詢(資料庫搜尋),例如
class:Risk。輸入時,欄位下方會顯示相符的項目數。
- 將Show as(顯示為)設為計數、清單或表格,設定順序(Last changed first、Newest first、Number 或名稱)與列數(1 到 50)。
- 按一下新增面板。
底部的在資料庫中開啟會在資料庫中執行相同的查詢。Export… → Table (CSV) 會下載每個相符的項目。
以細分計算項目
- 按一下 + 新增面板並選擇細分。
結構描述有 Status 屬性時,新的細分會依該屬性計算需求數,否則依類別計算項目數。
- 選擇 ⋯ → 設定…,並選取計數依據:類別、標籤,或屬性下的某個列舉屬性(列為類別:屬性)。
- 按一下儲存。
值在 6 個以內時,面板會繪製中間顯示總數的環形圖;超過時會繪製水平長條。將指標移到扇區或長條上即可查看其計數;類別或標籤扇區會開啟篩選為該類別或標籤的資料庫。
- 若要在其他地方使用圖表,請選擇 ⋯ → 匯出… → Chart (SVG) 或 Chart (PNG)。除非勾選透明背景,否則 PNG 為白色背景。
撰寫專案摘要
- 在頂端列中選擇 ✦ AI ▾ → Write Project Brief,或按一下專案摘要面板中的撰寫摘要。
Holarch 會將專案摘要資訊、自最新專案基準線以來的變更(或過去 30 天內變更的項目)、健康檢查發現的問題(高風險、失敗的測試、超限的量測、逾期的 TBD/TBR 項目、待審查的關聯、模型檢查錯誤)以及目前的 SE 流程階段傳送給 AI。
- 在預覽中閱讀摘要。它分為三個部分:變更、有風險與 Next(後續),並附有其提及之項目的連結。
- 按一下保留在首頁上將其儲存在專案摘要面板中(一次復原即可全部撤回),或按一下關閉捨棄它。
面板會顯示摘要的撰寫時間、使用的模型,以及撰寫所依據的內容。重新撰寫會在新的預覽之後取代它。
編輯專案描述
- 按一下描述行旁的編輯描述(沒有描述時為新增描述),或選擇首頁 ▾ → 編輯描述…。
- 在 RTF 格式文字編輯器中編輯文字,然後按一下儲存。
第一行會顯示在首頁頂端。此描述與專案偏好設定…中的描述相同。
實作範例:CubeSat EO-1 示範專案的審查看板
CubeSat EO-1 示範專案開啟時包含後續動作、需求狀態與測試案例狀態細分、驗證、Functional Flow 已釘選的圖、以發射日期為首的里程碑、Model Walkthrough 流程關卡、未解決的討論、最近的工作與專案摘要。為設計審查做準備:
- 開啟示範專案。首頁會開啟。
- 按一下主欄道末端的 + 新增面板,然後選擇已儲存的檢視。
- 輸入
class:Risk作為查詢,將Show as 設為表格、列設為 10,然後按一下新增面板。表格會列出 RK-1 Reaction Wheel Failure、RK-3 Launch Slip 與其他風險。
- 按兩下新面板的名稱,輸入風險登錄表並按 Enter。
- 將面板拖曳到驗證上方。
- 選擇 ✦ AI ▾ → Write Project Brief,閱讀預覽,然後按一下保留在首頁上。
- 審查之前,在風險表格上選擇 ⋯ → 匯出… → Table (CSV),將其附加到審查套件中。
提示與良好做法
- 每個面板一個問題。需求狀態的細分與 Draft 需求的已儲存檢視,比一個擁擠的表格更容易閱讀。
- 以問題為面板命名,例如未驗證的需求。
- 讓側欄道保持簡短:里程碑、討論與最近的工作適合放在那裡;表格與圖表需要主欄道。
- 在每次審查時儲存專案基準線。這樣自基準線以來的變更與摘要就會顯示自該次審查以來的變更。
- 在查詢中使用屬性測試,例如
Requirement:"Status=Draft"。順序由面板的順序決定。
常見錯誤
- 「沒有可依類別計數的內容。請以 ⋯ → 設定… 選擇要計數的內容。」細分沒有可計數的項目。請選擇其他計數依據。
- 「尚無專案基準線。請在「基準線和版本」上儲存一個,以計算其後的變更。」自基準線以來的變更需要全專案的基準線。在此之前,它會列出最近變更的項目。
- 拖曳時面板沒有移動。請拖曳其標頭而非其內容,或使用 Alt+方向鍵。
- 摘要已過時。摘要只會在要求時撰寫一次。較大的變更後,請按一下重新撰寫。
與其他功能的關聯
- 健康狀態與後續動作:後續動作使用的計數與需要處理、導覽列徽章以及頂端列的需要處理按鈕相同。
- SE 流程:SE 流程關卡會顯示 SE 流程指南的目前階段、其未結的檢查,以及關卡里程碑與審查套件。
- 模型與資料庫:已儲存的檢視與自基準線以來的變更篩選使用資料庫的查詢語法。
- 基準線和版本:自基準線以來的變更會像比較一樣,將最新的專案基準線與目前的模型比較;在「基準線與版本」中比較會開啟完整的比較。
- 驗證與風險:驗證使用與 RVTM 相同的列;風險使用風險登錄表與專案風險等級(風險、問題與決策)。
- 匯出:開啟 Include Project Preferences 時,面板版面配置會隨專案匯出一起帶走(請參閱匯入和匯出)。
首頁
頁首
| 控制項 | 功能 |
|---|---|
| 首頁 ▾ | 新增面板…、編輯描述…、專案偏好設定…、匯出專案…與重設首頁…。僅檢視存取權時不顯示。 |
| 繼續:… | 開啟您最近開啟的項目。在您開啟過圖、文件或其他項目後顯示。 |
| ✦ AI ▾ → Write Project Brief(在頂端列中) | 撰寫專案摘要(見上文)。 |
重設首頁…會詢問「要以適合專案階段的預設組合取代面板嗎?復原可恢復目前的面板。」重設會取代每個面板。
面板標頭
| 控制項 | 功能 |
|---|---|
| 姓名 | 面板的名稱。按兩下即可就地重新命名。拖曳標頭即可移動面板。 |
| ⋯ | 設定…、重新命名…、調高 / 調矮、上移、下移、Move to Side lane / Move to Main lane、匯出…與從首頁移除。 |
面板
| 面板 | 顯示的內容 | 設定與匯出 |
|---|---|---|
| 後續動作 | 最多 6 個最緊急的項目,從失敗的測試到第一批需求 | — |
| 我的工作 | 指派給我的(附到期日)、Awaiting review(等待審查:In Review 狀態的需求)與 Mentions(提及:提到您名稱的未結留言);開啟「我的工作」 | — |
| SE 流程關卡 | 目前的階段及其所屬階段與進度、Open checks(未結的檢查,最多 4 個,高面板 8 個)附連結,以及 Gate(關卡):該階段的每次審查及其里程碑、審查套件與剩餘天數;Open SE Process | — |
| 模型檢查 | 錯誤與警告,接著是主要的發現事項(5 個,高面板 10 個),錯誤優先,各附修正;開啟模型檢查 | — |
| 需求品質 | 依品質分數呈現需求的長條:Good (67 % or more)(良好,67 % 以上)、Fair(尚可)、Poor (under 34 %)(不佳,低於 34 %)與未評分,接著是 Lowest scores(最低分,4 個,高面板 10 個);Open Quality | — |
| 驗證 | verified(已驗證,總數中的 n 項)、失敗與 without a test(沒有測試);每一項都會開啟篩選為該項的 RVTM。高面板:Without a test 會列出這些需求 | — |
| 風險 | 熱度圖:在專案風險等級上,以可能性列(最高者在頂端)對應後果欄,每個儲存格顯示風險數與該儲存格的等級顏色;沒有機率或後果的風險會計入下方;Open Risk Register | — |
| 里程碑 | 標記為 Milestone 且開始日期為今天或之後的 Time 項目(5 個,高面板 12 個),附日期與 In n days(還有幾天);14 天內的標籤會醒目提示。已過的里程碑數顯示在下方 | — |
| 自基準線以來的變更 | 最新的專案基準線,接著是 added(已新增)、removed(已移除)、changed(已變更)與 link changes(關聯變更),接著是 Latest changed items(最近變更的項目,4 個,高面板 8 個);在「基準線與版本」中比較 | 設定…:Only items that match(只包含相符的項目:資料庫查詢) |
| 未解決的討論 | 未解決的留言(5 個,高面板 12 個),提及您的優先,附項目、作者、日期與解決 | — |
| 已儲存的檢視 | 以計數、清單或表格(Number、名稱、類別)呈現的查詢;在資料庫中開啟 | 設定…:已儲存的查詢、查詢(資料庫搜尋)、Show as、順序、列;Table (CSV) |
| 細分 | 以環形圖(最多 6 個值)或長條(超過 6 個)呈現項目數,下方顯示「Count by …」(計數依據 …) | 設定…:計數依據;Chart (SVG)、Chart (PNG) |
| 專案摘要 | 保留的摘要、撰寫時間與撰寫所依據的內容;撰寫摘要 / 重新撰寫 | — |
| 筆記 | 自由的 RTF 格式文字;編輯,然後儲存或取消 | — |
| 模型內容 | 項目數:items(項目)、requirements(需求)、actions(動作)、assets(資產)與 relationships(關係),接著是 Recent changes:最近變更的項目(6 個,高面板 12 個);開啟資料庫 | — |
| 最近的工作 | 開啟的分頁與最近編輯的文件(6 個,高面板 12 個) | — |
| 已釘選的項目 | 以附圖片的卡片呈現一個圖、文件、簡報、圖表或其他成品 | 設定…:Kind(種類)、Item(項目);Picture (PNG) |
| 圖庫 | 以卡片呈現某一種類的每個成品,附搜尋、排序與 Show more(顯示更多) | 設定…:Kind |
舊版的儀表板
以舊版小工具儀表板儲存的專案,開啟時其小工具會依閱讀順序轉換為面板。位於舊網格右側三分之一的小工具會移到側欄道;高度 10 列以上的小工具會成為高面板。小工具自己的標題會成為面板的名稱。
| 小工具 | 面板 |
|---|---|
| 筆記 | 含相同文字的 Note |
| 圓餅圖、長條圖 | 含相同類別、標籤或屬性的細分 |
| 實體表格 | 以表格呈現的已儲存的檢視,含相同的查詢、順序、欄,最多 50 列 |
| 最近的變更 | 自基準線以來的變更 |
| 最近的留言 | 未解決的討論 |
| 倒數計時器 | 里程碑,以計時器的項目或日期為首 |
| 行事曆 | 里程碑(月曆位於專案管理) |
| 流程步驟 | SE 流程關卡,附一行顯示檢查清單及其進度;步驟仍是模型中的項目 |
| 需求驗證(RVTM) | 驗證 |
| 成品預覽 | 已釘選的項目 |
| 所有現有項目 | 圖庫 |
| 專案摘要資訊、專案描述、主要頁面 | 不會轉移:需要處理與生命週期會顯示計數,描述位於標頭,導覽列則連結各頁面 |
欄道上方的通知會說明有多少小工具成為面板,並列出未轉移的小工具。保留這些面板會儲存轉換後的版面配置;使用預設面板會以預設組合取代它。舊的版面配置會保留在專案中,直到隨專案一起刪除。
儲存、復原與角色
- 對首頁的每項變更(新增、移動、調整大小、重新命名、設定、移除、重設、保留摘要)都能以一次復原撤回(⌘Z / Ctrl+Z)。
- 版面配置是專案的一部分。所有成員看到的首頁都相同,一位成員所做的變更會傳達給其他人。
- 檢視者與審查者可以看到面板,但看不到首頁 ▾、+ 新增面板或 ⋯ 中的編輯命令。
訊息
| 訊息 | 意義與修正方式 |
|---|---|
| 「每個面板都已在首頁上。」 | 每個單一面板都已在首頁上,無法再新增其他面板。請先移除一個。 |
| 「請選擇一個項目。此專案尚無此種類的項目。」 | 已釘選的項目:請選擇其他種類,或先建立此種類的項目。 |
| 「無法讀取查詢。請對照資料庫搜尋語法檢查。」 | 已儲存的檢視:請修正查詢。 |
| 「此面板的已儲存查詢已被刪除。請以 ⋯ → 設定… 選擇其他查詢。」 | 已儲存的檢視所依據的資料庫查詢已不存在。 |
| 「已釘選的項目已不存在。請以 ⋯ → 設定… 選擇其他項目。」 | 已釘選的成品已被刪除。 |
| 「未使用任何流程指南。請選擇一個流程,即可在此查看其階段檢查與關卡。」 | 沒有流程的 SE 流程關卡。請按 Open SE Process 並選擇一個流程。 |
| 「沒有即將到來的里程碑。請將 Time 項目加上 Milestone 標籤並設定開始日期,或在 SE 流程上新增關卡里程碑。」 | 里程碑沒有可顯示的內容。 |
| 「無法顯示此面板:…」 | 面板無法繪製。請檢查其設定,或將其移除後再新增一次。 |
限制
- 兩個欄道;面板分為矮或高。
- 已儲存的檢視:最多 50 列;CSV 包含每個相符的項目。
- 專案摘要:最多 150 項變更與 40 個高風險會傳送給 AI。SysML v2 專案中無法使用摘要。
- 每個專案一個首頁,由所有成員共用。