Holarch

控制与评审

产品线和配置

使用特性和配置在一个项目中对多个产品建模,用 Applies To 和适用性说明哪些条目适用于哪些产品,以单一配置查看和编辑模型,并按配置生成文档、RVTM 和基线。

使用方法 →

本页内容
  1. 概述
  2. 概念
    1. 功能
    2. 配置
    3. 判定
    4. 完整性
    5. 各阶段的完整性
    6. 发布配置
    7. 通过变更请求发布
    8. 已发布的定义
    9. “适用于”和适用性
    10. 共享标识和配置值
    11. 150 % 视图
  3. 如何使用
    1. 何时使用及原因
    2. 开始产品线
    3. 创建配置
    4. 说明哪些条目属于哪些产品
    5. 查看和编辑一个配置
    6. 为配置指定自有值
    7. 为一个配置生成规格说明
    8. 实例:CubeSat EO-1 演示
    9. 提示和良好做法
    10. 常见错误
    11. 与其他功能的关联方式
  4. 产品线页面
    1. 页面标题区
    2. 功能
    3. 配置
    4. 空状态
    5. 键盘
    6. 屏幕阅读器
  5. 适用于
    1. 字段
    2. “选择…”对话框
    3. “适用于”表达式
    4. 表达式消息
  6. 以配置查看
    1. 菜单
    2. 横幅
    3. 每个页面显示的内容
    4. 屏幕阅读器
  7. 在配置视图中编辑
    1. 创建和更改条目
    2. 移除和删除
    3. 添加现有条目
    4. 视图中不可用的功能
    5. 已发布和已退役的配置保留其值
    6. 撤销和历史记录
    7. 与他人协作
  8. 配置值
    1. 哪些字段可以不同
    2. 在配置视图中
    3. 在“所有配置”中
  9. 适用性
    1. 字段
    2. 按序列号或日期查看
    3. 适用性消息
    4. 条目的修订
  10. 文档、RVTM 和验证
    1. 为一个配置导出文档
    2. 文档大纲
    3. RVTM
    4. 测试中心
    5. 图和权衡研究
  11. 基线和变更请求
    1. 按配置创建基线
    2. 变更请求
  12. 模型检查
  13. 搜索、导入和导出
  14. REST API 和 MCP
  15. 方案
  16. SysML v2 项目
  17. 限制
  18. 相关页面

概述

产品线是共享大部分同一设计的一系列产品。对共享设计只建模一次,标出各产品的不同之处,并将每个产品定义为一个配置。这样每个页面都可以按一个配置显示模型,而对共享设计的每次更改都会传递到每个产品。

您在以下位置使用产品线:

  • 控制与评审 → 产品线:特性、特性规则以及由特性构建的配置。
  • 属性面板的产品线组:所选条目的适用于和适用性。
  • 顶栏中的查看方式 ▾:以一个配置显示和编辑模型。
  • 文档、RVTM、测试中心、基线和版本以及变更请求:按配置输出和控制。

产品线属于 Individual 和 Team 方案。按配置创建基线、配置所有者以及变更请求所影响的配置属于 Team 方案。参见方案。

概念

功能

特性是各产品之间不同的选项,例如“X-band Downlink”或“Propulsion”。特性构成一棵树:父特性将相关的选项归为一组。

每个特性都有:

  • 种类:Mandatory(每个具有父特性的配置也具有它)或可选(按配置选择)。新特性为 Optional。
  • 子级:关于其子特性的规则。Any number(自由选择)、Choose one(每个配置恰好选择一个子特性)或 Choose at least one(一个或多个)。新特性为 Any number。
  • 规则:一个特性需要另一个特性,或排除它。排除是双向的。
  • 约束:一条可选规则,在选择该特性的任何配置中都必须成立,写法与适用于相同。

配置

配置是一个产品:对特性的一种选择。每个配置都有:

  • 编号和名称,例如 CFG-2 EO-1 Lite。
  • 状态:草稿、已发布或已退役。新配置为草稿,已发布配置的副本也是草稿(复制、复制粘贴、导入到打开的项目中):它没有自己的发布记录。已退役的配置可以查看,但不能编辑。配置通过发布配置…发布(参见发布配置)。
  • 阶段(可选):它所处的生命周期阶段,例如 Preliminary design 或 CDR。阶段决定适用哪些完整性规则。
  • 所有者(可选,Team 方案):必须批准更改该配置的变更请求的人员或团队。
  • 适用性(可选):按该配置制造的单元的序列号或制造日期。

配置的有效选择不只是您勾选的特性:

  • 所选特性;
  • 它们的父特性,一直到根;
  • 每个所选特性的 Mandatory 子特性;
  • 树根部的 Mandatory 特性。

判定

Holarch 根据特性规则检查每个配置,并显示判定:

  • 有效:该选择遵循所有规则。
  • Breaks: …:违反了某条规则,例如“Breaks: Encrypted Downlink requires X-band Downlink.”(违反:Encrypted Downlink 需要 X-band Downlink。)
  • Incomplete: …:缺少某个选择,例如“Incomplete: choose a Downlink (choose one).”(不完整:请选择一个 Downlink。)

当多条规则不满足时,判定按以下顺序指出第一条:被另一个所选特性排除的 Mandatory 特性、没有选择或选择多于一个的 Choose one 组、没有选择的 Choose at least one 组、未满足的“需要”、被违反的“排除”、不成立的约束。

完整性

有效判定只涉及特性规则。完整性检查配置所包含的条目:

  • 其中的每条叶需求都由其中的某个条目验证(适用于该配置的测试用例);
  • 其中的每个连接(Conduit)的两端都在其中,每个具有自身“适用于”的关系的两端都在其适用的配置中;
  • 其中的每个条目的父项都在其中。

每个配置显示完成或缺口数,例如“3 gaps”。已退役的配置不检查。完整性忽略适用性:当条目适用于某个配置时,它就属于该配置。

各阶段的完整性

配置的阶段决定检查的范围。每个阶段使用五个级别之一:

级别默认阶段检查
1Concept每个条目的父项都在配置中。
2Preliminary design级别 1,并且每个连接的两端都在其中,每条叶需求都由其中的某个条目满足。
3详细设计级别 2,并且每条叶需求都由其中的某个条目验证。
4测试级别 3,并且每个进行验证的测试用例都有规程(描述或测试步骤)和针对此配置的结果。
5Production级别 4,并且每个进行验证的测试用例在此配置中都为 Passed,且没有未关闭的问题与其条目关联。

使用 SE 流程时,阶段列表改为包含其评审关口(SRR、PDR、CDR、TRR 等),每个都有一个级别:SRR 为 1,PDR 为 2,CDR 为 3,TRR 为 4,生产和运行评审为 5。没有阶段时,完整性使用上文完整性下的规则(需求已验证、连接端点、父项)。

若要更改某个阶段的级别,请打开产品线页面的 ⋯ → 设置…,并在阶段下选择一个级别。一次撤销即可撤回该更改。

完整性行分别显示模型完整性和验证情况,例如“Complete at CDR · 12/40 verified”:第一部分是针对该阶段的检查,第二部分是在此配置中有 Passed 结果的需求。验证从级别 3 起显示,没有阶段时也显示。

发布配置

配置通过发布配置…发布:在产品线页面上打开该配置列的 ⋯,或按 ⌘K / Ctrl+K 并输入“Release”。在属性面板或数据库中将状态设为已发布会打开同一个对话框。

