专业化管理 > Info*Engine 管理 > Info*Engine 管理实用程序 > 服务和适配器 > Info*Engine Servlet
  
Info*Engine Servlet
Info*Engine servlet 提供了 Info*Engine 与 Web 服务器之间的接口。您可以使用该 servlet 通过 HTTP 或 HTTPS 直接调用 Info*Engine 任务。通过 Info*Engine servlet 调用任务时,Info*Engine 虚拟数据库 (VDB) 在响应中将被渲染为 XML。
此表单还提供 SOAP RPC servlet 的默认配置。SOAP (简单对象访问协议) 是第三方应用程序可以使用的基于 XML 的轻型协议。Info*Engine SOAP servlet 捕捉并处理通过 Web 发出的 Info*Engine SOAP 请求,可用于远程交换信息和执行自定义 Info*Engine 业务任务。有关详细信息,请参阅 SOAP Services (SOAP 服务)。
有关此处未列出的属性的信息,以及有关使用可用的表单按钮和正确输入属性值的说明,请参阅常用的属性和操作
凭证映射属性
可以通过服务器指定要使用的凭证文件来设置验证映射。凭证文件允许用户使用适合于一个或多个适配器的凭证登录到服务器上。
凭证映射属性通常在 wt.properties 文件中配置,而不是通过“属性管理”实用程序配置。但是,在配置新的适配器时,可以使用“属性管理”实用程序来设置某些凭证映射属性。
有关详细信息,请参阅凭证映射
凭证映射器
credentialsMapper
站点为通过 Info*Engine 验证用户创建的验证任务的相对路径。此路径相对于配置的任务根路径。该属性为可选属性。
调用业务任务处理器执行业务任务时,它会检查 credentialsMapper 属性。如果设置了该属性,则任务处理器会在执行对其分配的任务之前执行验证映射任务。验证映射任务可将用户名用作密钥,以从一个或多个适配器可访问的信息系统获取用户特定的验证信息。然后,根据该验证信息创建一个输出组。
如果不指定 credentialsMapper 属性,则 Info*Engine 不会在执行指定任务之前执行基于服务器的验证映射任务。
凭证文件
credentialsFiles
站点针对每个用户创建的用于存储验证映射文件的目录的相对路径。每个映射文件的名称必须与传递给 Info*Engine 的验证用户名相匹配。此目录路径相对于配置的任务根路径。该属性为可选属性。
如果未指定此属性,则 Info*Engine 不会查找验证映射文件。
指定后,Info*Engine 会尝试打开并读取与所提供的用户名对应的验证映射文件。
会在执行业务任务之前,以及执行在 credentialsMapper 属性中命名的任务之前打开该文件。
有效凭证时间
credentialsTimeToLive
该属性通过允许任务处理器从缓存中读取验证信息来提高性能。否则,每次读取验证文件或执行验证映射任务时,任务处理器都会发送验证信息。
该属性的值为在刷新验证信息之前进行缓存的毫秒数。该值必须为正整数,否则会被忽略。如果未定义该属性,则不会缓存验证组信息,性能将得不到提高。
任务编译属性
通过指定编译属性,可以设置编译任务的位置以及需要添加至类路径的任何其他文件。
有关详细信息,请参阅 About Info*Engine Tasks and Task Rules (关于 Info*Engine 任务和任务规则)。
任务根
taskRootDirectory
XML 业务任务的根路径。
servlet 可从中找到所有 XML 业务任务的根文件系统目录。这使 servlet 可以在本地编译和执行任务。
在没有任务处理器的情况下运行 servlet 时,此属性很有用。
代码库
codebase
编译任务所在的目录。
编译器 Classpath
compiler.classpath
编译任务时添加至类路径的其他 JAR 文件和类文件。请输入标准 Java 类路径。对于 Windows 系统,请使用分号 (;) 作为路径分隔符。对于 Unix 系统,请使用冒号 (:) 作为路径分隔符。
存储库目录 n
compiler.libDirectoryn
如果将其他 JAR 文件和类文件添加至类路径,请使用此字段指定这些文件所在的目录。
n 的第一个值必须为 1,并且它的值必须连续增加。
常规属性
要指定常规属性,请使用以下字段:
主目录
home
Info*Engine 根安装目录。Info*Engine 的根安装目录与 Windchill 的根安装目录 (wt.home) 相同。
服务器名称
ieServerName
Info*Engine 服务器或 servlet 所用任务处理器的名称。默认情况下会提供该值。
任务前缀
taskPrefix
URL 中所使用的参考 XML 业务任务的前缀。该前缀帮助 Servlet 确定是否向任务处理器或模板处理器发送请求。默认值为 /infoengine/servlet/IE/tasks/
Info*Engine servlet 为任务处理器提供以此前缀开头的 URL。例如,如果使用默认前缀,Web 服务器会命名为“myServer”,用户输入以下 URL:
http://myServer/infoengine/servlet/IE/tasks/myTask.xml
Info*Engine servlet 会将该 URL 递交至任务处理器,从而使其定位并执行“myTask.xml”。
前缀中的第一个条目必须设置为与您为应用程序 URL 输入的值相同。在配置 servlet 引擎以使用 Info*Engine servlet 运行时,对此进行设置。对于 JRun 和 Tomcat servlet 引擎,Windchill 为您设置前缀值和相应 servlet 引擎设置。
* 
PTC 建议不要更改前缀的 /servlet/IE/tasks/ 部分。如果您更改前缀的这一部分,则必须手动在 servlet 引擎中进行更改。如果您希望允许其他 URL 引用这些前缀,则可以在 Web 服务器中将 URL 重定向。
启动任务 n
startupTaskn
可以配置 Info*Engine 来在启动时执行特定任务。例如,可以自动生成“队列”或“事件”预定。n 的第一个值必须为 1,并且它的值必须连续递增,如下例所示:
com.infoengine.startupTask1=msg/subscribeQueue.xml
该属性的值为启动 Info*Engine 时开始的任务的路径。
有关详细信息,请参阅 Info*Engine Tasks
XML 解析器调试
request.xmlParser.debug
启用 XML 解析器调试。解析传入的 XML 时,会出于调试目的而打印信息。
请求调试
request.xmlStream.debug
启用 XML 日志记录请求。这会出于调试目的打印传入的 XML。
Send-Mail Webject 属性
Send-Mail webject 可创建和发送电子邮件消息。配置 Send-Mail webject 属性允许您在执行该 webject 时设置某些默认值。
有关详细信息,请参阅配置·Send-Mail 属性Send-Mail webject 说明
默认邮件创作者
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 参数。
属性管理器属性
首次登录到“属性管理”实用程序时,“基础 URI”值会自动生成。稍后可以在 servlet 设置中配置此信息。
管理基础 URI
“属性管理”实用程序用户界面的默认基础 URI。该值决定了在“属性管理”主页中列出哪些服务、适配器和属性集。
指定一个指向可配置属性位置的完全限定 LDAP URL。
动态属性配置
服务或适配器的配置信息可在服务或适配器运行时更新,这样无需重新启动便可更新属性。
“有效时间”属性用于指定自动重新加载服务或适配器的属性前经过的时间 (以分钟为单位)。仅当这些属性可以访问时,才能自动重新加载。默认情况下,属性不过期。
其他属性
如果未在表单中定义属性,则可将其添加到“其他特性”字段中。添加其他属性时,属性名称格式将包括适配器条目的名称 (服务名称),后跟属性名称。例如:
<service_name>.dbuser
在相应的字段中,指定服务或适配器使用的属性以及该属性的值。单击新属性名称旁边的“添加”以打开可修改属性值的文本框。
如果值过长而无法完整显示,则会出现“编辑”操作。单击“编辑”可打开一个含有较大文本区域的新浏览器窗口。