GJB 6600.1-2008:总则导读
《装备交互式电子技术手册 第 1 部分:总则》先回答 IETM 应覆盖哪些功能、内容、界面和数据要求,再由后续分部细化编码、模式和数据字典。本文依据 2008 年版的目录与正文整理阅读路径。
第 1 部分在四个分部中处于什么位置?
总则适用于装备 IETM 的研制、使用和维护,规定功能、内容、样式、数据格式及管理信息等总体要求。阅读时可先用总则明确交付物和使用场景,再用第 2 部分核对 DMC 与 ICN 编码,用第 3 部分核对数据模块模式,最后用第 4 部分核对元素和属性定义。
| 目录章节 | 主要主题 | 项目中可提出的问题 |
|---|---|---|
| 第 4 章:一般要求 | 基本要求、功能、目录树、管理信息、安全保密、安装运行和包装。 | 用户如何进入、检索、使用和管理手册? |
| 第 5 章:内容要求 | 文本、图形、音频、视频和动画,以及警告、注意、注释与帮助信息。 | 不同媒体怎样表达同一项技术任务? |
| 第 6 章:样式要求 | 界面及其信息呈现。 | 阅读端的界面和提示能否让用户正确操作? |
| 第 7 章:数据要求 | 数据模块、结构、通用层、信息层、分类和更新。 | 内容怎样组织、引用、维护和更新? |
一般要求:从功能到运行管理
第 4 章将基本要求、功能要求、目录树、管理信息、安全保密、安装运行和包装分开讨论。这提示项目不能只验收编辑完成的页面,还要核对读者能否访问和导航、使用记录如何管理、信息怎样受控,以及目标环境中的安装与运行方式。
附录 A 列出 IETM 的基本功能和扩展功能。制定需求时,应把项目实际采用的功能逐项写入技术协议与验收方案;不要将扩展功能直接解释成所有项目的必备项。
内容要求:媒体与安全提示
第 5 章按文本、图形、音频、视频和动画组织内容要求,还单列警告、注意、注释和帮助信息。编制团队可据此建立内容检查表:文字是否清楚、图文是否对应、媒体是否可访问、警示是否出现在相关操作之前、帮助信息是否能在任务发生处被找到。
样式要求:阅读界面怎样承载内容
第 6 章集中讨论界面样式,包括界面结构及菜单、对话框、文本、图形和警示信息的呈现。项目验收可选一组典型任务,检查导航路径、字号与对比度、图文对应、警示可见性及不同屏幕尺寸下的阅读效果。
数据要求:哪些结构和标签需继续核对?
第 7 章给出数据组织的总体框架:数据模块及其结构、通用层、信息层、分类与更新。理解“模块身份与状态”和“具体技术信息”这两层,有助于把内容创作、审核、发布和变更记录连接起来。
总则不是全部 XML 元素或属性的清单。具体的数据模块编码和信息控制编码见GJB 6600.2 编码导读;元素如何组合见GJB 6600.3 模式导读;元素和属性的含义、格式与关系见GJB 6600.4 数据字典导读。需要查某个“标签”时,应先确定采用的分部、版本和项目模式基线,再查对应模式及数据字典。
把总则转成项目核对清单
- 范围:确定装备、读者角色、使用环境和要交付的手册类型。
- 功能:区分基本功能、项目选用的扩展功能及其验收样例。
- 内容:列出文本、图形、音视频和安全提示的编制与审核责任。
- 样式:用典型任务检查界面、导航、图文呈现和警示可见性。
- 数据:让模块结构、编码、模式、数据字典、引用和更新流程使用同一批准基线。
这份清单是实施建议,不等同于标准逐条符合性结论。项目还应结合正式标准文本和技术协议形成可验证的要求矩阵。
常见问题
GJB 6600.1-2008 总则主要规定什么?
第 1 部分从一般要求、内容要求、样式要求和数据要求四个方面说明装备交互式电子技术手册,并列有基本功能和扩展功能的附录。具体适用范围应按正式标准和项目文件核对。
总则中的扩展功能都必须实现吗?
不能把附录列出的扩展功能直接理解为每个项目的必备功能。应区分基本功能与扩展功能,并在项目需求、技术协议和验收方案中明确采用范围。
总则是否给出了全部数据模块标签的定义?
第 1 部分说明数据模块、结构、通用层和信息层等总体要求。具体编码、模式结构与元素定义还需分别核对 GJB 6600.2、GJB 6600.3 和 GJB 6600.4。