Technical Information 应用程序

其他功能 > 服务信息管理 > 自定义 Windchill Service Information Manager 和 Windchill Service Parts > 自定义发布 > 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 文档类型，您可以使用以下主题类型：

• 概念

提供背景信息，用户必须了解这些信息，然后可以使用产品或接口，或执行任务。

• 封面页面

为 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 服务器，必须对事务存档进行配置并使其处于活动状态。(有关事务存档、部分 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 样式表的一些提示。

手册标题

示例样式表使用 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 属性的值，如下所示：

可用	图解	是否显示部件编号？	是否显示项编号？
True	True	是	是
True	False	是	否
False	True	否	是
False	False	否	否

通过修改 XML 版本的样式表并使用 SetOutputAttribute，将值另存为属性。然后会针对作为自定义表格一部分生成的 _sfe 元素测试这些属性。

这对您有帮助吗?