Info*Engine 服务器
Info*Engine 服务器提供一种机制,用于检索和处理用户或自定义应用程序想要查看或检索的数据。
|
默认情况下,不再使用 Info*Engine 服务器条目。但是,可以创建条目来集成 Info*Engine 原有的独立安装。
|
有关此处未列出的属性的信息,以及有关使用可用的表单按钮和正确输入属性值的说明,请参阅
常用的属性和操作。
凭证映射属性
可以通过服务器指定要使用的凭证文件来设置身份验证映射。凭证文件允许用户使用适合于一个或多个适配器的凭证登录到服务器上。
凭证映射特性通常在 wt.properties 文件中配置,而不是通过“特性管理”实用程序配置。但是,在配置新的适配器时,可以使用“特性管理”实用程序来设置某些凭证映射特性。
凭证映射器
credentialsMapper
站点所创建的旨在通过 Info*Engine 进行用户身份验证的身份验证任务的相对路径。此路径相对于配置的任务根路径。该属性为可选属性。
调用业务任务处理器执行业务任务时,它会检查 credentialsMapper 属性。如果设置了该属性,则任务处理器会在执行对其分配的任务之前执行身份验证映射任务。身份验证映射任务可将用户名用作密钥,以从一个或多个适配器可访问的信息系统获取用户特定的身份验证信息。然后,根据该身份验证信息创建一个输出组。
如果不指定 credentialsMapper 属性,则 Info*Engine 不会在执行指定任务之前执行基于服务器的身份验证映射任务。
凭证文件
credentialsFiles
站点针对每个用户创建的用于存储身份验证映射文件的目录的相对路径。每个映射文件的名称必须与传递给 Info*Engine 的验证用户名相匹配。此目录路径相对于配置的任务根路径。该属性为可选属性。
◦ 如果未指定此属性,则 Info*Engine 不会查找身份验证映射文件。
◦ 指定后,Info*Engine 会尝试打开并读取与所提供的用户名对应的身份验证映射文件。
会在执行业务任务之前,以及执行在 credentialsMapper 属性中命名的任务之前打开该文件。
有效凭证时间
credentialsTimeToLive
该属性通过允许任务处理器从缓存中读取身份验证信息来提高性能。否则,每次读取身份验证文件或执行身份验证映射任务时,任务处理器都会发送身份验证信息。
该属性的值为在刷新身份验证信息之前进行缓存的毫秒数。该值必须为正整数,否则会被忽略。如果未定义此属性,则不会缓存身份验证组信息,性能将得不到提高。
任务编译属性
通过指定编译属性,可以设置编译任务的位置以及需要添加至类路径的任何其他文件。
代码库
codebase
编译任务所在的目录。
编译器 Classpath
compiler.classpath
编译任务时添加至类路径的其他 JAR 文件和类文件。请输入标准 Java 类路径。对于 Windows 系统,请使用分号 (;) 作为路径分隔符。对于 Unix 系统,请使用冒号 (:) 作为路径分隔符。
存储库目录 n
compiler.libDirectoryn
如果将其他 JAR 文件和类文件添加至类路径,请使用此字段指定这些文件所在的目录。
n 的第一个值必须为 1,并且它的值必须连续增加。
常规特性
要指定常规特性,请使用以下字段:
主目录
home
Info*Engine 根安装目录。Info*Engine 的根安装目录与 Windchill 的根安装目录 (wt.home) 相同。
启动任务 n
startupTaskn
可以配置 Info*Engine 来在启动时执行特定任务。例如,可以自动生成“队列”或“事件”预定。n 的第一个值必须为 1,并且它的值必须连续递增,如以下示例所示:
com.infoengine.startupTask1=msg/subscribeQueue.xml
该属性的值为启动 Info*Engine 时开始的任务的路径。
XML 解析器调试
request.xmlParser.debug
启用 XML 解析器调试。解析传入的 XML 时,会出于调试目的而打印信息。
请求调试
request.xmlStream.debug
启用 XML 日志记录请求。这会出于调试目的打印传入的 XML。
默认 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 的可分辨名称。有关详细信息,请参阅
实现消息和 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 参数。
默认结果队列
msg.defaultResultsQueue
管理的队列的 LDAP 可分辨名称。值可以是与已配置的基础 URI 相对应的名称,也可以是完全限定的 LDAP 可分辨名称。如果对应,则 cn= (通用名称属性) 为隐式 (如果未明确指定)。
此队列位置与下列 webject 配合使用:
◦ 查询结果 - 放置结果的队列位置。如果未指定该属性,则必须指定 webject QUEUE 参数。
◦ 删除结果 - 放置结果的队列位置。如果未指定该属性,则必须指定 webject QUEUE 参数。
◦ 队列任务 - 放置结果的队列位置。如果未指定该属性,则必须指定 DESTINATION 参数。
Send-Mail Webject 属性
Send-Mail webject 可创建和发送电子邮件消息。配置 Send-Mail webject 属性允许您在执行该 webject 时设置某些默认值。
要配置 Send-Mail 默认设置,请设置以下属性:
默认邮件创作者
mail.originator
Send-Mail webject 使用的默认创作者 (发送消息的电子邮件地址)。
对应于 FROM webject 参数。
默认 SMTP 服务器
mail.smtp.server
Send-Mail webject 使用的默认服务器。
默认 SMTP 用户名
mail.smtp.username
连接至 SMTP 服务器时提供的默认用户名。
对应于 USERNAME 参数。
默认 SMTP 密码
mail.smtp.password
与“默认 SMTP 用户名”关联的默认密码。
对应于 PASSWORD 参数。
动态属性配置
服务或适配器的配置信息可在服务或适配器运行时更新,这样无需重新启动便可更新属性。
“有效时间”属性用于指定自动重新加载服务或适配器的属性前经过的时间 (以分钟为单位)。仅当这些属性可以访问时,才能自动重新加载。默认情况下,属性不过期。
其他特性
如果未在表单中定义特性,则可将其添加到“其他特性”字段中。添加其他属性时,属性名称格式将包括适配器条目的名称 (服务名称),后跟属性名称。例如:
<service_name>.dbuser
在相应的字段中,指定服务或适配器使用的属性以及该属性的值。单击新属性名称旁边的“添加”以打开可修改属性值的文本框。
如果值过长而无法完整显示,则会出现“编辑”操作。单击“编辑”可打开一个含有较大文本区域的新浏览器窗口。