对话框显示:

  • 阶段:此次发布所针对的阶段。会针对该阶段检查完整性。
  • 特性规则和修订:违反规则或同时有两个修订生效的配置无法发布:“CFG-2 cannot be Released. Breaks: Wallbox requires Large pack. Change its selection on the Product Line page first.”(CFG-2 无法发布。违反:Wallbox 需要 Large pack。请先在产品线页面上更改其选择。)
  • 该阶段的完整性,带有显示缺口,以及验证(其中有多少需求已验证)。
  • 未关闭的高风险,仅在完整性级别为 5(Production)的阶段显示:配置中处于高级别(设置了剩余级别时按剩余级别)且未关闭的风险和危险源,例如“风险 RSK-1 Battery fire:High,Open”。这是一个警告:它不会阻止发布,也不需要原因。Risk 在其状态为 Open 且不是 Opportunity 时计入;Hazard 在被 Accepted 或 Closed 之前计入。
  • 发布条件,仅在配置不完整时显示:原因(10 到 2,000 个字符)和审批人。在两者都填写之前,发布保持不可用。

点击发布。配置的状态变为已发布,Holarch 会保留一份发布记录:阶段、发布时的完整性和验证、已接受的缺口、原因和审批人,以及已发布的定义(见下文)。一次撤销即可将发布及其记录一并撤回。

完整性和验证按 Holarch 在发布时于您的浏览器中计算的结果记录。Holarch 在线版会检查已发布的定义是否与其 SHA-256 摘要相符,并拒绝文件不相符的发布;它目前还不会再次检查完整性。

由谁审批:

  • 桌面应用:输入审批人的姓名。它按输入的姓名记录;此 Holarch 副本没有账户。
  • Holarch 在线版,Individual 方案:您审批自己的发布;服务器会记录您的账户和时间。
  • Holarch 在线版,Team 方案:由配置的所有者审批,没有所有者时由项目所有者审批。不完整的发布会以待审批状态等待,直到审批人在其上打开发布配置…并点击审批发布(Holarch 会要求输入其密码)。只有当项目允许自我审批时(变更请求 → 设置),您才能审批自己的请求。完整的发布无需审批。

服务器会拒绝没有附带发布记录的“状态改为已发布”操作,因此 API 客户端或旧版页面无法跳过该对话框。它还会拒绝删除或更改发布记录的项目保存,即使来自项目所有者也是如此。

撤回发布…(列的 ⋯,或将状态改回草稿或已退役)会要求填写原因。发布记录会保留,其日志中会添加撤回信息;发布记录永不删除。再次发布会成为发布 2。

对于在发布记录出现之前就已发布的配置,会提供记录发布…(列的 ⋯)。它将配置今天的状态记录为其发布,并标记为“recorded later”(后来记录)。

  • 一次为多个配置设置状态时(数据库 → 属性…),会指出违反规则的配置(它们保持为草稿),并依次为其余每个配置打开发布配置…。
  • 在实时模型中撤回发布,而不是在变更请求中撤回。若要通过变更请求发布配置,请暂存该发布(参见通过变更请求发布)。如果变更请求只是将配置的状态设为已发布,应用时并不会发布该配置;配置保持其状态,变更请求的其余部分照常应用。
  • AI 或 MCP 提案无法发布配置:其评审会显示“需要发布记录”并提供发布配置…;应用该提案会应用其其他更改。

暂不支持发布 SysML v2 项目的配置。

通过变更请求发布

发布可以作为变更请求的一部分,这样批准更改的委员会也会批准该发布。在变更请求中工作(或打开变更请求)时,暂存该发布:

  • 在变更请求上,选择添加更改 ▾ → 发布配置…,然后选择配置。
  • 在产品线页面上,选择该配置列的 ⋯ → Release with CR-12…。
  • 在属性面板或数据库中,将状态设为已发布。

对话框相同,标题为“随 CR-12 发布 CFG-2”。它会针对变更请求将要形成的模型,检查所选阶段的完整性,并在级别 5 时列出未关闭的高风险;当该阶段报告的结果比上次发布差,或在下一阶段留有缺口时,它会发出警告。配置不完整时,请输入原因;请求的审批者取代审批人。点击 添加到 CR-12:该发布作为一项更改暂存(“Release CFG-2 at CDR”),在此之前配置保持为草稿(其列的状态标签显示“Release staged in CR-12”),并且该配置计为受该请求影响,因此在适用审批规则时需要其所有者的批准。

应用已批准的请求时,Holarch 会发布该配置并保留其发布记录,包括暂存时的阶段、原因和已接受的缺口,以及请求的审批者和 via CR-12。一次撤销即可将已应用的请求和发布一并撤回。如果在应用时配置已被删除或退役、已经发布或正在等待审批、违反特性规则,或有请求未接受的缺口,Holarch 不会发布该配置。请求的其余部分仍会应用,请求的日志和结果会说明原因。修正后请再次暂存发布。

Holarch 在线版根据请求的投票(由服务器提供账户和时间)记录审批,而从不根据页面中输入的姓名记录。由请求批准的不完整发布无需单独审批发布。只有应用请求的人员才能在审批检查后一小时内记录其发布;项目保存或 API 客户端无法通过变更请求添加发布。

已发布的定义

每份发布记录都保存发布时的配置:其条目和关系及其值、所做选择、所使用的库特性和配置、发布时读取的其他项目中的关联条目,以及验证结果。它作为带有 SHA-256 摘要的压缩文件存储在项目中。

在基线和版本上,发布卡片列出每次发布及其配置、阶段、完整性、审批人、日期和状态。其 ⋯ 菜单提供:

  • 打开已发布的定义:以只读方式显示已发布的条目及其发布时的值(例如某个配置的自有 Mass)。
  • 验证:检查记录是否与其摘要相符(完好),并根据记录自身的输入重建配置(精确重现):其快照、它所冻结的库特性和配置,以及解析时使用的架构。之后的编辑、新的库发布、已更改的关联条目以及重命名的类、属性或关系都不会改变结果。
  • 与今天比较:配置现在显示的内容与发布时的比较,包括已移到另一个发布的库(以其发布标签命名)以及之后发生变化的关联条目。
  • 导出(JSON):记录及其定义。
  • 撤回…

“适用于”和适用性

任何条目或关系上都有两个字段说明它属于哪些产品:

  • 适用于说明哪些配置包含该条目。它是由特性和配置组成的表达式,例如 F-4 and not F-5。为空表示每个配置。
  • 适用性说明该条目从哪个单元或日期起生效:序列号(例如 1-20, 25, 40-)、日期范围,或两者兼有。为空表示始终生效。

两者相互独立并组合使用:当条目适用于该配置并且在视图的序列号或日期上生效时,它就在视图中。

共享标识和配置值

一个条目在每个配置中都是同一个条目。其名称、Number、类、标签和负责人在各处都相同,其在层级中的位置、文档顺序和图布局也相同。

其描述和属性值可以不同。配置值是条目针对某个配置的自有值,例如 EO-1 Lite 中 Daily Data Volume 为 1 GB,而其他配置保持 3 GB。没有自有值的配置使用条目的基础值。

150 % 视图

所有配置(未选择配置)显示整个产品线:每个产品的每个条目,带有基础值。因配置而异的字段标记为 不同。在此视图中可以重新编号、恢复基线以及在所有位置删除条目。

如何使用

何时使用及原因

当多个产品共享大部分需求、功能和架构时,请使用产品线:飞行件和较轻的变型、出口版本、客户选项、批次升级。一个模型使共享部分保持同步。每个配置仍有自己的规格说明、RVTM 和基线。

推荐的工作顺序:

  1. 照常对共享设计建模。
  2. 将各产品不同之处列为特性,并附上其规则。
  3. 每个产品添加一个配置,并检查每个配置是否有效。
  4. 用“适用于”标记只有部分产品才有的条目,用配置值标记不同的值。
  5. 生成文档并验证每个配置。

如果您的产品之间只有制造日期或序列号不同,请创建单个配置(例如“Production”),并只使用适用性。

