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
图解部件目录
标题页面编号
在标题页面上,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
要测试 serviceableillustrated 的值,您需要编辑 XML 版本的样式表,而不是通过 Arbortext Styler 用户接口添加 partattribute name=”serviceable”partattribute name=”illustrated” 的值作为 partitem 的属性。
项编号和部件编号的输出取决于 serviceableillustrated 属性的值,如下所示:
可用
图解
是否显示部件编号?
是否显示项编号?
True
True
True
False
False
True
False
False
通过修改 XML 版本的样式表并使用 SetOutputAttribute,将值另存为属性。然后会针对作为自定义表格一部分生成的 _sfe 元素测试这些属性。
这对您有帮助吗?