为 Arbortext 创建的动态文档配置发布
本节介绍发布使用 Arbortext Editor 创建的动态文档的配置过程。
利用 WVS 框架可发布使用 Arbortext Editor 创作的动态文档。要配置这些文档的发布，必须使用 wvs.properties 为 Arbortext Editor 配置 WVS 发布器。然后为发布文档定义及装载规则。这些规则称为发布规则。
Windchill Visualization Services (WVS) 提供了一种框架，通过它可以发布 EPMDocument 来创建可视化的表示。该发布使用工作器完成，并由工作器代理进行管理。动态文档是一种可变类型的 EPMDocument，因此该框架以同种方式支持它们。
WVS 基于指定的发布规则向 Arbortext Publishing Engine 发送请求。这些规则指定创建表示的时间 (例如检入之后)，以及所需的表示格式 (例如 PDF 和 HTML)。创建表示之后，可创建 WTDocuments 并使用 PublishedContent 链接将其链接到动态文档的各个表示。新的 WTDocument 可用作下游业务过程的一部分。
为 Arbortext Editor 配置 WVS 发布器
为便于 Arbortext Publishing Engine 从 Windchill 下载输入文件以及后续上载输出文件，需要一个身份验证文件。该文件通常称为 auth.properties。
 |
位于 <Windchill>\codebase\WEB-INF\conf 目录中的 wvs.properties 文件包含以下特性设置，而该设置定义了 auth.properties 文件的位置。如果更改 auth.properties 文件的位置，则必须相应地编辑此属性。
publish.cadconvert.ARBORTEXT=com.ptc.arbortext.windchill.apepublishing.CadConvertARBORTEXT,
useworkerdownload=$(wt.home)$(wvs.dir.sep)auth.properties, types=PDF HTML WEB POSTSCRIPT HTMLHELP SGML XML RTF DMP 3D, defaulttype=PDF |
要配置 auth.properties 文件，请执行以下步骤：
1. 使用文本编辑器在 <Windchill> 根目录 (也称为 %WT_HOME%) 中创建 auth.properties 文件。
2. 添加一个包含用户名和可选密码值的身份验证变量。这是本文件中的唯一条目。语法为以下两种之一：
auth=$user:
|
|
PTC 建议仅在演示或测试服务器中使用 auth=<username>:<password>。要使用 auth=<username>:<password>，请将 e3config.xml 中的值 com.arbortext.e3.allowAuthenticationWithoutTrustedHost 设置为 Arbortext Publishing Engine 服务器上的 true。
|
3. 使用有效值替换 <用户名> 和 <密码>。用户必须具有足够的权限，才能读取和下载存储在 Windchill 中的所有待发布动态文档结构。
4. 保存更改并关闭 auth.properties 文件。
5. 在之前所述的 publish.cadconvert.ARBORTEXT 特性中，为 auth.properties 文件提供了 $(wt.home)$(wvs.dir.sep)auth.properties 的默认位置。如果为该文件使用不同的位置，请务必编辑该特性值以反映更新后的路径。您必须使用 xconfmanager 实用程序进行此更改：
xconfmanager -s
"publish.cadconvert.ARBORTEXT=com.ptc.arbortext.windchill.apepublishing.CadConvertARBORTEXT,
useworkerdownload=$(wt.home)$(wvs.dir.sep)auth.properties,
types=PDF HTML WEB POSTSCRIPT HTMLHELP SGML XML RTF DMP 3D,
defaulttype=PDF" -t <Windchill>\wvs.properties
-p
"publish.cadconvert.ARBORTEXT=com.ptc.arbortext.windchill.apepublishing.CadConvertARBORTEXT,
useworkerdownload=$(wt.home)$(wvs.dir.sep)auth.properties,
types=PDF HTML WEB POSTSCRIPT HTMLHELP SGML XML RTF DMP 3D,
defaulttype=PDF" -t <Windchill>\wvs.properties
-p
6. 重新启动 Windchill 服务器。
 |
wvs.properties 文件中包含一个名为 publish.usesPublishRules=ARBORTEXT 的设置。如果该特性被删除或 ARBORTEXT 被移除，则 WVS 不会将发布规则用于 Arbortext 创建的动态文档。不建议这样做。
|
|
|
如果 Arbortext Publishing Engine 版本低于 8.2.0.0，或 com.ptc.arbortext.wvs/PreferAdapter 发布参数设置为 yes，则 WVS 支持受信任主机身份验证。此功能允许工作器在不使用密码的情况下进行身份验证，由此可以实现在发布操作期间使用“真实的用户”进行身份验证。
有关 WVS 受信任主机身份验证的详情，请参阅WVS 受信任主机身份验证的注意事项。
有关 Windchill 受信任主机身份验证的详情，请参阅在 Windchill 中配置替代身份验证。
|
|
|
有关指定 WVS 工作器参数的详情，请参阅服务工作器参数。
|
发布 Arbortext 创作的动态文档
动态文档的发布由发布规则控制。有关详情，请参阅关于发布规则。