开始产品线

  1. 按 ⌘K / Ctrl+K 并选择开始产品线…:它会打开该页面和New Feature对话框。或者在数据库中用+ 新建条目创建一个特性或配置条目。导航栏中会出现控制与评审 → 产品线,每个条目的属性面板中会出现产品线组。
  2. 在产品线页面上,点击+ 新建特性并输入特性的名称,例如“Downlink”。按 Enter。名称即被保存,并开始一个新的同级行。
  3. 输入下一个特性的名称。若要使其成为上一行的子项,请按 ⌥⇧→ / Alt+Shift+→。⌥⇧← / Alt+Shift+← 将其移回外层。
  4. 在属性面板中设置每个特性的种类和子级(在其行上按 Enter)。
  5. 从该行的 ⋯ 菜单添加规则:规则…用于“需要”和“排除”,约束…用于约束。

在项目有第一个特性或配置之前,产品线页面、属性面板中的该组以及“适用于”列都是隐藏的。删除最后一个特性或配置后它们会再次隐藏,但仍持有“适用于”或适用性值的条目除外。

创建配置

  1. 在产品线页面上,点击+ 新建配置。输入名称,例如“EO-1 Lite”。配置中会出现一个新列。
  2. 勾选此产品具有的特性。对于 Choose one 组,单元格是单选按钮:选择一个会替换另一个。标记为隐含的单元格是因另一个特性(父特性或 Mandatory 子特性)而包含的;它们无法更改。
  3. 阅读列下方的判定行。修正选择,直到显示有效。
  4. 阅读完整性行。指向缺口数可查看各个缺口。
  5. 点击检查配置可一次检查所有配置。

若要从现有产品开始,请打开该配置列标题的 ⋯ 菜单并选择复制。副本具有相同的选择和相同的配置值。

说明哪些条目属于哪些产品

  1. 选择一个条目(例如需求),并打开属性面板的产品线组。
  2. 在适用于中,输入特性或配置编号,例如 F-4。用 ↓ 和 Enter 从建议列表中选择。字段下方的行会显示,例如“Applies to 1 of 2 configurations: CFG-1”(适用于 2 个配置中的 1 个:CFG-1)。
  3. 用 and、or、not 和括号组合各项:F-3 and not F-5。
  4. 或者点击选择…,从列表中选择配置或特性。

对于每个产品都有的条目,请将“适用于”留空。大多数条目都保持为空。

查看和编辑一个配置

  1. 点击顶栏中的 查看方式 ▾ 并选择一个配置。您会看到一个横幅:“正在查看配置 CFG-2 EO-1 Lite。新条目仅适用于 CFG-2;更改的值归 CFG-2 所有。”现在每个页面都只显示 CFG-2 的条目,并带有 CFG-2 的值。
  2. 照常工作。新条目适用于 CFG-2。当其他配置也有该条目时,更改的描述或属性会成为 CFG-2 的自有值。
  3. 点击横幅中的离开,可再次查看所有配置。

该选择属于浏览器标签页。其他人和其他标签页保留各自的视图。有关每条规则,参见在配置视图中编辑。

为配置指定自有值

  1. 在 查看方式 ▾ 中选择配置。
  2. 选择条目并在属性面板中更改属性。编辑时,字段下方的提示会显示,例如“仅为 CFG-2 保存。其他配置保留 3 GB。”更改后,字段会显示 CFG-2 value 标签。
  3. 若要撤销该差异,请打开该标签的菜单并选择 使用基础值。

为一个配置生成规格说明

  1. 打开文档,点击交付 ▾并选择一个 Word 模板,例如 Specification (Word)。您会看到导出到 Word对话框。
  2. 将配置设为该产品,将适用性设为 Any unit、序列号或日期。
  3. 导出文档。文档会省略不适用的章节,按显示的方式为其余章节编号,并在标题页、页脚和文件名中注明该配置。

实例:CubeSat EO-1 演示

CubeSat EO-1 演示项目有两个产品:EO-1 Flight,带有 X 波段下行链路和加密;以及 EO-1 Lite,带有 S 波段下行链路。在“Manage Projects”中用 Project Files ▾ → New Demo Project 创建演示项目。

  1. 打开控制与评审 → 产品线。您会看到特性 Downlink(Mandatory,Choose one),其下有 S-band Downlink 和 X-band Downlink;Encrypted Downlink(Optional,需要 X-band Downlink);以及 Propulsion(Optional,需要 X-band Downlink)。
  2. 查看配置 CFG-1 EO-1 Flight(X-band 和 Encrypted Downlink,序列号 1–2)和 CFG-2 EO-1 Lite(S-band,序列号 3 及以后)。两者的判定都显示有效。
  3. 在 CFG-2 列中,勾选 Encrypted Downlink。判定变为“Breaks: Encrypted Downlink requires X-band Downlink.”(违反:Encrypted Downlink 需要 X-band Downlink。)按 ⌘Z / Ctrl+Z。
  4. 打开需求 4.4 Downlink Encryption。它的“适用于”是 Encrypted Downlink 特性(F-4),因此它只在 EO-1 Flight 中。1.5.2 S-band Transmitter、其接口 IF-08 和 IF-12,以及 5.1 S-band Downlink Rate 适用于 F-2;1.5.3 X-band Payload Radio、其接口 IF-08.1 和 IF-12.1、5.5 X-band Downlink Rate 及其测试用例 TC-21 X-band Link Test 适用于 F-3。
  5. 选择 查看方式 ▾ → CFG-2 EO-1 Lite,并打开需求 5.4 Daily Data Volume。其描述为“at least 1 GB”,并带有 CFG-2 value 标签。在 EO-1 Flight 中,它保留基础文本“at least 3 GB”。
  6. 打开测试用例 TC-11 UHF Command Test。它每个配置有一个结果:在 EO-1 Flight 中为 Passed,在 EO-1 Lite 中为 In Progress。
  7. 打开 1.3.2 Battery Pack,查看其特性参数 Thermostat Heater Power(2 W,适用性 SN 1)和 Software-Controlled Heater Power(3 W,SN 2 及以后):加热器从第二个航天器起发生了更改。
  8. 打开控制与评审 → 基线和版本。EO-1 Flight PDR 是 CFG-1 的基线(Team 方案)。
  9. 在“所有配置”中打开验证 → 模型检查。Product line 规则会警告没有配置选择 Propulsion(ProductLine.4)。演示项目有意不选择它,作为该检查的示例。

提示和良好做法

  • 让特性描述产品,而不是文档:“X-band Downlink”,而不是“Section 5 option”。
  • 在“适用于”中优先使用特性项。当您添加第三个带有 X 波段下行链路的产品时,F-3 仍然正确,而 CFG-1 则不然。
  • 将许多相关选项归入一个父特性,而不是编写冗长的表达式。
  • 只为确实不同的值指定配置值。其他一切都保持共享。
  • 对受控的配置使用已发布,对不再制造的产品使用已退役。
  • 将从某个序列号起的零件更改建模为两个条目(旧的和新的),各自带有适用性。

常见错误

  • 编辑后某个条目从视图中消失。其“适用于”或适用性不再包含该配置。提示消息会指出它;点击撤销,或在“所有配置”中找到它。
  • 某个配置一直显示 Incomplete。某个 Choose one 或 Choose at least one 组没有选择。请勾选该组的一个子特性。
  • 某个条目不在任何配置中。其“适用于”指定的特性没有被任何配置选择。模型检查会报告此问题(ProductLine.2)。
  • 一次移动更改了每个产品。结构是共享的:在配置视图中移动条目或重新排序会在所有配置中移动它。

与其他功能的关联方式

  • 文档:按配置以及序列号或日期生成。
  • RVTM 和测试中心:按配置记录结果;“verified”表示已针对该产品验证。
  • 模型检查:Product line 规则集检查表达式、判定、适用性和修订(supersedes)。
  • 基线和版本(Team):为一个配置创建基线并比较配置。
  • 变更请求(Team):查看请求更改了哪些配置;由所有者审批。
  • 搜索:appliesto:CFG-2 和 varies:yes 按配置查找条目。
  • REST API 和 MCP:以一个配置读取模型。

产品线页面

控制与评审 → 产品线在左侧显示特性,在右侧显示配置。宽度小于 1,100 px 时,两个区域上下堆叠。

