论文部分内容阅读
摘要：正常情况下查阅AMM手册，通过超链接可以很快跳转至相关联的AMM手册中其他章节或其他手册内容，偶尔会遇到超链接失效的情况。本文就如何举一反三查找同类失效超链接及其处理进行探讨。
关键词：超链接；SGML文件；数据提取
Keywords：hyperlink；SGML file；data extraction
在维修手册管理及电子签工卡编辑过程中常见的超链接问题有三种：第一种是被指向的章节存在，需要手动按章节查找，仅影响查阅速度，勉强可以接受；第二种是指向错误，误导查阅方向，需要尽快修订；第三种是链接章节不存在，会导致维修工作实施的中断，需要立即更正。
1 超链接分类
依据目标是否为AMM手册内容，可将超链接分成两类：内部超链接和外部超链接，其说明如表1所示。
2 案例分析
2.1 第一种超链接问题
1）问题描述
该问题表现为被指向的章节存在，需要手动按章节目录查找。AMM手册中有些ESPM超链接可以跳转，以打开对应的ESPM章节（见图1），有些则仅跳转至ESPM目录（见图2），需要手动按章节查找。
2）问题分析
查阅图1和图2中两个外部超链接对應的AMM的SGML文件内容，图1中参考ESPM20-56-00链接的REFLOC为六位数，图2中参考ESPM20-42-21链接的REFLOC为七位数，末尾数为0。
通过Python软件进行数据搜索、提取和整理后发现，在整本AMM中共有 56个ESPM章节被调用。元素REFEXT的子元素REFLOC为六位数的ESPM的超链接有18个；REFLOC为七位数的ESPM超链接有38个，尾数皆为0。
经过一一核对，在Airnav X系统中，REFEXT的子元素REFLOC为六位数的ESPM超链接不可跳转，REFLOC为七位数的ESPM超链接跳转正常。查阅AMM的SGML文件用户指南（第250页），参考上文提到的定义，REFLOC为六位数指向非特定供应商，故参考任一供应商均可接受，该处超链接问题仅影响查阅速度，不会对工作造成实际影响。如果REFLOC为七位数的ESPM超链接出现问题，将会产生实际工作中参考错误手册章节的风险。
3）解决方案
将出现该问题的所有超链接一次性发给空客，空客确认是Airnav X系统问题，将跟进处理。
2.2 第二种超链接问题
1）问题描述
该问题表现为指向错误，误导查阅方向。在我司2020年5月版AMM手册中有超链接PIPC但无法跳转到对应PIPC章节的情况，以图3中PIPC-CSN（71-13-11-15 ITEM 010） 为例，点击搜索不到结果。
2）问题分析
经过初步数据收集，发现该问题出现在71 7678 LEAP构型的三个AMM章节。
查阅AMM手册的SGML文件及SGML文件的用户指南（第199页）可知，对于超链接至PIPC中的消耗性航材，元素EXPD的EXPDTYPE值为ENG；对于超链接至IPC中的消耗性航材，元素EXPD的EXPDTYPE值为AFRM。
因此，该问题是由源数据中元素EXPD的类型属性EXPDTYPE值设置错误造成的。实际上PIPC手册不包含71、76和78这三个章节（见图4）。
由此推测该问题是由手册编辑人员没有意识到PIPC中没有这三个章节导致的。按照这个思路，通过对Python软件搜索71（76和78）得到的结果进行确认，这三个章节的AMM中所有消耗性航材超链接均有此问题。
3）解决方案
反馈空客后，空客陆续对有问题的TASK进行修正，如图5所示。
对于使用AMM手册SGML文件做结构化工卡编辑的维修单位而言，建议在与系统开发人员沟通确认可操作后，将整本AMM手册SGML文件进行源数据字符替代，即把元素EXPD的类型属性值EXPDTYPE="ENG">71和EXPDTYPE="ENG">78替换成 EXPDTYPE="AFRM">71和EXPDTYPE="AFRM">78，通过纠正源数据错误来保证编辑的结构化工卡中超链接正确。
AMM手册ATA76（LEAP）中超链接错误已经过反馈得到修正。
2.3 第三种超链接问题
1）问题描述
该问题表现为链接章节不存在。从图6能够清晰看出，一份MPD项目对应的TASK的步骤参考TASK在202102版手册中已被删除，导致超链接失效，进而影响步骤施工，对于维修单位这种情况是不能接受的。
经空客确认，该问题为其误删所致。那么，AMM手册里还有没有其他被删除的TASK依然被以超链接的方式引用？
2）问题分析
前文定义介绍过，在SGML文件中AMM内部超链接均存在于REFBLOCK元素中，参考用户指南（第244页）样例，对比此处超链接源数据，可以看出缺少REFINT元素，多了改版元素（202102版手册中删除产生变化，系统自动添加改版元素）。
按照该条件使用Python进行数据搜索，可以得出相应的失效TASK超链接（见图7，其中的搜索结果有待去重处理）。
通过修改正则表达式，可以进一步找出之前改版造成的失效超链接。
2.1节和2.2节的搜索均可通过修改图7中的正则表达式实现。
3）解决方案
a. 被引用超链接在当前版本AMM手册中存在：元素REFBLOCK中无REFINT元素，该种情况补齐元素信息即可恢复跳转功能。
b. 被引用超链接在当前版本AMM手册中不存在。又分两种情况：
？该TASK内容不适用我司，如我司未选的构型。该失效链接对实际工作无影响，故可以接受。
？该TASK内容适用我司，失效链接将导致工作无法进行，不可接受，需立即反馈空客申请ADVANCE COPY。将AMM手册202011版中共300余失效内部超链接反馈给空客（TR 80856659）后，空客认为其中47个缺失的TASK（占总数的15%）影响了127个TASK使用。空客将陆续修正这些失效链接，计划到2021 11版手册发布时彻底处理完毕。
3 结束语
从参考用户指南对AMM手册SGML文件中元素的解读出发，将目标数据类型写成正则表达式，利用Python软件从整本SGML文件中查找提取所有目标数据，整理分析确认后反馈空客修订手册，消除失效超链接对手册查阅的影响。对于使用源数据进行结构化工卡编辑的维修单位而言，通过修订源数据，可以保障编辑的工卡正确。
参考资料
[1] Airbus. AMM手册[Z].
[2] Airbus. AMM的SGML文件用户指南[Z].
作者简介
李健军，从事空客飞机的维修手册系统管理及电子签工卡编写工作。
关键词：超链接；SGML文件；数据提取
Keywords：hyperlink；SGML file；data extraction
在维修手册管理及电子签工卡编辑过程中常见的超链接问题有三种：第一种是被指向的章节存在，需要手动按章节查找，仅影响查阅速度，勉强可以接受；第二种是指向错误，误导查阅方向，需要尽快修订；第三种是链接章节不存在，会导致维修工作实施的中断，需要立即更正。
1 超链接分类
依据目标是否为AMM手册内容，可将超链接分成两类：内部超链接和外部超链接，其说明如表1所示。
2 案例分析
2.1 第一种超链接问题
1）问题描述
该问题表现为被指向的章节存在，需要手动按章节目录查找。AMM手册中有些ESPM超链接可以跳转，以打开对应的ESPM章节（见图1），有些则仅跳转至ESPM目录（见图2），需要手动按章节查找。
2）问题分析
查阅图1和图2中两个外部超链接对應的AMM的SGML文件内容，图1中参考ESPM20-56-00链接的REFLOC为六位数，图2中参考ESPM20-42-21链接的REFLOC为七位数，末尾数为0。
通过Python软件进行数据搜索、提取和整理后发现，在整本AMM中共有 56个ESPM章节被调用。元素REFEXT的子元素REFLOC为六位数的ESPM的超链接有18个；REFLOC为七位数的ESPM超链接有38个，尾数皆为0。
经过一一核对，在Airnav X系统中，REFEXT的子元素REFLOC为六位数的ESPM超链接不可跳转，REFLOC为七位数的ESPM超链接跳转正常。查阅AMM的SGML文件用户指南（第250页），参考上文提到的定义，REFLOC为六位数指向非特定供应商，故参考任一供应商均可接受，该处超链接问题仅影响查阅速度，不会对工作造成实际影响。如果REFLOC为七位数的ESPM超链接出现问题，将会产生实际工作中参考错误手册章节的风险。
3）解决方案
将出现该问题的所有超链接一次性发给空客，空客确认是Airnav X系统问题，将跟进处理。
2.2 第二种超链接问题
1）问题描述
该问题表现为指向错误，误导查阅方向。在我司2020年5月版AMM手册中有超链接PIPC但无法跳转到对应PIPC章节的情况，以图3中PIPC-CSN（71-13-11-15 ITEM 010） 为例，点击搜索不到结果。
2）问题分析
经过初步数据收集，发现该问题出现在71 7678 LEAP构型的三个AMM章节。
查阅AMM手册的SGML文件及SGML文件的用户指南（第199页）可知，对于超链接至PIPC中的消耗性航材，元素EXPD的EXPDTYPE值为ENG；对于超链接至IPC中的消耗性航材，元素EXPD的EXPDTYPE值为AFRM。
因此，该问题是由源数据中元素EXPD的类型属性EXPDTYPE值设置错误造成的。实际上PIPC手册不包含71、76和78这三个章节（见图4）。
由此推测该问题是由手册编辑人员没有意识到PIPC中没有这三个章节导致的。按照这个思路，通过对Python软件搜索
3）解决方案
反馈空客后，空客陆续对有问题的TASK进行修正，如图5所示。
对于使用AMM手册SGML文件做结构化工卡编辑的维修单位而言，建议在与系统开发人员沟通确认可操作后，将整本AMM手册SGML文件进行源数据字符替代，即把元素EXPD的类型属性值EXPDTYPE="ENG">
AMM手册ATA76（LEAP）中超链接错误已经过反馈得到修正。
2.3 第三种超链接问题
1）问题描述
该问题表现为链接章节不存在。从图6能够清晰看出，一份MPD项目对应的TASK的步骤参考TASK在202102版手册中已被删除，导致超链接失效，进而影响步骤施工，对于维修单位这种情况是不能接受的。
经空客确认，该问题为其误删所致。那么，AMM手册里还有没有其他被删除的TASK依然被以超链接的方式引用？
2）问题分析
前文定义介绍过，在SGML文件中AMM内部超链接均存在于REFBLOCK元素中，参考用户指南（第244页）样例，对比此处超链接源数据，可以看出缺少REFINT元素，多了改版元素（202102版手册中删除产生变化，系统自动添加改版元素）。
按照该条件使用Python进行数据搜索，可以得出相应的失效TASK超链接（见图7，其中的搜索结果有待去重处理）。
通过修改正则表达式，可以进一步找出之前改版造成的失效超链接。
2.1节和2.2节的搜索均可通过修改图7中的正则表达式实现。
3）解决方案
a. 被引用超链接在当前版本AMM手册中存在：元素REFBLOCK中无REFINT元素，该种情况补齐元素信息即可恢复跳转功能。
b. 被引用超链接在当前版本AMM手册中不存在。又分两种情况：
？该TASK内容不适用我司，如我司未选的构型。该失效链接对实际工作无影响，故可以接受。
？该TASK内容适用我司，失效链接将导致工作无法进行，不可接受，需立即反馈空客申请ADVANCE COPY。将AMM手册202011版中共300余失效内部超链接反馈给空客（TR 80856659）后，空客认为其中47个缺失的TASK（占总数的15%）影响了127个TASK使用。空客将陆续修正这些失效链接，计划到2021 11版手册发布时彻底处理完毕。
3 结束语
从参考用户指南对AMM手册SGML文件中元素的解读出发，将目标数据类型写成正则表达式，利用Python软件从整本SGML文件中查找提取所有目标数据，整理分析确认后反馈空客修订手册，消除失效超链接对手册查阅的影响。对于使用源数据进行结构化工卡编辑的维修单位而言，通过修订源数据，可以保障编辑的工卡正确。
参考资料
[1] Airbus. AMM手册[Z].
[2] Airbus. AMM的SGML文件用户指南[Z].
作者简介
李健军，从事空客飞机的维修手册系统管理及电子签工卡编写工作。