交互式電子技術手冊結構化數據適用性研究

王剛

引言

飛機在生產線制造完成時便具有確定的構型。在交付和使用階段，由于用戶需求、技術改進改型等因素，會產生構型差異和使用維護條件的差異。飛機技術出版物內容必須與所描述飛機的實物構型保持一致，因此，向不同用戶交付的技術出版物由于構型差異，內容也會存在差異。通常，影響技術出版物內容產生差異的主要因素有型號、序列號、設備改型號、服務通告、維護作業位置（如航線、機庫、車間），用戶的經驗級別等。

飛機技術出版物需包含所有不同構型的技術內容，在向用戶交付時，只交付包含該用戶所持有的適用飛機的內容。因此在技術出版物中引入了適用性的概念，在技術出版物中定義數據內容的適用范圍。

適用性概述

采用S1000D規范制作交互式電子技術手冊，數據模塊及其內容片段對應飛機不同的構型。適用性的目的是通過在出版物內容中標注適用性，應用軟件系統或程序可將滿足條件的技術內容過濾并提取出來，以滿足特定用戶、特定飛機產品、特定技術條件和環境下的飛機使用維護需要。

適用性（Applicability）提供了識別數據模塊或數據模塊的內容片段是否有效的機制。數據模塊通常與產品的物理構型相關，但也可能涵蓋如工具可用性、環境條件等其他方面的信息。適用性的應用范圍跨度很廣，從一個數據模塊某處的一個簡單聲明到管理生命周期的適用性，包括產品定義、適用性編寫和產品實例構型跟蹤等。

適用性規則

適用性機制

在S1000D規范中定義了技術出版物適用性的機制，主要包括：適用性聲明（Applicability Declaration）、適用性注釋（Applicability Annotation）、適用性過濾（Applicability Filtered view）。

適用性聲明

為了對技術出版物中應用的適用性信息進行生命周期管理，定義三類特定的適用性數據模塊，分別是：產品屬性交叉引用表數據模塊（Applicability Cross-reference Table Data Module，ACT DM），定義了影響技術出版物內容適用性的產品屬性，如型號、批次、序列號、零件號（選型）等，產品屬性一般為產品的“不可變信息”;條件交叉引用表數據模塊（Conditions Cross-reference Table Data Module，CCT DM），定義影響技術出版物內容適用性的各類條件，如氣象條件、服務通告等;產品交叉引用表數據模塊（Products Cross-reference Table Data Module，PCT DM），定義了產品實例信息庫，每個產品實例都包含了若干ACT和CCT中定義的產品屬性和條件。

適用性數據模塊

ACT、CCT、PCT三類數據模塊用于對適用性信息進行定義、管理及被DM引用，在出版物編寫和管理階段應用。

ACT數據模塊

ACT數據模塊用于聲明對數據適用性產生影響的產品屬性。產品屬性在產品的設計生產階段確定，且在全壽命周期內通常不會改變，例如，型號（model）。

ACT數據模塊是對適用性定義的參考中心點，提供了對一個CCT和一個PCT的數據模塊的參引，所有需要適用性過濾的數據模塊（DM）、出版物模塊（PM）內容，必須在其標識和狀態段參引一個ACT數據模塊。

通過ACT數據模塊與CCT DM、PCT DM的結合，可實現利用ACT數據模塊訪問所有適用性定義及產品實例取值，實現適用性過濾。

ACT數據模塊包含下列部分：產品屬性的定義（元素<productAttributeList>）（必選）、對CCT數據模塊的參引（元素<condCrossRefTableRef>）（可選）、對PCT數據模塊的參引（元素<product-CrossRefTableRef>）（可選）。

ACT數據模塊的頂層結構圖如圖1所示。

產品屬性可根據特定需求定義，可以定義多個產品屬性信息，如下表所示。

CCT數據模塊

CCT數據模塊用于聲明影響數據適用性的條件。條件可以是技術性、操作性、環境性或任何其他類型的影響數據適用性的條件，CCT DM允許任何條件創建。

技術條件通常與產品的物理構型相關，例如服務通告、工程指令和改型。技術條件的狀態在產品實例的服務生命周期可以變更，技術條件應隨產品實例跟蹤。

操作條件與產品操作或維護時的條件相關。這些條件通常不作為產品構型的組成部分且不需跟蹤。操作條件有受規章影響的ETOPS要求等;維護條件有可用工具、內部或外部電源以及維修位置（戶內或戶外）等。

環境條件與維護時或維護前操作期間的環境條件相關，例如溫度、風速、是否有雨、風沙情況等。

