Windchill 适配器特性
Windchill 适配器特性表单包含常用特性和特定于适配器的特性。
常用特性位于表单顶部。这些字段将定义与 LDAP 条目相关联的属性。有关此处未列出的特性的信息，以及有关使用表单和导入与导出 LDAP 条目的说明，请参阅
常用的特性和操作。
指定特性值时，以下主题可能会有所帮助：
• Info*Engine User's Guide中的“指定 URI 和 URL”
• Info*Engine User's Guide 中的“MOM 凭证映射”
• Info*Engine Implementation Guide中的“实现任务队列”
• Info*Engine Implementation Guide中的“实现消息和 Web 事件服务”
常规特性
要指定常规特性，请使用以下字段：
主目录
home
Info*Engine 根安装目录。Info*Engine 的根安装目录与 Windchill 的根安装目录 (wt.home) 相同。
加载平衡器
load.balancer
与 Windchill 适配器进行通信时，Info*Engine 客户端应使用的加载平衡器实现。通常将该值设为 wt.adapter.LoadBalancer，这样会利用多方法服务器环境中的 Windchill RMI 来选择最佳方法服务器以处理下一个请求。
“秘诀”
secret.text
用于标记和验证已发送给适配器的请求的字符串。对于您输入的值，其作用与密码相同，用于验证您的请求。
此特性不是必要特性，但可额外增大 LDAP 条目的安全性。如果输入值，则在 webject INSTANCE 参数中指定的进程外适配器名称必须标识一个具有此秘诀密码设置的 LDAP 条目。
有关验证请求的信息，请参阅Info*Engine User's Guide中的“适配器的凭证映射”和PTC Windchill Administration - Configuring Your PTC Windchill Environment中的“更改 Info*Engine 请求验证特性”。
“秘诀 2”
secret.text2
另一个用于标记和验证已发送给适配器的请求的字符串。此特性可生成更全面的请求签名，可用于替代“机密”特性或与其同时使用。
有关验证请求的信息，请参阅Info*Engine User's Guide中的“适配器的凭证映射”和PTC Windchill Administration - Configuring Your PTC Windchill Environment中的“更改 Info*Engine 请求验证特性”。
“秘诀运算法则”
secret.algorithm
用于加密“机密”和“机密2”特性值的算法。
有效值包括 SHA-1、MD2 和 MD5。该特性的默认值为 SHA-1。默认值为 SHA-1。
默认 JMS 服务
jms.defaultService
在未指定 SERVICE 参数而调用 MSG 和 WES webject 时所应该使用的 JMS 服务的名称。
核心 JMS 特性
通过 Java 消息服务 (JMS) 配置 Info*Engine 时，通常设置以下特性。根据特性在表单中的位置以及这些特性执行的功能对特性说明进行分组。
|
|
通过 JMS MOM 配置 Info*Engine 时，最好创建新的 JMS 服务条目。可以使用特性编辑器为该 JMS 服务条目指定核心和其他特性。
随后，可以输入该 JMS 服务的服务名称来作为 MSG 和 WES webject 的 SERVICE 参数。或者，可以输入该服务名称作为 Info*Engine 服务器或适配器的“默认 JMS 服务”特性的值。
|
JMS 上下文提供程序族
jms.CtxFactory
用于在查找管理对象期间返回初始 JNDI 上下文的族的类名称。如果未指定，则假定管理对象存储在 LDAP 中。
默认值为 com.sun.jndi.ldap.LdapCtxFactory。
JMS 基础 URI
jms.baseUri
与 JMS 相关的 URI 相对应的 LDAP 统一资源指示符 (URI)。
这可用作与 JMS 相关的管理对象所在的基础位置。
JMS 基础 URI 承担者
jms.baseUri.principal
所提供的用来验证与“JMS 基础 URI”相关联的 JNDI 用户的用户名。
JMS 基础 URI 密码
jms.baseUri.password
与“JMS 基础 URI 承担者”相关联的密码。
“JMS 用户”
jms.username
与 JMS 提供程序或 MOM 关联的默认用户。
JMS 密码
jms.password
用于连接 JMS 提供程序或 MOM 的默认密码。
队列连接工厂
msg.queueConnectionFactory
JMS MOM 使用的受管理的 JMS 队列连接工厂的位置。
标题连接工厂
wes.topicConnectionFactory
受管理的 JMS 标题连接工厂的位置。该值可以是完全限定的 URI，也可以是相对于已配置的基础 URI 的可分辨名称。有关详细信息，请参阅Info*Engine Implementation Guide中的“实现消息发送和 Web 事件服务”。
WES 预订标识符
wes.subscriptionIdentifier
创建主题预定时使用的唯一标识符。如果单个主机上的多个 Info*Engine 进程要生成同一主题的预定，则设置该特性。
每个单独的 Info*Engine 服务必须具备唯一的标识符。如果未指定该特性，则会基于主机名和事件名称生成标识符。
JMS 存储库目录
jms.lib
与 JMS 服务进行通信所需的第三方 JAR 文件所在的目录。如果服务类路径中已经包括了 JAR 文件，此特性为可选。
其他 JMS 特性
通过 JMS 服务配置 Info*Engine 时，还可以设置以下特性。根据特性在表单中的位置以及这些特性执行的功能对特性说明进行分组。
JMS 恢复重试间隔
jms.recoveryRetryInterval
MOM 断开连接时，两次尝试重新建立连接之间所需等待的时间 (以秒为单位)。
默认值为 30。
JMS 错误消息队列
jms.badMessageQueue
当接收到的消息无法转换为 Info*Engine 请求时，该特性可定义用于放置此消息的队列位置以供管理员进行处理。如果未指定该特性，将丢弃错误消息。
WES 上下文提供程序族
wes.CtxFactory
用于在查找管理对象期间返回 Windchill 初始上下文的族的类名称。
默认值为 com.sun.jndi.ldap.LdapCtxFactory。
WES 基础 URI
wes.baseUri
具有 WES 相关管理对象的 LDAP 统一资源指示符 (URI) (LDAP 目录内的子树)。
如果未指定，则会使用 jms.baseUri 特性。
WES 用户
wes.username
连接至 JMS MOM 时需要提供的 WES 用户名。
如果未指定，则会使用 jms.username 特性。
WES 密码
wes.password
与“WES 用户”关联的密码。
如果未指定，则会使用 jms.password 特性。
WES 错误消息队列
wes.badMessageQueue
当接收到的消息无法转换为 Info*Engine 请求时，该特性可定义用于放置此消息的队列位置以供管理员进行处理。如果未指定该特性，将丢弃错误消息。
如果未指定，则会使用 jms.badMessageQueue 特性。
MSG 上下文提供程序族
msg.CtxFactory
用于在查找管理对象期间返回初始 JNDI 上下文的族的类名称。
默认值为 com.sun.jndi.ldap.LdapCtxFactory。
队列基础 URI
msg.baseUri
具有队列相关管理对象的 LDAP 统一资源指示符 (URI) (LDAP 目录内的子树)。
如果未指定，则会使用 jms.baseUri 特性。
队列用户
msg.username
连接至 JMS MOM 时需要提供的用户名。
如果未指定，则会使用 jms.username 特性。
队列密码
msg.password
与“队列用户”关联的密码。
如果未指定，则会使用 jms.password 特性。
MSG 错误消息队列
msg.badMessageQueue
当接收到的消息无法转换为 Info*Engine 请求时，该特性可定义用于放置此消息的队列位置以供管理员进行处理。如果未指定该特性，将丢弃错误消息。
如果未指定，则会使用 jms.badMessageQueue 特性。
默认预订/提交队列
msg.defaultExecutionQueue
管理的队列的 LDAP 可分辨名称。该值可以是与已配置基础 URI 相对应的名称，也可以是完全限定的 LDAP 可分辨名称。如果对应，则 cn= (通用名称属性) 为隐式 (如果未明确指定)。
此队列位置与下列 webject 配合使用：
◦ 队列任务 - 队列任务的放置位置。如果未指定该特性，则必须指定 webject QUEUE 参数。
◦ 预订队列 - 使用 webject 时要预订的队列。如果未指定该特性，则必须指定 webject QUEUE 参数。
有关 Webject 的详细信息，请参阅Info*Engine User's Guide。
默认结果队列
msg.defaultResultsQueue
管理的队列的 LDAP 可分辨名称。该值可以是与已配置基础 URI 相对应的名称，也可以是完全限定的 LDAP 可分辨名称。如果对应，则 cn= (通用名称属性) 为隐式 (如果未明确指定)。
此队列位置与下列 webject 配合使用：
◦ Query-Results - 放置结果的队列位置。如果未指定该特性，则必须指定 webject QUEUE 参数。
◦ Delete-Results - 放置结果的队列位置。如果未指定该特性，则必须指定 webject QUEUE 参数。
◦ Queue-Task - 放置结果的队列位置。如果未指定该特性，则必须指定 webject DESTINATION 参数。
有关 Webject 的详细信息，请参阅Info*Engine User's Guide。
动态特性配置
服务或适配器的配置信息可在服务或适配器运行时更新，这样无需重新启动便可更新特性。
“有效时间”特性用于指定自动重新加载服务或适配器的特性前经过的时间 (以分钟为单位)。仅当这些特性可以访问时，才能自动重新加载。默认情况下，特性不过期。
其他特性
如果未在表单中定义特性，则可将其添加到“其他特性”字段中。添加其他特性时，特性名称格式将包括适配器条目的名称 (服务名称)，后跟特性名称。例如：
<service_name>.dbuser
在相应的字段中，指定服务或适配器使用的特性以及该特性的值。单击新特性名称旁边的“添加”以打开可修改特性值的文本框。
如果值过长而无法完整显示，则会出现“编辑”操作。单击“编辑”可打开一个含有较大文本区域的新浏览器窗口。
