消息连接器配置设置

要配置消息连接器，您可以修改一个名为 MessageConnectorConfig.xml 的 XML 文件，此文件位于 Interact 运行时服务器上的消息连接器目录中，通常是 <Interact_home>/msgconnector/config/MessageConnectorConfig.xml。以下描述了此 XML 文件中的每个配置。请注意，如果在消息连接器已部署且在运行之后修改此文件，请务必在完成修改此文件之后，取消部署消息连接器，然后重新部署，或者重新启动应用程序服务器以重新装入这些设置。

下表包含 MessageConnectorConfig.xml 文件的 generalSettings 节中可选设置和必需设置的列表。

消息连接器常规设置
元素	描述	缺省值
<interactURL>	用于处理来自消息连接器页面标记的 Interact 运行时服务器（如运行消息连接器的运行时服务器）的 URL。该元素是必需的。	http://localhost:7001/interact
<defaultDateTimeFormat>	缺省日期格式。	MM/dd/yyyy
<log4jConfigFileLocation>	Log4j 属性文件的位置。此位置相对于 $MESSAGE_CONNECTOR_HOME 环境变量（如果已设置）；如果未设置此环境变量，那么此值是相对于消息连接器 Web 应用程序的根路径。	config/MessageConnectorLog4j.properties

消息连接器常规设置

元素

描述

缺省值

用于处理来自消息连接器页面标记的 Interact 运行时服务器（如运行消息连接器的运行时服务器）的 URL。该元素是必需的。

http://localhost:7001/interact

缺省日期格式。

MM/dd/yyyy

Log4j 属性文件的位置。此位置相对于 $MESSAGE_CONNECTOR_HOME 环境变量（如果已设置）；如果未设置此环境变量，那么此值是相对于消息连接器 Web 应用程序的根路径。

config/MessageConnectorLog4j.properties

下表包含 MessageConnectorConfig.xml 文件的 defaultParameterValues 节中可选设置和必需设置的列表。

消息连接器缺省参数设置
元素	描述	缺省值
<interactiveChannel>	缺省交互式渠道的名称。
<interactionPoint>	缺省交互点的名称。
<debugFlag>	确定是否启用调试。允许的值为 true 和 false。	false
<contactEventName>	所发布的联系事件的缺省名称。
<acceptEventName>	所发布的接受事件的缺省名称。
<imageUrlAttribute>	包含商品图像的 URL 的缺省商品属性名称（如果消息连接器链接中未指定属性名称）。
<landingPageUrlAttribute>	点击链接登录页面的缺省 URL（如果消息连接器链接中未指定 URL）。

确定是否启用调试。允许的值为 true 和 false。

false

所发布的联系事件的缺省名称。

所发布的接受事件的缺省名称。

包含商品图像的 URL 的缺省商品属性名称（如果消息连接器链接中未指定属性名称）。

点击链接登录页面的缺省 URL（如果消息连接器链接中未指定 URL）。

下表包含 MessageConnectorConfig.xml 文件的 behaviorSettings 节中可选设置和必需设置的列表。

下表包含 MessageConnectorConfig.xml 文件的 storageSettings 节中可选设置和必需设置的列表。

消息连接器存储设置
元素	描述	缺省值
<persistenceMode>	当高速缓存将新条目保存到数据库时。允许的值为 WRITE-BEHIND（数据最初写入到高速缓存，随后更新到数据库）和 WRITE-THROUGH（数据同时写入到高速缓存和数据库）。	WRITE-THROUGH
<maxCacheSize>	内存高速缓存中条目的最大数量。	5000
<maxPersistenceBatchSize>	将条目保存到数据库时的最大批处理大小。	200
<macCachePersistInterval>	在将某一条目保存到数据库之前，其在高速缓存中停留的最大时间（以秒为单位）。	3
<maxElementOnDisk>	磁盘高速缓存中条目的最大数量。	5000
<cacheEntryTimeToExpireInSeconds>	对于磁盘高速缓存中条目，在到期之前可保持的最大时间长度。	60000
<jdbcSettings>	包含特定信息的 XML 文件的节（如果使用 JDBC 连接）。此节与 <dataSourceSettings> 节互斥。	缺省情况下配置为连接到在本地服务器上配置的 SQL Server 数据库，但是如果启用此节，那么必须提供实际的 JDBC 设置和凭证才能登录。
<dataSourceSettings>	包含特定信息的 XML 文件的节（如果使用数据源连接）。此节与 <jdbcSettings> 节互斥。	缺省情况下配置为连接到本地 Web 应用程序服务器上定义的 InteractDS 数据源。

当高速缓存将新条目保存到数据库时。允许的值为 WRITE-BEHIND（数据最初写入到高速缓存，随后更新到数据库）和 WRITE-THROUGH（数据同时写入到高速缓存和数据库）。

在将某一条目保存到数据库之前，其在高速缓存中停留的最大时间（以秒为单位）。

磁盘高速缓存中条目的最大数量。

5000

对于磁盘高速缓存中条目，在到期之前可保持的最大时间长度。

60000

包含特定信息的 XML 文件的节（如果使用 JDBC 连接）。此节与 <dataSourceSettings> 节互斥。

缺省情况下配置为连接到在本地服务器上配置的 SQL Server 数据库，但是如果启用此节，那么必须提供实际的 JDBC 设置和凭证才能登录。

包含特定信息的 XML 文件的节（如果使用数据源连接）。此节与 <jdbcSettings> 节互斥。

缺省情况下配置为连接到本地 Web 应用程序服务器上定义的 InteractDS 数据源。

下表包含 MessageConnectorConfig.xml 文件的 audienceLevels 节中可选设置和必需设置的列表。

在此示例中，缺省属性的值与此节中定义的 audienceLevel 的名称相匹配。此配置文件中必须至少定义一个受众级别。

消息连接器受众级别设置
元素	元素	描述	缺省值
<audienceLevel>		包含受众级别配置的元素。提供一个名称属性，如 <audienceLevel name="Customer"> 中一样
	<messageLogTable>	日志表的名称。此值是必需的。	UACI_MESSAGE_CONNECTOR_LOG
<fields>	<field>	此 audienceLevel 的一个或多个受众标识字段的定义。
	<name>	受众标识字段的名称，如 Interact 运行时中所指定。
	<httpParameterName>	此受众标识字段的对应参数名称。
	<dbColumnName>	数据库中此受众标识字段的对应列名称。
	<type>	受众标识字段的类型，如 Interact 运行时中所指定。值可以是 string 或 numeric。

包含受众级别配置的元素。提供一个名称属性，如 <audienceLevel name="Customer"> 中一样

日志表的名称。此值是必需的。

UACI_MESSAGE_CONNECTOR_LOG

<field>

此 audienceLevel 的一个或多个受众标识字段的定义。

<name>

受众标识字段的名称，如 Interact 运行时中所指定。

此受众标识字段的对应参数名称。

数据库中此受众标识字段的对应列名称。

<type>

受众标识字段的类型，如 Interact 运行时中所指定。值可以是 string 或 numeric。