控制与评审
产品线和配置
使用特性和配置在一个项目中对多个产品建模,用 Applies To 和适用性说明哪些条目适用于哪些产品,以单一配置查看和编辑模型,并按配置生成文档、RVTM 和基线。
本页内容
概述
产品线是共享大部分同一设计的一系列产品。对共享设计只建模一次,标出各产品的不同之处,并将每个产品定义为一个配置。这样每个页面都可以按一个配置显示模型,而对共享设计的每次更改都会传递到每个产品。
您在以下位置使用产品线:
- 控制与评审 → 产品线:特性、特性规则以及由特性构建的配置。
- 属性面板的产品线组:所选条目的适用于和适用性。
- 顶栏中的查看方式 ▾:以一个配置显示和编辑模型。
- 文档、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”。已退役的配置不检查。完整性忽略适用性:当条目适用于某个配置时,它就属于该配置。
各阶段的完整性
配置的阶段决定检查的范围。每个阶段使用五个级别之一:
| 级别 | 默认阶段 | 检查 |
|---|---|---|
| 1 | Concept | 每个条目的父项都在配置中。 |
| 2 | Preliminary design | 级别 1,并且每个连接的两端都在其中,每条叶需求都由其中的某个条目满足。 |
| 3 | 详细设计 | 级别 2,并且每条叶需求都由其中的某个条目验证。 |
| 4 | 测试 | 级别 3,并且每个进行验证的测试用例都有规程(描述或测试步骤)和针对此配置的结果。 |
| 5 | Production | 级别 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 和基线。
推荐的工作顺序:
- 照常对共享设计建模。
- 将各产品不同之处列为特性,并附上其规则。
- 每个产品添加一个配置,并检查每个配置是否有效。
- 用“适用于”标记只有部分产品才有的条目,用配置值标记不同的值。
- 生成文档并验证每个配置。
如果您的产品之间只有制造日期或序列号不同,请创建单个配置(例如“Production”),并只使用适用性。
开始产品线
- 按 ⌘K / Ctrl+K 并选择开始产品线…:它会打开该页面和New Feature对话框。或者在数据库中用+ 新建条目创建一个特性或配置条目。导航栏中会出现控制与评审 → 产品线,每个条目的属性面板中会出现产品线组。
- 在产品线页面上,点击+ 新建特性并输入特性的名称,例如“Downlink”。按 Enter。名称即被保存,并开始一个新的同级行。
- 输入下一个特性的名称。若要使其成为上一行的子项,请按 ⌥⇧→ / Alt+Shift+→。⌥⇧← / Alt+Shift+← 将其移回外层。
- 在属性面板中设置每个特性的种类和子级(在其行上按 Enter)。
- 从该行的 ⋯ 菜单添加规则:规则…用于“需要”和“排除”,约束…用于约束。
在项目有第一个特性或配置之前,产品线页面、属性面板中的该组以及“适用于”列都是隐藏的。删除最后一个特性或配置后它们会再次隐藏,但仍持有“适用于”或适用性值的条目除外。
创建配置
- 在产品线页面上,点击+ 新建配置。输入名称,例如“EO-1 Lite”。配置中会出现一个新列。
- 勾选此产品具有的特性。对于 Choose one 组,单元格是单选按钮:选择一个会替换另一个。标记为隐含的单元格是因另一个特性(父特性或 Mandatory 子特性)而包含的;它们无法更改。
- 阅读列下方的判定行。修正选择,直到显示有效。
- 阅读完整性行。指向缺口数可查看各个缺口。
- 点击检查配置可一次检查所有配置。
若要从现有产品开始,请打开该配置列标题的 ⋯ 菜单并选择复制。副本具有相同的选择和相同的配置值。
说明哪些条目属于哪些产品
- 选择一个条目(例如需求),并打开属性面板的产品线组。
- 在适用于中,输入特性或配置编号,例如
F-4。用 ↓ 和 Enter 从建议列表中选择。字段下方的行会显示,例如“Applies to 1 of 2 configurations: CFG-1”(适用于 2 个配置中的 1 个:CFG-1)。 - 用
and、or、not和括号组合各项:F-3 and not F-5。 - 或者点击选择…,从列表中选择配置或特性。
对于每个产品都有的条目,请将“适用于”留空。大多数条目都保持为空。
查看和编辑一个配置
- 点击顶栏中的 查看方式 ▾ 并选择一个配置。您会看到一个横幅:“正在查看配置 CFG-2 EO-1 Lite。新条目仅适用于 CFG-2;更改的值归 CFG-2 所有。”现在每个页面都只显示 CFG-2 的条目,并带有 CFG-2 的值。
- 照常工作。新条目适用于 CFG-2。当其他配置也有该条目时,更改的描述或属性会成为 CFG-2 的自有值。
- 点击横幅中的离开,可再次查看所有配置。
该选择属于浏览器标签页。其他人和其他标签页保留各自的视图。有关每条规则,参见在配置视图中编辑。
为配置指定自有值
- 在 查看方式 ▾ 中选择配置。
- 选择条目并在属性面板中更改属性。编辑时,字段下方的提示会显示,例如“仅为 CFG-2 保存。其他配置保留 3 GB。”更改后,字段会显示 CFG-2 value 标签。
- 若要撤销该差异,请打开该标签的菜单并选择 使用基础值。
为一个配置生成规格说明
- 打开文档,点击交付 ▾并选择一个 Word 模板,例如 Specification (Word)。您会看到导出到 Word对话框。
- 将配置设为该产品,将适用性设为 Any unit、序列号或日期。
- 导出文档。文档会省略不适用的章节,按显示的方式为其余章节编号,并在标题页、页脚和文件名中注明该配置。
实例:CubeSat EO-1 演示
CubeSat EO-1 演示项目有两个产品:EO-1 Flight,带有 X 波段下行链路和加密;以及 EO-1 Lite,带有 S 波段下行链路。在“Manage Projects”中用 Project Files ▾ → New Demo Project 创建演示项目。
- 打开控制与评审 → 产品线。您会看到特性 Downlink(Mandatory,Choose one),其下有 S-band Downlink 和 X-band Downlink;Encrypted Downlink(Optional,需要 X-band Downlink);以及 Propulsion(Optional,需要 X-band Downlink)。
- 查看配置 CFG-1 EO-1 Flight(X-band 和 Encrypted Downlink,序列号 1–2)和 CFG-2 EO-1 Lite(S-band,序列号 3 及以后)。两者的判定都显示有效。
- 在 CFG-2 列中,勾选 Encrypted Downlink。判定变为“Breaks: Encrypted Downlink requires X-band Downlink.”(违反:Encrypted Downlink 需要 X-band Downlink。)按 ⌘Z / Ctrl+Z。
- 打开需求 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。
- 选择 查看方式 ▾ → CFG-2 EO-1 Lite,并打开需求 5.4 Daily Data Volume。其描述为“at least 1 GB”,并带有 CFG-2 value 标签。在 EO-1 Flight 中,它保留基础文本“at least 3 GB”。
- 打开测试用例 TC-11 UHF Command Test。它每个配置有一个结果:在 EO-1 Flight 中为 Passed,在 EO-1 Lite 中为 In Progress。
- 打开 1.3.2 Battery Pack,查看其特性参数 Thermostat Heater Power(2 W,适用性 SN 1)和 Software-Controlled Heater Power(3 W,SN 2 及以后):加热器从第二个航天器起发生了更改。
- 打开控制与评审 → 基线和版本。EO-1 Flight PDR 是 CFG-1 的基线(Team 方案)。
- 在“所有配置”中打开验证 → 模型检查。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 之类编号的项目序列号前缀。
配置的适用性指明按该配置制造的单元。它不会筛选该配置的条目。
按序列号或日期查看
- 选择查看方式 ▾ → 适用性 ▸ → 序列号…(或日期…,或序列号和日期…),或 ⌘K / Ctrl+K 设置适用性…。
- 输入序列号、制造日期或两者。横幅会加上该时点:“正在查看 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 方案。由项目所有者的方案决定。)
按配置创建基线
- 打开控制与评审 → 基线和版本。
- 点击为配置创建基线…。查看某个配置时,按钮显示为基线 CFG-2…,并跳过选择。
- 选择配置并输入名称(初始为“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:产品线。
方案
| 功能 | Free | Individual | Team |
|---|---|---|---|
| 通过 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 副本时转换特性和配置。
- 表达式不包含序列号或日期;这些请使用适用性。