模型
模型與資料庫
LML 實體、類別、屬性、關係與標籤,以及用來尋找、編輯、建立關係、產生報告與還原它們的資料庫檢視。
概觀
LML 專案將一切儲存在一個模型中,該模型以生命週期建模語言(LML 2.0)為基礎,並支援 LML 1.x 模型。需求、功能、資產、介面、測試、風險與決策都是實體。圖、文件、矩陣、登錄表與圖表都是相同實體的檢視。在一個檢視中所做的變更會顯示在每個檢視中。
Holarch 的畫面將每個實體稱為項目(例如+ 新增項目、刪除項目…與項目檢視);實體是 LML 對同一事物的術語,⌘K / Ctrl+K 可用任一個詞找到命令。
資料庫是模型的直接檢視:一個列出專案中每個實體的表格。使用它來尋找、編輯、關聯、報告與還原實體。它有查詢語言、篩選條件、已儲存的查詢、可設定的欄、行內編輯、大量操作工具與報告。已刪除的實體會進入專案的垃圾桶。
另外兩個檢視一次顯示一個實體:
- 項目檢視會顯示一個實體的所有資訊。
- 位於介面右側的屬性面板會從任何頁面顯示所選的實體。
本頁涵蓋模型概念、資料庫、項目檢視、屬性面板、屬性編輯器、歷程記錄、留言與鎖定。若要變更類別、屬性、關係與標籤本身,請參閱結構描述與擴充。
概念
實體
實體是某個類別的一個實例。每個實體都有:
- 名稱(最多 255 個字元)與編號(最多 255 個字元,例如
1.2.3)。實體至少需要兩者之一。 - 類別,決定其屬性、可擁有的關係以及可帶有的標籤。
- 描述,一個格式化文字欄位(標題、清單、表格、圖片、連結)。
- 標籤,在不變更其類別的情況下為實體分類的標記。
- 屬性,類別專屬的欄位(例如 Requirement 的狀態或 Action 的持續時間)。
- 選用的圖片,顯示在屬性面板中,並用於某些圖。
- 中繼資料:
- ID,例如
e42,在專案中唯一。 - 建立與修改時間日期。
- 已鎖定旗標。
- ID,例如
課程
類別構成一棵樹。子類別會繼承其父類別的屬性與關係目標。查詢某個類別時也會找到其子類別。主要的 LML 類別:
| 等級 | 適用情境 | 典型關係 |
|---|---|---|
| 動作 | 功能、活動與任務:系統做什麼 | decomposed by、performed by(Asset)、generates 與 receives(Input/Output)、satisfies(Requirement) |
| Asset | 系統、子系統、人員與組織:由誰或什麼執行動作 | performs、connected by(Conduit)、decomposed by |
| Resource(Asset 的子類別) | 可消耗或可產生的資產,例如電池電量或資料儲存空間 | produced by、consumed by、seized by |
| Input/Output | 在動作之間傳遞的資料、物料或能量 | generated by、received by、transferred by |
| Conduit 與 Logical(Connection 的子類別) | 資產之間的實體連結(介面);資料模型中資產之間的關係 | connects to(Asset)、transfers(Input/Output)、decomposed by |
| 陳述 與 需求 | 目標、假設與定義;「The system shall…」陳述 | decomposed by、satisfied by、verified by、traced to |
| Artifact | 文件、規格、測試套件、簡報 | source of、decomposed by(章節)、originates(Requirement) |
| Heading | 結構化文件的一個章節(LML 2.0):可容納任何類別的項目 | sourced by(Artifact)、decomposed by(子章節)、contains(任何類別) |
| Verification Requirement(Statement 的子類別) | 在需求被視為已達成之前,必須證明什麼以及如何證明(LML 2.0) | verifies(Requirement、Asset)、traced to(Test Case) |
| Test Case(Action 的子類別) | 驗證活動 | verifies(Requirement)、evaluates(Asset)、decomposed by(步驟) |
| Task 與 Transition(Action 的子類別) | 專案任務;狀態轉移 | decomposed by、occurs |
| Risk | 可能出錯的事情 | caused by、mitigated by、resolves |
| Characteristic 與 Measure(Characteristic 的子類別) | 參數、效能指標、TPM;值、單位、格式化方程式、計算值 | specifies |
| Cost、Time、Location(Orbital、Physical、Virtual)、Decision、Issue、Equation | 成本資料、里程碑、地點、決策、問題、方程式 | incurred by、occurred by、located at、alternative、… |
有兩種類別不會到處出現:
- 抽象類別(例如 Location 與 Connection)用於將子類別分組。您無法直接建立它們。
- 隱藏類別(例如由方塊圖建立的 Port)不會出現在類別選擇器中。
應用程式內的說明主題 LML Classes (schema) 會列出完整的即時集合。
Holarch 的預設結構描述以 LML 2.0 規格為基礎,並保留 LML 1.x 模型使用的每個類別、關係與屬性。LML 2.0 的增補包括 Verification Requirement 類別;evaluates(Test Case → Asset);Test Case 上的事件條件與事件約束;Task 上的計畫開始與優先順序;Risk 上的緩解狀態與趨勢;Decision 狀態中的 Open 與 Closed;Time 上的結束(留空時由開始與持續時間推得);Physical 上的單位(Altitude 的單位);Logical 上的 decomposed by;任何 Connection 上的 transfers;Characteristic 與 Measure 上選用的格式化方程式(Equation:LaTeX 文字)與計算值(Computable:以其他屬性構成的公式,在它們變更時重新計算);以及用於結構化文件的 Heading 類別,搭配 contains / contained by 與 originates / originated by(Artifact → Requirement:需求所來自的權威來源)。在這些增補之前建立的專案會保留其結構描述;結構描述 → 新增新的內建項目…會將它們加入。
屬性
屬性是依類別定義的具型別欄位。型別決定編輯器,以及值如何被搜尋、排序、彙總與匯出。關於每種型別,請參閱屬性類型與編輯器。
關係也可以有屬性。例如 decomposed by 有多重性,performed by 有數量,receives 有觸發。
關係
關係以一個具名關聯連接兩個實體。每個關聯都有一個反向關係:「Capture Image Strip performed by Payload Camera」與「Payload Camera performs Capture Image Strip」是同一個連結。Holarch 只儲存一次該連結,並從兩端顯示它。
將關係當作從來源到目標的句子來閱讀。反向關係則從另一端閱讀同一個連結。在屬性面板中,每個實體都會以從該實體讀起的名稱列出其連結。
結構描述決定每種關聯可以連接哪些類別。Holarch 只提供允許的關聯並拒絕其他關聯,讓模型保持有效。重複新增相同的關係不會有任何效果。
關係分為幾個家族:
- 可追溯性:traced to、satisfied by、verified by、derived by、refined by 與 copied by 從 Statement 或 Requirement 開始。traced to 是通用的一種:目標回應該陳述,但不說明如何回應。合適時請使用具體的類型。請參閱追溯關係。
- 結構:decomposed by、related to、specified by 與 instantiates 用於建立階層並描述實體。
- 行為與架構:performed by、generates、receives、connected by 與 transferred by 將功能、資產、項目與介面連在一起。
- 風險、決策、成本與時間:caused by、mitigated by、alternative、incurred by、occurs 等。
關係參考列出每一對關係及其連接的類別、意義與範例。應用程式內的說明主題 LML Relationships (schema) 會列出專案的即時集合。
decomposed by / decomposes 用於建立每個階層。自動編號、文件大綱、階層圖與樹狀圖、彙總以及 Action 圖的子項都依循它。
標籤
標籤可為實體加上標記而不變更其類別。例如:標記為Functional Requirement或Performance Requirement的 Requirement、標記為假設的 Statement、標記為測試套件的 Artifact。
標籤可以巢狀(父標籤帶有子標籤),也可以限定於特定類別。應用程式內的說明主題 Labels (schema) 會列出每個標籤。
鎖定、歷程記錄與留言
- 已鎖定的實體會拒絕編輯、刪除、類別變更以及新增或移除關係,直到有人解除鎖定。仍然可以留言。
- 每項變更都會記錄在實體的歷程記錄中,附上日期,在託管服務上還會附上做出變更的人。您可以還原任何較早的版本。
- 留言會將審查附註附加到實體。您可以編輯、解決、重新開啟與刪除留言。
使用方式
使用時機與原因
模型是整個系統工程生命週期的唯一事實來源。使用資料庫直接處理模型,無須經由圖或文件:
- 在需求定義期間:列出需求、檢查其狀態,並找出沒有父項、來源或驗證的需求。
- 在功能分析與架構期間:找出沒有執行者的功能、沒有介面的資產,以及仍需分解的葉節點實體。
- 在審查之前:找出未解決的留言、未驗證的需求與孤立項(沒有任何關係的實體)。匯出表格或定義報告。
- 大量變更:一次為多個實體重新加上標籤、重新編號、設定屬性或建立關係。
它能回答「哪些需求仍在審查中?」、「哪些功能尚未配置給資產?」以及「這個需求上個月是怎麼寫的?」這類問題。
以查詢尋找實體
以查詢列中的篩選晶片縮小表格範圍,然後以搜尋文字進一步精簡。
- 按一下導覽列底部的資料庫。
- 按一下查詢列開頭的+ 篩選。
會開啟一個清單,其中有結構、類別、標籤、關係、圖與合併群組,並附數量。輸入文字可縮小範圍,例如
requ。 - 在類別下選擇 Requirement(按一下它,或以 ↓ 移到它並按 Enter)。
晶片類別:Requirement會出現,表格只顯示需求。清單保持開啟,並出現需求屬性群組。
- 在需求屬性下選擇狀態。
- 選擇= is,接著選擇In Review,然後按一下新增篩選條件。
晶片Requirement:狀態 = 審查中會出現,表格範圍隨之縮小。
- 在晶片後的搜尋方塊中輸入關鍵字,例如
power。表格會隨著您的輸入進行篩選。搜尋涵蓋名稱、編號與描述。
搜尋適用於任何語言,且不區分大小寫與字元寬度:
muller會找到「Müller」,strasse會找到「Straße」,abs會找到全形的「ABS」。只有在您輸入重音符號時才會區分重音:element會找到「Élément」與「Element」,élément只會找到「Élément」。日文濁音符號(ガ、カ)與韓文音節會保留區別。依名稱排序會依循您的瀏覽器語言,因此「Ölpumpe」會與 O 排在一起,而不是排在 Z 之後。 - 若要變更排序,請按一下欄標題。再按一次可反轉順序。
您也可以輸入整個查詢並按 Enter,例如 class:Requirement Requirement:"Status=In Review" power。開頭的篩選詞會變成晶片,其餘內容留在搜尋方塊中。請參閱查詢語法。若要從現成的問題開始,請按一下檢視窗格中的某個檢視,例如沒有驗證測試的需求。
建立與編輯實體
- 按一下頁首中的+ 新增項目。
建立項目對話方塊會開啟,其中有類別、名稱、編號與描述,游標位於名稱中。在名稱空白時按建立,欄位下方會顯示「請輸入名稱。」;在名稱中按 Enter 會建立實體。
當查詢恰好有一個類別晶片時(例如在需求、資產、決策與項目與輸入/輸出頁面上),按鈕會以該類別命名(+ 新增 Requirement、+ 新增 Asset),而以該類別為標題的對話方塊沒有類別欄位。在 SysML v2 專案中,名稱使用 SysML v2 用語(架構 → 零件上的+ 新增零件),編號稱為簡短名稱,新零件沒有簡短名稱欄位。零件或動作的對話方塊有所屬:包含它的零件定義,預設為關注系統。建立後的附註會說明它放在哪裡,例如「已在 Vehicles::Vehicle 中建立 Roof Rack」。項目與輸入/輸出上的+ 新增項目為停用:請在編輯器或檢視中新增項。
這些單一類別頁面也會保留自己的欄,與資料庫的欄分開。它們一開始沒有類別欄:需求顯示編號、名稱、狀態、驗證方法、品質分數、描述與標籤;決策顯示編號、名稱、狀態、描述與標籤;資產與項目與輸入/輸出顯示編號、名稱、描述、標籤與修改時間。零件顯示名稱、類型、擁有者、多重性、描述與標籤,在含有個體的模型中另加執行個體。欄 ▾ → 預設欄會回到這組欄。
- 填寫欄位並按一下建立。
新實體會被選取並在屬性面板中開啟。
- 在屬性面板的第一個群組(需求或定義)中編輯編號、名稱、描述與標籤,並在其下方的群組中編輯該類別的欄位。
- 若要改在表格中編輯,請按兩下編號、描述或屬性儲存格,或在名稱上按 F2。按 Enter 儲存,或按 Esc 取消。若要一次變更多個儲存格,請從試算表貼上或向下填滿(請參閱像試算表一樣編輯)。
- 若要查看實體的所有資訊,請在可編輯儲存格以外的地方按兩下其列。
項目檢視會開啟。
新需求的 Status 一開始設為 Draft。結構描述中有預設值的屬性會以該預設值開始。
關聯實體
新增關係的方式有四種。請選擇適合工作的方式。
從屬性面板或項目檢視新增一個關係:
- 選取實體並前往追溯區段。
- 找到該關聯。若未列出,請選取顯示所有關係,查看該類別支援的每個關聯。
- 在關聯上按一下 +,然後選擇關聯現有…或新增 <class>…。
從表格:新增關係欄(請參閱欄),然後按一下儲存格中的 +。
一次新增多個:
- 勾選各列。
- 按一下大量操作列中的關係…。
- 勾選一個或多個關聯,以及一個或多個目標。
- 按一下套用。
一次編輯多個實體
- 勾選要變更的列。若要勾選一個範圍,請 Shift+按一下第二個勾選方塊。
大量操作列會出現並顯示已選取 N 項。
- 在大量操作列中選擇一個動作。請參閱下方清單。
- 若要復原整個動作,請按 ⌘Z / Ctrl+Z(或 Ctrl+Z)。每個大量操作都能以一次復原撤回。
大量操作列的動作,依工作流程順序:
- ✦ AI ▾提供針對已勾選列的 AI 動作。
- 關係…可新增或移除關係;在矩陣中開啟會在可追溯性矩陣中顯示已勾選的列。
- 屬性…可設定一個屬性,或新增名稱或編號前綴。
- 標籤 ▾可在所有已勾選實體上切換某個標籤。
- 變更類別…可變更類別。
- 更多 ▾提供開啟、複製副本、鎖定 / 解除鎖定、尋找和取代…、彙總…、重新編號子項…、連同子項複製…、歷程記錄…、新增到文件…與匯出…。
關於每個控制項,請參閱大量操作列。
儲存並重複使用檢視
- 設定篩選條件、搜尋文字、排序、欄與樹狀結構。
- 在檢視窗格中,按一下儲存檢視…。
- 輸入名稱。
- 若要共用,請勾選與專案共用:
- 已勾選:檢視會儲存在專案中,供每個開啟專案的人使用(👥)。
- 未勾選:檢視會留在此瀏覽器中,在您於此瀏覽器開啟的每個專案中都可使用(👤)。
- 按一下儲存。
若要套用檢視,請按一下其名稱。它會還原查詢、晶片、欄與樹狀結構。符合目前查詢的檢視會反白顯示。
若之後要變更已儲存的檢視,請設定好表格,然後在該檢視上選擇 ⋯ → 將目前檢視儲存在此處。⋯ → 與專案共用可共用個人檢視,或將共用檢視再改為個人檢視。
行事曆圖表可以顯示共用檢視的事件。其在資料庫中編輯查詢會以該檢視開啟資料庫,並在查詢列中提供更新「<name>」按鈕:變更查詢後按一下它,即可將變更儲存到共用檢視。使用它的每個行事曆與投影片表格都會跟著更新。
產生報告
- 以查詢縮小表格範圍,或勾選特定的列。
- 按一下頁首中的匯出…(或大量操作列中的更多 ▾ → 匯出…)。
匯出會開啟。
- 在匯出為中選擇要匯出的內容並設定其選項。
- 檢查檔案名稱。
- 按一下匯出。
檔案會下載。
實例演練:CubeSat EO-1
以管理專案 → 專案檔案 ▾ → 新增示範專案建立示範專案。其中包含:
- EO-1 系統需求規格(SRS-001)。
- 太空船分解:1 EO-1 Spacecraft,下有 1.1 Payload Camera、1.2 ADCS、1.3 EPS 等。
- 影像作業流程,從 OPS.1 Transmit Imaging Plan 到 OPS.12 Process Image Products。
- 測試案例,例如 TC-01 Ground Sample Distance Test。
找出等待核准的需求:
- 按一下資料庫。
- 按一下+ 篩選,在類別下選擇 Requirement,然後在需求屬性下選擇狀態。
- 選擇= is與In Review,然後按一下新增篩選條件。
清單包括 1.5 Daily Collection Volume、1.6 Revisit Time 與 3.4 Bus Regulation。核准頁面使用相同的查詢(
Requirement:"Status=In Review")。
找出未驗證的需求:
- 在檢視窗格中,按一下沒有驗證測試的需求。
晶片類別:Requirement會出現,而
NOT relationship:"verified by"留在搜尋方塊中。表格會列出尚未有任何 Test Case 驗證的需求。輸入class:Requirement AND NOT relationship:"verified by"並按 Enter 會得到相同的結果。
顯示誰滿足每個需求:
- 按一下欄 ▾。
- 在關係下勾選 satisfied by,然後按 Esc。
3.4 Bus Regulation 的列會顯示 1.3.3 Power Distribution Unit。按一下空白儲存格中的 + 可新增滿足它的實體。
- 若也要顯示誰執行這些實體,請開啟 satisfied by Entity 欄的 ▾,選擇關聯欄…,選擇 performed by,然後按一下插入。
檢查單一需求:
- 按一下 2.1 Pointing Accuracy 的列。
屬性面板會顯示它。其討論區段中有關於 TC-04 的審查附註。
- 查看追溯區段。
verified by 列出其測試案例,satisfied by 列出 1.2 ADCS。
儲存並報告工作:
- 在已套用沒有驗證測試的需求的情況下,按一下檢視窗格中的儲存檢視…。
- 將其命名為
Unverified requirements,勾選與專案共用,然後按一下儲存。專案中的每個人現在都有此檢視。
- 按一下匯出…並選擇表格 (Excel)。
- 保持勾選凍結標題列,然後按一下匯出。
試算表會使用您新增的欄。
提示與良好做法
- 從廣泛開始,再逐步縮小。先新增類別晶片。之後+ 篩選只會列出對該類別有效的標籤及其屬性。
- 使用樹狀結構以樹狀方式閱讀分解。父項在清單中的實體會顯示在父項之下。
- 審查之前,從內建檢視開始,例如待審查的關聯或模型檢查發現事項,再以晶片縮小範圍。
- 儲存您每週使用的檢視並與專案共用,讓團隊依據相同的清單工作。
- 在分解的根上使用重新編號子項…來編號,而不是手動輸入編號。對於 Action,動作流程順序會依循 Action 圖。
- 鎖定已核准的內容。鎖定已納入基準線的需求或介面,讓意外的編輯被拒絕。
- 解決留言而不是刪除它們,讓審查記錄得以保留。
常見錯誤
- 「沒有符合搜尋或篩選條件的實體。清除它們即可查看所有實體。」先前搜尋的某個晶片仍在作用中。以其 × 移除它,或按一下查詢列中的清除。
- 清單中缺少某個關聯。可能是該關聯尚無任何連結,或結構描述不允許該類別使用它。請在追溯區段中選取顯示所有關係。若該關聯應被允許,請在結構描述編輯器中新增目標。
- 編輯被拒絕並顯示「已鎖定的實體無法修改。請先解除鎖定。」該實體已鎖定。對於關係,任一端的實體都可能已鎖定。請以鎖定按鈕解除鎖定。
- 變更類別會移除資料。變更類別會移除新類別不能有的關係、標籤、屬性值與圖。對話方塊會列出儲存時會清除的內容:在按一下變更類別之前請先閱讀。復原會還原一切。
- 已刪除的實體從表格中消失。開啟專案的垃圾桶(導覽列工具)並按一下還原。它會以相同的 ID 回來,並保留與仍存在之實體的關係。
與其他功能的關聯
- 供應一切:圖、文件、可追溯性矩陣、RVTM、模型檢查、模擬器與所有登錄表都讀取相同的實體。請參閱可追溯性與需求。
- 預設頁面:導覽列中的需求、核准、資產、項目與輸入/輸出與決策都是帶有預設查詢的資料庫。
- 矩陣:頁首中的在矩陣中開啟會在可追溯性矩陣中開啟目前的查詢。大量操作列中的在矩陣中開啟則以已勾選的列開啟。
- 文件:新增到文件…會將已勾選的實體關聯到文件 Artifact。請參閱文件。
- 匯入與匯出:CSV、Excel、Word 與 ReqIF 匯入會建立出現在此處的實體,報告則會將它們匯出。請參閱匯入和匯出。
- 結構描述:類別、屬性、關聯與標籤來自專案的結構描述。請參閱結構描述與擴充。
資料庫檢視
資料庫會列出專案中的每個實體,並提供篩選、編輯、關聯與報告的工具。從導覽列底部的資料庫開啟它。頁面左側是檢視窗格,中間是查詢列與表格,右側是屬性面板。
網址可帶有 ?q=<query>、?class=<id>、?label=<id> 與 ?focus=<entity id>(選取該列並捲動到它)。來自內建項目舊編號的 class 或 label 號碼會改寫為目前的 ID。
頁首
| 控制項 | 功能 |
|---|---|
| 匯出… | 為已勾選的列開啟匯出;未勾選任何列時則為目前的查詢開啟。 |
| 在矩陣中開啟 | 開啟可追溯性矩陣,並將目前的查詢放在其軸上。 |
| + 新增項目 | 開啟建立項目。當查詢固定了某個類別時,會以該類別命名,例如+ 新增 Requirement。 |
| ✦ AI ▾(位於頂端列) | 針對屬性面板中所顯示實體的 AI 動作,以及「產生需求…」。 |
查詢列
| 控制項 | 功能 |
|---|---|
| + 篩選 | 開啟篩選清單。請參閱篩選條件。 |
| 晶片 | 每個篩選條件一個晶片,依查詢順序排列:類別:…、屬性篩選(例如Requirement:狀態 = 審查中)、標籤:…、結構篩選(例如沒有父項)、圖:…、關係:…以及篩選條件或搜尋文字。同類的晶片以或連接。每個晶片都有 × 可將其移除。按一下屬性晶片可變更或移除它。 |
| 排序晶片 | 當沒有可見的欄標題顯示排序時,會顯示排序,例如排序:關係最多 ↓。按一下它可反轉順序;× 會回到預設排序(依編號)。 |
| 搜尋方塊 | 自由文字或查詢語法。隨著您的輸入進行篩選(短暫停頓後)。Enter 會將開頭的篩選詞變成晶片。在空白方塊中按 Backspace 會移除最後一個晶片;Esc 會清除搜尋文字。 |
| 清除 | 移除搜尋文字與每個篩選條件。排序會保留。 |
| ? | 開啟搜尋語法,一份查詢範例表。 |
| 樹狀結構 | 在父項之下顯示子項(請參閱樹狀結構)。開啟時呈按下狀態。 |
| 庫項目 | 當專案顯示庫的項目時出現。也會列出這些唯讀項目(請參閱庫)。開啟時呈按下狀態。 |
| 欄 ▾ | 開啟欄清單。請參閱欄。 |
檢視窗格
| 項目 | 功能 |
|---|---|
| 所有實體 | 每個實體,依編號排序。 |
| 最近變更 | 依修改時間排序,最新的在前(order:modified-)。 |
| 關聯最多 | 依關係數量排序,最多的在前(order:related-)。 |
| 沒有驗證測試的需求 | class:"Requirement" NOT relationship:"verified by". |
| 待審查的關聯 | 具有待審查連結的實體:自連結上次審查以來,上游項目已變更(is:suspect)。 |
| 未結的 TBD/TBR | 具有未結 TBD 或 TBR 的需求(is:tbd)。 |
| 模型檢查發現事項 | 具有模型檢查發現事項的實體(is:finding)。 |
| 未解決的留言 | is:commented. |
| 已鎖定 | is:locked. |
| 已儲存 | 您已儲存的檢視:先列出共用的(👥),再列出您自己的(👤)。儲存檢視…會儲存目前的檢視。每個檢視都有 ⋯(請參閱已儲存的檢視)。 |
| ‹(窗格標頭) | 隱藏檢視窗格。左邊緣的細長 › 條可再次顯示它。 |
| ⋯(窗格標頭) | 重設欄、排序和樹狀結構(預設欄與寬度,依編號排序,不使用樹狀結構)與搜尋語法。 |
按一下檢視會以預設排序套用其查詢;已儲存的檢視還會還原其欄與樹狀結構。符合目前查詢的檢視會反白顯示(您輸入其查詢時也是如此)。
若要變更窗格的寬度,請拖曳其右邊緣(從 160 px 到視窗的 40 %),或將焦點移到邊緣並按向左與向右方向鍵。按兩下邊緣可重設寬度。寬度與窗格是否隱藏會保留在此瀏覽器中,適用於每個專案。在寬度 760 px 以下的視窗中,窗格改由邊緣按鈕開啟。
已儲存的檢視
- 儲存檢視…會開啟儲存檢視,其中有名稱與與專案共用。它會儲存完整的查詢、晶片、欄與樹狀結構。
- 共用檢視儲存在專案中(可復原),並與每個能開啟專案的人共用。其他檢視儲存在此瀏覽器中,可在您於此瀏覽器開啟的每個專案中使用。
- 檢視上的 ⋯:重新命名…、將目前檢視儲存在此處(以目前的查詢、欄與樹狀結構取代其原有內容)、與專案共用(共用時為勾選;選擇它即可切換)、上移、下移與刪除。
- 拖曳檢視,可在相同共用方式的檢視之間重新排序。
表格
- 欄:預設為編號、名稱、類別、描述、標籤與修改時間。可從標題與欄 ▾變更它們(請參閱欄)。
- 捲動:表格會捲動瀏覽每一列;沒有分頁。超過 200 列時,只會繪製捲動位置附近的列,讓大型專案保持快速。捲動位置會保留到下次以相同專案與查詢造訪時。表格下方的列會顯示實體數量(在樹狀結構中還會顯示所顯示的列數)。
- 屬性儲存格中的日期與數字會依循您瀏覽器的語言與地區(德文:29.10.2026, 14:05 與 1234,5);午夜的日期只顯示日期。數字會使用當地的小數點符號,但不加千分位分隔符號,因為零件號碼與代碼常是數字。編輯儲存格時會顯示儲存的值。
- 列會依循偏好設定中的列密度(寬鬆或緊密)。描述顯示兩行;在欄 ▾中勾選顯示完整描述可顯示全部內容。
- 名稱儲存格:連結到項目檢視。它也會顯示標記:
- 🔒 表示已鎖定的實體。
- 審查標記(⚠)表示需求有待審查的連結。
- 💬 表示實體有未解決的留言。
- 按一下列可選取它並在屬性面板中顯示。按兩下列可開啟項目檢視。焦點在某列上時,↑ 與 ↓ 會移到上一列或下一列,Home 與 End 會移到第一列或最後一列,Enter 會在屬性面板中顯示它。
- 按兩下編號、純文字描述或屬性儲存格,即可就地編輯。使用鍵盤時,以 Tab 移到儲存格並按 Enter 或 F2。Enter 會儲存(在描述中按 Shift+Enter 會新增換行);Esc 會取消;焦點會留在儲存格上。選項與是/否會開啟清單,日期會開啟日期方塊,多選則接受以分號分隔的值。格式化文字描述、檔案、品質檢查與計算值需在屬性面板或項目檢視中編輯。
- 名稱:在名稱上按 F2 可就地重新命名實體。
- 關係儲存格會以連結列出相關的實體,並有 + 可新增關係(跟隨另一欄的關聯欄沒有 +)。
- 標題:按一下可依該欄排序;再按一次可反轉。▾ 會開啟欄選單。拖曳標題的右邊緣可調整大小(最小 40 px):只有該欄會變更,表格會隨之變寬或變窄。按兩下邊緣可重設寬度。
- 勾選方塊:標題的勾選方塊會勾選每一列(全部,而不只是可見的列)。Shift+按一下可勾選或取消勾選一個範圍。
像試算表一樣編輯
表格可像試算表一樣一次編輯多個儲存格。每次貼上或填滿都能以一次復原撤回。
- 在儲存格之間移動:焦點在儲存格上時,← 與 → 會沿著列移動,↑ 與 ↓ 會移到上一列或下一列的同一欄。
- 貼上區塊:在 Excel、Numbers 或 Google Sheets 中複製儲存格,按一下區塊起始的儲存格,然後按 ⌘V / Ctrl+V。列向下、欄向右,依表格顯示的順序排列,因此請先調整欄的順序以符合。貼上的空白儲存格會清除值。
- 將一個值貼到多列:勾選各列,然後在其中一個已勾選列的儲存格上貼上單一值。每個已勾選的列都會得到該值。
- 向下填滿:勾選各列,將焦點移到該欄中的某個儲存格,然後按 ⌘D / Ctrl+D,或在欄標題的選單中選擇向下填滿。第一個已勾選列的值會填入其他已勾選的列。未勾選任何列時,⌘D / Ctrl+D 會從上一列複製值。
- 複製:在儲存格上按 ⌘C / Ctrl+C 會複製其文字;當其列屬於已勾選的列時,會複製已勾選列在該欄中的值,每行一個。
值會依屬性的儲存方式讀取:選項必須符合屬性的其中一個選項(不區分大小寫),是/否接受 yes、no、true、false、1 與 0,數字接受分布,日期接受常見的日期格式,而受工作流程監控的狀態只接受其允許的下一個狀態。
有些儲存格會被略過:
- 唯讀儲存格:庫項目、已鎖定項目、格式化文字描述、檔案、品質檢查、計算值與關係欄
- 不符合屬性的值,例如數字欄中的文字
貼上或填滿後的訊息會計算已變更與已略過的儲存格,並說明最常見的原因。超出最後一列的列不會新增;訊息會計算它們。
樹狀結構
查詢列中的樹狀結構會以樹狀顯示分解。父項不在結果中的實體為頂層列;按一下 ▸ 可展開子項(即使查詢會排除子項,也會顯示它們)。▸ / ▾ 是一個按鈕:以 Tab 移到它並按 Enter 或 Space。樹狀結構會隨已儲存的檢視一起儲存。
右鍵選單
在表格或樹狀結構中的列上按右鍵,即可在指標處開啟其選單。使用鍵盤時,將焦點移到某列(其名稱連結、勾選方塊或儲存格),然後按 Shift+F10 或選單鍵;選單會在該列開啟,Esc 會將焦點送回該處。在觸控螢幕上,長按該列。
選單開頭最多有三項建議動作,依選單開啟時實體的狀態挑選。每項都會在右側顯示其原因(也顯示在其工具提示中)。接著是✦ 更多 AI ▸與一條分隔線。
| 建議 | 時機 | 顯示的原因 |
|---|---|---|
| 檢查連結… | 自此實體的連結上次審查以來,上游項目已變更。開啟該實體的審查。 | 上游已變更 |
| 解決 TBD…(或解決 TBR…) | 需求有未結的 TBD 或 TBR。開啟 TBD/TBR 登錄表,並選取該需求。 | 未結的 TBD,或逾期的 TBD |
| ✦ 新增可量測的標準…、✦ 拆分複合需求…、✦ 建議名稱…、✦ 簡化…、✦ 改寫得更清楚… | 需求未通過某項可由改寫修正的品質準則,例如無法量測的效能用語,或 AI 發現事項指出它無法驗證(新增可量測的標準);兩個以上的陳述或連接詞(拆分);缺少名稱(建議名稱);不必要的不定詞片語(簡化);其他措辭發現事項(改寫得更清楚)。最多兩項。 | 未通過:準則 |
| ✦ 產生測試案例… | 需求沒有 verified by 關係。 | 未驗證 |
| ✦ 產生子需求… | 需求或陳述可以分解,且沒有子項。 | 無子項 |
| ✦ 建議流程… | Action 有兩個以上的子 Action,且沒有已儲存的流程。 | 無流程 |
| ✦ AI 需求檢查…與✦ 就此詢問 AI… | 以上皆不適用。 | 尚待判斷的準則,或沒有任何標記 |
這些建議只使用專案中已有的內容(以規則為基礎的品質檢查、您已接受的 AI 發現事項、關係與標記),因此選單會立即開啟。它們依上述順序列出。
✦ 更多 AI ▸會列出該實體的每個 AI 動作:
| 實體 | ✦ AI 動作 |
|---|---|
| 需求 | AI 需求檢查…、改寫 ▸(改寫得更清楚、新增可量測的標準、簡化、拆分複合需求、草擬理由、建議名稱)、產生子需求…、產生測試案例… |
| 其他陳述 | 改寫 ▸(不含新增可量測的標準)、產生子需求… |
| 有兩個以上子 Action 的 Action | 建議流程…(功能分析) |
| 文件 | 產生需求…、摘要文件…、翻譯文件… |
| Risk 以外的任何實體 | 產生風險… |
| 任何實體 | 就此詢問 AI…會以該實體為內容脈絡開啟詢問 AI,並已起頭提問 |
每個 AI 動作都會在任何內容變更之前顯示其結果供審查,與從 ✦ AI 控制項操作時相同。當 AI 關閉時(沒有提供者或金鑰、僅檢視存取權,或組織已關閉 AI),選單的 AI 部分會是一列變暗的項目:✦ AI 動作:後接原因。檢查連結… 與解決 TBD… 仍會顯示。請參閱AI 輔助。
分隔線之後的命令:
| 命令 | 功能 |
|---|---|
| 開啟 | 開啟項目檢視。 |
| 重新命名… | 變更名稱。 |
| 複製副本 | 複製實體,與大量操作列的複製副本相同。 |
| 新增子項目… | 以您輸入的名稱建立同類別的實體,並以 decomposed by 將其關聯。其編號會延續父項的編號(例如 2.3.4)。 |
| 狀態 ▸、優先順序 ▸ | 設定該屬性。目前的值顯示在右側,並在清單中被勾選。對於沒有狀態或優先順序的類別,選單會改為顯示其前兩個清單屬性(例如 Port 的方向 ▸)。 |
| 關聯到 ▸ | 先列出該類別最常用的關係(對需求而言:verified by、satisfied by、traced from、refined by、derived by),接著是所有關係 ▸,依 A–Z 列出該類別允許的每個關係。選擇其中一個會開啟目標實體的選擇器。 |
| 新增到文件 ▸ | 列出文件;選擇其中一份會將該實體連同其子項新增到該文件的結尾。已包含它的文件會變暗。 |
| 在圖中顯示 ▸ | 列出可以顯示該實體的圖類型;選擇其中一種會開啟它。 |
| 複製連結 | 複製指向該實體項目檢視的連結。 |
| 複製編號 | 複製實體的編號(有編號時才顯示)。 |
| 刪除… | 確認後刪除實體及其關係。 |
不使用勾選方塊勾選多列:⌘ / Ctrl-按一下(Windows 與 Linux 上為 Ctrl-按一下)某列可勾選或取消勾選它,⇧ / Shift-按一下可勾選從上次按一下的列開始的範圍,⌘ / Ctrl+⇧ / Shift-按一下可將該範圍加入已勾選的列。焦點在某列時,⌘A / Ctrl+A 會勾選每一列,⇧ / Shift+↑ / ⇧ / Shift+↓ 會從焦點所在列擴展已勾選的列。範圍依顯示的列計算,套用目前的排序、篩選與樹狀結構,也包括可見範圍之外的列。大量操作列會顯示數量(「已選取 21 項」);Esc 會取消勾選所有列。
在未勾選的列上按右鍵,會使它成為選取項目(其他列會取消勾選)。在已勾選的列上按右鍵,且有其他列也已勾選時,會作用於所有已勾選的列:選單會顯示已選取 N 項,而複製副本、設定狀態 ▸、設定優先順序 ▸、新增到文件 ▸與刪除會套用到所有這些列。✦ 群組提供✦ AI 需求檢查(n 項需求)…、✦ 改寫(n) ▸、✦ 產生測試案例(n)…、✦ 就這些詢問 AI(n)…與✦ 建議追溯(n)…,每項都為所有項目提供一個預覽(對多個選取項目使用 AI)。其他命令需要單一列。
每個命令都能以一次復原撤回。已鎖定的實體無法從選單重新命名、關聯、新增子項、設定狀態或優先順序、新增到文件或刪除。每個命令在其他地方也能使用:大量操作列、屬性面板或項目檢視。
若要使用瀏覽器本身的選單(例如在新分頁中開啟名稱連結),請 ⌥ / Alt-按右鍵。文字方塊與正在編輯的儲存格會保留瀏覽器的選單。
大量操作列
至少勾選一列時出現,並顯示已選取 N 項。工具依工作順序排列:先是 AI,然後是追溯,再來是編輯。
| 控制項 | 功能 |
|---|---|
| ✦ AI ▾ | 已勾選列的 AI 動作,與右鍵選單相同:單一列時為其建議與✦ 更多 AI ▸;多列時為✦ AI 需求檢查(n 項需求)…、✦ 改寫(n) ▸、✦ 產生測試案例(n)…、✦ 就這些詢問 AI(n)…與✦ 建議追溯(n)…。每個結果都會在任何內容變更之前先預覽。 |
| 關係… | 開啟N 個實體的關係。動作為新增關係或移除關係。當並非每個已勾選的類別都允許某個關聯時,關係會顯示「(n/m 個類別)」。目標項目有搜尋功能。摘要會顯示關係 × 目標 × 來源。結構描述不允許的配對會被略過並計數。 |
| 在矩陣中開啟 | 以已勾選的列開啟可追溯性矩陣。 |
| 屬性… | 開啟為 N 個實體設定屬性。選項為描述、新增到名稱開頭、新增到編號開頭、影像,或所有已勾選類別共有的任何屬性(品質屬性除外)。值會取代每個實體上的該屬性。前綴會加在現有名稱或編號的前面。 |
| 標籤 ▾ | 列出對每個已勾選類別都有效的標籤。✔ 標示所有已勾選實體都已有的標籤;選擇它會從所有實體移除該標籤,否則會將其新增到所有實體。 |
| 變更類別… | 變更類別。請參閱變更類別。 |
| 更多 ▾ | 開啟(單一列)、複製副本(複製每個已勾選的實體,包括類別、編號、描述、屬性、標籤、影像與關係,命名為「Copy of …」)、鎖定 / 解除鎖定(只要有任何已勾選實體已鎖定,就會解除鎖定)、尋找和取代…、彙總…(一個有子項的列)、重新編號子項…(單一列)、連同子項複製…(單一列)、歷程記錄…(單一列)、新增到文件…、匯出…。 |
| 刪除項目… / 刪除 N 個項目… | 確認後刪除已勾選的實體(它們會進入專案的垃圾桶)。已鎖定的實體會被略過。 |
| × | 取消勾選所有列(Esc 的作用相同)。 |
當已勾選的列包含庫項目時,列的開頭會顯示「已選取 N 個庫項目」與採用…,後者會將它們複製到專案中,成為會記住其來源的可編輯項目。
新增到文件…會以 source of 將已勾選的實體關聯到文件。可用兩種方式之一選擇文件:
- 現有文件:在現有 Artifact下選擇一個 Artifact。
- 新文件:保留— 新增文件 —,並在或命名一個新的 Artifact下輸入名稱。Holarch 會建立一個標記為文件的新 Artifact。
查詢語法
相同的語法也適用於資料庫搜尋、已儲存的查詢、首頁的已儲存的檢視面板、矩陣查詢軸與其他查詢欄位。
| 查詢 | 符合 |
|---|---|
power | 名稱、編號或描述包含「power」(不區分大小寫) |
"power subsystem" | 完全相符的片語 |
number:2.3, number:5.* | 編號,以 * 為萬用字元 |
name:Gen% | 名稱,以 % 為萬用字元 |
description:battery | 描述包含該文字 |
id:e12 | 具有該 ID 的實體 |
class:Requirement | 類別,包括子類別。駝峰式大小寫可不加引號:class:TestCase |
label:"Functional Requirement" | 具有該標籤的實體 |
is:root, is:leaf, is:orphan, is:top, is:diagram, is:locked, is:commented | 沒有父項;沒有子項;沒有關係;有子項的根;有圖;已鎖定;有未解決的留言 |
is:suspect, is:tbd, is:finding | 有待審查的連結;有未結的 TBD 或 TBR;有模型檢查發現事項 |
is:library | 從庫發行版以唯讀方式顯示的庫項目;以此詞或開啟庫項目時,資料庫會列出庫項目(請參閱庫) |
status:Approved | 任何具有狀態屬性之類別的該屬性(不區分大小寫) |
quality:rework, quality:Verifiable=no, quality:R7 | 需求已儲存的品質結果:需要重做(也可用 good、notrun、stale、manual、ai)、某項準則評為 No(=yes:評為 Yes)、某條規則的發現事項(請參閱篩選品質頁面) |
relationship:"verified by" | 至少有一個該類型的關係 |
in:"Station Spec" | 該文件(其名稱或 ID)的項目。對於彙編文件:其各部分及其項目 |
diagram:LML_ACTION | 具有該圖類型。代碼:LML_ACTION、LML_ASSET、LML_SPIDER、LML_HIERARCHY、LML_RISK、LML_TIMELINE、LML_SEQUENCE、TREE、SYSML_ACTIVITY、SYSML_BDD、SYSML_IBD、SYSML_CLASS、SYSML_PACKAGE、SYSML_PARAMETRIC、SYSML_STATE_MACHINE、SYSML_USE_CASE、SYSML_REQUIREMENT、IDEF0、N2、LAYER、RADAR,或圖鍵,例如 ffbd |
Requirement:"Status=Draft" | 以 =、>、<、>=、<= 進行屬性測試。類別詞可以使用駝峰式大小寫:TestCase:"Status=Passed" |
Requirement:"Name~pump" | 屬性包含該文字(~) |
Requirement:"Owner=" | 屬性為空(= 之後沒有內容) |
Risk:"Probability>=50" | 數字屬性 |
Asset:"Mass>2 kg" | 帶單位的值:兩邊都會換算(2500 g 符合;以公尺表示的值則不符合) |
value:"Mass * 1.1 <= 12 kg" | 以項目的值進行帶單位的算術:+、-、*(或 ×)、/(或 ÷)、括號與比較(<、<=、>、>=、=、!=)。值可以是屬性、指定該項目的特性(其 Value 與 Units),或預算配置(Mass Allocation);請在數字後寫上單位(12 kg、9.81 [m/s^2]) |
value:"sum(decomposed by → Mass) > Mass Allocation" | 相關項目的總計:某個值的 sum(或 total)、min、max,以及 count(decomposed by);-> 可代替 →。沒有該值的項目會被略過 |
Action:"Duration>2 hours" | 持續時間屬性(單位:second、minute、hour、day、week、month、year;省略時為小時) |
Physical:"Coordinates=38.9,-77.0" | 位置屬性(緯度、經度)(僅限相等比較) |
order:name, order:name- | 排序;結尾的 - 表示遞減排序。也可用 order:number(預設)、order:class、order:created、order:modified、order:diagrammodified、order:related、order:unsorted |
AND, OR, NOT, ( ) | 組合詞彙。兩個並列的詞表示 AND。 |
屬性測試如何比較值:
- 是/否與品質屬性:
true、yes或1表示是。 - 數字:依數值比較;分布以其平均值比較。數字後帶有單位時(
Mass>2 kg),兩邊會先換算為相同單位,而其他種類的值(公尺對公斤)則不符合。 - 日期:以日期剖析,例如
Task:"Start>2026-01-01"。 - 多選:任何一個所選值相符時,
=即為真。 - 檔案屬性:
=yes符合具有檔案的實體。 - 文字與選項:比較時不區分大小寫。
Name與Number可作為任何類別的屬性名稱:Requirement:"Number>=3"。
範例:class:Requirement AND NOT relationship:"verified by" 會列出沒有測試的需求。
輸入的篩選條件如何變成晶片
當您按 Enter 時,搜尋開頭的篩選詞會變成晶片。會移動的詞包括:
order:、is:、class:、label:、diagram:與relationship:詞。- 類別屬性測試,例如
Requirement:"Status=Draft"或Requirement:"Name~pump"。 - 以
AND連接的上述任何詞。 - 同一種類、以括號括住的 OR 群組,例如
(class:Risk OR class:Issue)。
第一個不是篩選條件的詞會連同其後的所有內容留在搜尋方塊中。篩選條件之後結尾的 OR 會新增晶片篩選條件或搜尋文字:列只要符合篩選條件或搜尋文字之一即可,而非兩者皆須符合。已儲存的檢視與連結以相同的文字照常運作:晶片就是查詢的開頭部分。
篩選條件
查詢列中的+ 篩選會開啟一份篩選條件清單。輸入文字可縮小範圍(群組名稱也會比對,因此 label 會列出每個標籤)。↑ 與 ↓ 用於移動,Enter 或按一下可開啟或關閉篩選條件,清單會保持開啟以選擇下一個。Esc 或按一下外部可關閉它。
| 群組 | 選項 |
|---|---|
| 結構 | 沒有父項、沒有子項、樹的頂端(沒有父項,有子項)、沒有關係、有圖、已鎖定、未解決的留言、待審查的關聯、未結的 TBD/TBR、模型檢查發現事項。 |
| 等級 | 帶有色票與數量的類別樹(類別的數量包含其子類別)。隱藏類別不會列出。 |
| 類別屬性 | 查詢中每個類別一個群組:名稱、編號,以及該類別除品質與檔案屬性以外的每個屬性。沒有類別晶片時,清單會顯示「請先新增一個類別:此處會列出其屬性。」 |
| 標籤 | 查詢中有類別時,列出對它們有效的每個標籤;否則列出使用中的標籤(連同其父標籤)。巢狀標籤會縮排。 |
| 關係 | 對於每個使用中的關聯,顯示有 關聯,並附上具有該關聯的實體數量。 |
| 圖 | 對於專案中存在的每種圖類型,顯示有 圖類型,並附上具有該類型的實體數量。 |
| 合併 | 符合篩選條件或搜尋文字:通過篩選條件的列,加上符合搜尋文字的列。 |
同一種類的選項(類別、標籤、關係、圖)以 OR 組合(任一即可)。結構選項與屬性篩選條件各自都必須符合(AND)。不同種類之間以 AND 組合。
屬性篩選條件。選擇屬性會在同一個面板中開啟其篩選條件:一個比較方式與一個值。
| 比較 | 符合 | 查詢 |
|---|---|---|
| = is | 相等(文字與選項不區分大小寫) | Requirement:"Status=Draft" |
| 包含 | 值包含該文字 | Requirement:"Name~pump" |
| > 多於、≥ 至少、< 少於、≤ 至多 | 依值比較數字、持續時間、日期與百分比 | Risk:"Probability>=50" |
| 為空 | 沒有值 | Requirement:"Owner=" |
選項、多選與是/否屬性會以清單提供其值;其他屬性接受輸入的文字,並有 e.g. 2 hours 與 yyyy-mm-dd 等提示。新增篩選條件會新增晶片;‹ 返回會回到清單。未輸入值就按新增篩選條件,會顯示「請輸入值,或選擇『為空』。」之後按一下晶片即可變更它:更新或移除。
欄
欄就地編輯:從每個標題以及欄 ▾。
欄標題
每個標題都有 ▾(也可在標題上按右鍵,或以 Shift+F10 開啟):
| 命令 | 功能 |
|---|---|
| 遞增排序 / 遞減排序 | 依該欄排序;目前使用的排序會被勾選。 |
| 左移 / 右移 | 將欄移動一個位置。 |
| 重新命名… | 為欄指定專屬的標題。 |
| 重設標題 | 顯示於已重新命名的欄:回到自動產生的標題(顯示在右側)。 |
| 寬度… | 以像素設定欄的寬度(40 到 2000),是拖曳標題右邊框的鍵盤替代方式;留空則回到預設寬度。 |
| 隱藏欄 | 移除該欄,以及跟隨其後的關聯欄。最後一欄無法隱藏。 |
| 插入欄… | 開啟插入欄,在此欄之後新增一欄:種類(實體欄位、屬性或關係)以及它要顯示的內容。 |
| 關聯欄… | 開啟關聯欄:透過您選擇的關係連結到此欄中實體的實體(對於欄位或屬性欄,則連結到每一列)。關係、顯示(實體、被連結實體的任何欄位或屬性),以及當該關聯有屬性時的關係屬性(例如 decomposed by 上的多重性),會取代實體顯示。一個關聯欄從該列最多跟隨 4 層關係。 |
| 編輯欄… | 適用於屬性欄與關係欄:變更該欄顯示的內容。 |
跟隨一個欄可串連關係。例如,一個 satisfied by 欄,再加上一個關聯的 performed by 欄,會列出執行滿足每個需求之功能的資產。
欄 ▾
一份列出您可顯示之每個欄的清單,附勾選方塊:欄位(實體(編號與名稱,作為連結)、編號、名稱、類別、描述、標籤、ID、全域 ID、建立、修改時間)、每個類別一個屬性群組(查詢中的類別,或每個使用中的類別),以及關係(這些類別允許的關聯)。勾選會將欄加到結尾;取消勾選則移除它。輸入文字可縮小清單範圍。
底部:顯示完整描述(否則描述只顯示兩行)與預設欄(六個預設欄,採預設寬度)。
欄、寬度、排序、樹狀結構與顯示完整描述都儲存在此瀏覽器中。檢視窗格中的 ⋯ → 重設欄、排序和樹狀結構會還原預設值。
報告
匯出…會在匯出對話方塊中,將已勾選的列或目前的查詢匯出為檔案。標頭會顯示涵蓋的實體數量,以及它們是已勾選的列還是目前的查詢。
- 在匯出為中選擇要匯出的內容。選項命名為「<內容> (<格式>)」,並依輸出分組(Word、Excel、CSV、交換、列印);會記住您上次的選擇。
- 設定其選項。
- 編輯檔案名稱。預設為專案或實體名稱。
- 按一下匯出。
大型匯出(數萬個實體)會分步驟寫入:進度卡片會顯示目前的工作(「正在讀取項目」、「正在寫入列」、「正在封裝檔案」)及數量,執行期間頁面仍會持續回應。
| 匯出為 | 輸出與選項 |
|---|---|
| 表格 (CSV) | 編號、名稱、描述、類別,接著是所選的欄。包含屬性:列出之類別的每個屬性,依定義它的類別分組(列出項目中最多使用的類別排在最前),每個群組都有一個可勾選整個群組的方塊;篩選屬性可縮小清單範圍,全部 / 無可勾選或清除所顯示的內容。包含:留言、建立日期、實體 URL、全域 ID、ID、標籤(預設開啟)、修改日期、關係(每個使用中的關聯一欄)、格式化文字(描述以 HTML 而非純文字輸出)、已鎖定。排序依據:編號、類別、ID、名稱或階層式。以 =、+、- 或 @ 開頭的文字會加上撇號前綴,讓試算表將其視為文字。 |
| 表格 (Excel) | 資料庫的欄,並加上層級欄。凍結標題列(開啟)、階層(子項位於父項之下)、取消合併儲存格、彙總(將數字與持續時間欄沿階層向上加總)。 |
| 定義 (Excel) | 每個實體一個區塊:類別、編號、名稱、描述、標籤、每個屬性與每個關係。凍結標題列(開啟)、全域 ID、ID、取消合併儲存格。 |
| 關係矩陣 (Excel) | 列是實體,欄是相關的實體。關係、在儲存格中顯示(X(無屬性)或某個關係屬性)、凍結標題列、儲存格加網底(綠色儲存格)、全域 ID。空白儲存格不會寫入檔案,因此檔案大小取決於關係數量。Excel 最多開啟 16,384 欄與 1,048,576 列:更大的矩陣不會匯出,對話方塊會說明這點並指向關係 (CSV)。 |
| 關係 (CSV) | 從匯出的實體出發,每個關係一列:Source Number、Source Name、Source Class、Relationship、Target Number、Target Name、Target Class 與 Attributes。關係(單一關係,或所有關係)。適用於 Excel 容納不下的矩陣,以及指令碼。 |
| 歷程記錄 (Excel) | 每個已記錄的變更一列:Date、ID、Global ID、Entity、Version、Change、Field、From、To。凍結標題列、全域 ID、ID、版本號碼。 |
| 留言 (Excel) | 當實體有留言時提供。每則留言一列,包括其實體的類別、名稱、編號與描述,以及留言、作者、日期與解決狀態。 |
| 分解 (Word) | 恰好一個實體時提供。以依層級排列的標題呈現分解,並附目錄、描述,以及該實體具有之所選圖類型的圖片(階層預設開啟)。 |
| 專案資料 (JSON) | 包含這些實體的專案 JSON 檔案。包含相關項目、包含留言(開啟)、包含歷程記錄、包含圖(開啟)、包含結構描述、不含實體的結構描述。可透過管理專案 → 專案檔案 ▾ → 匯入專案 (.json)…匯入。 |
| 專案套件(.holarch) | 包含這些實體及其關係、圖、留言與結構描述,以及每個附加檔案與圖片的 Holarch 套件。匯入時會讀回並先檢查它;請參閱 Holarch 備份格式。 |
| 需求 (ReqIF) | ReqIF 1.2 XML:每個類別一種類型,字串、XHTML 與列舉屬性,關係以 relation 表示,分解則以規格階層表示。 |
| 表格 (列印) | 從瀏覽器列印表格。 |
關於這些檔案如何匯入其他工具及匯回 Holarch,請參閱匯入和匯出。
屬性面板
屬性面板會在介面右側顯示所選的項目。在資料庫、圖、文件或登錄表中選取項目,即可在此顯示。
標頭為一列:類別徽章、項目的編號與名稱、開啟位置 ▾、圖釘(保持屬性面板開啟)與 ×(關閉項目)。Esc 會隱藏屬性面板。
開啟位置 ▾會列出可開啟該項目的每個檢視:
- 項目檢視。
- 適用於其類別的每種圖類型。
- 文件檢視(Artifact 與 Statement)。
- 模擬器(Action)。
- 測試中心(Test Case)。
- 矩陣、圖表或模擬結果(若存在)。
- 可追溯性矩陣。
面板是一份可捲動的群組清單,順序依您通常處理項目的方式排列。頂端的連結是索引而非分頁:每個連結會跳到其群組、在群組摺疊時將其展開,並將鍵盤焦點移到其標題;您正在閱讀之群組的連結會以粗體顯示。追溯與討論連結會顯示項目有多少關係與未解決的留言。按一下群組標題可摺疊或展開它;Holarch 會在您的瀏覽器中依類別記住這項設定。品質一開始為摺疊狀態。連結右端的全部摺疊會摺疊每個群組,只留下簡短的標題清單;當每個群組都已摺疊時,它會顯示為全部展開,並再次全部展開。Holarch 也會依類別記住這項設定,如同您按過每個標題一樣。此按鈕與連結一樣是鍵盤停駐點,圖的形狀與連線面板也有相同的按鈕。在追溯內,較小的標題(需求、分解、其他專案)會為群組中的關係分類。
| 群組 | 內容 |
|---|---|
| 需求(需求與陳述)或定義(其他類別) | 編號、名稱、描述,以及項目所述的內容:理由、來源、成功準則;其他類別上的種類、依據、觸發等 |
| 工作流程 | 需求的審查列;優先順序、關鍵性、擁有者、負責人、到期日與關注,TBD/TBR 及其擁有者與到期日;其他類別上的狀態、日期與核准者;接著是標籤 |
| 驗證 | 驗證方法與層級、Verified by(已關聯的測試案例及其狀態),在正式計畫群中還有驗證結案欄位;Test Case 的狀態與測試細節 |
| 數值 | 預算數量、門檻值、目標值與目前值、單位;其他類別上的數量、金額與比率 |
| 時程 | 開始、持續時間、完成百分比、完成 |
| 評估 | 嚴重性、可能性、機率與後果評等(風險、危害、失效模式) |
| 符合性 | 符合性與符合性回應(正式計畫群) |
| 品質 | 品質分數與品質準則;標題會顯示「N% · M 項中符合 N 項」 |
| 其他屬性 | 其他每個屬性、您自己的屬性,以及位於 «Name» 下的構造型標記值 |
| 追溯、討論、詳細資料 | 關係、留言,以及 ID、日期、歷程記錄與影像 |
沒有屬性的群組會被省略。屬性面板夠寬時,短欄位每列並排兩個,窄時每列一個;長文字、勾選方塊群組與檔案佔滿整個寬度。理由等長文字欄位在空白時為一行,並隨著輸入而變高。空白欄位會顯示未設定。擁有者欄位會在您輸入時建議名稱:專案中已使用的名稱,以及在共用專案中的成員。將指標停留在屬性的標籤上可查看其描述。
正式計畫群屬性(符合性、符合性回應、驗證結案者、驗證結案日期、驗證結案附註)會在專案偏好設定中開啟正式計畫群時顯示,或在其中任一項有值時顯示。
需求或定義
- 需求:連結審查通知(請參閱需求)。
- 編號與名稱(在項目檢視中為頁面的標題列),接著是描述(格式化文字;按一下即可編輯,或以 Tab 移到它並按 Enter 或 F2),需求還有 EARS ▾。
- 說明項目內容的屬性,例如理由、來源與成功準則。
工作流程
- 需求的審查列:狀態(在此選擇另一個狀態)、由誰在何時設定,以及核准、拒絕…或重新開啟(請參閱需求)。狀態不會作為獨立欄位重複顯示。
- 優先順序、關鍵性與擁有者,接著是負責人與到期日。在共用專案中,通知 → 關注(一個眼睛圖示與關注字樣,開啟時為正在關注)可讓您收到有關該項目的通知(請參閱通知)。
- 以晶片顯示標籤。晶片上的 × 會移除標籤。+ 標籤會列出對該類別有效的每個標籤,依結構描述巢狀排列,已套用者標有 ✓;選擇其中一個即可新增或移除。沒有工作流程群組的項目會在其第一個群組的結尾顯示標籤。
追溯
關係依用途分組:
| 群組 | 關聯 |
|---|---|
| 需求 | traced from/to、satisfies/satisfied by、refines/refined by、derives/derived by、specifies/specified by、source of/sourced by |
| 配置 | performs/performed by、generates/generated by、receives/received by、transfers/transferred by、connects to/connected by、located at/locates、consumes/consumed by、produces/produced by、seizes/seized by |
| 驗證 | verifies/verified by |
| 分解 | decomposes/decomposed by |
| 其他 | 其他每個關聯 |
- 此區段會顯示有連結的關聯、您保持顯示的關聯,以及模型檢查標記的關聯。顯示所有關係還會列出該類別允許的空關聯;標籤會說明有多少被隱藏。
- 模型檢查的缺口會顯示在其關聯下方,例如葉節點需求上的「沒有驗證測試案例」(與驗證 → 模型檢查的規則相同,請參閱可追溯性)。
- 每個關聯都會顯示其名稱與連結數量;將指標停留在其上可查看它所連結的類別。按一下名稱可摺疊或展開它。
- 關聯上的 +:關聯現有…(搜尋、勾選多個、關聯所選)或新增 <class>…(建立允許之類別的項目並將其關聯)。
- 群組上的 ⋯:為空時仍顯示,每個關聯一個勾選。此選擇適用於該類別的每個項目,並保留在此瀏覽器中。預設保持顯示的有 decomposed by、decomposes、satisfied by、satisfies、sourced by、source of、traced from、traced to、verified by 與 verifies;Statement 與 Requirement 則不包含 satisfies、source of 與 verifies。
- 每個已關聯的項目都有連結、適用時的 ⚠ 審查標記、用於關係屬性的屬性,以及移除關係的 ×。
- 當項目已鎖定,或目前的檢視自行管理該關聯時,🔒 會取代 +(「此處為唯讀:此檢視會管理此關係。」)。
討論
項目的留言。請參閱留言。
詳細資料
- ID 附複製連結。ID 也是項目在匯出中的全域 ID,匯入時以比對現有實體的依據:全域 ID可依此找到該項目。
- 類別及其父類別,例如「Statement / Requirement」,接著是建立、修改時間,以及已鎖定時的已鎖定。
- 歷程記錄:已記錄的變更數;按一下可查看完整的歷程記錄。
- 影像:新增影像。有影像時:縮圖(按一下可顯示原尺寸)、下載、取代與移除。
項目檢視
項目檢視會在一個頁面上顯示一個項目,群組與屬性面板相同。可用下列任一方式開啟:
- 按兩下資料庫的列。
- 在任何地方按一下項目的名稱。
- 從開啟位置 ▾選擇項目檢視。
網址為 entity/<id>。
頁首
- 歷程記錄…會開啟完整的歷程記錄。
- 受組態管控之項目的提議變更…。
- 鎖定按鈕(🔒 表示鎖定,🔓 表示解除鎖定)。
- 開啟位置 ▾:可開啟該項目的每個檢視(請參閱屬性面板)。
- 複製副本。
- 子項目 ▾:重新編號子項…(項目有子項時)、彙總…(項目有子項時)、連同子項目複製…與尋找和取代…(該項目及其所有子孫)。
- 更多 ▾:匯出…、變更類別…(變更類別)與刪除項目…。
- ✦ AI 控制項的 ▾ 會列出此項目的 AI 工具。
頁面
- 標題列:以彩色晶片顯示類別,接著是編號與名稱。按一下編號或名稱即可編輯。晶片是一個類別選單:選擇另一個類別會執行變更類別,若有內容會被移除,則會先開啟「變更類別」對話方塊。已鎖定的項目會在群組上方顯示鎖定通知。
- 屬性面板的群組,從需求或定義到追溯、討論與詳細資料。在寬頁面上,第一個群組(陳述及其支援文字)與工作流程(狀態、人員、日期與標籤)並排;其他群組在其下方橫跨整個頁面。在窄頁面上,每個群組為一欄。
- 詳細資料 → 歷程記錄會開啟完整的歷程記錄。
已刪除項目的網址會顯示「此項目已刪除」及還原項目。未知的 ID 會顯示「找不到項目」。兩者都提供返回資料庫。
屬性類型與編輯器
| 類型 | 編輯器與行為 |
|---|---|
| TEXT | 單行文字。 |
| BIG_TEXT | 隨著輸入而變高的多行文字(最高 400 px)。 |
| NUMBER | 一個數字,或以 = 開頭的分布(請參閱分布)。 |
| PERCENT | 0 到 100。超出範圍的值會被限制在範圍內,並顯示訊息。 |
| ENUMERATION | 以選取選項...開頭的選擇清單。當屬性上有工作流程時,只會提供目前的值與允許的下一個值,並標示 ⇢ 工作流程。 |
| MULTISELECT | 勾選方塊;值會排序後儲存。空白時顯示「沒有選項。請在結構描述編輯器中將選項新增到屬性。」 |
| BOOLEAN | 標示為是或否的勾選方塊。 |
| DATETIME | 日期與時間選擇器。 |
| DURATION | 一個數字或分布,加上一個單位:秒、分鐘、小時、天、週、月、年。=script() 讓模擬器從動作的 duration() 掛鉤取得持續時間。 |
| GEOPOINT | 緯度(−90 到 90)與經度(−180 到 180),附在地圖上顯示 ↗(OpenStreetMap)。空白時顯示「沒有位置」。 |
| URI | 附開啟連結 ↗的連結。沒有通訊協定的文字會加上 https://(IP 與 MAC 位址會保持輸入的樣子)。只有 http、https 與 mailto 連結會開啟。 |
| FILE | 上傳…或取代…、預覽(圖片、PDF 與文字檔案)、作為下載連結的檔案名稱,以及移除檔案。 |
| HTML | 格式化文字,與描述相同。 |
| EQUATION | LaTeX 文字,例如 E = mc^2。 |
| COMPUTABLE | 計算值。請參閱可計算屬性。 |
| MULTIPLICITY | n、n..m、n..* 或 *。 |
| QUALITY | 未檢查、是或否,由品質檢查設定。手動選擇值即為手動覆寫,標示為手動,在檢查器重新執行時會保留;自動(重新檢查)會移除覆寫。 |
| QUALITY_SCORE | 來自品質檢查的唯讀百分比。未檢查時顯示「尚無分數。請檢查其品質。」;文字變更後顯示「品質:已過時 — 請重新執行」。 |
| USER_TEAM | 指稱某個人或團隊的文字。 |
值會在欄位失去焦點或選擇變更時儲存。每次儲存都能以一次復原撤回。
分布
數字與持續時間屬性接受分布,例如 Action 的持續時間或 Cost 的金額。模擬器每次執行都會對其取樣。時間軸、彙總與搜尋使用其平均值。
輸入 = 即可查看清單。欄位下方的提示會說明參數。
| 分布 | 公式 | 參數 |
|---|---|---|
| Beta | =beta.dist(α,β) | α > 0 且 β > 0 |
| Binomial | =binom.dist(n,p) | n 為正整數,p 大於 0 且至多為 1 |
| Exponential | =expon.dist(λ) | λ > 0 為速率;平均值為 1/λ |
| Gamma | =gamma.dist(k,θ) | k > 0 且 θ > 0 |
| 對數常態 | =lognorm.dist(μ,σ) | μ > 0 且 σ > 0 |
| 常態 | =norm.dist(μ,σ) | σ > 0 |
| Poisson | =poisson.dist(λ) | λ > 0 |
| 三角 | =triang.dist(a,b,c) | a 小於 b,且 c 介於 a 與 b 之間 |
| 均勻 | =uniform.dist(a,b) | b > a |
| Weibull | =weibull.dist(λ,k) | λ > 0 且 k > 0 |
持續時間不能為負數:取樣值低於 0 時會重新抽取,因此常態分布的持續時間會在 0 處截斷。
可計算屬性
COMPUTABLE 屬性保存以其他實體之屬性構成的方程式。可將其用於衍生值,例如由質量求得重量。
- 按一下定義…(或編輯…)。對話方塊會開啟。
- 在變數下,按一下+ 新增變數。
- 輸入變數名稱。
- 按一下選擇項目…並挑選實體。
- 選擇其屬性。會提供數字、百分比、持續時間與可計算屬性。
- 輸入方程式,例如
mass * 9.81。 - 設定小數位數(0 到 10,預設 2)與結果單位。
- 按一下計算進行測試。
您會看到結果。
- 按一下儲存。
在方程式中,持續時間以小時計算,分布以其平均值計算。方程式支援:
- 運算子
+ - * / ^ %與括號。 - 函式
sqrt、abs、sin、cos、tan、asin、acos、atan、log(以 10 為底)、ln、exp、floor、ceil、round、min、max與pow。 - 常數
pi與e。
當變數的屬性變更時(包括可計算屬性的連鎖),以及專案開啟時,值會重新計算。重新計算可強制重新計算。
來自子項的值。
變數可以讀取項目本身的子項,而非單一實體,讓總計隨分解的變化保持最新。
- 在對話方塊中,按一下+ 子項目的值。
- 選擇函式:加總、平均值、最小值、最大值或計數。
- 選擇屬性。清單包含該項目類別及其以下類別的數字、百分比、持續時間與計算屬性。計數還提供項目,用於計算項目本身。
- 選擇取自子項目(直接子項)或取自最低層級項目(分解的葉節點)。
- 保持勾選× 零件數量,可依每個項目的分解多重性或數量加權,與彙總相同。取消勾選則每個項目只計一次。
- 在方程式中使用變數的名稱,例如
total * 1.1表示 10 % 的餘裕。
子項的值如何讀取:
- 子項的屬性即為所選的屬性,或子項類別上同名的屬性。
- 沒有值的項目會被略過。沒有任何內容的加總或計數為 0;沒有任何內容的平均值、最小值或最大值沒有結果。
- 當子項的值變更、子項被新增、移動或移除,以及多重性變更時,值會作為同一個變更的一部分重新計算(一次復原即可同時撤回兩者)。
- 可以讀取子項本身的計算值,讓每個層級都能加總其子樹:例如 Total Mass =
own + kids,其中own是項目的 Mass,kids是子項 Total Mass 的加總。
該屬性會顯示⟳ 來自子項目;將指標停留在方程式上,可查看每個子項變數讀取的內容。
實體工具
變更類別
變更類別會變更一個或多個實體的類別。以資料庫中的變更類別…,或項目檢視中的更多 ▾ → 變更類別…開啟它。
- 選擇新類別。
- 若也要變更分解的子孫,請勾選同時變更子項目(分解)。
- 閱讀摘要。
它會顯示「N 個項目將變成 Class。」接著列出儲存時會清除的內容:新類別不允許的關係、標籤、屬性值與圖。若沒有任何內容遺失,它會顯示「沒有其他實體受到影響。」
- 按一下變更類別。通知會顯示「已變更 N 個項目的類別。」
在項目檢視中變更類別欄位會執行相同的檢查,且只有在有內容會被移除時才開啟此對話方塊。
彙總
彙總對話方塊(以實體為標題;資料庫中為彙總…,項目檢視中為子項目 ▾ → 彙總…)會對分解的葉節點計算一個值。
- 屬性:該類別的任何數字、持續時間、清單或多選屬性。
- 持續時間單位(僅限持續時間):自動(使用中的最大單位),或從毫秒到年的固定單位。
- 四捨五入至(小數位)(預設 3)。
- 僅此檢視中顯示的項目(從會篩選實體的檢視開啟時可用)。
值的計算方式:
- 數字會在葉節點上加總。每個數字都會乘以其分解的多重性或數量。分布以其典型值計算。
- 帶單位的文字值(例如「2.5 kg」)會換算後加總。
- 持續時間會加總。
- 列舉與多選取最常出現的值。若有平手,由您選擇值。
結果會顯示「M 個最低層級項目中有 N 個有值。」儲存該值會將值寫入實體一次。
保持即時則會讓總計保持最新。當類別有 Computed 屬性時會出現:在保持即時於下選擇它。保持即時會在該屬性中寫入一個方程式,以最低層級項目及其零件數量加總所選屬性(請參閱可計算屬性)。它適用於數字、百分比與持續時間屬性;持續時間以小時加總。沒有 Computed 屬性時,對話方塊會提示您在結構描述編輯器中新增一個。
尋找及取代
在 N 個項目中尋找及取代會搜尋名稱、編號與描述。
- 在尋找與取代為中輸入。僅大小寫相同會讓搜尋區分大小寫。略過已鎖定的項目(開啟)會排除已鎖定的實體。
- 您停止輸入後即開始搜尋。它會依輸入的文字比對(不使用萬用字元)。在大型選取範圍中,進度卡片會顯示搜尋的數量;再次輸入會開始新的搜尋。
- 符合項目會顯示有多少符合項目,並列出它們及其項目、欄位、符合編號與周圍的文字。取消勾選符合項目即可略過;全選或全不選可切換全部。
- 超過 1,000 個符合項目時,清單只顯示前 1,000 個(「2,431 個符合項目;列出前 1,000 個。」)。同時取代未列出的 N 個符合項目(開啟)會將其他項目納入取代;關閉它則只取代清單中已勾選的符合項目。
- 取代所選會變更已勾選的符合項目,一次復原即可全部撤回。在格式化文字描述中只會變更文字,絕不變更格式。大型取代會顯示其進度(「正在取代文字」,然後是「正在儲存已取代的文字」);其他編輯會等到它完成。
重新編號子項
重新編號子項…(以項目為標題)會為項目以下的分解編號。可從項目檢視中的子項目 ▾、資料庫大量操作列中的更多 ▾(單一列)或圖的根開啟它。
- 前置詞:子項會成為
Prefix.1、Prefix.2,依此類推。以符號結尾的前置詞(例如SR-)不會加點:SR-1、SR-1.1。留空則從1開始編號。項目本身的編號不會變更。 - 順序(Action):大綱順序保留目前的編號順序;動作流程順序依循 Action 圖,不在圖上的子項排在最後。
- 僅直接子項目只編號一層。
- 預覽會列出每個子項及其目前與新編號;變更的編號會反白顯示,並有一行計算其數量。在按下重新編號之前不會有任何變更,按下後會套用此清單,一次復原即可全部撤回。當所有編號都已相符時,重新編號無法使用。
編號方式
專案偏好設定… → 編號可設定此專案中重新編號子項…的預設值。對話方塊中的專案編號配置…會開啟相同的設定。
| 設定 | 選項 | 預設 |
|---|---|---|
| 子項順序 | 大綱順序(目前編號)、動作流程順序(Action) | 大綱順序 |
| 前置詞 | 父項的編號、無前置詞、固定文字(搭配前置詞文字,例如 SR-) | 父項的編號 |
| 起始編號 | 從 1 開始、從 0 開始 | 從 1 開始 |
按一次復原即可撤回已儲存的配置變更。文件保留其自己的編號設定(請參閱文件 → 重新編號)。
連同子項複製
複製對話方塊(以實體為標題)會將實體、其分解及其圖複製為新實體。實體名稱用於為副本命名(預設為「Copy of …」)。對於 Action,同時複製模擬實體(執行的 Asset 與 Cost)也會複製這些實體。指向複製範圍外實體的關係仍指向原始實體。
複製副本
將一個實體(類別、編號、描述、屬性、標籤、影像,以及所有關係及其屬性)複製為「Copy of …」。副本不會被鎖定。
歷程記錄與還原
歷程記錄會顯示實體的每項變更,並讓您回到較早的版本。每次建立、編輯、關係變更、刪除與還原都會記錄下來。
可用下列任一方式開啟歷程記錄:
- 項目檢視頁首中的歷程記錄…。
- 屬性面板或項目檢視中的詳細資料 → 歷程記錄(N 項變更…按鈕)。
- 資料庫大量操作列中的更多 ▾ → 歷程記錄…。
歷程記錄對話方塊會由新到舊列出版本。每一列會顯示版本 N、日期與距今多久、在託管服務上的作者,以及變更內容的簡短描述,例如「Changed Status and Verifiable」或「Added satisfied by F1 Detect Wrong-Way Entry」。它不會顯示值。
按一下某個版本(或在其上按 Enter 或 Space),即可在較大的視窗中審查它:
- 該版本中的每項變更,包括其類型、欄位以及標記出的變更:移除的字詞以紅色背景加刪除線,新增的字詞以綠色背景顯示。文字以逐字方式比較,移動過的句子會在兩處都以紫色顯示,兩者之間有移至 / 移自連結;短值顯示為 舊 → 新;關係顯示為已新增 <item>或已移除 <item>。螢幕閱讀器會將這些標記宣讀為已刪除與已插入的文字。
- ‹ 上一個(較舊)與下一個 ›(較新),以及 ← 與 →,可在同一個視窗中瀏覽各版本。
- 還原到版本 N(不適用於目前版本)。
- Esc 或關閉會回到清單,停留在相同版本。
變更類型:
| 類型 | 意義 |
|---|---|
CREATED, REMOVED, RESTORED | 實體已建立、刪除或還原 |
METADATA | 名稱、編號、標籤或其他欄位已變更 |
DESCRIPTION | 描述已變更(逐字標記) |
CLASS_ID | 類別已變更 |
IMAGE_ID | 影像已變更 |
ATTRIBUTE | 屬性值已變更(從 → 到) |
RELATIONSHIP | 已新增或移除關係 |
RELATIONSHIP_ATTRIBUTE | 關係屬性已變更 |
WORKFLOW | 核准、連結審查或品質記錄已變更 |
QUALITY | 品質檢查附註已變更 |
還原到版本 N會以一個步驟復原此實體、其欄位及其關係的所有後續變更。可以復原。
專案的垃圾桶
專案的垃圾桶保存在此專案中刪除的實體。每個條目保留 30 天,之後會自動移除,即使在沒有人開啟的專案中也一樣。條目數量沒有上限。在 30 天限制推出之前就已在垃圾桶中的項目,其 30 天從升級後第一次開啟專案時起算,而非從刪除時起算;在伺服器上,沒有人開啟的專案從升級時起算。已刪除的項目絕不會出現在其專案之外:管理專案中的垃圾桶只保存已刪除的專案(請參閱共用與協同作業)。
以導覽列工具中的垃圾桶(位於資料庫與圖旁)、⌘K / Ctrl+K → 垃圾桶,或移除後附註中的開啟垃圾桶開啟它。
哪些內容會進入垃圾桶
- 已刪除的實體:Shift+Delete、刪除項目…、刪除項目…、大量操作列的刪除 N 個項目…、透過 API 的刪除,以及從變更請求或 AI 提案套用的刪除。
- 不再被任何內容保有的已移除實體:在圖、文件或簡報上的移除只會將項目從該檢視中移出。若這使實體完全沒有關係,它會作為同一個變更的一部分移到垃圾桶,因此按一次復原即可同時還原兩者。附註會顯示「已從圖中移除並移到垃圾桶。」(或「已從文件中移除並移到垃圾桶。」、「已從簡報中移除並移到垃圾桶。」),並提供復原與開啟垃圾桶。當只有部分被移除的實體移到垃圾桶時,附註會說明數量:「已從圖中移除 3 個實體。其中 1 個已沒有任何關係,已移到垃圾桶。」
- 當實體已鎖定或已納入基準線、是一份文件、有自己的圖、在格式化文字中被引用(任何描述或文件中的實體值、連結、交互參照或圖的圖片),或出現在其他圖或白板中時,即使沒有關係,它也會留在專案中。
- 從行事曆、看板與圖表中移除項目只會變更屬性;這些實體絕不會移到垃圾桶。
已刪除實體的子項
刪除實體絕不會讓其子項失去父項。每個子項都會上移到被刪除實體的父項之下,保持相同的關係(decomposed by;文件為 source of;Test Suite 為 referenced by),並位於被刪除實體在編號中的位置。當實體有多個父項時,您從中刪除的圖上所顯示的父項優先。沒有父項時,子項會成為頂層項目。這屬於同一個變更,因此一次復原即可全部撤回。
確認訊息會說明子項的去向,例如「其 3 個子項會上移到『F.1 Collect Data』之下。」或「其 3 個子項會成為頂層項目。」。勾選同時刪除子項目可改為刪除整個分支:該行會變成「其 3 個子項及其下的 12 個項目也會被刪除。」。此方塊每次都以未勾選開始。文件保有其自己的規則:刪除章節會刪除其內容。
垃圾桶頁面
條目由新到舊列出。每一列顯示:
| 欄 | 顯示內容 |
|---|---|
| 等級 | 實體的類別 |
| 實體 | 編號與名稱 |
| 已刪除 | 刪除的時間 |
| 原因 | 已刪除、已連同其下 N 個項目一起刪除,或已從 <view> 移除;已無任何關係(例如「已從 Launch Sequence (Action Diagram) 移除;已無任何關係」) |
| 保留時長 | 自動移除前剩餘的天數 |
| 關係 | 它原有多少關係 |
- 在依名稱、編號、類別或原因篩選中輸入,可縮小清單範圍。
- 還原會以相同的 ID 帶回實體,以及其圖、留言和與專案中實體的關係。刪除時上移的子項會回到其下。以同時刪除子項目刪除的實體會連同其分支一起還原。
- ⋯ → 預覽會以唯讀方式顯示條目:類別、編號、刪除時間、原因、剩餘天數、描述、屬性、關係、上移的子項,以及參照位置:仍引用它的文字。
- ⋯ → 永久刪除…會詢問「永久刪除「<entity>」:將無法再從垃圾桶還原。可用 ⌘Z / Ctrl+Z 復原。」,然後移除該條目。
- 以其他方式帶回的實體(還原專案基準線、將文件還原到其基準線,或對孤立基準線執行還原文件)會作為該還原的一部分離開垃圾桶;復原該還原動作會將其條目放回。
- 全部還原會還原每個條目;條目達 5,000 個以上時,執行期間會顯示進度卡片。清空垃圾桶會詢問「永久刪除垃圾桶中的 N 個實體:它們將無法再還原。可用 ⌘Z / Ctrl+Z 復原。」。
- 檢視者與審查者可以看到垃圾桶,但無法還原或刪除。
還原已刪除的實體
- 開啟導覽列工具中的垃圾桶。
- 在篩選欄位中輸入名稱的一部分。
- 按一下其列上的還原。附註「已還原「<entity>」。」會確認這點,實體也會回到其圖與頁面上。
注意:格式化文字中對已刪除實體的參照(實體值、連結、交互參照、圖的圖片)在其還原之前會顯示為遺失。它保留其 ID,因此這些參照會隨之恢復。
留言
留言可將審查附註附加到實體。它們位於屬性面板與項目檢視的討論區段,以及文件的留言窗格中。
- 在新增留言…中輸入,然後按一下新增留言。留言會記錄日期與您的帳戶名稱。
- ✎ 用於編輯(留言會標示「(已編輯)」),✓ 用於解決,↺ 用於重新開啟,× 用於刪除。
- 留言下的回覆會開啟回覆方塊;新增回覆會發佈它。回覆會縮排在其所回答的留言之下,回覆的回覆會加入同一個討論串。
- ✓ 與 ↺ 會作用於整個討論串。刪除討論串的第一則留言會刪除其回覆;Holarch 會先詢問(「要刪除這則留言及其 N 則回覆嗎?」)。
- 已解決的留言會隱藏;顯示已解決 (N)會將其納入。
- 有未解決留言的實體會在資料庫中顯示 💬,並在討論連結上顯示數量。
is:commented可找到它們。 - 已鎖定的實體也可以留言。檢視者可以閱讀留言,但無法新增或變更(「僅供檢視:留言需要編輯存取權。」)。
- 首頁上的未解決的討論面板會列出未解決的留言,匯出… → 留言 (Excel)可將其匯出。
鎖定
鎖定實體可保護它免於意外變更,例如在核准之後。
- 以項目檢視頁首中的 🔒 按鈕鎖定實體,或勾選各列後按一下資料庫大量操作列中的鎖定。
- 解除鎖定可將其還原。已鎖定項目的屬性面板會顯示「🔒 已鎖定的項目。解除鎖定即可編輯。」及解除鎖定。
- 已鎖定的實體會拒絕對其欄位的編輯、類別變更、刪除,以及在任一端新增或移除關係。其編輯器會停用。
- 任何具有編輯存取權的人都可以鎖定與解除鎖定。鎖定會記錄在歷程記錄中。
is:locked與已鎖定篩選條件可找到已鎖定的實體。
刪除與還原
- 可從大量操作列(刪除項目…)、項目檢視(更多 ▾ → 刪除項目…),或圖或文件中刪除。已鎖定的實體不會被刪除。
- 已刪除的實體會連同其關係、圖與留言進入專案的垃圾桶。還原會以相同的 ID 將其帶回。
- 復原(⌘Z / Ctrl+Z)也能撤銷刪除。
僅檢視存取權
在託管服務上,具有檢視者角色的專案成員可以開啟每個頁面、搜尋並執行報告,但無法變更任何內容。編輯器會停用,任何嘗試的變更都會顯示「僅供檢視:請向擁有者要求編輯存取權。」
鍵盤快速鍵與手勢
| 按鍵或手勢 | 位置 | 動作 |
|---|---|---|
| Enter | 搜尋方塊 | 套用查詢;開頭的篩選詞會變成晶片 |
| Backspace / Esc | 空白搜尋方塊 / 有文字的搜尋方塊 | 移除最後一個晶片 / 清除搜尋文字 |
| ↑ / ↓, Enter | + 篩選與欄 ▾清單 | 在選項之間移動 / 開啟或關閉某個選項(清單保持開啟) |
| ↑ / ↓, Home / End | 焦點所在的列 | 移到上一列 / 下一列 / 第一列 / 最後一列 |
| Esc | 資料庫 | 取消選取所選的列(未在輸入且沒有開啟對話方塊時) |
| 按一下 | 表格列 | 選取並在屬性面板中顯示 |
| 按兩下 | 表格列 | 開啟項目檢視 |
| 按兩下 | 編號或描述儲存格 | 就地編輯 |
| Enter / Shift+Enter / Esc | 正在編輯的儲存格 | 儲存 / 換行(描述)/ 取消 |
| Shift+按一下 | 列的勾選方塊 | 勾選或取消勾選一個範圍 |
| 按右鍵、Shift+F10、選單鍵、長按 | 表格列 | 開啟該列的右鍵選單 |
| ⌥ / Alt+按右鍵 | 表格列 | 顯示瀏覽器本身的選單 |
| 按一下 / 再按一下 | 欄標題 | 排序 / 反轉 |
| ▾、按右鍵 | 欄標題 | 欄選單 |
| 拖曳 / 按兩下 | 欄標題邊緣 | 調整大小 / 重設寬度 |
| 拖曳 | 已儲存的檢視 | 在相同共用方式的檢視之間重新排序 |
| ⌘ / Ctrl+Z / ⌘ / Ctrl+Shift+Z | 任何位置 | 復原 / 重做(Windows 與 Linux 上為 Ctrl) |
所有快速鍵:鍵盤快速鍵。
選項與設定
儲存在此瀏覽器中:
- 資料庫檢視設定:排序與方向、欄、欄寬、樹狀結構、顯示完整描述與捲動位置。檢視窗格中的 ⋯ → 重設欄、排序和樹狀結構會將其清除。較早版本的設定會沿用:列高大於 1× 時會開啟顯示完整描述;頁面大小、文字對齊與「記住捲動位置」已不再使用。
- 您自己已儲存的檢視(未共用)。
- 依類別保持顯示的關聯、顯示所有關係、已摺疊的關聯、顯示已解決,以及品質群組的開啟狀態。
儲存在專案中:共用檢視、實體、關係、留言、歷程記錄與專案的垃圾桶。
訊息
| 訊息 | 意義與修正方式 |
|---|---|
| 「沒有符合搜尋或篩選條件的實體。清除它們即可查看所有實體。」 | 沒有實體通過搜尋與篩選條件。以晶片的 × 將其移除,或按一下清除。 |
| 「請先新增一個類別:此處會列出其屬性。」 | + 篩選只會列出查詢中類別的屬性。請新增類別晶片。 |
| 「請輸入值,或選擇『為空』。」 | 屬性篩選條件需要一個值。 |
| 「關聯欄最多跟隨 4 層關係。」 | 超過此深度時不會提供關聯欄…。 |
| 「以 + 新增項目新增實體,或匯入 CSV 檔案。」 | 專案尚無任何實體。 |
| 「已移除 N 個屬性或關聯已不存在的欄。」 | 某個欄參照了已刪除的屬性或關聯;該欄已被捨棄。 |
| 「表格至少需要一個欄。請保留一個欄。」 | 欄清單不能為空。 |
| 「所選類別沒有共同的標籤」 | 已勾選實體的類別沒有共同的標籤。 |
| 「請選擇一個關係以及至少一個目標。」 | 關係…在按下套用之前兩者都需要。 |
| 「已建立 N 個關係,略過 M 個結構描述不允許的關係」 | 某些來源與目標配對不允許使用該關聯。 |
| 「Class 不能有『relation』」 | 該列的類別不允許該關係欄的關聯。 |
| 「請為項目指定名稱或編號。」 | 名稱與編號不能同時為空。 |
| 「已鎖定的實體無法修改。請先解除鎖定。」 | 解除該實體(或關係另一端的實體)的鎖定。 |
| 「已鎖定的實體無法刪除。請先解除鎖定。」 | 刪除中的已鎖定實體已被略過。 |
| 「已鎖定的項目無法變更類別。請先解除鎖定。」 | 變更類別之前請先解除鎖定。 |
| 「文件只有在最多一個子項時才能變更類別。」 | 當目標為文件類別時,顯示於「變更類別」中。 |
| 「僅供檢視:請向擁有者要求編輯存取權。」 | 您在此專案中的角色是檢視者。 |
| 「影像超過 N MB 上限。」/「超過 N MB 的檔案不會儲存;只保留名稱。」 | 檔案大於每個檔案的上限。 |
| 「請輸入數字。」/「百分比至少必須為 0。」/「百分比至多必須為 100。」 | 百分比欄位輸入。 |
| 「不是數字。請輸入數字。」/「不是有效的分布。」/「預期格式為 =norm.dist(mu, sigma)」/「參數必須是數字。請為每個參數輸入數字。」 | 數字或分布輸入;也包括參數檢查,例如「Sigma 必須大於 0。」或「B 必須大於 A。」 |
| 「請使用 n、n..m 或 n..*」 | 多重性輸入。 |
| 「變數名稱『x』無效:必須包含字母、不可以數字開頭,且不可為『i』或『e』。」/「變數『x』沒有實體(可能已被刪除)。」/「未知的名稱『x』」/「方程式沒有有限的結果。請檢查是否除以零。」 | 可計算屬性錯誤。 |
| 「沒有可彙總的內容:此階層中沒有任何實體具有所選屬性的值。」 | 彙總在葉節點上找不到任何值。 |
| 「Class 沒有可彙總的數字、持續時間或清單屬性。」 | 此類別無法進行彙總。 |
| 「沒有符合項目。」/「未選取任何項目。」 | 尋找及取代沒有找到任何內容,或沒有勾選任何符合項目。 |
| 「此實體沒有已記錄的變更。」 | 歷程記錄是空的。 |
| 「此檔案類型無法預覽。請下載檔案以開啟它。」 | 改為下載檔案。 |
限制
- 名稱與編號:各 255 個字元。
- 表格在 200 列以內會繪製所有列;超過時只繪製捲動位置附近的列(其餘列會在捲動時繪製)。
- 實體選擇器與大量操作的目標清單會顯示前 300 個符合項目;輸入文字可縮小範圍。
- 專案的垃圾桶會將每個條目保留 30 天,條目數量沒有上限。
- 一個專案最多保留 4,000 筆歷程記錄;超過時,最舊的 1,000 筆會移出專案。它們仍可在項目的歷程記錄…中的較早的變更下閱讀,也可透過活動上的載入較早的變更閱讀(在 app.holarch.app 上:Individual 與 Team 方案)。建立超過 500 個項目的動作(匯入)會以一筆摘要記錄移出,而非逐一項目移出。
- 復原會保留工作階段的最後 200 個步驟。在桌面應用程式中,非常大的步驟(匯入或大型模型的大量變更)保留得較少:復原歷程最多保存約 4,800 萬個字元的變更資料,且一律保留最新的步驟。
- 關聯欄從該列最多跟隨 4 層關係(先前以最多 8 層儲存的欄仍會顯示)。
- 影像與檔案:適用託管服務的每個檔案上限(Free 方案 10 MB,Individual 25 MB,Team 100 MB)。寬度或高度超過 4,000 px 的 PNG、JPEG 與 WebP 影像在儲存時會縮小。