Holarch

模型

模型和数据库

LML 实体、类、属性、关系和标签,以及用于查找、编辑、关联、报告和恢复它们的数据库视图。

使用方法 →

本页内容
  1. 概述
  2. 概念
    1. 实体
    2. 课程
    3. 属性
    4. 关系
    5. 标签
    6. 锁定、历史记录和评论
  3. 如何使用
    1. 何时使用及原因
    2. 用查询查找实体
    3. 创建和编辑实体
    4. 关联实体
    5. 一次编辑多个实体
    6. 保存并重用视图
    7. 生成报告
    8. 实例:CubeSat EO-1
    9. 提示和良好做法
    10. 常见错误
    11. 与其他功能的关联方式
  4. 数据库视图
    1. 页面标题区
    2. 查询栏
    3. 视图窗格
    4. 已保存的视图
    5. 表格
    6. 像电子表格一样编辑
    7. 树
    8. 右键菜单
    9. 批量操作栏
  5. 查询语法
    1. 输入的筛选条件如何变成筛选标签
  6. 筛选条件
  7. 列
    1. 列标题
    2. 列 ▾
  8. 报告
  9. 属性面板
    1. 需求或定义
    2. 工作流
    3. 追溯
    4. 讨论
    5. 详细信息
  10. 条目视图
    1. 页面标题区
    2. 页面
  11. 属性类型和编辑器
    1. 分布
    2. 可计算属性
  12. 实体工具
    1. 更改类
    2. 汇总
    3. 查找和替换
    4. 重新编号子项
    5. 编号方案
    6. 连同子项复制
    7. 创建副本
  13. 历史记录和还原
  14. 项目的回收站
    1. 哪些内容会进入回收站
    2. 已删除实体的子项
    3. 回收站页面
    4. 恢复已删除的实体
  15. 评论
  16. 锁定
  17. 删除和恢复
  18. 只读访问
  19. 键盘快捷键和手势
  20. 选项和设置
  21. 消息
  22. 限制
  23. 相关内容

概述

LML 项目将所有内容存储在一个模型中,该模型基于生命周期建模语言(LML 2.0),并支持 LML 1.x 模型。需求、功能、资产、接口、测试、风险和决策都是实体。图、文档、矩阵、登记册和图表都是同一组实体的视图。在一个视图中所做的更改会显示在所有视图中。

Holarch 的界面将每个实体称为条目(例如+ 新建条目、删除条目…和条目视图);实体是 LML 对同一事物的称呼,⌘K / Ctrl+K 用这两个词都能找到命令。

数据库是模型的直接视图:一张包含项目中所有实体的表格。用它来查找、编辑、关联、报告和恢复实体。它提供查询语言、筛选条件、已保存的查询、可配置的列、内联编辑、批量工具和报告。已删除的实体会进入项目的回收站。

另有两个视图一次显示一个实体:

  • 条目视图显示一个实体的全部信息。
  • 属性面板位于界面右侧,可在任何页面显示所选实体。

本页介绍模型概念、数据库、条目视图、属性面板、属性编辑器、历史记录、评论和锁定。要更改类、属性、关系和标签本身,请参阅架构和扩展。

概念

实体

实体是某个类的一个实例。每个实体都有:

  • 名称(最多 255 个字符)和编号(最多 255 个字符,例如 1.2.3)。实体至少需要其中之一。
  • 类,决定其属性、可以拥有的关系以及可以带有的标签。
  • 描述,一个富文本字段(标题、列表、表格、图像、链接)。
  • 标签,用于对实体分类而不更改其类的标记。
  • 属性,特定于类的字段(例如 Requirement 的状态或 Action 的Duration)。
  • 可选的图像,显示在属性面板中,并用于某些图。
  • 元数据:
    • ID,例如 e42,在项目中唯一。
    • 创建时间和修改时间。
    • 已锁定标志。

课程

类构成一棵树。子类继承其父类的属性和关系目标。对某个类的查询也会找到其子类。主要的 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 Valuespecifies
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)列出了所有标签。

锁定、历史记录和评论

  • 已锁定的实体会拒绝编辑、删除、更改类以及新增或移除关系,直到有人将其解锁。仍允许评论。
  • 每次更改都会记录在实体的历史记录中,包括日期,在托管服务上还包括做出更改的人。您可以恢复任何较早的版本。
  • 评论为实体附加评审意见。您可以编辑、解决、重新打开和删除评论。

如何使用

何时使用及原因

模型是整个系统工程生命周期的唯一事实来源。使用数据库直接处理模型,而无需通过图或文档:

  • 在需求定义期间:列出需求,检查其状态,并找出没有父项、来源或验证的需求。
  • 在功能分析和架构设计期间:找出没有执行者的功能、没有接口的资产,以及仍需分解的叶实体。
  • 评审之前:找出未解决的评论、未经验证的需求和孤立项(没有任何关系的实体)。导出表格或定义报告。
  • 批量更改:一次为多个实体重新设置标签、重新编号、设置属性或创建关系。

