了解发布进程
必备知识
了解点对点发布进程是成功实现自定义的关键。达到此目标所需的技能集通常包括:
• 执行 Arbortext Publishing Engine 管理和配置,包括 Windchill PDMLink 的 PTC Server connection。
• 执行 Arbortext Editor,以及使用 Arbortext Styler 开发样式表。
• 执行开发和部署 Arbortext Editor and Publishing Engine 的特殊文档类型应用,以及如何使用 application 目录。
• 开发 XSL 变换样式表。
• 使用 XPath 表达式。
• 使用 Windchill PDMLink 管理。
• 使用 Windchill 可视化服务 (WVS) 和工作器代理管理。
• 编写 WVS 发布规则。
发布先决条件
需要先成功安装、设置、配置和操作下列项目以继续实现自定义:
• Arbortext Publishing Engine 必须在支持的 Windows 服务器上进行安装和配置。
安装和配置 Arbortext Publishing Engine 的说明位于 Installing Arbortext Publishing Engine 和 Configuring Arbortext Publishing Engine 指南中,这些指南是“Arbortext Publishing Engine 帮助中心”文档的一部分。
• 必须在 Windchill 文件 wvssis.properties 中配置 Windchill WVS 与 Arbortext Publishing Engine 服务器的连接。
从 Windchill 设置服务器连接的说明位于 Configuring Windchill Service Information Manager and Windchill Service Parts (《配置 Windchill Service Information Manager 和 Windchill Service Parts》) 中,属于 Windchill Service Information Manager 文档的一部分,该文档可从本帮助中心和下列 PTC 参考文档支持站点获取:
选取“浏览文档”,以访问链接。
• Arbortext Publishing Engine 服务器必须安装并启用服务应用程序 com.ptc.arbortext.service。默认情况下,它位于 Arbortext Publishing Engine application 目录。Service 应用程序管理准备发布的输入 XML 文档的初始变换。
• Arbortext Publishing Engine 服务器必须安装并启用文档类型以处理发布输出。默认情况下,示例位于 Arbortext Publishing Engine application 目录。技术信息 DITA 文档类型应用程序 com.ptc.arbortext.techinfo 是通过 Arbortext Publishing Engine 分配的某种文档类型的工作示例。
• 必须在 Arbortext Publishing Engine 服务器上配置 PTC Server connection 与 Windchill 的连接,以允许 Arbortext Publishing Engine 服务器从 Windchill 检索对象。
设置 PTC Server connection 的说明位于 Arbortext Content Management Guide 中,该指南是 Arbortext Publishing Engine 文档的一部分。
• 必须在 Windchill PDMLink 上配置 SIS 工作器,以便 WVS 可以管理从信息结构、发布结构和部件列表发送至 Arbortext Publishing Engine 的发布请求。
设置 SIS 工作器的说明位于 Configuring Windchill Service Information Manager and Windchill Service Parts (《配置 Windchill Service Information Manager 和 Windchill Service Parts》) 中,该指南是 Windchill Service Information Manager 文档的一部分。
• 必须在 Windchill PDMLink 上设置 WVS 发布规则,以便用户可以选择发布规则,并且 WVS 可以将关联的发布参数发送到 Arbortext Publishing Engine。发行规则必须具有明确的名称和说明,以便用户可以区分它们。
设置发布规则的说明位于 Configuring Windchill Service Information Manager and Windchill Service Parts (《配置 Windchill Service Information Manager 和 Windchill Service Parts》) 中,该指南是 Windchill Service Information Manager 文档的一部分。
• 应在服务产品中定义发布结构、信息结构和部件列表 (可选)。在使用发布操作前常规 WVS 发布必须可操作。
发布操作在本帮助中心中有所说明。
• 使用“发布表示”菜单操作项、快捷菜单或工具栏按钮,能够以指定输出格式创建发布表示。用户可以指定发布名称、说明,有时还可以指定 WVS 发布规则。输出类型以及各种发布参数是由 WVS 发布规则或用户在部件列表中的选择而指定。
• “发布表示”可用于发布 Arbortext Content Delivery 的束。束发布会生成一个文件,它会调用用作 Arbortext Content Delivery 的输入的束。该束位于 Arbortext Publishing Engine 服务器的目标目录中,Arbortext Content Delivery 可在此位置找到该束。束发布过程不会将束返回至 Windchill,但是会返回束发布操作的相关信息。
• WVS 发布规则文件必须定义 SIS 工作器参数,用于控制发布过程。在
服务工作器参数中对参数及示例进行了说明。
服务信息发布工作流
从服务产品结构发布基本工作流遵循此过程:
1. 从发布结构、信息结构或部件列表触发发布操作时,多个文件会在一个名为有效负载的文件中生成、压缩并由 WVS 发送到 Arbortext Publishing Engine 服务器。文件的数量和类型特定于结构、其内容、指定的输出以及请求的发布作业的发布规范。
2. Windchill Service Information Manager 从结构创建通用 XML 文档以发送到 Arbortext Publishing Engine 服务器。
您需要了解此常规 XML 格式,才能成功将输入 XML 文档变换为符合您文档类型结构的格式。XSLT 变换样式表会作为 Service 应用程序处理的一部分提供。此 XSLT 样式表是使用 WVS 发布规则中的一个参数指定的。
3. WVS 发布规则规范将被转换为发布规范文件,它将在有效载荷中发送到 Arbortext Publishing Engine 服务器。其参数会在发布过程中被应用。
4. 由输入 XML 文档参考的对象 (例如图形) 会被发送到 Arbortext Publishing Engine 作为有效负载的一部分,这些对象也可以使用 Windchill PDMLink 的 PTC Server connection进行检索。选择哪种方式由 SIS 工作器参数确定。
5. 输入 XML 文档、发布规范和参考对象 (如有必要) 均会压缩为有效载荷文件以及介绍有效载荷内容的内容清单 XML 文件。
然后,使用由服务应用程序处理的 f=acl 函数调用,将有效载荷作为 HTTP 请求的 POST 类型发送到 Arbortext Publishing Engine 服务器进行处理。
6. 服务应用程序包含 XSLT 样式表,此类样式表可将通用 XML 输入文档变换为默认情况下与示例分布式 DITA 文档类型兼容的形式,例如图解部件列表或 Arbortext Content Delivery 束。
7. 必须在 Arbortext Publishing Engine 服务器上安装一种文档类型,这样才可以从服务应用程序中获得临时文档并生成发布输出或束。
技术信息示例专用的 DITA 文档类型在 Arbortext Publishing Engine 服务器上进行分发。默认情况下,会处理默认 Service 应用程序生成的内容和批注,并且能够根据发布规范生成输出。
Technical Information 应用程序是为了编写和发布有关工作文档类型示例的服务操作和部件的信息而设计。任何客户文档类型均需模拟内置到 Technical Information 应用程序中的功能和操作。
8. Arbortext Publishing Engine 服务器接收到有效负载后,请求将被导向至 Arbortext Publishing Engine 子进程并随后由其进行处理。
发布规范必须指定将常规输入 XML 文档变换为符合指定文档类型的标注的 XSLT 变换样式表。XSLT 需要指定这一输出文档类型。
9. 服务应用程序将发布结构、信息结构、或部件列表输入 XML 变换为映射结构。如果该结构参考部件列表,则部件列表将会变换为独立的 XML 格式 (称为“图解部件定义”(IPD))。如果只有部件列表作为输入,则会将其放置在参考部件列表的包装发布结构 XML 文件中,该部件列表会像由发布结构实际参考一样进行变换。
10. Arbortext Publishing Engine 子进程会将文档置于特定于输出文档类型的管道过滤器中,然后根据指定样式表创建输出的样式并发布输出 (使用 Arbortext Styler 样式表指定的 APP)。
11. Arbortext Publishing Engine 服务器会收集已发布的输出 (或错误消息,如果已生成)、composer 日志 (以 XML 和 HTML 两种格式) 以及标识输出类型、进程 ID、事务处理 ID、Arbortext Publishing Engine 服务器名称和 IP 地址的内容清单,然后,会将这些文件压缩至一个响应文件中。响应 zip 会返回至 SIS 工作器。如果输出为束,则响应文件中不会包括该束,但是会包括有关该束路径的信息。该束将保留在 Arbortext Publishing Engine 服务器的目标目录中,等待 Arbortext Content Delivery 的进一步操作。
12. SIS 工作器会将返回的响应 zip 文件交付给 WVS。
13. WVS 或者会从“表示”选项卡提供包含表示的 zip 的链接。如果表示包括 PDF,则可以配置后发布委派来提取 PDF,并将其作为 Windchill PDMLink 中的表示检入。