控件功能
+ 新建特性在树的末尾添加一个使用下一个编号(F-1、F-2……)的特性。
检查配置列出每个配置,显示有效或其第一个问题,以及完成或其缺口。
+ 新建配置添加一个使用下一个编号(CFG-1、CFG-2……)的配置列。
⋯导出 CSV(按配置列出特性,带有 Selected 或 Implied 以及判定)和帮助。

功能

一个树形网格,包含特性(编号和名称)、种类、子级和使用者(有多少条目在“适用于”中指定该特性)列。规则在行中显示为小标签,例如“requires F-3”。

在属性面板中设置特性的种类和子级:在行上按 Enter 即可在属性面板中打开它。

行的 ⋯ 菜单:

  • 添加子特性…
  • 重命名(F2)
  • 规则…:需要和排除勾选列表
  • 约束…:选择该特性时必须成立的“适用于”表达式
  • 显示使用它的条目
  • 删除…

配置

一个网格,每个特性一行(按树的顺序),每个配置一列。每个列标题显示编号、名称和状态,在 Team 方案中还显示所有者。

单元格:

  • 可自由选择的特性显示为复选框。
  • Choose one 特性的子特性显示为单选按钮。
  • 因另一个特性而包含的特性显示隐含标记。工具提示会指出该特性,例如“Included because F-1 is selected.”(因选择了 F-1 而包含。)

底部的判定行显示有效或第一个问题(特性规则)。其下方的完整性行显示完成或缺口数;其工具提示会列出缺口(参见完整性)。

列标题的 ⋯ 菜单:

  • 以此配置查看
  • 重命名…
  • 适用性…
  • 所有者…(Team):在属性面板中打开该配置。
  • Baseline CFG-2…(Team):保存此配置的基线(参见按配置创建基线)。
  • 复制:复制选择和每个配置值,一次撤销即可全部撤回。副本是一个名为“<name> (copy)”的草稿。
  • 退役,或对已退役的配置使用恢复为草稿。已退役配置的视图为只读。
  • 删除…:将配置移到回收站。条目会保留其值,因此Restore可将其完整恢复。

空状态

  • 没有特性时:“尚无特性。添加第一个特性:各产品之间不同的选项。”
  • 没有配置时:“尚无配置。配置就是一个产品:对特性的一种选择。”

键盘

按键位置作用
Tab页面在标题栏操作和两个网格之间移动。它从不缩进。
Home / End功能第一行或最后一行。
↑ / ↓功能上一行或下一行。
← / →功能折叠或展开。
Enter功能命名时:保存名称并在下方开始一个新的同级行。在所选行上:在属性面板中打开该特性。
F2功能就地重命名特性。按 Esc 或将名称留空则不添加任何内容。
⌥ / Alt+↑ / ⌥ / Alt+↓功能在同级特性之间上移或下移该特性(两个特性交换编号)。
⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+←功能缩进或取消缩进该特性,与文档大纲中相同。
Delete功能确认后删除该特性。
方向键配置在单元格之间移动。
Space配置勾选或清除该单元格。
Enter配置在列标题上:打开其菜单。
Home / End配置第一列或最后一列。

屏幕阅读器

特性是一个名为“Features”的树形网格。配置是一个名为“Configurations by feature”的网格;每个单元格的朗读内容例如“F-3 X-band Downlink in CFG-1 EO-1 Flight: selected”。更改会被朗读:“X-band Downlink selected for CFG-1.”、“CFG-2 breaks a rule: Encrypted Downlink requires X-band Downlink.”、“CFG-2 is valid.”

适用于

适用于说明哪些配置包含某个条目。它位于属性面板的产品线组中(在各属性组之后)、条目视图中,以及数据库的一列中。暂不支持:在关系面板中编辑关系的“适用于”。

字段

  • 适用于:表达式。为空时显示“所有配置”。
  • 选择…:从列表中选择配置或特性,而不必输入。
  • 其下方的预览行:“Applies to 2 of 4 configurations: CFG-1, CFG-3”(适用于 4 个配置中的 2 个:CFG-1、CFG-3)或“Applies to every configuration”(适用于每个配置)。
  • 当某个配置视图添加或移除了该条目时,会显示 Removed from CFG-2 和 Added to CFG-4 之类的标签。点击其中一个上的 ✕ 即可清除:该条目在该配置中再次遵循“适用于”。
  • 当表达式指定了已删除的特性或配置时(以其旧编号显示),会显示警告。

特性和配置条目没有“适用于”。

在数据库中,一旦有任何条目使用“适用于”,适用于列就会出现(可从其 ▾ 隐藏,从列重新添加)。双击单元格,或按 Enter 或 F2,即可用同一字段编辑它。

输入时会打开匹配的特性和配置列表,然后是运算符。↓/↑ 移动,Enter 或 Tab 插入,Esc 关闭列表,再按一次 Esc 还原字段。Enter 保存;表达式有效时,离开字段即保存。

“选择…”对话框

适用于 — <item>提供三种选择:

  • 每个配置:清除表达式。
  • 这些配置:勾选配置;写入 CFG-1 or CFG-3。
  • 特性:勾选特性并选择全部(写入 F-2 and F-5)或任意(写入 F-2 or F-5)。

生成的表达式显示在下方。作为表达式编辑将其放入文本字段而不保存。应用会保存,一次撤销即可全部撤回。

“适用于”表达式

您输入的内容含义
F-3 或 "X-band Downlink"一个特性,可用编号或带引号的名称。当配置的有效选择包含它时为真。
CFG-2 或 config "EO-1 Lite"一个配置。仅对该配置为真。
and, or, not, ( )组合各项。&、| 和 ! 也可以使用,并显示为单词。not 优先结合,然后是 and,最后是 or。
all, none每个配置,或一个都没有。

不区分大小写。Holarch 以条目的 ID 存储表达式,因此重命名或重新编号特性永远不会破坏它。它显示编号;对于没有编号的条目,显示带引号的名称。

已删除或未知的特性为假,模型检查会将其报告为错误。

表达式消息

无效的表达式永远不会被保存。字段会保留您的文本并标出错误,上一个有效值仍然生效。位置从 1 开始按字符计数。

