配置服务文档的发布
概述
Windchill 可视化服务 (WVS) 为发布文档、创建可视化表示和生成束提供了框架。此发布过程使用由工作器代理管理的工作器。
WVS 框架支持从信息结构、发布结构和部件列表进行发布。要配置发布，必须使用 WVS 属性配置 WVS 发布器。您可以随后定义并加载发布规则来发布到特定的输出。
WVS 基于指定的发布规则向 Arbortext Publishing Engine 发送请求。这些规则可指定创建输出或后发布对象、传递用于发布的参数以及指定输出类型，如 PDF 或 Arbortext Content Delivery 束。
配置 WVS 发布器
您将需要为 Arbortext Publishing Engine 设置身份验证以从 Windchill 中下载输入文件以及后续处理输出文件。有两种处理身份验证的方式可供选择。您将需要使用文本编辑器在 <Windchill-path> 根目录 (也称为 %WT_HOME%) 下创建 auth.properties 文件。然后评估在发布操作期间使用哪种身份验证方式：
• 使用无需在发布请求中传递密码的“受信任主机身份验证”进行验证。
• 设置将随发布请求一起传递的用户名和密码以进行身份验证。
 |
有关 WVS 受信任主机身份验证的信息，请参阅WVS 受信任主机身份验证的注意事项。
有关 Windchill 受信任主机身份验证的信息，请参阅在 Windchill 中配置替代身份验证。
|
要使用“受信任主机身份验证”实现 WVS 到 Arbortext Publishing Engine 的发布：
1. 请将身份验证变量添加到 auth.properties 文件，如以下示例所示：
auth=$user:
2. 将 Arbortext Publishing Engine 服务器的 Property 添加到 Windchill site.xconf 文件：
<Property name="wt.auth.trustedHosts" overridable="true"
targetFile="codebase/wt.properties" value="server-IP-address"/>
targetFile="codebase/wt.properties" value="server-IP-address"/>
3. 运行 xconfmanager -pF 以传播此特性。
4. 在 Windchill shell 中，通过以下操作重新启动 Windchill：
windchill stop
windchill start
windchill start
要将用户名和密码身份验证添加到 auth.properties 文件：
1. 添加一个包含用户名和可选密码值的身份验证变量。这是本文件中的唯一条目。语法为以下两种之一：
auth=username
auth=username:password
要使用 auth=<username>:<password>，请将 e3config.xml 中的值 com.arbortext.e3.allowAuthenticationWithoutTrustedHost 设置为 Arbortext Publishing Engine 服务器上的 true。
|
|
PTC 建议仅在演示或测试服务器中使用 auth=<username>:<password>。如果不使用受信任的主机，则必须在 Arbortext Publishing Engine 服务器上的 e3config.xml 文件中设置 com.arbortext.e3.allowAuthenticationWithoutTrustedHost 特性。
|
使用有效值替换 username 和 password。
2. 请确保用户具有足够的权限以读取和下载存储在可发布 Windchill 中的所有 Windchill Service Information Manager 结构。
此外，使用 auth.properties 文件的位置来配置 Windchill。特别是，wvs.properties 包含 auth.properties 位置。
|
|
可在 Windchill-path\codebase\WEB-INF\conf 目录下找到 wvs.properties 和 wvs.properties.xconf 文件的位置。
|
1. 在 wvs.properties 文件中，一组 Windchill Service Information Manager 发布属性通常将 auth.properties 的位置指定为：
$(wt.home)$(wvs.dir.sep)auth.properties
如果 auth.properties 的位置发生更改，请确保更新该路径。您必须使用 xconfmanager 实用工具进行更改，并且需要指定整个属性语句，例如：
xconfmanager -s
"updated statement within quotes"
-t Windchill-path\wvs.properties -p
"updated statement within quotes"
-t Windchill-path\wvs.properties -p
默认情况下，下列属性提供了 auth.properties 的位置，如果它的位置发生更改，则需要更新这些属性 (忽略换行符)：
publish.cadconvert.com.ptc.arbortext.windchill.partlist.PartList.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF BUNDLE EPUB,defaulttype\=PDF
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.BaseDiv|com.ptc.sis.IsRoot.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=BUNDLE ,defaulttype\=BUNDLE
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.BaseDiv|com.ptc.sis.PsSection.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF HTML BUNDLE EPUB,defaulttype\=PDF
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.BaseDiv|com.ptc.sis.PsSection|com.ptc.sis.PsRoot.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF HTML BUNDLE EPUB,defaulttype\=PDF
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.Content|com.ptc.sis.ContentRef
|com.ptc.sis.PartsListRef.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF HTML BUNDLE EPUB,defaulttype\=PDF
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.Content|com.ptc.sis.ContentRef
|com.ptc.sis.TextualContentRef.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF HTML BUNDLE EPUB,defaulttype\=PDF
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF BUNDLE EPUB,defaulttype\=PDF
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.BaseDiv|com.ptc.sis.IsRoot.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=BUNDLE ,defaulttype\=BUNDLE
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.BaseDiv|com.ptc.sis.PsSection.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF HTML BUNDLE EPUB,defaulttype\=PDF
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.BaseDiv|com.ptc.sis.PsSection|com.ptc.sis.PsRoot.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF HTML BUNDLE EPUB,defaulttype\=PDF
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.Content|com.ptc.sis.ContentRef
|com.ptc.sis.PartsListRef.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF HTML BUNDLE EPUB,defaulttype\=PDF
publish.cadconvert.wt.part.WTPart|com.ptc.sis.Base
|com.ptc.sis.Content|com.ptc.sis.ContentRef
|com.ptc.sis.TextualContentRef.SIS=
com.ptc.arbortext.windchill.publisher.CadConvertSIS,
useworkerdownload\=$(wt.home)$(wvs.dir.sep)auth.properties,
types\=PDF HTML BUNDLE EPUB,defaulttype\=PDF
2. 重新启动 Windchill 服务器。
 |
wvs.properties 文件还包含名为 publish.usesPublishRules=ARBORTEXT SIS 的设置。如果删除此属性或移除 ARBORTEXT SIS 值，则 WVS 将不会使用发布规则。不建议这样做。
|
其他性能配置
如果站点将管理 WVS 与 Arbortext Publishing Engine 服务器之间的大型事务处理，可能需要添加一个属性将超时时段延长，以保证发布作业能够完成。
1. 将 Property 添加到 Windchill site.xconf 文件：
<Property name=" publish.cadtimeout.component.SIS " overridable="true"
targetFile="codebase/wvs.properties" value="7200"/>
targetFile="codebase/wvs.properties" value="7200"/>
以秒为单位设置超时值。例如，7200 表示 2 小时。
2. 运行 xconfmanager -pF 以传播此特性。
3. 在 Windchill shell 中，通过以下操作重新启动 Windchill：
windchill stop
windchill start
windchill start