模型
模型和数据库
LML 实体、类、属性、关系和标签,以及用于查找、编辑、关联、报告和恢复它们的数据库视图。
概述
LML 项目将所有内容存储在一个模型中,该模型基于生命周期建模语言(LML 2.0),并支持 LML 1.x 模型。需求、功能、资产、接口、测试、风险和决策都是实体。图、文档、矩阵、登记册和图表都是同一组实体的视图。在一个视图中所做的更改会显示在所有视图中。
Holarch 的界面将每个实体称为条目(例如+ 新建条目、删除条目…和条目视图);实体是 LML 对同一事物的称呼,⌘K / Ctrl+K 用这两个词都能找到命令。
数据库是模型的直接视图:一张包含项目中所有实体的表格。用它来查找、编辑、关联、报告和恢复实体。它提供查询语言、筛选条件、已保存的查询、可配置的列、内联编辑、批量工具和报告。已删除的实体会进入项目的回收站。
另有两个视图一次显示一个实体:
- 条目视图显示一个实体的全部信息。
- 属性面板位于界面右侧,可在任何页面显示所选实体。
本页介绍模型概念、数据库、条目视图、属性面板、属性编辑器、历史记录、评论和锁定。要更改类、属性、关系和标签本身,请参阅架构和扩展。
概念
实体
实体是某个类的一个实例。每个实体都有:
- 名称(最多 255 个字符)和编号(最多 255 个字符,例如
1.2.3)。实体至少需要其中之一。 - 类,决定其属性、可以拥有的关系以及可以带有的标签。
- 描述,一个富文本字段(标题、列表、表格、图像、链接)。
- 标签,用于对实体分类而不更改其类的标记。
- 属性,特定于类的字段(例如 Requirement 的状态或 Action 的Duration)。
- 可选的图像,显示在属性面板中,并用于某些图。
- 元数据:
- ID,例如
e42,在项目中唯一。 - 创建时间和修改时间。
- 已锁定标志。
- ID,例如
课程
类构成一棵树。子类继承其父类的属性和关系目标。对某个类的查询也会找到其子类。主要的 LML 类:
| 类别 | 适用场景 | 典型关系 |
|---|---|---|
| Action | 功能、活动和任务:系统做什么 | 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 |
| Statement 和 Requirement | 目标、假设和定义;“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;Value、Units、Formatted Equation、Computed Value | specifies |
| Cost、Time、Location(Orbital、Physical、Virtual)、Decision、Issue、Equation | 成本数据、里程碑、地点、决策、问题、方程 | incurred by、occurred by、located at、alternative、… |
有两种类不会在所有地方出现:
- 抽象类(例如 Location 和 Connection)用于对子类分组。无法直接创建它们。
- 隐藏类(例如由框图创建的 Port)不会出现在类选择器中。
应用内帮助主题LML 类(架构)列出了完整的实时类集。
Holarch 的默认架构基于 LML 2.0 规范,并保留 LML 1.x 模型使用的所有类、关系和属性。LML 2.0 新增的内容包括:Verification Requirement 类;evaluates(Test Case → Asset);Test Case 上的 Event Conditions 和 Event Constraints;Task 上的 Planned Start 和 优先级;Risk 上的 Mitigation Status 和 趋势;Decision 状态中的 Open 和 已关闭;Time 上的 End(留空时由 Start 和 Duration 推算);Physical 上的 Units(Altitude 的单位);Logical 上的 decomposed by;任何 Connection 上的 transfers;Characteristic 和 Measure 上可选的 Formatted Equation(Equation:LaTeX 文本)和 Computed Value(Computable:基于其他属性的公式,在这些属性更改时重新计算);以及用于结构化文档的 Heading 类,带有 contains / contained by 和 originates / originated by(Artifact → Requirement:需求所来自的权威来源)。在这些新增内容之前创建的项目会保留其架构;架构 → Add New Built-ins…可添加它们。
属性
属性是按类定义的类型化字段。类型决定编辑器,以及值如何被搜索、排序、汇总和导出。有关每种类型,请参阅属性类型和编辑器。
关系也可以有属性。例如 decomposed by 有多重性,performed by 有 Amount,receives 有 Trigger。
关系
关系用一个命名的关系类型连接两个实体。每个关系都有一个逆关系:"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 构建所有层级。自动编号、文档大纲、层级图和树形图、汇总以及动作图的子项都遵循它。
标签
标签为实体添加标记而不更改其类。示例:标记为 Functional Requirement 或 Performance Requirement 的 Requirement、标记为假设的 Statement、标记为测试套件的 Artifact。
标签可以嵌套(父标签带子标签),并可限定于某些类。应用内帮助主题Labels (schema)列出了所有标签。
锁定、历史记录和评论
- 已锁定的实体会拒绝编辑、删除、更改类以及新增或移除关系,直到有人将其解锁。仍允许评论。
- 每次更改都会记录在实体的历史记录中,包括日期,在托管服务上还包括做出更改的人。您可以恢复任何较早的版本。
- 评论为实体附加评审意见。您可以编辑、解决、重新打开和删除评论。
如何使用
何时使用及原因
模型是整个系统工程生命周期的唯一事实来源。使用数据库直接处理模型,而无需通过图或文档:
- 在需求定义期间:列出需求,检查其状态,并找出没有父项、来源或验证的需求。
- 在功能分析和架构设计期间:找出没有执行者的功能、没有接口的资产,以及仍需分解的叶实体。
- 评审之前:找出未解决的评论、未经验证的需求和孤立项(没有任何关系的实体)。导出表格或定义报告。
- 批量更改:一次为多个实体重新设置标签、重新编号、设置属性或创建关系。
它可以回答诸如 “哪些需求仍处于评审中?”、“哪些功能尚未分配给资产?” 和 “这条需求上个月是怎么写的?” 之类的问题。
用查询查找实体
用查询栏中的筛选标签缩小表格范围,然后用搜索文本进一步细化。
- 点击导航栏底部的数据库。
- 点击查询栏开头的+ 筛选。
此时会打开一个列表,其中包含结构、类、标签、关系、图和合并分组,并显示计数。输入文字可缩小列表范围,例如
requ。 - 在类下选择 Requirement(点击它,或用 ↓ 移到它并按 Enter)。
出现筛选标签 Class: Requirement,表格只显示需求。列表保持打开,并出现需求属性分组。
- 在需求属性下选择状态。
- 选择= is,然后选择评审中,并点击添加筛选条件。
出现筛选标签Requirement: Status = In Review,表格范围随之缩小。
- 在筛选标签后面的搜索框中输入关键字,例如
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 即可创建实体。
当查询恰好只有一个类筛选标签时(如需求、资产、决策和条目与输入/输出页面),按钮会以该类命名(+ 新建需求、+ 新建资产),其对话框以该类为标题,且没有类字段。在 SysML v2 项目中,名称使用 SysML v2 术语(架构 → 部件上的+ 新建部件),编号称为短名称,新部件没有短名称字段。部件或动作的对话框有所属:容纳它的部件定义,预设为所关注的系统。创建后的提示会说明它被放在了哪里,例如 "Created Roof Rack in Vehicles::Vehicle"。条目与输入/输出上的+ 新建条目处于禁用状态:请在编辑器中或在视图上添加项。
这些单类页面也有各自的列,与数据库的列分开。它们开始时没有类列:需求显示编号、名称、状态、验证方法、质量评分、描述和标签;决策显示编号、名称、状态、描述和标签;资产和条目与输入/输出显示编号、名称、描述、标签和修改时间。部件显示名称、类型、所有者、多重性、描述和标签,在含有个体的模型中还显示实例。列 ▾ → 默认列可恢复这组列。
- 填写字段并点击创建。
新实体被选中,并在属性面板中打开。
- 在属性面板的第一组(需求或定义)中编辑编号、名称、描述和标签,在其下方的各组中编辑该类的字段。
- 要改为在表格中编辑,请双击编号、描述或属性单元格,或在名称上按 F2。按 Enter 保存,或按 Esc 取消。要一次更改多个单元格,请从电子表格粘贴或向下填充(请参阅像电子表格一样编辑)。
- 要查看实体的全部信息,请在可编辑单元格之外双击其行。
条目视图随即打开。
新需求的状态初始为草稿。在架构中有默认值的属性以该默认值开始。
关联实体
添加关系有四种方式。请选择适合任务的方式。
一条关系,从属性面板或条目视图添加:
- 选择实体并转到追溯部分。
- 找到该关系。如果未列出,请选择显示所有关系,查看该类支持的所有关系。
- 点击该关系上的+,然后选择关联现有…或新建 <class>…。
从表格添加:添加一个关系列(请参阅列),然后点击单元格中的+。
一次添加多条:
- 勾选这些行。
- 点击批量操作栏中的关系…。
- 勾选一个或多个关系以及一个或多个目标。
- 点击应用。
一次编辑多个实体
- 勾选要更改的行。要勾选一个范围,请按住 Shift 并点击第二个复选框。
批量操作栏出现,并显示已选择 N 项。
- 在批量操作栏中选择一项操作。请参阅下面的列表。
- 要撤销整个操作,请按 ⌘Z / Ctrl+Z(或 Ctrl+Z)。每个批量操作都可通过一次撤销撤回。
批量操作栏中的操作,按工作流顺序排列:
- ✦ AI ▾为勾选的行提供 AI 操作。
- 关系…添加或移除关系;在矩阵中打开在可追溯性矩阵中显示勾选的行。
- 属性…设置一个属性,或添加名称或编号前缀。
- 标签 ▾在所有勾选的实体上切换某个标签。
- 更改类…更改类。
- 更多 ▾提供打开、创建副本、锁定 / 解锁、查找和替换…、汇总…、重新编号子项…、连同子项复制…、历史记录…、添加到文档…和导出…。
有关每个控件,请参阅批量操作栏。
保存并重用视图
- 设置筛选条件、搜索文本、排序、列和树。
- 在视图窗格中,点击保存视图…。
- 输入名称。
- 要共享它,请勾选与项目共享:
- 已勾选:视图存储在项目中,供每个打开该项目的人使用(👥)。
- 未勾选:视图保留在此浏览器中,可用于您在其中打开的每个项目(👤)。
- 点击保存。
要应用某个视图,请点击其名称。它会恢复查询、筛选标签、列和树。与当前查询匹配的视图会突出显示。
要在以后更改已保存的视图,请先设置好表格,然后在该视图上选择⋯ → 将当前视图保存在此处。⋯ → 与项目共享可共享个人视图,或将共享视图重新变为个人视图。
日历图表可以显示某个共享视图中的事件。其在数据库中编辑查询会打开数据库并应用该视图,查询栏中会出现更新“<name>”按钮:更改查询,然后点击该按钮将更改保存到共享视图。使用该视图的所有日历和幻灯片表格都会随之更新。
生成报告
- 用查询缩小表格范围,或勾选特定的行。
- 点击页面标题栏中的导出…(或批量操作栏中的更多 ▾ → 导出…)。
导出随即打开。
- 在导出为中选择要导出的内容,并设置其选项。
- 检查文件名。
- 点击导出。
文件随即下载。
实例:CubeSat EO-1
使用管理项目 → 项目文件 ▾ → 新建演示项目创建演示项目。它包含:
- EO-1 System Requirements Specification(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和评审中,并点击添加筛选条件。
列表中包括 1.5 Daily Collection Volume、1.6 Revisit Time 和 3.4 Bus Regulation。审批页面使用同一查询(
Requirement:"Status=In Review")。
查找未经验证的需求:
- 在视图窗格中,点击没有验证测试的需求。
出现筛选标签 Class: 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-flow order遵循动作图的顺序。
- 锁定已审批的内容。锁定已纳入基线的需求或接口,使误编辑被拒绝。
- 解决评论而不是删除它们,以便保留评审记录。
常见错误
- "No entities match the search or filters. Clear them to see all entities."(没有实体与搜索或筛选条件匹配。清除它们即可查看所有实体。)之前搜索留下的筛选标签仍然生效。用其×将其移除,或点击查询栏中的清除。
- 列表中缺少某个关系。要么该关系还没有任何关联,要么架构不允许该类使用它。在追溯部分选择显示所有关系。如果该关系应当被允许,请在架构编辑器中添加一个目标。
- 编辑被拒绝,并显示 "Locked entities cannot be modified. Unlock them first."(已锁定的实体无法修改。请先解锁。)该实体已锁定。对于关系,任一端的实体都可能已锁定。用锁定按钮将其解锁。
- 更改类会移除数据。更改类会移除新类不能拥有的关系、标签、属性值和图。对话框会列出保存时将清除的内容:请在点击更改类之前阅读。撤销可恢复所有内容。
- 已删除的实体从表格中消失。打开项目的回收站(导航栏工具),然后点击恢复。它会以相同的 ID 恢复,并保留与仍然存在的实体之间的关系。
与其他功能的关联方式
- 为一切提供数据:图、文档、可追溯性矩阵、RVTM、模型检查、仿真器和所有登记册都读取同一组实体。请参阅可追溯性和需求。
- 预设页面:导航栏中的需求、审批、资产、条目与输入/输出和决策都是带有预设查询的数据库。
- 矩阵:页面标题栏中的在矩阵中打开会在可追溯性矩阵中打开当前查询。批量操作栏中的在矩阵中打开会用勾选的行打开它。
- 文档:添加到文档…将勾选的实体关联到一个文档 Artifact。请参阅文档。
- 导入和导出:CSV、Excel、Word 和 ReqIF 导入会创建显示在此处的实体,报告则将它们导出。请参阅导入和导出。
- 架构:类、属性、关系和标签来自项目的架构。请参阅架构和扩展。
数据库视图
数据库列出项目中的所有实体,并提供筛选、编辑、关联和报告工具。从导航栏底部的数据库打开它。页面左侧是视图窗格,中间是查询栏和表格,右侧是属性面板。
地址中可以带有 ?q=<query>、?class=<id>、?label=<id> 和 ?focus=<entity id>(选中该行并滚动到该行)。内置条目旧编号中的 class 或 label 编号会被改写为当前 ID。
页面标题区
| 控件 | 功能 |
|---|---|
| 导出… | 为勾选的行打开导出;未勾选任何行时,为当前查询打开。 |
| 在矩阵中打开 | 打开可追溯性矩阵,并将当前查询放在其轴上。 |
| + 新建条目 | 打开创建条目。当查询限定了某个类时,以该类命名,例如+ 新建需求。 |
| ✦ AI ▾(位于顶部栏中) | 针对属性面板中所示实体的 AI 操作,以及生成需求…。 |
查询栏
| 控件 | 功能 |
|---|---|
| + 筛选 | 打开筛选列表。请参阅筛选条件。 |
| 筛选标签 | 每个筛选条件一个筛选标签,按查询顺序排列:Class: …、属性筛选(如 Requirement: Status = In Review)、Label: …、结构筛选(如没有父项)、Diagram: …、Relationship: …以及筛选条件或搜索文本。同一种类的筛选标签以或连接。每个筛选标签都有用于移除它的×。点击属性筛选标签可更改或移除它。 |
| 排序标签 | 当没有可见的列标题显示排序时,显示当前排序,例如排序:关系最多 ↓。点击它可反转顺序;×恢复默认排序(按编号)。 |
| 搜索框 | 自由文本或查询语法。随输入进行筛选(短暂停顿后)。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 取消;焦点保留在该单元格上。选项和 Yes/No 会打开列表,日期会打开日期框,多选值以分号分隔。富文本描述、文件、质量检查和计算值在属性面板或条目视图中编辑。
- 名称:在名称上按 F2 可就地重命名实体。
- 关系单元格以链接形式列出相关实体,并带有用于添加关系的+(跟随另一列的关联列没有+)。
- 标题:点击可按该列排序;再次点击可反转。▾打开列菜单。拖动标题的右边缘可调整宽度(最小 40 px):只有该列改变,表格随之变宽或变窄。双击边缘可重置宽度。
- 复选框:标题中的复选框会勾选所有行(全部行,而不仅是视图中可见的行)。按住 Shift 并点击可勾选或取消勾选一个范围。
像电子表格一样编辑
表格可以像电子表格一样一次编辑多个单元格。每次粘贴或填充都可通过一次撤销撤回。
- 在单元格之间移动:焦点在某个单元格上时,← 和 → 沿行移动,↑ 和 ↓ 移到上一行或下一行的同一列。
- 粘贴一个区块:在 Excel、Numbers 或 Google Sheets 中复制单元格,点击区块起始的单元格,然后按 ⌘V / Ctrl+V。行向下排,列向右排,顺序与表格显示的顺序一致,因此请先排好列以使其对应。粘贴的空单元格会清除值。
- 将一个值粘贴到多行:勾选这些行,然后在其中一个勾选行的单元格上粘贴单个值。所有勾选的行都会得到该值。
- 向下填充:勾选这些行,聚焦该列中的一个单元格,然后按 ⌘D / Ctrl+D,或在列标题的菜单中选择向下填充。第一个勾选行的值会填入其他勾选行。未勾选任何行时,⌘D / Ctrl+D 复制上一行的值。
- 复制:在单元格上按 ⌘C / Ctrl+C 可复制其文本;当其所在行属于勾选的行时,会复制勾选行中该列的值,每行一个。
值按属性的存储方式读取:选项必须与该属性的某个选项匹配(不区分大小写),Yes/No 接受 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 selected");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 classes)"。目标条目带有搜索。摘要显示关系数 × 目标数 × 源数。架构不允许的组合会被跳过并计数。 |
| 在矩阵中打开 | 用已勾选的行打开可追溯性矩阵。 |
| 属性… | 打开为 N 个实体设置属性。可选项为描述、添加到名称开头、添加到编号开头、图像,或所有已勾选的类共有的任何属性(质量属性除外)。值会替换每个实体上的该属性。前缀会添加在现有名称或编号之前。 |
| 标签 ▾ | 列出对每个已勾选的类都有效的标签。✔ 标记所有已勾选实体都已有的标签;选择它会从所有实体上移除该标签,否则会将其添加到所有实体。 |
| 更改类… | 更改类。请参阅更改类。 |
| 更多 ▾ | 打开(一行)、创建副本(复制每个已勾选的实体,包括类、编号、描述、属性、标签、图像和关系,命名为 "Copy of …")、锁定 / 解锁(任一已勾选实体已锁定时为解锁)、查找和替换…、汇总…(带子项的一行)、重新编号子项…(一行)、连同子项复制…(一行)、历史记录…(一行)、添加到文档…、导出…。 |
| 删除条目… / 删除 N 个条目… | 确认后删除已勾选的实体(它们会进入项目的回收站)。已锁定的实体会被跳过。 |
| × | 取消勾选所有行(Esc 的作用相同)。 |
当已勾选的行包括库条目时,操作栏开头会显示 "N library items selected" 和采用…,后者会将它们复制到项目中,成为可编辑且记得其来源的条目。
添加到文档…用 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" | 对条目的值进行带单位的算术运算:+、-、*(或 ×)、/(或 ÷)、括号以及比较(<、<=、>、>=、=、!=)。值可以是属性、该条目所 specified by 的特征(其 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。 |
属性测试如何比较值:
- Yes/No 和质量属性:
true、yes或1表示 Yes。 - 数字:按数值比较;分布按其均值比较。数字后带单位时(
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=" |
选项、多选和 Yes/No 属性在列表中提供其值;其他属性接受输入的文本,并带有 e.g. 2 hours 和 yyyy-mm-dd 等提示。添加筛选条件会添加筛选标签;‹ 返回返回列表。没有值时点击添加筛选条件会显示 “输入一个值,或选择“为空”。” 以后点击该筛选标签可更改它:更新或移除。
列
列在原处编辑:通过每个列标题和列 ▾。
列标题
每个列标题都有▾(也可右键点击列标题,或按 Shift+F10 打开):
| 命令 | 功能 |
|---|---|
| 升序排序 / 降序排序 | 按该列排序;当前排序会被勾选。 |
| 左移 / 右移 | 将该列移动一个位置。 |
| 重命名… | 为该列指定一个自己的标题。 |
| 重置标题 | 对重命名过的列显示:恢复为生成的标题(显示在右侧)。 |
| 宽度… | 以像素为单位设置列宽(40 到 2000),是拖动列标题右边框的键盘替代方式;留空则恢复默认宽度。 |
| 隐藏列 | 移除该列,以及跟随它的关联列。最后一列无法隐藏。 |
| 插入列… | 打开插入列,在此列之后添加一列:种类(实体字段、属性或关系)以及它显示的内容。 |
| 关联列… | 打开关联列:通过您选择的关系与此列中的实体(对于字段或属性列,则与每一行)关联的实体。包括关系、显示(实体,或所关联实体的任何字段或属性),以及在该关系有属性时的关系属性(例如 decomposed by 上的多重性),后者会代替实体显示。关联列从该行出发最多跟随 4 个关系。 |
| 编辑列… | 用于属性列和关系列:更改该列显示的内容。 |
跟随一列可串联关系。例如,一个 satisfied by 列再加一个相关的 performed by 列,会列出执行满足每条需求的功能的资产。
列 ▾
列出您可以显示的每一列,带有复选框:字段(实体(编号和名称,作为链接)、编号、名称、类、描述、标签、ID、全局 ID、创建时间、修改时间),每个类一个属性组(查询中的类,或所有正在使用的类),以及关系(这些类允许的关系)。勾选会将该列添加到末尾;取消勾选会将其移除。输入文字可缩小列表范围。
底部有:显示完整描述(否则描述显示两行)和默认列(六个默认列,使用默认宽度)。
列、宽度、排序、树和显示完整描述存储在此浏览器中。视图窗格中的⋯ → 重置列、排序和树可恢复默认设置。
报告
导出…在导出对话框中将已勾选的行或当前查询导出到文件。标题显示涵盖的实体数量,以及它们是已勾选的行还是当前查询。
- 在导出为中选择要导出的内容。各选项命名为 "<content> (<format>)",并按输出分组(Word、Excel、CSV、交换、打印);系统会记住您上次的选择。
- 设置其选项。
- 编辑文件名。默认为项目或实体名称。
- 点击导出。
大型导出(数万个实体)分步写入:进度卡片显示正在进行的操作("Reading items"、"Writing rows"、"Packing the file")及计数,运行期间页面保持响应。
| 导出为 | 输出和选项 |
|---|---|
| 表格 (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 同样按类记住这一点,就像您逐个点击了每个标题一样。该按钮与链接一样是一个键盘停靠点,图形状和连接的面板也有相同的按钮。在追溯中,较小的标题(需求、分解、其他项目)对该组的关系进行分类。
| 组 | 包含的内容 |
|---|---|
| 需求(需求和陈述)或定义(其他类) | 编号、名称、描述,以及条目所表述的内容:Rationale、Source、Success Criteria;其他类上的 Kind、Justification、Trigger 等 |
| 工作流 | 对于需求为评审条;Priority、Criticality、Owner、负责人、截止日期和关注,TBD/TBR 及其负责人和截止日期;其他类上的状态、日期和审批人;然后是标签 |
| 验证 | Verification Method 和 Level、Verified by(所关联的测试用例及其状态),在正式项目群中还有验证关闭字段;Test Case 的状态和测试详情 |
| 值 | Budget Quantity、Threshold、Objective 和当前 Value、Units;其他类上的数量、金额和费率 |
| 进度 | Start、Duration、Percent Complete、Finish |
| 评估 | 严重性、可能性、概率和后果等级(风险、危险源、失效模式) |
| 符合性 | Compliance 和 Compliance Response(正式项目群) |
| 质量 | Quality Score 和质量准则;标题显示 "N% · N of M met" |
| 其他属性 | 所有其他属性、您自己的属性,以及 «Name» 下的构造型标记值 |
| 追溯、讨论、详细信息 | 关系、评论,以及 ID、日期、历史记录和图像 |
没有属性的组会被省略。属性面板足够宽时,短字段每行两个;较窄时每行一个;长文本、复选框组和文件占满整行。Rationale 等长文本字段为空时只有一行,随输入而增高。空字段显示未设置。Owner 字段会在输入时提示名称:项目中已使用的名称,以及共享项目中的成员。将指针悬停在属性标签上可查看其描述。
正式项目群属性(Compliance、Compliance Response、Verification Closed By、Verification Closure Date、Verification Closure Notes)在项目偏好设置中开启正式项目群时显示,或在其中某个属性有值时显示。
需求或定义
- 对于需求:关联评审通知(请参阅需求)。
- 编号和名称(在条目视图中它们是页面的标题行),然后是描述(富文本;点击即可编辑,或按 Tab 移到它,然后按 Enter 或 F2),需求还带有 EARS ▾。
- 说明条目内容的属性,例如 Rationale、Source 和 Success Criteria。
工作流
- 对于需求为评审条:状态(可在此选择其他状态)、设置人和设置时间,以及审批、拒绝…或重新打开(请参阅需求)。状态不会作为单独的字段重复出现。
- Priority、Criticality 和 Owner,然后是负责人和截止日期。在共享项目中,通知 → 关注(一只眼睛和关注字样,开启时为正在关注)可让您收到关于该条目的通知(请参阅通知)。
- 标签以筛选标签样式显示。标签上的×可移除该标签。+ 标签列出对该类有效的每个标签,按架构中的方式嵌套,已应用的标签带有 ✓;选择一个即可添加或移除。没有工作流组的条目会在其第一组末尾显示其标签。
追溯
关系按用途分组:
| 组 | 关系 |
|---|---|
| 需求 | 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 |
| 其他 | 所有其他关系 |
- 该部分显示有关联的关系、您保持可见的关系,以及模型检查标记的关系。显示所有关系还会列出该类允许的空关系;标签会说明有多少个被隐藏。
- 模型检查发现的缺口显示在相应关系之下,例如叶需求上的 "No verifying test case"(没有验证测试用例)(规则与验证 → 模型检查相同,请参阅可追溯性)。
- 每个关系显示其名称和关联数量;将指针悬停在上面可查看它关联到哪些类。点击名称可折叠或展开它。
- 关系上的+:关联现有…(搜索、勾选多个、关联所选)或新建 <class>…(创建一个允许的类的条目并关联它)。
- 组上的⋯:为空时仍显示,每个关系一个勾选项。该选择适用于该类的每个条目,并保存在此浏览器中。默认情况下,decomposed by、decomposes、satisfied by、satisfies、sourced by、source of、traced from、traced to、verified by 和 verifies 保持可见;Statement 和 Requirement 不包括 satisfies、source of 和 verifies。
- 每个关联的条目都有一个链接,适用时有 ⚠ 评审标记,有用于关系属性的属性,以及用于移除该关系的×。
- 当条目已锁定,或当前视图自己管理该关系时,🔒 会替代+("Read-only here: this view manages this relationship.",即此处只读:此视图管理该关系)。
讨论
该条目的评论。请参阅评论。
详细信息
- ID,带有复制链接。该 ID 也是条目在导出中的全局 ID,导入时的Match existing entities by: Global ID会据此找到该条目。
- 类及其父类,例如 "Statement / Requirement",然后是创建时间、修改时间,已锁定时还有已锁定。
- 历史记录:已记录的更改次数;点击可查看完整历史记录。
- 图像:添加图像。有图像时:一个缩略图(点击可按原尺寸显示)、下载、替换和移除。
条目视图
条目视图在一个页面上显示一个条目,其分组与属性面板相同。可通过以下任一方式打开它:
- 双击数据库中的一行。
- 在任何地方点击条目的名称。
- 从打开方式 ▾中选择条目视图。
地址为 entity/<id>。
页面标题区
- 历史记录…打开完整历史记录。
- 提议更改…适用于受配置控制的条目。
- 锁定按钮(🔒 锁定,🔓 解锁)。
- 打开方式 ▾:该条目可以在其中打开的每个视图(请参阅属性面板)。
- 创建副本。
- 子条目 ▾:重新编号子项…(条目有子项时)、汇总…(条目有子项时)、连同子条目克隆…和查找和替换…(该条目及其所有后代)。
- 更多 ▾:导出…、更改类…(更改类)和删除条目…。
- ✦ AI 控件的 ▾ 列出适用于该条目的 AI 工具。
页面
- 标题行:以彩色标签显示的类,然后是编号和名称。点击编号或名称即可编辑。该标签是一个类菜单:选择另一个类会运行更改类,如果有内容将被移除,会先打开更改类对话框。已锁定的条目会在各组上方显示锁定通知。
- 属性面板中的各组,从需求或定义到追溯、讨论和详细信息。在宽页面上,第一组(陈述及其支持文本)和工作流(状态、人员、日期和标签)并排显示;其他组在它们下方横跨整个页面。在窄页面上,所有组排成一列。
- 详细信息 → 历史记录打开完整历史记录。
已删除条目的地址会显示 "This item was deleted"(此条目已被删除)以及恢复条目。未知的 ID 会显示 "Item not found"(未找到条目)。两者都提供返回数据库。
属性类型和编辑器
| 类型 | 编辑器和行为 |
|---|---|
| TEXT | 单行文本。 |
| BIG_TEXT | 多行文本,随输入而增高(最高 400 px)。 |
| NUMBER | 一个数字,或以 = 开头的分布(请参阅分布)。 |
| PERCENT | 0 到 100。超出范围的值会被截取到范围内,并显示一条消息。 |
| ENUMERATION | 以Select an option...开头的选项列表。如果该属性设有工作流,则只提供当前值和允许的下一个值,并标记为⇢ 工作流。 |
| MULTISELECT | 复选框;值按排序后保存。为空时显示 "No choices. Add them to the attribute in the Schema Editor."(没有选项。请在架构编辑器中将选项添加到该属性。) |
| BOOLEAN | 一个标记为是或否的复选框。 |
| DATETIME | 日期和时间选择器。 |
| DURATION | 一个数字或分布加上一个单位:秒、分钟、小时、天、周、月、年。=script() 让仿真器从动作的 duration() 钩子获取持续时间。 |
| GEOPOINT | 纬度(−90 到 90)和经度(−180 到 180),带有在地图上显示 ↗(OpenStreetMap)。为空时显示 "No location"(无位置)。 |
| URI | 一个带有打开链接 ↗的链接。没有协议的文本会自动加上 https://(IP 地址和 MAC 地址按输入保留)。只有 http、https 和 mailto 链接可以打开。 |
| FILE | 上传…或替换…、预览(图像、PDF 和文本文件)、作为下载链接的文件名,以及移除文件。 |
| HTML | 富文本,与描述相同。 |
| EQUATION | LaTeX 文本,例如 E = mc^2。 |
| COMPUTABLE | 一个计算值。请参阅可计算属性。 |
| MULTIPLICITY | n、n..m、n..* 或 *。 |
| QUALITY | 未检查、是或否,由质量检查设置。手动选择一个值即为手动覆盖,标记为手动,检查器重新运行时会保留;自动(重新检查)移除该覆盖。 |
| QUALITY_SCORE | 来自质量检查的只读百分比。未检查时显示 "No score yet. Check its quality."(尚无评分。请检查其质量。);文本更改后显示 "Quality: stale — re-run"(质量:已过时,请重新运行)。 |
| USER_TEAM | 指明某个人员或团队的文本。 |
值在字段失去焦点或选项改变时保存。每次保存都可通过一次撤销撤回。
分布
数字和持续时间属性接受分布,例如 Action 的 Duration 或 Cost 的 Amount。仿真器在每次运行时对其抽样。时间线、汇总和搜索使用其均值。
输入 = 即可查看列表。字段下方的提示会说明各参数。
| 分布 | 公式 | 参数 |
|---|---|---|
| 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。
当某个变量的属性更改时(包括可计算属性链)以及项目打开时,值会重新计算。重新计算可强制计算。
来自子项的值。
变量可以读取条目自己的子项,而不是单个实体,这样当分解结构变化时,总计也能保持最新。
- 在对话框中,点击+ 子项的值。
- 选择函数:求和、平均值、最小值、最大值或计数。
- 选择属性。列表包含该条目的类及其下级类的数字、百分比、持续时间和计算属性。计数还提供条目,用于统计条目本身。
- 选择取自子条目(直接子项)或取自最低层级条目(分解结构的叶节点)。
- 保持勾选× 部件数量,以按每个条目的分解多重性或Quantity加权,与汇总的做法相同。取消勾选则每个条目只计一次。
- 在方程中使用变量的名称,例如
total * 1.1表示 10 % 的裕量。
如何读取子项的值:
- 子项的属性是所选的属性,或子项的类上同名的属性。
- 没有值的条目会被跳过。对空集求和或计数结果为 0;对空集求平均值、最小值或最大值没有结果。
- 当子项的值更改、添加、移动或移除子项,以及多重性更改时,值会作为同一更改的一部分重新计算(一次撤销即可将两者一并撤回)。
- 可以读取子项自己的计算值,因此每一层都可以对其子树求总计:例如 Total Mass =
own + kids,其中own是该条目的 Mass,kids是子项 Total Mass 之和。
该属性显示⟳ 来自子条目;将指针指向方程可查看每个子项变量读取的内容。
实体工具
更改类
更改类可更改一个或多个实体的类。在数据库中用更改类…打开它,或在条目视图中用更多 ▾ → 更改类…打开。
- 选择新类。
- 要同时更改分解结构中的后代,请勾选同时更改子条目(分解)。
- 阅读摘要。
它会显示 "N items will become Class."(N 个条目将变为该类。)然后列出保存时将清除的内容:新类不允许的关系、标签、属性值和图。如果没有任何损失,它会显示 "No other entities are affected."(没有其他实体受到影响。)
- 点击更改类。提示消息显示 "Changed the class of N items."(已更改 N 个条目的类。)
在条目视图中更改类字段会运行同样的检查,并且只有在有内容将被移除时才会打开此对话框。
汇总
汇总对话框(以实体为标题;在数据库中为汇总…,在条目视图中为子条目 ▾ → 汇总…)基于分解结构的叶节点计算一个值。
- 属性:该类的任何数字、持续时间、列表或多选属性。
- 持续时间单位(仅限持续时间):自动(使用中的最大单位),或从毫秒到年的固定单位。
- 舍入到(小数位)(默认 3)。
- 仅此视图中显示的条目(从筛选实体的视图打开时可用)。
值的计算方式:
- 数字在叶节点上求和。每个值都乘以其分解多重性或Quantity。分布按其典型值计。
- 带单位的文本值(例如 "2.5 kg")会被换算并求和。
- 持续时间会被求和。
- 枚举和多选取出现最频繁的值。出现并列时,由您选择值。
结果显示 "N of M lowest-level items have a value."(M 个最低层级条目中有 N 个有值。)保存该值将值一次性写入实体。
保持实时则会使总计保持最新。当该类有 Computed 属性时它才会出现:在保持实时于下选择该属性。保持实时会向该属性写入一个方程,按部件数量对最低层级条目的所选属性求和(请参阅可计算属性)。它适用于数字、百分比和持续时间属性;持续时间以小时求和。没有 Computed 属性时,对话框会提示在架构编辑器中添加一个。
查找和替换
在 N 个条目中查找和替换搜索名称、编号和描述。
- 在查找和替换为中输入。仅大小写相同使搜索区分大小写。跳过已锁定的条目(开启)会排除已锁定的实体。
- 停止输入后搜索开始。它按输入的文本原样匹配(不支持通配符)。对于大量选择,进度卡片会显示搜索的计数;再次输入会开始新的搜索。
- 匹配项显示匹配的数量,并列出每个匹配项的条目、字段、匹配编号及其上下文文本。取消勾选匹配项可跳过它们;全选或全不选可切换全部。
- 超过 1,000 个匹配项时,列表显示前 1,000 个("2,431 matches; the first 1,000 are listed.")。同时替换未列出的 N 个匹配项(开启)会将其他匹配项也纳入替换;关闭它则只替换列表中已勾选的匹配项。
- 替换所选会更改已勾选的匹配项,一次撤销即可全部撤回。在富文本描述中只更改文本,绝不更改格式。大型替换会显示进度(“正在替换文本”,然后是 “正在保存替换后的文本”);其他编辑会等待它完成。
重新编号子项
重新编号子项…(以条目为标题)为条目下的分解结构编号。可从条目视图中的子条目 ▾、数据库批量操作栏中的更多 ▾(一行)或图的根打开它。
- 前缀:子项变为
Prefix.1、Prefix.2等。以符号结尾的前缀(例如SR-)不加点:SR-1、SR-1.1。留空则从1开始编号。条目自身的编号不会改变。 - 顺序(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)也能撤销删除。
只读访问
在托管服务上,具有查看者角色的项目成员可以打开每个页面、搜索和运行报告,但无法更改任何内容。编辑器会被禁用,任何更改尝试都会显示 “View only: ask an owner for edit access.”(仅查看:请向所有者申请编辑权限。)
键盘快捷键和手势
| 按键或手势 | 位置 | Action |
|---|---|---|
| Enter | 搜索框 | 应用查询;开头的筛选词变为筛选标签 |
| Backspace / Esc | 空搜索框 / 有文本的搜索框 | 移除最后一个筛选标签 / 清除搜索文本 |
| ↑ / ↓, Enter | + 筛选和列 ▾列表 | 在选项之间移动 / 开启或关闭某一项(列表保持打开) |
| ↑ / ↓, Home / End | 焦点所在的行 | 移到上一行 / 下一行 / 第一行 / 最后一行 |
| Esc | 数据库 | 取消选择所选行(未在输入且没有打开对话框时) |
| 点击 | 表格行 | 选择并在属性面板中显示 |
| 双击 | 表格行 | 打开条目视图 |
| 双击 | 编号或描述单元格 | 就地编辑 |
| Enter / Shift+Enter / Esc | 正在编辑的单元格 | 保存 / 换行(描述)/ 取消 |
| Shift+点击 | 行复选框 | 勾选或取消勾选一个范围 |
| 右键点击、Shift+F10、菜单键、长按 | 表格行 | 打开该行的右键菜单 |
| ⌥ / Alt+右键点击 | 表格行 | 显示浏览器自己的菜单 |
| 点击 / 再次点击 | 列标题 | 排序 / 反转 |
| ▾、右键点击 | 列标题 | 列菜单 |
| 拖动 / 双击 | 列标题边缘 | 调整宽度 / 重置宽度 |
| 拖动 | 已保存的视图 | 在共享方式相同的视图之间重新排序 |
| ⌘ / Ctrl+Z / ⌘ / Ctrl+Shift+Z | 任何位置 | 撤销 / 重做(Windows 和 Linux 上为 Ctrl) |
所有快捷键:键盘快捷键。
选项和设置
存储在此浏览器中:
- 数据库视图设置:排序及方向、列、列宽、树、显示完整描述和滚动位置。视图窗格中的⋯ → 重置列、排序和树可清除这些设置。早期版本的设置会沿用:行高大于 1× 会开启显示完整描述;页面大小、文本对齐和“记住滚动位置”已不再使用。
- 您自己保存的视图(未共享)。
- 按类保持可见的关系、显示所有关系、折叠的关系、显示已解决以及质量组的展开状态。
存储在项目中:共享视图、实体、关系、评论、历史记录和项目的回收站。
消息
| 留言 | 含义和解决方法 |
|---|---|
| "No entities match the search or filters. Clear them to see all entities."(没有实体与搜索或筛选条件匹配。清除它们即可查看所有实体。) | 没有实体通过搜索和筛选条件。用筛选标签的×将其移除,或点击清除。 |
| “请先添加一个类:此处会列出其属性。” | + 筛选只列出查询中各类的属性。请添加一个类筛选标签。 |
| “输入一个值,或选择“为空”。” | 属性筛选需要一个值。 |
| “关联列最多跟随 4 层关系。” | 不会提供比这更深的关联列…。 |
| "Add an entity with + New Item, or import a CSV file."(用 + 新建条目添加实体,或导入 CSV 文件。) | 项目中还没有实体。 |
| "Removed N column(s) whose attribute or relation no longer exists."(已移除 N 个其属性或关系已不存在的列。) | 某列引用了已删除的属性或关系;该列已被删除。 |
| “表格至少需要一列。请保留一列。” | 列列表不能为空。 |
| “所选类没有共同的标签” | 已勾选实体的类没有共同的标签。 |
| “请选择一个关系和至少一个目标。” | 关系…在点击应用之前需要两者都已选择。 |
| "Created N relationship(s), skipped M not allowed by the schema"(已创建 N 个关系,跳过 M 个架构不允许的关系) | 对于该关系,有些源与目标的组合不被允许。 |
| “Class 不能具有“relation”” | 该行的类不允许该关系列的关系。 |
| “请为条目指定名称或编号。” | 名称和编号不能同时为空。 |
| "Locked entities cannot be modified. Unlock them first."(已锁定的实体无法修改。请先解锁。) | 解锁该实体(或关系另一端的实体)。 |
| “无法删除已锁定的条目。请先将其解锁。” | 删除操作中的已锁定实体被跳过。 |
| “已锁定的条目无法更改类。请先将其解锁。” | 在更改类之前先解锁。 |
| “只有当文档最多只有一个子条目时才能更改类。” | 当目标是文档类时,在更改类中显示。 |
| "View only: ask an owner for edit access."(仅查看:请向所有者申请编辑权限。) | 您在此项目中的角色是查看者。 |
| "Image exceeds the N MB limit."(图像超过 N MB 的限制。)/ “超过 N MB 的文件不会存储;仅保留文件名。” | 文件大于单个文件的大小限制。 |
| "Enter a number."(请输入数字。)/ “百分比不能小于 0。” / “百分比不能大于 100。” | 百分比字段的输入。 |
| "Not a number. Enter a number." / "Not a valid distribution." / "Expected the form =norm.dist(mu, sigma)" / "Parameters must be numbers. Enter a number for each parameter."(不是数字,请输入数字 / 不是有效的分布 / 应采用 =norm.dist(mu, sigma) 的形式 / 参数必须是数字,请为每个参数输入数字。) | 数字或分布的输入;还有参数检查,例如 "Sigma must be greater than 0."(Sigma 必须大于 0。)或 "B must be greater than A."(B 必须大于 A。) |
| “使用 n、n..m 或 n..*” | 多重性的输入。 |
| "Invalid variable name "x": it needs a letter, can't start with a digit, and can't be "i" or "e"." / "Variable "x" has no entity (it may have been deleted)." / "Unknown name "x"" / "The equation has no finite result. Check for division by zero."(变量名无效:需要包含字母、不能以数字开头,且不能是 i 或 e / 变量没有实体(可能已被删除)/ 未知名称 / 方程没有有限结果,请检查是否除以零。) | 可计算属性的错误。 |
| "Nothing to roll up: no entity in this hierarchy has a value for the chosen attribute."(没有可汇总的内容:此层级结构中没有实体具有所选属性的值。) | 汇总在叶节点上没有找到任何值。 |
| “Class 没有可汇总的数字、持续时间或列表属性。” | 此类无法进行汇总。 |
| “没有匹配项。” / “未选择任何内容。” | 查找和替换没有找到任何内容,或者没有勾选任何匹配项。 |
| “此条目没有已记录的更改。” | 历史记录为空。 |
| “此文件类型没有预览。请下载文件后打开。” | 请改为下载该文件。 |
限制
- 名称和编号:各 255 个字符。
- 表格最多绘制 200 行全部内容;超过时只绘制滚动位置附近的行(其余行在滚动时绘制)。
- 实体选择器和批量目标列表显示前 300 个匹配项;输入文字可缩小范围。
- 项目的回收站将每个条目保留 30 天,条目数量没有限制。
- 一个项目最多保留 4,000 条历史记录;超出后最旧的 1,000 条会移出项目。它们仍可在条目的历史记录…中的较早的更改下阅读,也可通过活动上的加载较早的更改阅读(在 app.holarch.app 上:Individual 和 Team 方案)。创建超过 500 个条目的操作(导入)会作为一条摘要记录移出,而不是逐条移出。
- 撤销保留会话中的最近 200 步。在桌面应用中,非常大的步骤(导入或对大型模型的批量更改)保留的步数较少:撤销历史最多保存约 4800 万个字符的已更改数据,并始终保留最新的一步。
- 关联列从该行出发最多跟随 4 个关系(之前保存的、最多跟随 8 个关系的列仍会显示)。
- 图像和文件:适用托管服务的单个文件大小限制(Free 方案 10 MB,Individual 25 MB,Team 100 MB)。宽度或高度超过 4,000 px 的 PNG、JPEG 和 WebP 图像在存储时会被缩小。