留言应采取的行动
No feature or configuration named “F-9”. Choose one from the list, or create the feature first.(没有名为“F-9”的特性或配置。请从列表中选择一个,或先创建该特性。)检查编号,或创建该特性。
Expected a feature or configuration after “and” (character 12).(“and”之后(第 12 个字符)应为特性或配置。)在运算符后添加一项。
Expected a feature or configuration at character 1.(第 1 个字符处应为特性或配置。)以一项、not 或 ( 开头。
Expected “and” or “or” before “F-5” (character 9).(“F-5”之前(第 9 个字符)应为“and”或“or”。)用运算符连接两项。
Missing “)” for the “(” at character 5.(第 5 个字符处的“(”缺少对应的“)”。)闭合括号。
“)” at character 9 has no matching “(”.(第 9 个字符处的“)”没有匹配的“(”。)删除多余的括号。
第 4 个字符处缺少名称的右引号。闭合带引号的名称。
“Wallbox” matches 2 features (F-3, F-11). Use the number.(“Wallbox”匹配 2 个特性(F-3、F-11)。请使用编号。)两个特性同名;请输入编号。
Applies To is too long. Use at most 200 features and configurations; group them with a parent feature instead.(Applies To 过长。最多使用 200 个特性和配置;请改为用父特性对其分组。)缩短表达式。

以配置查看

查看方式 ▾以一个配置显示整个模型。一旦项目有了配置,它就会出现在顶栏中保存状态的左侧。

菜单

  • 所有配置:整个产品线。
  • 每个配置一项,带有其状态;当它违反规则或不完整时,会带有标记。
  • 适用性 ▸:任意单元、序列号…、日期…或序列号和日期…。参见按序列号或日期查看。
  • 管理产品线:打开产品线页面。

菜单可用 Enter、Space 或 ↓ 打开;方向键移动,Enter 选择,Esc 关闭。⌘K / Ctrl+K 中有按配置查看…、查看所有配置、设置适用性…、转到产品线、新建特性…、新建配置…,在视图中还有将现有条目添加到 CFG-2…。

横幅

选择了某个配置时,顶栏下方的横幅会显示,例如“正在查看 SN 23 时的配置 CFG-2 EO-1 Lite。新条目仅适用于 CFG-2;更改的值归 CFG-2 所有。”它显示视图中有多少条目(“1,350 个条目中的 1,204 个”),并带有:

  • 更改 ▾:与“查看方式 ▾”相同的菜单。
  • 离开:返回“所有配置”。

当您同时在变更请求中工作时,变更请求的横幅在前,配置的横幅在后。

每个页面显示的内容

  • 不适用于该配置的条目和关系,或在视图所处时点未生效的条目和关系,都会被排除。
  • 具有配置值的条目显示这些值。
  • 计数、汇总、预算、仿真、质量得分和模型检查都针对该配置计算。
  • 文档大纲、生成的文档和 RVTM 按显示的方式为条目编号。存储的编号不会改变;导出中会注明“Numbering as shown in CFG-2.”(编号按 CFG-2 中的显示。)
  • 搜索和查询在视图上运行。

该选择属于浏览器标签页,重新加载时会保留。切换视图不是编辑,因此撤销会跳过它。

屏幕阅读器

按钮显示为“查看方式:CFG-2 EO-1 Lite”。横幅是一个名为“配置视图”的区域。进入、离开和更改时点都会被朗读,例如“正在查看配置 CFG-2 EO-1 Lite。1,350 个条目中有 1,204 个适用。”和“正在查看所有配置。”

在配置视图中编辑

在配置视图中编辑与在其他地方一样。Holarch 将每次编辑转换为对整个产品线的更改,因此其他配置保留原有内容。每个操作都可通过一次撤销撤回。

创建和更改条目

您的操作结果
创建条目(任何方式:+ 新建、图、文档、数据库行、粘贴、复制、模板、导入、已应用的 AI 或 MCP 提案)该条目仅适用于此配置。只有一个配置时,“适用于”保持为空。
复制,或 Copy with Children每个副本都适用于此配置,并将显示的值作为其基础值。
更改名称、Number、类或标签为每个配置更改它们。字段显示已共享图标;更改会被朗读,例如“已为所有配置更改 Name。”
更改其他配置也有的条目的描述或属性保存为此配置的自有值。与基础值相等的值会移除自有值。已退役的配置算作其他配置,因此它们保留各自的值。
更改只有此配置才有的条目的描述或属性保存为基础值。
更改适用于或适用性为每个配置更改它们。字段显示已共享图标,编辑时提示显示“为每个配置(而不仅是 CFG-2)更改 Applies To。”当条目不再属于该视图时,它会离开视图:“R-4.2 no longer applies to CFG-2.”(R-4.2 不再适用于 CFG-2。),并带有撤销。
添加关系添加到产品线。当其两端也同时位于另一个配置中时,它仅限于此配置。
更改关系的属性与条目的属性相同。
移动、重新排序、缩进、取消缩进或更改父项为每个配置更改共享结构:“已为所有配置移动。”
更改图布局由每个配置共享。
记录测试结果保存为此配置的结果,即使没有其他配置具有该测试用例也是如此。运行套件会显示“Recording results for CFG-2.”(正在记录 CFG-2 的结果。)
编辑架构、项目设置、共享或库订阅共享,与“所有配置”中相同。

移除和删除

您的操作结果
删除其他配置也有的条目确认对话框会询问,例如“要从 CFG-2 中移除 R-4.2 吗?它会保留在 CFG-1 和 CFG-3 中。”从 CFG-2 中移除 只将其从此配置中移除;全部删除…会将其删除到回收站。
移除此类带有子项的条目同时从 CFG-2 中移除其 3 个子项(默认开启)。关闭时:子项保留在配置中,并显示在上一级。
删除只有此配置才有的条目照常删除到回收站。
移除其他配置也有的关系仅从此配置中移除:“Removed the link from CFG-2. It stays in 2 other configurations.”(已从 CFG-2 中移除该关联。它保留在另外 2 个配置中。)
移除只有此配置才有的关系照常删除。
从图中移除为此配置移除条目与图之间的关系。在只列出其形状的图上,对话框会显示“Removes the shape from this diagram in every configuration.”(在每个配置中从此图移除该形状。)
从回收站恢复将条目恢复到产品线。如果它不适用于该配置:“已恢复 R-4.2。它不适用于 CFG-2。”

当一次编辑使所选条目离开视图时,焦点会移到同一列表中的下一个条目,提示消息会说明该条目去了哪里。

添加现有条目

用于向图、文档或关系添加现有条目的选择器会列出视图中的条目。若要引入不适用于该配置的条目,请使用 ⌘K / Ctrl+K 中或横幅的更改 ▾菜单中的将现有条目添加到 CFG-2…:“已将 Battery 添加到 CFG-2。”

视图中不可用的功能

  • 重新编号…、从此处重新编号…和重新编号子项…:编号由所有配置共享。请在“所有配置”中重新编号。
  • 恢复基线和 Restore Earlier Version:“Leave the configuration view to restore a baseline.”(请离开配置视图以恢复基线。)
  • 在已退役配置中的每次编辑:“CFG-1 已退役。要进行更改,请复制它。”除非配置控制将其锁定,否则已发布的配置仍可编辑。

已发布和已退役的配置保留其值

其他地方的编辑永远不会改变已退役配置所显示的内容,并且只有通过变更请求才会改变已发布的配置。当您更改条目的基础值时(在“所有配置”中、使用设为基础值,或通过导入或已应用的 AI 或 MCP 提案),每个具有该条目且没有自有值的已退役配置,以及每个不在变更请求中的已发布配置,都会作为同一更改的一部分将旧值作为其自有值。原本为空的基础值不会保留。

已锁定、从库挂载和受控的条目对于配置值也保持其通常的规则。

撤销和历史记录

  • 撤销可跨视图切换使用。当该步骤是在另一个视图中完成时,提示消息会指出它:“Undid a change made in CFG-2: Mass of Battery.”(已撤销在 CFG-2 中所做的更改:Battery 的 Mass。)
  • 历史记录会在该视图中所做的每项更改旁显示“In CFG-2”。

与他人协作

处于不同配置中的两个人永远不会覆盖彼此的值或移除操作。基础编辑和配置值永远不会冲突。两个人为同一配置更改同一字段时:与任何字段一样,后一次更改生效。

当有人删除了您正在查看的配置时,您的标签页会返回“所有配置”:“CFG-2 已被删除。正在显示所有配置。”

配置值

配置值是条目针对某个配置的自有描述或属性值。

哪些字段可以不同

字段可按配置不同
描述、每个属性、关系属性是
名称、Number、类、标签、负责人否:它们标识条目
适用于、适用性、特性和配置的属性、selects、requires、excludes否:它们定义配置
带有审批工作流的属性(例如审批下的 Requirement Status)否:每个条目一条审批记录
质量结果、评审数据和计算值否:针对每个视图计算
图布局和文档设置否

在配置视图中

  • 具有此配置自有值的字段会显示 CFG-2 value 标签。其菜单:
    • 使用基础值(3 GB):移除自有值。
    • 设为基础值:将此值设为基础值;其他配置的自有值保留。
    • 所有配置中的值…
  • 从不变化的字段显示已共享图标(“由所有配置共享。”)。
  • 编辑其他配置也有的条目的字段时,提示显示“仅为 CFG-2 保存。其他配置保留 3 GB。”

在“所有配置”中

具有自有值的字段显示不同(2)。其菜单中有所有配置中的值…和清除配置值。

编辑可以不同的字段时,提示会说明更改影响哪些配置,例如“Changes CFG-2 and CFG-3. CFG-1 (Released) keeps 1,400. CFG-4 keeps its own value.”(更改 CFG-2 和 CFG-3。CFG-1(已发布)保留 1,400。CFG-4 保留其自有值。)

所有配置中的值…首先列出基础值,然后列出每个配置及其值和源(“自有值”或“基础”)。就地编辑一行并按 Enter 保存。

在数据库中,具有自有值的单元格带有角标。历史记录、更改列表和比较会将配置值命名为例如“Mass (CFG-2)”,将成员关系更改命名为“In CFG-2”。

适用性

适用性说明条目、关系或配置从哪个单元或制造日期起生效。一旦项目有了配置,适用性字段就会出现。

字段

在属性面板的产品线组中(位于“适用于”下方),以及在配置的适用性…对话框中:

  • 序列号:一个列表,例如 1-20, 25, 40-。40- 表示 40 及以后。留空表示每个单元。
  • 生效起始:适用的第一个制造日期(YYYY-MM-DD)。
  • 截至(不含):不再适用的第一个制造日期。

字段下方的摘要会显示,例如“In effect for SN 1–20 and 25, and SN 40 on.”(对 SN 1–20 和 25 以及 SN 40 起生效。)其他位置的标签显示“SN 1–20, 25, 40– · From 2027-03-01”。同时设置了序列号和日期时,两者都必须满足。

序列号会排序并合并后存储。最多 200 个范围,数字最大为 1,000,000,000,000。暂不支持:用于输入 SN-0021 之类编号的项目序列号前缀。

配置的适用性指明按该配置制造的单元。它不会筛选该配置的条目。

按序列号或日期查看

  1. 选择查看方式 ▾ → 适用性 ▸ → 序列号…(或日期…,或序列号和日期…),或 ⌘K / Ctrl+K 设置适用性…。
  2. 输入序列号、制造日期或两者。横幅会加上该时点:“正在查看 SN 23 时的配置 CFG-3 Block 2。”

序列号和制造日期一起描述一个单元:“SN 75 built 2027-06-15”。此时当两者都满足(各自在条目设置了的地方)时,条目才会显示。序列号…保留已选择的日期,日期…保留序列号;任意单元清除两者。文档(导出对话框中的序列号和日期)、RVTM 和 API(effectivity=sn:75,date:2027-06-15)都使用相同的时点。

条目具有按序列号查看按日期查看
仅序列号当编号在其列表中时显示显示,并带有其标签
仅日期显示,并带有其标签当日期在其范围内时显示
两者当编号在其列表中时显示当日期在其范围内时显示
都没有显示内容显示内容

在“所有配置”中选择序列号时,会选中序列号包含该编号的配置。当有多个配置包含它时,菜单会列出它们(“SN 23 位于 CFG-2 和 CFG-3 中。请选择一个。”)。当该时点超出所选配置自身的适用性时,横幅会警告:“SN 23 is outside CFG-2's effectivity (SN 1–20).”(SN 23 超出 CFG-2 的适用性(SN 1–20)。)

适用性消息

留言应采取的行动
“x”不是序列号或范围。请使用数字和范围,例如 1-20, 25, 40-。修正所指出的部分。
范围“20-1”是倒序的。请先写较小的数字。交换两个数字。
最多使用 200 个序列号范围。合并范围。
序列号最大为 1000000000000。使用较小的数字。
“x”不是日期。请使用 YYYY-MM-DD。修正日期。
Effective Until 必须晚于 Effective From。更改其中一个日期。
请将序列号写成 1-20, 25, 40- 之类的范围。显示在字段下方;请修正范围。
Until 必须晚于 From。显示在字段下方;请更改其中一个日期。
SN 12–30 与 CFG-3(SN 21–40)重叠。配置上的警告,不阻止操作:两个产品共用序列号。

条目的修订

当某个零件从某个序列号或日期起发生更改时,请将旧零件和新零件建模为两个条目,各自带有适用性,并用 supersedes 将新零件与旧零件关联(其反向关系为 superseded by)。诸如“rev C supersedes rev B supersedes rev A”的链会使它们成为同一位置的各个修订。Holarch 从不在修订之间进行选择:它会报告修订的适用性在哪里重叠,或在哪里使某些单元没有修订。

  • 横幅:当两个修订在视图的时点上同时生效时,横幅会警告:“Overlapping revisions: A-20 Cooling unit has 2 in effect at SN 75 (A-20A, A-20B).”(重叠的修订:A-20 Cooling unit 在 SN 75 时有 2 个修订生效(A-20A、A-20B)。)
  • 模型检查:在两个修订上分别报告 Revisions in effect together(ProductLine.13),并给出它们共有的序列号和日期;在修订所分解的条目(或最早的修订)上报告 Units with no revision in effect(ProductLine.14),并给出第一个和最后一个修订之间没有修订的单元,例如“SN 1–49 from 2027-07-01”。
  • 发布和基线:当配置的两个修订重叠时,无法将其设为已发布或为其创建基线:CFG-1 cannot be Released: A-20A and A-20B are both in effect for SN 50–99 from 2027-06-01 until 2027-07-01.(CFG-1 无法发布:A-20A 和 A-20B 在 2027-06-01 至 2027-07-01 期间对 SN 50–99 同时生效。)请更改其中一个修订的适用性,然后再发布。

重叠和缺口在两个修订都适用的每个配置内、在该配置自身的适用性范围内检查。

文档、RVTM 和验证

为一个配置导出文档

在至少有一个配置的项目中,交付 ▾下的 Word 模板(例如 Specification (Word))和 ⌘K / Ctrl+K 将文档导出到 Word会先打开一个简短的导出到 Word对话框。没有配置的项目与以前一样一键导出。

  • 配置:所有配置,或某一个配置(“CFG-2 EO-1 Lite”)。已退役的配置列在最后,并标记为“(Retired)”。初始选择为您的标签页正在查看的配置。
  • 适用性:任意单元、序列号(例如 23;“SN 23”也可以)或日期。初始值为视图的时点。
  • 显示适用范围(仅在“所有配置”中,默认开启):在只有部分配置才有的每个章节下添加“Applies to: CFG-1, CFG-3”。已退役的配置不计入。

All Exports… → Document (Word) 在其 Product line 组中有相同的选项(基线导出除外)。

配置的文档包含:

  • 仅包含适用于该配置并在所选单元或日期生效的章节,并带有该配置的自有值。
  • 被省略章节下的章节会上移到最近的保留章节下。
  • 视图编号:位于被省略同级条目之后的条目会以相同的样式重新编号(4 变为 3,4.1 变为 3.1)。存储的编号不会改变。文件会在标题下注明“Numbering as shown in CFG-2.”(编号按 CFG-2 中的显示。)
  • 在标题页和页脚中:“Configuration CFG-2 EO-1 Lite · Serial number 23”(或“· Effective 2027-03-01”)。公司 Word 模板可以用字段 {{Configuration}} 放置它。
  • 文件名会注明配置:“SRS – CFG-2 EO-1 Lite.docx”。
  • 没有单元或日期时,带有适用性的章节会在标题下显示其标签,例如“Effective SN 21 and later”。

在配置视图中打印或保存 PDF 时,打印的页脚中也会包含配置和时点。

文档大纲

  • 在配置视图中,大纲显示视图编号。重新编号…和从此处重新编号…不可用:“Numbers are shared by all configurations. Renumber in All configurations.”(编号由所有配置共享。请在“所有配置”中重新编号。)在视图中,添加和移动后的自动重新编号是关闭的。
  • 一旦项目使用了适用于和适用性列,View ▾ → 列就会提供它们。
  • 文档的 ReqIF 导出将“适用于”和适用性写为字符串属性。对话框会显示“Applies To and effectivity are exported as string attributes. Configuration values are not exported.”(Applies To 和适用性作为字符串属性导出。配置值不导出。)

RVTM

  • 在配置视图中:显示该配置的需求和结果,因此“verified”表示已针对该产品验证。# 列显示视图编号。导出 ▾会在文件名(“RVTM – CFG-2 EO-1 Lite.csv”)和 Word 标题中注明配置。
  • 在“所有配置”中:一个配置列组,每个未退役的配置有一个汇总状态。“—”表示该需求不属于该配置(工具提示为“Does not apply to CFG-1”)。CSV 和 Excel 导出会为每个配置添加一个“Status in CFG-1”列(不属于该配置时为“Does not apply”)。
  • 适用性列:一个开关,默认隐藏,按标签页保存。
  • 只有配置自己的结果才计入。没有配置的结果(在该配置存在之前记录,或在“所有配置”中记录)不验证任何配置。在配置中,该测试用例显示为未运行,需求的状态会显示“A result without a configuration (TC-1) does not count for CFG-2.”(没有配置的结果(TC-1)不计入 CFG-2。)配置列的工具提示、导出以及为配置生成的文档中也有相同的说明。若要验证该配置,请在查看它时再次运行测试。
  • 在某个序列号上:状态来自在所查看配置中为该序列号记录的最新一次运行(被测件“23”、“SN 23”或“SN-0023”),并附有说明“Results recorded for SN 23 first”(优先使用为 SN 23 记录的结果)。没有此类运行的测试用例保持其状态。导出使用相同的状态。

测试中心

  • 在配置视图中,运行套件会显示“Recording results for CFG-2.”(正在记录 CFG-2 的结果。),并在配置 / 版本中填入“CFG-2 EO-1 Lite”。在某个序列号上,它还会填写被测件。结果保存为该配置的值,因此一个测试用例每个配置保存一个结果。
  • 视图中的导入结果…会显示相同的说明并填写相同的字段。
  • 在“所有配置”中,“运行套件”和“导入结果…”会询问记录结果:选择测试所运行的配置,或无配置(不验证任何配置)。初始时没有选择任何项,在您选择之前不会记录任何结果。某个配置的结果保存为其值,与在该配置的视图中相同;不在所选配置中的测试用例不会被记录,并会说明原因。无配置的结果保存为测试用例在“所有配置”中的值;配置视图会将其显示为测试用例状态下方的说明,而不是其结果。
  • 结果文件可以有一个配置列。某行的值(配置的编号、名称或两者)会将该行记录到该配置;不指向任何配置的值会跳过该行,并在对话框中列出。
  • 复用结果…(位于测试用例的状态下方):在您能说明理由时(例如因为测试的是相同的单元设计),将另一个配置的结果计入未运行该测试的配置。选择要复用的结果(某个配置的结果,或没有配置的结果)、它所针对的配置(在配置视图中为所查看的配置;在“所有配置”中为包含该测试用例且没有自己结果的任何配置),并输入理由(必填)。该结果会连同您的姓名、日期和理由一起复制到该配置,一次撤销即可全部撤回(提示消息“Reused the CFG-1 result for CFG-2.”,带有撤销)。
  • 复用的结果从不隐匿。在该配置中,测试用例的状态下方会显示已复用以及“from CFG-1 by Ann Lee on 2026-10-28: same motor and cooler”;该配置的 RVTM 会在需求的状态下方显示“Result reused from CFG-1 (TC-1): …”;在“所有配置”中,配置列显示“reused”(理由为其工具提示);为该配置生成的导出和文档会添加相同的说明;模型检查将其列为 ProductLine.17。停止复用可将其撤回(测试再次显示 Not Run),在该配置中运行测试则会用该配置自己的结果替换它。
  • 编辑测试用例的 Configuration 属性时(属性面板、条目视图、运行套件、导入结果),会建议项目的配置。它仍是自由文本:诸如“Build 2.4.1”之类的版本仍然可用。

图和权衡研究

  • 显示适用范围(图工具栏,LML 项目,在“所有配置”中):为带有“适用于”或适用性的条目的形状着色,并在其下方写出适用范围,例如“Applies to F-4 · Effective SN 30 and later”。该设置按标签页保存,在配置视图中不提供。
  • 权衡研究 → + From Configurations…(位于备选方案下)将产品线的配置作为备选方案添加,一次撤销即可全部撤回。已退役的配置初始为未勾选。提示消息:“Added 2 alternatives.”

基线和变更请求

这些功能属于 Team 方案。没有该方案时,这些命令不可用,并显示“Baselines per configuration are part of the Team plan. The project owner's plan decides.”(按配置创建基线属于 Team 方案。由项目所有者的方案决定。)

按配置创建基线

  1. 打开控制与评审 → 基线和版本。
  2. 点击为配置创建基线…。查看某个配置时,按钮显示为基线 CFG-2…,并跳过选择。
  3. 选择配置并输入名称(初始为“CFG-2 baseline 1”)。点击保存基线。提示消息显示“Baseline of CFG-2 saved.”(已保存 CFG-2 的基线。)表格的 Document 列会显示,例如“Configuration CFG-2 EO-1 Lite”。

基线记录整个产品线,标注该配置,并在按某个适用性时点查看时记录该时点。可以像任何基线一样比较和恢复它。暂不支持:记录配置的判定、选择和审批的已发布定义记录。

每个基线还会记录项目从其他项目使用的内容:所用每个库的发布,以及指向其他项目中条目的每个链接及该条目当时的最后更改。当特性来自显示的库时,比较 → Configuration ▾会按基线所记录的库发布(而不是现在所用的发布)进行解析,因此随较新发布而离开配置的条目会显示为一项更改。在基线开始记录库发布之前保存的基线会按现在所用的发布解析,页面会说明这一点。恢复基线不会改变项目所使用的库发布。

对于产品线,比较有两种选择:

  • Configuration ▾:比较一个配置所显示的内容。它会选择该配置最新的两个基线,或其最新基线和当前模型。
  • Compare with ▾:在 From 版本内比较两个配置,例如“What differs between CFG-2 and CFG-1 in EO-1 Flight PDR”(EO-1 Flight PDR 中 CFG-2 与 CFG-1 的差异)。

在配置视图中创建的项目基线仍会记录整个产品线。

变更请求

  • 变更请求页面有一张配置卡片:“Changes items in 2 of 4 configurations: CFG-2, CFG-3”(更改 4 个配置中 2 个的条目:CFG-2、CFG-3),带有按配置显示(每个配置中已更改的条目)。对基础值的更改不计入具有自有值的配置。
  • 差异将配置值命名为“Mass (CFG-2)”、“Description (CFG-2)”和“In CFG-2”,并列出“Applies To”和“Effectivity”的更改。
  • 所有者作为审批人:当已更改配置的所有者指定了一名项目成员时,该请求还需要此人的批准。规则行显示“CFG-2's owner (Lee) must approve: this request changes CFG-2.”(CFG-2 的所有者(Lee)必须审批:此请求更改了 CFG-2。),屏幕阅读器会朗读“Approval needed from Lee for CFG-2”。未指定项目成员的所有者不会添加规则。
  • 配置控制:开启变更控制后,已发布且位于最新基线中的配置受控。它在条目上的自有值只能通过变更请求更改(“… released, in the latest baseline”)。
  • 受控条目的适用范围:已批准或已纳入基线的条目的适用于、适用性,以及在配置视图中将其放入或移出某个配置,与其其他字段一样,只能通过变更请求更改。源受控的关系也是如此。在托管服务上,服务器还会检查离线所做的更改。
  • 库:已挂载的库发布中的特性和配置会在“适用于”、配置和视图中计入。它们是只读的。

模型检查

项目中一旦有 Feature 或 Configuration,验证 → 模型检查就会运行内置规则集产品线。

规则Heading严重程度
ProductLine.1“适用于”引用了不存在的特性或配置错误
ProductLine.2不属于任何配置的条目警告
ProductLine.3违反规则或不完整的配置错误
ProductLine.4没有任何配置选择的特性警告
ProductLine.5所在配置不包含其父条目的条目警告
ProductLine.6两端从不同时出现在同一配置中的关系警告
ProductLine.7序列号重叠的配置警告
ProductLine.8超出条目所属配置的适用性警告
ProductLine.9针对条目不属于的配置的值警告
ProductLine.10在某个配置中未验证的需求警告
ProductLine.11在某个配置中缺少一端的连接警告
ProductLine.13同时生效的修订版警告
ProductLine.14没有生效修订版的单元警告
ProductLine.15没有配置的测试结果警告
ProductLine.16其中有需求未验证的已发布配置错误
ProductLine.17从另一个配置复用的测试结果警告

完整性规则会在所有配置下检查每个配置,无需切换视图。ProductLine.10 会列出某条需求未在其中验证的配置,例如“Not verified in CFG-2, CFG-3 (Released)”。ProductLine.11 会列出配置和缺失的一端,例如“In CFG-2: A-11 Coolant pump is not in the configuration”。对于已发布的配置,ProductLine.3 显示“Released configuration.”,对于草稿则显示“It cannot be Released until this is fixed.”。ProductLine.16 列出已发布配置未验证的需求。

ProductLine.13 和 14 检查通过 supersedes 关联的修订版(参见条目的修订版):在两个重叠的修订版上各显示“Overlaps A-20B for SN 50–99 from 2027-06-01 until 2027-07-01”,在它们所分解的条目上显示“No revision in effect for SN 1–49 from 2027-07-01”。

ProductLine.15 列出在没有配置的情况下记录了状态的测试用例,以及该结果不计入的配置,例如“Passed without a configuration; does not count for CFG-2”。请在查看各个配置时再次运行该测试。

ProductLine.17 列出通过复用结果…使结果计入某个配置的测试用例,并附上理由,例如“CFG-2: Reused from CFG-1 by Ann Lee on 2026-10-28: same motor and cooler”。请审查该理由,或在查看该配置时运行测试以替换复用的结果。

对于 ProductLine.9,修复 → 移除值会列出这些值,例如“Mass (CFG-2): 1,520”,并将其移除,一次撤销即可全部撤回。

在 CubeSat EO-1 演示中,特性 Propulsion 是有意未被选择的:它是 ProductLine.4 的示例。

搜索、导入和导出

  • 搜索和查询:appliesto:CFG-2 查找适用于 CFG-2 的条目;varies:yes 查找具有配置值的条目。
  • JSON:保留每个字段。
  • CSV:项目一旦使用产品线,数据库导出会在其他列之后添加四列:适用于(按您输入的形式)、序列号适用性、生效起始和生效截止。导入读取相同的列标题(映射步骤:产品线组)。未知的特性或配置、错误的序列号范围或错误的日期会针对该行报告,并且不导入该字段。
  • ReqIF:“适用于”和适用性作为字符串属性;配置值不导出。
  • 导入文件中无效的“适用于”或适用性值不会导入。

REST API 和 MCP

  • list_configurations(MCP)和 GET …/configurations(REST)列出特性、规则以及配置及其判定结果。
  • 读取路由和 MCP 读取工具接受 configuration(编号、名称或 id)和 effectivity(sn:23 或 date:2027-03-01)。返回的是该配置的视图。不带这些参数时,条目带有 appliesTo、effectivity 及其配置 values。
  • 尚不支持:通过 API(run_model_checks、GET …/model-checks)运行模型检查中的产品线规则(ProductLine.1–9)。请在验证 → 模型检查中运行它们。
  • 写入接受 appliesTo 和 effectivity。带有 configuration 时,写入如同在该配置的视图中进行;以这种方式提出的 AI 客户端提议会显示“Apply in CFG-2: new items apply to CFG-2; changed values become CFG-2's.”

有关每个字段和消息,请参见 REST API:产品线。

方案

功能FreeIndividualTeam
通过 API 以单一配置读取项目✓✓✓
产品线页面、查看方式 ▾、适用于、配置值和适用性,只读✓✓✓
编辑产品线:特性、配置、选择、适用于、配置值、适用性、按配置的文档和 RVTM,通过 API 写入—✓✓
按配置的基线、按配置比较、变更请求所更改的配置、配置所有者——✓

由项目所有者的方案决定。学术邮箱地址或班级组织保留所有行。

没有该方案时,产品线为只读,且不会删除任何内容:

  • 产品线页面显示特性、配置、矩阵和判定结果。检查配置、导出 CSV 和列的以此配置查看可用。+ 新建特性、+ 新建配置、矩阵以及会更改内容的行和列命令均被禁用。页面显示“只读:编辑产品线属于 Individual 和 Team 方案。由项目所有者的方案决定。”,并带有选择方案…。
  • 查看方式 ▾以只读方式显示一个配置。横幅显示同样的说明。
  • 属性面板以只读方式显示适用于、适用性和配置值。Feature 和 Configuration 条目为只读。
  • ⌘K / Ctrl+K 中的新建特性…、新建配置…和开始产品线…仍会列出,并说明它们为何无法运行。
  • 导出保留每个字段。新的使用会被拒绝,并显示“产品线属于 Individual 和 Team 方案。由项目所有者的方案决定。”没有 Team 方案的配置所有者会看到:“配置所有者属于 Team 方案。由项目所有者的方案决定。”

SysML v2 项目

SysML v2 在语言中内置了可变性:变化点、变体和配置(@HolarchConfiguration 用法)。SysML v2 项目使用相同的产品线页面和查看方式 ▾控件:

  • 产品线页面:变化点树、带判定结果行的配置矩阵、规则(产品线的 assert 约束,只读,带在编辑器中打开)、插入变化点…(打开编辑器)、检查配置和+ 新建配置。选择一个变体会在配置中写入,例如 part :>> charger = charger::wallbox;。
  • 查看方式 ▾:列出每个产品线的配置及其判定结果。每个视图、数据库、属性面板和产品线页面都会跟随它。
  • 在 Free 方案上,产品线页面与 LML 项目中一样为只读:插入变化点…、+ 新建配置和矩阵中的选择均被禁用,浏览器、属性面板和 ⌘K / Ctrl+K 中的新建配置…会说明原因。模型的文本在编辑器中仍可编辑。
  • 在配置视图中编辑(Individual 和 Team;Free 上为只读):每次编辑都是一次经检查器检查的 SysML v2 文本编辑,一次撤销即可全部撤回。更改的属性成为该配置自己的值;新部件属于该配置;删除继承的可选元素会写入 part :>> roofBox[0];。
  • 模型旁边的 Holarch 数据(例如风险和任务)适用于每个配置,但在显示某个配置时创建的条目除外:它们适用于该配置。在 SysML v2 项目中尚无法编辑它们的“适用于”。适用性在模型元素和配置上设置(属性面板的适用性部分)。
  • 尚不支持:对 LML 项目执行创建 SysML v2 副本…时不包含其特性和配置(报告将它们列在未转换下)。请在副本中重新对变体建模。

参见 SysML v2 变体和配置。

限制

  • 适用于:最多 2,000 个字符、200 个项和 32 层括号。
  • 序列号:最多 200 个范围,数字最大为 1,000,000,000,000。
  • 名称、编号、类、标签、负责人和结构不能因配置而不同。
  • 每个结构(父条目和顺序)由所有配置共享。尚不支持:每个配置各自的结构。
  • ReqIF 导出不包含配置值。
  • 尚不支持:项目序列号前缀,以及在关系面板中为关系设置“适用于”。
  • 尚不支持:区分审批、生效、实际构建和改装日期的适用性。适用性是一个序列号范围列表和一个构建日期范围。
  • 尚不支持:将配置基线作为已发布的定义。它记录的是以该配置标记的产品线,而不是将配置的判定结果、选择和审批作为单独的记录。
  • 尚不支持:在创建 LML 项目的 SysML v2 副本时转换特性和配置。
  • 表达式不包含序列号或日期;这些请使用适用性。