其他條件不限定。條件可以與技術文檔可用性信息相關。例如，當培訓和技術數據更加綜合化時，根據執行維護的人員的資質和訓練記錄創建條件，并且技術數據可以根據人員資質進行剪裁。

在CCT DM中，首先定義一個常用條件類型，然后為該類型條件定義一個具體的條件。CCT DM允許定義多個類型的條件。每一條件類型包含若干具體條件。

CCT數據模塊分為三個部分：條件常用類型的定義（元素<condTypeList>）、特定條件的定義（元素<condList>）、技術條件合并狀態清單（元素<incorpor-ation>）。

CCT數據模塊的頂層結構圖如圖2所示。

條件類型如服務通告，可根據需求定義具體的條件。

PCT數據模塊

PCT數據模塊是定義產品實例的數據存儲庫，并指定每個產品實例對應的產品屬性值和條件取值。PCT數據模塊中，對產品實例的定義包括一系列產品屬性和條件的實際取值。每部分取值必須包含以下三部分信息（在元素<productCrossRefTable>＼<<product>＼<assign>中）：

對產品屬性或條件的參引，屬性“app-licPropertyIdent”，來自ACT和CCT中的屬性ID，如：“model”。產品屬性或條件的標識，屬性“applicPropertyType”，“prodattr”表示產品屬性，“condition”表示條件。實際取值：屬性“applicProper-tyValue”，來自ACT或CCT。

PCT數據模塊的頂層結構圖如圖3所示。

PCT DM內容組合的示例：

表示：

XXX型號，序列號為045，MSN為0705，執行XXX-32-SB070后;

XXX型號，序列號為039，MSN為0610，執行XXX-32-SB120前。

三類適用性數據模塊之間的關系

ACT、CCT、PCT三類數據模塊是以ACT為中心點實現三者的關聯，可以確保引用的適用性準確、規范。所有需要適用性過濾的數據模塊、發布模塊都必須通過標識和狀態段參引ACT數據模塊，參引關系如圖4所示。

DM和PM參引ACT DM：

所有需要進行適用性過濾的DM和PM必須通過標識和狀態段的<applicCross-RefTableRef>參引到同一ACT數據模塊。從數據模塊到ACT的單向參引，ACT與CCT間的雙向參引，ACT與PCT間的雙向參引，如圖5所示。

飛機技術出版物適用性注釋規則

飛機技術出版物適用性注釋的對象

在出版物內容中須標注適用性的對象包括：數據模塊（DM），包括整個DM級別的適用性和DM中局部內容的適用性;技術插圖，某幅插圖的適用性;出版物模塊（PM），發布的PM適用性，主要指PM適用的客戶、飛機架次等。

在數據模塊中適用性注釋級別的原則：根據出版物使用對象設置適用性。確保數據唯一性，盡量在較低的內容級別標注適用性。如，某維修程序中僅某個步驟有適用性差異，那么適用性應標注在該步驟，而非整個DM，以避免重復性信息。

在數據模塊中，適用性注釋應用于以下兩個級別：整個DM級別，標識和狀態段的<applic>;DM中的部分內容，標識和狀態段的<referencedApplicGroup>＼<applic>。

適用性在數據模塊中的表述方法

（1）數據模塊級別的適用性標注

在標識和狀態段中直接定義<applic>元素時，指示整個數據模塊的適用性。表示方法為：

<applic>

<displayText>Model XXX </displayText>

<assert applicPropertyIdent=”model” applicPropertyType=”prodattr”? applicPropertyValues=”XXX” />

</applic>

（2）數據模塊內容的適用性標注

在標識和狀態段的<referencedApplic-Group>中定義<applic>時，指示數據模塊內部局部內容的適用性。在數據模塊內部需要指明部分內容的適用性時，應當使用內容元素的applicRefId屬性，引用到<referencedApplicGroup>中的某個<applic>上。表示方法為：

在<referencedApplicGroup>定義適用性表達式：

<referencedApplicGroup>

<applic id=”app-001”>

<displayText> Model XXX</displayText>

<assert? ? applicPropertyIdent=”model”

applicPropertyType=”prodattr”

applicPropertyValues=”XXX” />

</applic>

<applic id=”app-002”>

<displayText>ModelXXX0</displayText>

<assertapplicPropertyIdent=”model”

applicPropertyType=”prodattr”

applicPropertyValues=”XXX” />

</applic>

</referencedApplicGroup>

在內容中引用所需的適用性表達式：

<mainProcedure>

<proceduralStep applicRefId=”appl-001”>

<title>Title</title>

<para>para1</para>

</proceduralStep>

<proceduralStep applicRefId=”appl-002”>