它可以回答诸如 “哪些需求仍处于评审中?”、“哪些功能尚未分配给资产?” 和 “这条需求上个月是怎么写的?” 之类的问题。

用查询查找实体

用查询栏中的筛选标签缩小表格范围,然后用搜索文本进一步细化。

  1. 点击导航栏底部的数据库。
  2. 点击查询栏开头的+ 筛选。

    此时会打开一个列表,其中包含结构、类、标签、关系、图和合并分组,并显示计数。输入文字可缩小列表范围,例如 requ。

  3. 在类下选择 Requirement(点击它,或用 ↓ 移到它并按 Enter)。

    出现筛选标签 Class: Requirement,表格只显示需求。列表保持打开,并出现需求属性分组。

  4. 在需求属性下选择状态。
  5. 选择= is,然后选择评审中,并点击添加筛选条件。

    出现筛选标签Requirement: Status = In Review,表格范围随之缩小。

  6. 在筛选标签后面的搜索框中输入关键字,例如 power。

    表格随输入进行筛选。搜索范围包括名称、编号和描述。

    搜索适用于任何语言,并忽略大小写和字符宽度:muller 能找到 "Müller",strasse 能找到 "Straße",abs 能找到全角的 "ABS"。重音符号只有在您输入时才会计入:element 能找到 "Élément" 和 "Element",élément 只能找到 "Élément"。日文浊音符号(ガ、カ)和韩文音节会被保留区分。按名称排序遵循浏览器语言,因此 "Ölpumpe" 排在 O 中,而不是排在 Z 之后。

  7. 要更改排序,请点击列标题。再次点击可反转顺序。

您也可以输入完整的查询并按 Enter,例如 class:Requirement Requirement:"Status=In Review" power。开头的筛选词会变成筛选标签,其余内容保留在搜索框中。请参阅查询语法。要从现成的问题开始,请点击视图窗格中的某个视图,例如没有验证测试的需求。

创建和编辑实体

  1. 点击页面标题栏中的+ 新建条目。

    创建条目对话框打开,其中包含类、名称、编号和描述,光标位于名称中。名称为空时点击创建,字段下方会显示 “请输入名称。”;在名称中按 Enter 即可创建实体。

    当查询恰好只有一个类筛选标签时(如需求、资产、决策和条目与输入/输出页面),按钮会以该类命名(+ 新建需求、+ 新建资产),其对话框以该类为标题,且没有类字段。在 SysML v2 项目中,名称使用 SysML v2 术语(架构 → 部件上的+ 新建部件),编号称为短名称,新部件没有短名称字段。部件或动作的对话框有所属:容纳它的部件定义,预设为所关注的系统。创建后的提示会说明它被放在了哪里,例如 "Created Roof Rack in Vehicles::Vehicle"。条目与输入/输出上的+ 新建条目处于禁用状态:请在编辑器中或在视图上添加项。

    这些单类页面也有各自的列,与数据库的列分开。它们开始时没有类列:需求显示编号、名称、状态、验证方法、质量评分、描述和标签;决策显示编号、名称、状态、描述和标签;资产和条目与输入/输出显示编号、名称、描述、标签和修改时间。部件显示名称、类型、所有者、多重性、描述和标签,在含有个体的模型中还显示实例。列 ▾ → 默认列可恢复这组列。

  2. 填写字段并点击创建。

    新实体被选中,并在属性面板中打开。

  3. 在属性面板的第一组(需求或定义)中编辑编号、名称、描述和标签,在其下方的各组中编辑该类的字段。
  4. 要改为在表格中编辑,请双击编号、描述或属性单元格,或在名称上按 F2。按 Enter 保存,或按 Esc 取消。要一次更改多个单元格,请从电子表格粘贴或向下填充(请参阅像电子表格一样编辑)。
  5. 要查看实体的全部信息,请在可编辑单元格之外双击其行。

    条目视图随即打开。

新需求的状态初始为草稿。在架构中有默认值的属性以该默认值开始。

关联实体

添加关系有四种方式。请选择适合任务的方式。

一条关系,从属性面板或条目视图添加:

  1. 选择实体并转到追溯部分。
  2. 找到该关系。如果未列出,请选择显示所有关系,查看该类支持的所有关系。
  3. 点击该关系上的+,然后选择关联现有…或新建 <class>…。

从表格添加:添加一个关系列(请参阅列),然后点击单元格中的+。

一次添加多条:

  1. 勾选这些行。
  2. 点击批量操作栏中的关系…。
  3. 勾选一个或多个关系以及一个或多个目标。
  4. 点击应用。

