Technical Information 應用程式
Technical Information 概觀
您需要在可發行由 Service 應用程式建立之轉換 XML 文件的 Arbortext Publishing Engine 伺服器上,實行文件類型。範例 DITA 文件類型應用程式隨附於 Arbortext Editor and Publishing Engine,您可以使用它來作為起點,或分析它以決定您自己的文件類型的主要需求。
Technical Information 應用程式是特殊的 DITA 文件類型。它可組織及管理關於服務操作與零件的資訊。依預設,Arbortext Publishing Engine 伺服器會將應用程式安裝在以下位置:
Arbortext-path\application\com.ptc.arbortext.techinfo
Technical Information 文件類型的描述
Technical Information 應用程式主題可用於開發服務資訊,或作為開發您自己的特殊 DITA 應用程式的起點。Technical Information 應用程式是 Arbortext DITA 應用程式的分項化,但自訂文件類型並不需要以 DITA 為基礎。
針對 Technical Information 文件類型,您可以使用下列主題類型:
概念
提供背景資訊,使用者必須瞭解這些資訊,才能使用產品或介面,或執行任務。
封面頁
提供針對 PDF 或列印文件繼續前往封面頁的資訊。
診斷
提供診斷資訊。
程序
提供如何執行任務的程序。在此情況下,步驟與圖形會在單一文字流中混合。
參考
提供服務、產品或零件之一般特徵的相關資訊。
並排程序
提供如何執行任務的程序。在此情況下,步驟與圖形會以表格形式並排顯示。
任務
提供程序資訊。
疑難排解
提供疑難排解或診斷資訊。
Technical Information 樣式表的描述
Technical Information 文件類型包括用於發行的範例 Arbortext Styler 樣式表,其位置為:
Arbortext-path\application\com.ptc.arbortext.techinfo
\doctypes\techinfo\techinfo.style
檢查轉換與樣式設定
您可以為輸出產生樣式表。欲檢查進度,您可於使用 Arbortext Publishing Engine Interactive 產生輸出時,從有效負載開啟根文件、對樣式表進行調整,及測試您的變更。XSLT 編寫者也可以使用此流程來評估產生目標圖與目標零件清單的轉換。
您需要從 Arbortext Publishing Engine 伺服器取得有效負載。必須為發行設定 WVS 與 Arbortext Publishing Engine。在 Arbortext Publishing Engine 伺服器中,必須配置交易封存並使其處於使用中狀態。(如需有關交易封存的資訊,請參閱Configuring Arbortext Publishing Engine (配置 Arbortext Publishing Engine)文件集,這是 Arbortext Publishing Engine 文件集的一部份。)然後可以從 Windchill 中的發行結構、資訊結構或零件清單啟動發行請求。從交易封存中尋找您的交易,下載並重新命名請求主體,稱為 rqbody.dat。使用 .zip 副檔名為其重新命名。
開啟有效負載的根文件 Identifier.xml (位於 Arbortext Publishing Engine Interactive) 以手動產生其目標圖。您可以先從 payload.zip 擷取檔案,然後開啟根 Identifier.xml 文件,或是您可以開啟 payload.zip 本身。僅當您從有效負載開啟 Identifier.xml 時,才會出現 「編輯」 > 「編輯已轉換的文件」 (這表示文件類型必須是 PublicationStructure 才可使用該選單項目)。當您選擇「編輯已轉換的文件」時,Arbortext Publishing Engine Interactive 會從 Service 應用程式中對根文件及其所有參考文件執行轉換。然後產生的目標圖 (例如 techinfomap) 會顯示在新視窗中。
如果您要使用 DITA 圖分項化,則可使用 Arbortext Publishing Engine Interactive 中的「編輯」 > 「編輯要套用樣式的經解析文件」,來查看套用樣式的結果。如果目標是其他某些文件類型,您至少可以透過檢視及發行圖來查看結果。
以下幾節提供有關如何設計 techinfo.style 樣式表的一些提示。
手冊標題
範例樣式表使用 techinfomap 根對應元素上的 outputclass 屬性來產生下列標題:
outputclass 屬性值
標題
service
服務手冊
installation
安裝手冊
owners
擁有者手冊
parts
圖解零件型錄
標題頁面編號
在標題頁上,numbernumberlist 用於產生序號、零件編號與模型編號的前置片語
outputclass 屬性值
片語
serial
序號
part
零件編號
model
模型編號
如果 outputclass 值為空或與所列值不同,不會產生文字。numberlist 可以包含 numberarrange
並排程序
欲使程序以文字在左,圖形在右的形式顯示,您需要套用特殊的標籤結構。至少其中一個 procstep 標籤必須包含 procinfo 標籤。如果程序中沒有顯示 procinfo 標籤,則它不會顯示為並排程序
零件清單表修改
「零件清單」XML 標示是自訂表格。因此,Arbortext Styler 樣式表會使用某些表格屬性來套用樣式。預設零件清單表包括「項目編號」、「階層」、「零件編號」、「零件名稱」、「數量」、「可提供服務的指示器」、「無圖解」與「備註」。
屬性
資料類型
partattribute名稱
輸出
項目編號
字串
itemNumber
項目序號
整數
itemSequenceNumber
階層
整數 (0-6)
indenture
否,已測試
零件編號
字串
number
零件名稱
字串
name
數量
字串
itemQuantity
可提供服務的指示器
布林值
serviceable
否,已測試
無圖解
布林值
illustrated
否,已測試
請參閱
FIG
ITM
ISN
referTo
備註
字串
remarks
Y
欲測試 serviceableillustrated 的值,您需要編輯 XML 版本的樣式表,而不是透過 Arbortext Styler 使用者介面,來新增 partattribute name=”serviceable”partattribute name=”illustrated” 的值作為 partitem 的屬性。
項目編號與零件編號的輸出視 serviceableillustrated 屬性的值而定,如下所示:
可提供服務
圖解
是否顯示零件編號?
是否顯示項目編號?
True
True
True
False
False
True
False
False
透過修改 XML 版本的樣式表及使用 SetOutputAttribute,值會儲存為屬性。然後會針對作為自訂表格一部份產生的 _sfe 元素測試這些屬性。
這是否有幫助?