Technical Information 应用程序
Technical Information 概述
您需要在可发布由服务应用程序创建的变换 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 文档类型，您可以使用以下主题类型：
• Concept
提供背景信息，用户必须了解这些信息，然后才能使用产品或界面，或执行任务。
• Cover Page
为 PDF 或打印文档提供继续操作封面页的信息。
• Diagnostic
提供诊断信息。
• Procedure
提供如何执行任务的步骤。在此情况下，步骤和图形会在一个文本流中混合。
• Reference
提供有关服务、产品或部件的常规特征的信息。
• Side-by-Side Procedure
提供如何执行任务的步骤。在此情况下，步骤和图形会以表格格式并排显示。
• Task
提供过程信息。
• Troubleshooting
提供故障排解或诊断信息。
Technical Information 样式表的说明
Technical Information 文档类型包括用于发布的示例 Arbortext Styler 样式表，其位置为：
Arbortext-path\application\com.ptc.arbortext.techinfo
\doctypes\techinfo\techinfo.style
\doctypes\techinfo\techinfo.style
检查变换和样式
您可以为输出生成样式表。要检查进度，可以从有效载荷打开根文档、对样式表进行调整、并在使用 Arbortext Publishing Engine Interactive 生成输出时测试更改。XSLT 作者还可以使用此进程来评估生成目标映射和目标部件列表的变换。
您需要从 Arbortext Publishing Engine 服务器获得有效载荷。必须设置 WVS 和 Arbortext Publishing Engine 才能发布。对于 Arbortext Publishing Engine 服务器，必须对事务存档进行配置并使其处于活动状态。(有关事务存档、部分 Arbortext Publishing Engine 文档的信息，请参阅 Configuring Arbortext Publishing Engine 文档。)然后，可以通过 Windchill 中的发布结构、信息结构或部件列表启动发布请求。从事务存档中查找事务，下载名为 rqbody.dat 的请求主体并进行重命名。使用 .zip 扩展名对其进行重命名。
在 Arbortext Publishing Engine Interactive 中打开有效载荷的根文档 Identifier.xml 可手动生成其目标映射。可以先从 payload.zip 中提取文件，然后打开根 Identifier.xml 文档，或者可以打开 payload.zip 本身。 > 仅在从有效载荷中打开 Identifier.xml 时显示 (这表示文档类型必须为 PublicationStructure，菜单项才可用)。在选取了“编辑变换后的文档”后，Arbortext Publishing Engine Interactive 会在根文档及其所有参考文档的服务应用程序中执行变换。然后生成的目标映射 (例如techinfomap) 会显示在新窗口中。
如果您使用的是 DITA 映射专业化产品，可以使用 Arbortext Publishing Engine Interactive 中的 > 来查看样式结果。如果目标为某个其它文档类型，至少可以通过查看并发布映射来查看结果。
以下部分提供有关如何设计 techinfo.style 样式表的一些提示。
 |
安装 Arbortext Styler 时，系统会自动安装服务应用程序。这适用于 Arbortext Styler 8.3.2.0 版本及更高版本。
|
配合使用 Styler 与服务应用程序
服务应用程序支持样式表开发人员使用从服务发布中收集的事务存档 (有效载荷) 来分析和解决样式表问题。此过程概述将 Styler 与服务应用程序配合使用的步骤。
1. 提取有效载荷
将 rqbody_XXX.dat 重命名为 rqbody_XXX.zip，并解压缩该文件以访问其内容。
2. 在 Styler 中打开发布结构
启动 Styler，打开发布结构文档 (例如，SM00345619.xml)，然后选择 > 。
3. 查找并复制 TechInfoMap 文件
“发布”对话框打开后，浏览到其中包含 .xml 文件的文件夹，找到新创建的 techinfomap.xml 文件 (例如 SM00345619-techinfomap.xml) 并立即复制该文件，因为 Styler 会在发布后将其删除。
4. 取消发布并编辑 TechInfoMap 文档
取消“发布”对话框，打开复制的 techinfomap.xml 文件。转至 > > ，并根据需要修改样式表。
手册标题
示例样式表使用 techinfomap 根映射元素上的 outputclass 属性生成以下标题：
|
outputclass 属性值
|
标题
|
|---|---|
|
service
|
服务手册
|
|
installation
|
安装手册
|
|
owners
|
所有者手册
|
|
parts
|
图解部件目录
|
标题页面编号
在标题页面上，number 和 numberlist 用于生成序列号、部件编号和模型编号的前置词
|
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
|
是
|
要测试 serviceable 和 illustrated 的值，您需要编辑 XML 版本的样式表，而不是通过 Arbortext Styler 用户界面添加 partattribute name=”serviceable” 和 partattribute name=”illustrated” 的值作为 partitem 的属性。
项编号和部件编号的输出取决于 serviceable 和 illustrated 属性的值，如下所示：
|
serviceable
|
illustrated
|
是否显示部件编号?
|
是否显示项编号?
|
|---|---|---|---|
|
True
|
True
|
是
|
是
|
|
True
|
False
|
是
|
否
|
|
False
|
True
|
否
|
是
|
|
False
|
False
|
否
|
否
|
通过修改 XML 版本的样式表并使用 SetOutputAttribute，将值另存为属性。然后会针对作为自定义表格一部分生成的 _sfe 元素测试这些属性。