S1000D 适用性 ACT、PCT、CCT 与产品构型过滤怎么做?
S1000D 适用性用于回答“这段内容适用于哪个产品、型号、批次或配置”。ACT、PCT、CCT、产品属性和条件逻辑共同把源数据映射到目标构型,帮助同一套数据模块生成不同设备的正确手册。适用性过滤不是简单的标签搜索,必须和配置管理、引用关系、PM 目录以及发布验收一起验证。
适用性解决什么问题?
同一型号系列往往包含基础配置、选装设备、不同批次和改型。若把每个构型都维护成一整本独立手册,内容重复、变更同步和版本追踪都会变得困难。S1000D 适用性把“内容对象”和“产品条件”分开管理:共享内容可以复用,有差异的部分通过条件表达,发布时再按目标构型筛选。
| 问题 | 适用性提供的思路 | 需要配合的管理对象 |
|---|---|---|
| 同一任务适用于多个配置 | 保留一个可复用内容源,用产品属性和条件声明适用范围。 | 产品特性代码、DMRL、版本和配置基线。 |
| 选装设备改变维修步骤 | 把差异步骤或工具拆成清晰分支,避免读者看到不适用内容。 | PM 目录、引用关系、程序和安全审核。 |
| 不同批次使用不同部件 | 用批次、序列范围或配置条件筛选对应模块和媒体。 | 配置管理数据、供应商信息、ICN 和零件表。 |
| 一个源数据生成多种手册 | 为每个目标构型定义筛选条件,生成可复现的交付结果。 | 构型测试矩阵、发布参数、验收记录。 |
ACT、PCT、CCT 如何配合?
在 S1000D 项目中,ACT、PCT、CCT 常被用来讨论适用性条件、产品特性和条件组合。不同 Issue、Schema、Data Dictionary 和项目 BREX 对元素名称、层级和编码方式可能有差异,因此以下是工作层面的理解,不应当直接当成某个版本的 XML 模板。
| 概念 | 工作层面的含义 | 实施时要确认 |
|---|---|---|
| ACT(Applicability Condition Type) | 描述适用性条件的类型或条件语义,例如按产品特性、范围或状态筛选内容。 | 正式名称、允许值、作用域、继承关系和与项目代码表的映射。 |
| PCT(Product Characteristic Type) | 描述产品特性条件,例如型号、选装项、批次、序列范围或设备状态。 | 特性代码来源、取值格式、配置基线和变更责任人。 |
| CCT(Condition Combination Type) | 描述多个条件如何组合,例如 AND、OR、NOT 或互斥关系。 | 逻辑优先级、空值处理、冲突组合和工具执行方式。 |
applic、assert、condition | 在对象或内容附近表达适用性声明、断言和组合条件。 | 元素版本、对象路径、条件作用域和发布时的继承规则。 |
工程上最重要的不是记住缩写,而是建立“产品特性代码 → 条件表达式 → 内容对象或 PM 节点 → 目标构型”的可追溯链路。若工具支持多种表达方式,应在项目规则中指定唯一的建模方法,避免作者各自解释。
产品属性、条件和构型如何建模?
建议先建立稳定的产品特性词汇,再把产品配置映射为可测试的条件。产品属性应该来自配置管理或型号数据,而不是由每位作者临时发明。条件表达式要能说明“满足什么条件时显示哪些内容”,并且可以在发布前用真值组合复现。
| 建模层 | 示例 | 常见风险 |
|---|---|---|
| 产品特性 | ENGINE=E2、PUMP=P3、LOT=2026A | 代码重名、大小写不一致、来源系统没有唯一负责人。 |
| 条件表达式 | ENGINE=E2 AND PUMP=P3 | 运算优先级不清、括号遗漏、空值被错误地当成满足条件。 |
| 内容作用域 | 一个程序步骤、警告、图形、DMRef 或 PM 节点。 | 条件挂载位置不明确,导致正文显示与目录筛选不一致。 |
| 目标构型 | 基础型、E2+P3 选装型、2026A 批次。 | 构型没有冻结版本,测试时无法复现筛选结果。 |
一个维修任务的构型过滤示例
假设同一设备有 E1、E2 两种发动机,液压泵 P3 只安装在 E2 的部分批次。更换液压泵的通用准备步骤可以复用,但拆卸工具、压力释放步骤和图形可能不同。项目可以把共享内容和差异内容分开管理,再用条件筛选目标构型。
| 内容对象 | 适用条件示例 | 发布时应看到的结果 |
|---|---|---|
| 通用安全准备 | 适用于设备系列 A 的全部构型。 | 所有 A 系列目标构型都包含该安全信息。 |
| E1 拆卸步骤 | ENGINE=E1 | E1 构型显示 E1 专用工具和步骤,不显示 E2 分支。 |
| E2+P3 拆卸步骤 | ENGINE=E2 AND PUMP=P3 | 只有同时满足 E2 与 P3 的构型显示该分支。 |
| 对应图形与零件表 | 与步骤采用相同或等价的构型条件。 | 图号、热点、零件号和步骤保持一致,不出现错配。 |
| PM 目录节点 | 按手册类型和目标构型配置目录。 | 筛选后没有空章节、重复章节或缺少必要引用。 |
上例只说明建模思路,不代表某个具体项目的正式语法。正式实施前应把条件写成项目采用的 ACT/PCT/CCT 模型和工具可执行规则,并用正例、反例和边界构型测试。
从产品配置到交付手册的实施流程
- 确定配置范围:列出型号、批次、选装项、序列范围、设备状态和需要交付的手册类型。
- 建立特性代码:登记产品属性、允许值、来源系统、版本和责任人,避免同义代码并存。
- 定义适用性模型:明确 ACT、PCT、CCT 的版本语义、条件组合、继承规则和空值处理。
- 绑定内容对象:将条件绑定到数据模块、程序步骤、警告、图形、DMRef 或 PM 节点,并记录作用域。
- 配置代表性构型:准备基础、选装、改型、批次边界和互斥组合等测试构型。
- 执行筛选与完整性校验:逐个构型检查目录、模块、引用、媒体、术语、警告和适用性结果。
- 生成并验收交付物:固定发布参数和源版本,抽检 PDF、IETP、Word 或交互阅读结果。
- 变更后回归测试:产品配置、规则或模块变化后,重新评估影响范围并复跑相关构型。
产品构型过滤检查清单
| 检查项 | 完成标准 | 责任角色 |
|---|---|---|
| 版本基线 | Issue、Schema、Data Dictionary、BREX、产品特性代码表和配置基线已登记。 | 项目负责人、配置管理员 |
| 条件语义 | ACT/PCT/CCT 的正式定义、逻辑优先级、空值和继承规则有项目说明。 | 标准工程师、工具管理员 |
| 特性代码 | 每个产品属性有唯一代码、允许值、来源和变更责任人。 | 系统工程师、配置管理员 |
| 对象作用域 | 模块、步骤、警告、媒体和 PM 节点的适用性作用域清楚且无意外继承。 | 数据模块编写人员、审核人员 |
| 构型覆盖 | 基础型、选装项、改型、批次边界和互斥组合都有代表性测试样例。 | 系统工程师、验收人员 |
| 内容完整性 | 筛选后的目录、引用、图形、零件号、警告和步骤均齐全,没有空节点或错配。 | 内容管理员、技术专家 |
| 结果可复现 | 保留构型输入、规则版本、源数据版本、发布参数和筛选报告。 | 配置管理员、发布人员 |
常见错误和处理方式
| 问题 | 可能原因 | 处理建议 |
|---|---|---|
| 筛选后内容为空 | 条件代码不存在、值拼写不一致、作用域或继承配置错误。 | 从产品属性到目标对象逐层追踪,补充规则和边界测试。 |
| 错误内容同时显示 | 条件表达式过宽、OR/AND 优先级误解或互斥关系未建模。 | 用真值表重写条件,明确括号和冲突处理。 |
| 目录有章节但正文缺失 | PM 节点与 DMRef 的适用性不一致,或引用模块被过滤掉。 | 对目录、引用对象和目标构型做端到端检查。 |
| 图形或零件号错配 | 媒体条件与步骤条件不同步,ICN 或零件表未纳入筛选。 | 建立图文与零件对象的共同测试样例并检查发布包。 |
| 同一构型每次结果不同 | 配置基线、规则版本或源数据状态未冻结。 | 固定输入版本,记录发布参数并保留筛选报告。 |
常见问题
ACT、PCT 和 CCT 分别是什么?
它们是 S1000D 适用性模型中常见的条件概念:ACT 通常表示适用性条件,PCT 表示产品特性条件,CCT 表示条件组合。实际元素、属性和编码方式必须以采用的 Issue、Data Dictionary、Schema 和项目规则为准。
适用性是写在数据模块里还是只写在 PM 里?
适用性可以作用于数据模块、出版物目录或具体内容对象,取决于项目模型和交付要求。应先定义作用域、继承关系和筛选规则,再统一配置,不能默认只放在 PM 或只放在数据模块里。
同一条维修步骤如何适用于多个产品构型?
应把共享步骤放在可复用的数据模块中,用产品属性和条件逻辑表达适用构型;对步骤、工具或安全信息存在差异的部分,拆分为明确的适用性分支,并用代表性构型进行筛选验证。
适用性筛选后目录出现空章节怎么办?
先检查 PM 引用、模块适用性、条件组合和目标构型是否一致,再决定隐藏空节点、补充替代模块或修订目录。空章节不能只靠发布模板掩盖,应留下处理记录并重新做完整性检查。
只测试一个标准型号可以证明适用性正确吗?
不能。至少应覆盖基础构型、选装项、不同批次或改型、条件边界和互斥组合,并比较每个构型的目录、模块、媒体、警告和交付结果。
VizMan 与适用性发布
VizMan IETM 面向 S1000D Issue 5.0 与 GJB 6600 场景,提供结构化内容编辑、适用性管理、规则校验、多格式发布和交互阅读能力。具体项目仍需根据合同、产品配置管理系统、业务规则和交付环境确认 ACT/PCT/CCT 的版本与实现范围。