一次编辑多个实体

  1. 勾选要更改的行。要勾选一个范围,请按住 Shift 并点击第二个复选框。

    批量操作栏出现,并显示已选择 N 项。

  2. 在批量操作栏中选择一项操作。请参阅下面的列表。
  3. 要撤销整个操作,请按 ⌘Z / Ctrl+Z(或 Ctrl+Z)。每个批量操作都可通过一次撤销撤回。

批量操作栏中的操作,按工作流顺序排列:

  • ✦ AI ▾为勾选的行提供 AI 操作。
  • 关系…添加或移除关系;在矩阵中打开在可追溯性矩阵中显示勾选的行。
  • 属性…设置一个属性,或添加名称或编号前缀。
  • 标签 ▾在所有勾选的实体上切换某个标签。
  • 更改类…更改类。
  • 更多 ▾提供打开、创建副本、锁定 / 解锁、查找和替换…、汇总…、重新编号子项…、连同子项复制…、历史记录…、添加到文档…和导出…。

有关每个控件,请参阅批量操作栏。

保存并重用视图

  1. 设置筛选条件、搜索文本、排序、列和树。
  2. 在视图窗格中,点击保存视图…。
  3. 输入名称。
  4. 要共享它,请勾选与项目共享:
    • 已勾选:视图存储在项目中,供每个打开该项目的人使用(👥)。
    • 未勾选:视图保留在此浏览器中,可用于您在其中打开的每个项目(👤)。
  5. 点击保存。

要应用某个视图,请点击其名称。它会恢复查询、筛选标签、列和树。与当前查询匹配的视图会突出显示。

要在以后更改已保存的视图,请先设置好表格,然后在该视图上选择⋯ → 将当前视图保存在此处。⋯ → 与项目共享可共享个人视图,或将共享视图重新变为个人视图。

日历图表可以显示某个共享视图中的事件。其在数据库中编辑查询会打开数据库并应用该视图,查询栏中会出现更新“<name>”按钮:更改查询,然后点击该按钮将更改保存到共享视图。使用该视图的所有日历和幻灯片表格都会随之更新。

生成报告

  1. 用查询缩小表格范围,或勾选特定的行。
  2. 点击页面标题栏中的导出…(或批量操作栏中的更多 ▾ → 导出…)。

    导出随即打开。

  3. 在导出为中选择要导出的内容,并设置其选项。
  4. 检查文件名。
  5. 点击导出。

    文件随即下载。

实例: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。

查找等待审批的需求:

  1. 点击数据库。
  2. 点击+ 筛选,在类下选择 Requirement,然后在需求属性下选择状态。
  3. 选择= is和评审中,并点击添加筛选条件。

    列表中包括 1.5 Daily Collection Volume、1.6 Revisit Time 和 3.4 Bus Regulation。审批页面使用同一查询(Requirement:"Status=In Review")。

查找未经验证的需求:

  1. 在视图窗格中,点击没有验证测试的需求。

    出现筛选标签 Class: Requirement,NOT relationship:"verified by" 保留在搜索框中。表格列出尚无任何 Test Case 验证的需求。输入 class:Requirement AND NOT relationship:"verified by" 并按 Enter 可得到相同的结果。

显示由谁满足每条需求:

  1. 点击列 ▾。
  2. 在关系下勾选 satisfied by,然后按 Esc。

    3.4 Bus Regulation 所在的行显示 1.3.3 Power Distribution Unit。点击空单元格中的+可添加一个满足它的实体。

  3. 要同时显示由谁执行这些实体,请打开 satisfied by Entity 列的▾,选择关联列…,选择 performed by,然后点击插入。

检查一条需求:

  1. 点击 2.1 Pointing Accuracy 所在的行。

    属性面板显示该需求。其讨论部分有关于 TC-04 的评审意见。

  2. 查看追溯部分。

    verified by 列出其测试用例,satisfied by 列出 1.2 ADCS。

保存工作并生成报告:

  1. 在应用了没有验证测试的需求的情况下,点击视图窗格中的保存视图…。
  2. 将其命名为 Unverified requirements,勾选与项目共享,然后点击保存。

    现在项目中的每个人都拥有该视图。

  3. 点击导出…并选择表格 (Excel)。
  4. 保持勾选冻结标题行,然后点击导出。

    电子表格使用您添加的列。

提示和良好做法

  • 先宽后窄。先添加一个类筛选标签。之后+ 筛选只会列出对该类有效的标签及其属性。
  • 使用树以树的形式阅读分解结构。父项在列表中的实体会显示在父项之下。
  • 评审之前,从内置视图开始,例如待审查的关联或模型检查发现项,然后用筛选标签缩小范围。
  • 保存每周都要使用的视图并与项目共享,让团队基于同样的列表工作。
  • 在分解结构的根上使用重新编号子项…进行编号,而不是手动输入编号。对于 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、创建时间、修改时间),每个类一个属性组(查询中的类,或所有正在使用的类),以及关系(这些类允许的关系)。勾选会将该列添加到末尾;取消勾选会将其移除。输入文字可缩小列表范围。