<title>Title</title>

<para>para2</para>

</proceduralStep>

</mainProcedure>

（3）數據模塊中適用性注釋方法

①適用性元素<applic>的注釋方法

在創建一個數據模塊時，應根據源數據要求在數據模塊的元素<applic>中編寫適用性注釋。當源數據出現變化引起數據模塊的適用性變化時，元素<applic>應相應更新。

適用性元素<applic>提供了兩種適用性注釋方法（即兩個分支）：可閱讀的注釋（human readable）分支、可計算的注釋（computer processing）分支。

可閱讀注釋（自然語言）提供了可讀適用性說明，由<displayText>表示?？砷喿x適用性注釋用于紙質出版物以及內容的靜態展示。通過這種方式，用戶可查看所有技術信息，并自行閱讀各類適用性注釋并決定其所需內容。這一方式無需適用性模型（即ACT、CCT和PCT數據模塊），無須支持客戶化發布，對適用性注釋的計算機處理部分也不作要求。

示例：

<applic>

<displayText>

<simplePara>適用于XXX</simplePara>

</displayText>

可計算的注釋為計算機處理提供了可計算格式的適用性注釋，由<assert>或<evaluate>表示。適用性注釋的計算機處理用于支持過濾后展示或客戶化發布。適用性注釋仍須以自然語言形式展示給終端用戶。

示例：

<applic>

<displayText><simplePara>SN： 001-002， 005-010 simplePara></displayText>

<evaluate andOr=”or”>

<assert applicPropertyIdent=”serialno”

applicPropertyType=”prodattr”

applicPropertyValues=”001～002|005～010”/>

</evaluate>

</applic>

②出版物模塊與插圖的適用性

（1）出版物模塊的適用性

適用性包括出版物模塊適用的：客戶（運營人）、飛機型號、序列號、MSN和國籍登記號等。這些適用性信息來自于ACT（及ACT 對CCT 和PCT 的引用）。PM 實質也是DM，因此在PM 的標識和狀態段需引用ACT、CCT、PCT DM，且在<applic>元素中標注。

（2）插圖的適用性

插圖的適用性與DM 類似，包括產品屬性、條件屬性，但不需要PCT，只被DM 引用，ACT、CCT 定義的適用性信息對插圖同樣適用。

適用性過濾

適用性過濾需采用信息系統實現，系統應支持基于適用性信息進行技術內容的過濾，即將滿足適用性要求的數據模塊從眾多的數據模塊中挑選出來，同時將數據模塊中符合要求的信息保留，將不符合適用性要求的內容過濾掉。

信息系統中的適用性過濾條件應僅限于ACT數據模塊中定義的適用性信息，以及ACT數據模塊中引用的PCT/CCT數據模塊中定義的適用性信息。通過系統處理，ACT、CCT、PCT模塊的適用性信息可以在系統中列出，供定義適用性過濾條件時進行選擇。

根據ACT、CCT、PCT數據模塊的適用性定義，系統對輸入的適用性過濾條件進行檢查，確保過濾條件符合預先設置和要求。選擇的各項過濾條件將組合在一起作為系統適用性計算的輸入。

在系統中，可以進行適用性計算，將輸入的適用性過濾條件與數據模塊中的適用性聲明進行匹配，以確定數據模塊的適用性是否符合客戶化需要，對數據模塊的適用性處理結果為“true”或“false”，系統將結果為“false”的數據模塊或數據模塊內容過濾掉。

適用性管理

適用性信息來源于工程源數據，即構型數據，經由技術出版物呈現。工程定義的構型信息須由技術出版物適用性模型展現，其適用性模型通過S1000D適用性聲明來應用。

產品屬性一旦在ACT中創建，將不需要對其再進行補充。隨著時間的推移，一旦飛機型號、版本及序列號等發生變更，需要對ACT加以更新。

產品特性一旦在CCT中創建，將不需要對其再進行補充。隨著時間的推移，由于服務通告、改型、工程指令等產生新的或發生構型變更，則須更新CCT數據模塊。

當出現新的產品實例，則須對PCT數據模塊進行更新。

結語

對數據模塊內容適用性的注釋是制作數據模塊的重要環節，提供了適用性管理的技術方法，是適用性相關的信息系統功能要求、適用性計算機過濾、適用性信息處理、客戶化技術出版物發布的基礎。

參考文獻：

[1]S1000D：國防工業技術出版物的國際規范[J].艦船科學技術，2008，30（06）：11-14.

[2]GJB3968A-2012.軍用飛機用戶技術資料通用要求[S].北京：國家人民解放軍總裝備部，2012.