底部有:显示完整描述(否则描述显示两行)和默认列(六个默认列,使用默认宽度)。

列、宽度、排序、树和显示完整描述存储在此浏览器中。视图窗格中的⋯ → 重置列、排序和树可恢复默认设置。

报告

导出…在导出对话框中将已勾选的行或当前查询导出到文件。标题显示涵盖的实体数量,以及它们是已勾选的行还是当前查询。

  1. 在导出为中选择要导出的内容。各选项命名为 "<content> (<format>)",并按输出分组(Word、Excel、CSV、交换、打印);系统会记住您上次的选择。
  2. 设置其选项。
  3. 编辑文件名。默认为项目或实体名称。
  4. 点击导出。

大型导出(数万个实体)分步写入:进度卡片显示正在进行的操作("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一个数字,或以 = 开头的分布(请参阅分布)。
PERCENT0 到 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富文本,与描述相同。
EQUATIONLaTeX 文本,例如 E = mc^2。
COMPUTABLE一个计算值。请参阅可计算属性。
MULTIPLICITYn、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 属性包含一个基于其他实体属性的方程。用它来表示派生值,例如由质量得出的重量。

  1. 点击定义…(或编辑…)。对话框随即打开。
  2. 在变量下,点击+ 添加变量。
  3. 输入变量名称。
  4. 点击选择条目…并选取实体。
  5. 选择其属性。可选的有数字、百分比、持续时间和可计算属性。
  6. 输入方程,例如 mass * 9.81。
  7. 设置小数位数(0 到 10,默认 2)和结果单位。
  8. 点击计算进行测试。

    您会看到结果。

  9. 点击保存。

在方程中,持续时间以小时计,分布以其均值计。方程支持:

  • 运算符 + - * / ^ % 和括号。
  • 函数 sqrt、abs、sin、cos、tan、asin、acos、atan、log(以 10 为底)、ln、exp、floor、ceil、round、min、max 和 pow。
  • 常量 pi 和 e。

当某个变量的属性更改时(包括可计算属性链)以及项目打开时,值会重新计算。重新计算可强制计算。

来自子项的值。

变量可以读取条目自己的子项,而不是单个实体,这样当分解结构变化时,总计也能保持最新。

  1. 在对话框中,点击+ 子项的值。
  2. 选择函数:求和、平均值、最小值、最大值或计数。
  3. 选择属性。列表包含该条目的类及其下级类的数字、百分比、持续时间和计算属性。计数还提供条目,用于统计条目本身。
  4. 选择取自子条目(直接子项)或取自最低层级条目(分解结构的叶节点)。
  5. 保持勾选× 部件数量,以按每个条目的分解多重性或Quantity加权,与汇总的做法相同。取消勾选则每个条目只计一次。
  6. 在方程中使用变量的名称,例如 total * 1.1 表示 10 % 的裕量。

如何读取子项的值:

  • 子项的属性是所选的属性,或子项的类上同名的属性。
  • 没有值的条目会被跳过。对空集求和或计数结果为 0;对空集求平均值、最小值或最大值没有结果。
  • 当子项的值更改、添加、移动或移除子项,以及多重性更改时,值会作为同一更改的一部分重新计算(一次撤销即可将两者一并撤回)。
  • 可以读取子项自己的计算值,因此每一层都可以对其子树求总计:例如 Total Mass = own + kids,其中 own 是该条目的 Mass,kids 是子项 Total Mass 之和。

该属性显示⟳ 来自子条目;将指针指向方程可查看每个子项变量读取的内容。

实体工具

更改类

更改类可更改一个或多个实体的类。在数据库中用更改类…打开它,或在条目视图中用更多 ▾ → 更改类…打开。

  1. 选择新类。
  2. 要同时更改分解结构中的后代,请勾选同时更改子条目(分解)。
  3. 阅读摘要。

    它会显示 "N items will become Class."(N 个条目将变为该类。)然后列出保存时将清除的内容:新类不允许的关系、标签、属性值和图。如果没有任何损失,它会显示 "No other entities are affected."(没有其他实体受到影响。)

  4. 点击更改类。提示消息显示 "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 撤销。”。
  • 查看者和评审者可以看到回收站,但无法恢复或删除。

恢复已删除的实体

  1. 打开导航栏工具中的回收站。
  2. 在筛选字段中输入名称的一部分。
  3. 点击其所在行的恢复。提示 “已恢复“<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 图像在存储时会被缩小。