特定于连接器的配置属性

特定于连接器的配置属性提供连接器在运行时需要的信息。特定于连接器的属性还提供了一种方式,更改连接器框架和特定于应用程序的连接器组件内静态信息或逻辑而不必重新编码和重新构建连接器。

表 55 是特定于连接器的配置属性的快速参考。模块列包含使用相关属性的连接器模块的列表。

表 55. 特定于连接器的配置属性的快速参考
名称 可能的值 缺省值 模块
ABAPDebug truefalse false ABAP 扩展
BAPI
HDR
AleEventDir path
ALE
AleUpdateStatus truefalse false ALE
AleSelectiveUpdate IDocType:MessageType
ALE
AleStatusMsgCode 消息代码
ALE
AleSuccessCode 5253 52 ALE
AleFailureCode 6858 68 ALE
AleSuccessText 成功文本
ALE
AleFailureText 失败文本
ALE
ApplicationPassword
SOFTWARE 全部
ApplicationUserName
CROSSWORLDS 全部
ArchiveDays

ALE
Client

全部
Group 表示一组应用程序服务器的登录组的任何有效名称
全部
gwService 网关服务器标识 sapgw00 RFC 服务器 ALE
Hostname IP 地址服务器名称
全部
InDoubtEvents Reprocess、FailOnStartUp、
LogError 或 Ignore
Ignore ABAP 扩展
Language
E 全部
MaxNumberOfConnections
2 ABAP 扩展和
ALE(仅限于请求处理)和
BAPI HDR
Modules 模块名称
全部
Namespace truefalse true ABAP 扩展
NumberOfListeners 任何正整数 1 RFC 服务器和

ALE

PollQuantity 任何正整数 20 ABAP 扩展和

ALE

RefreshLogonCycle true true 全部
RfcProgramId 程序标识 CWLDSERVER RFC 服务器和
ALE
RfcTraceOn truefalse false 全部
SAPALE_Archive_Queue 任何有效的 WebSphere MQ 队列名
ALE
SAPALE_Event_Queue 任何有效的 WebSphere MQ 队列名
ALE
SAPALE_Wip_Queue 任何有效的 WebSphere MQ 队列名
ALE
SAPALE_Error_Queue


SAPALE_Unsubscribed_Queue


SAPSystemID SAP 系统的逻辑名
全部
SAPtid_MQChannel 任何有效的 MQ 通道
ALE
SAPtid_MQPort 任何有效的 MQ 端口
ALE
SAPtid_Queue 任何有效的 MQ 队列名
ALE(仅限于请求处理)
SAPtid_QueueManager 任何有效的 MQ 队列管理器名
ALE
SAPtid_QueueManagerHost 任何有效的 MQ 队列管理器主机名
ALE
SAPtid_QueueManagerLogin 任何有效的 MQ 队列管理器登录名
ALE
SAPtid_QueueManagerPassword 任何有效的 MQ 队列管理器密码
ALE
Sysnr 系统号 00 全部
DateTimeFormat 无或 legacy
全部
TransIdCollabName

不再受支持
UpdateIDocStatus truefalse True ALE
IDocSuccessCode 12
ALE
IDocFailureCode 11
ALE
IDocSuccessText 分派成功
ALE
IDocFailureText 分派失败
ALE
UseDefaults truefalse false ABAP 扩展
ALE
BAPI

ABAPDebug

指定连接器在开始处理业务对象时是否对适当的功能模块调用 ABAP 调试器。当此属性设置为 true 时,连接器对以下连接器模块打开 ABAP 调试器:

仅当您已执行以下操作时,连接器才调用 ABAP 调试器:

注:
您只能在打开调试器之后添加断点。
重要提示:
在生产环境中,此属性应始终设置为 false

缺省值是 false

AleEventDir

指定由 ALE 模块用来将事件写入日志和恢复事件的 event 目录的根目录(\ale)位置。当连接器首次启动时,如果它在启动连接器的目录中未找到该根目录,则它会创建该目录和 event 子目录:

例如,如果连接器位于 \connectors\SapConnector1(在产品目录中),则连接器创建以下目录:

\connectors\SapConnector1\ale
 
UNIX

如果您首次启动连接器时未在连接器的目录中,则连接器在您启动连接器的目录中创建该根目录,而不考虑此属性的值。

有关更多信息,请参阅ALE 模块概述

缺省值为:
UNIX

$<ProductNameDir>/connectors/SAP/ale

Windows

%ProductNameDir%\connectors\SAP\ale

AleUpdateStatus

指定审计跟踪是否对于所有消息类型都是必需的。此属性必须设置为 true,以使连接器在 ALE 模块已检索 IDoc 对象进行事件处理之后更新标准 SAP 状态码。

有关更多信息,请参阅ALE 模块概述

缺省值是 false

AleSelectiveUpdate

指定当配置连接器以更新标准 SAP 状态码时要更新哪些 IDocType 和 MessageType 组合。仅当 AleUpdateStatus 已设置为 true 时您才能为此属性定义值。

此属性的语法为:

IDocType:MessageType[,IDocType:MessageType [,...]]
 

其中冒号(:)定界符分隔每个 IDocType 和 MessageType,逗号(,)定界符分隔集合中的条目。以下示例举例说明了两个集合。在该示例中,MATMAS03 DEBMAS03 是 IDoc,MATMASDEBMAS 是消息类型:

MATMAS03:MATMAS,DEBMAS03:DEBMAS
 

有关更多信息,请参阅ALE 模块概述

AleStatusMsgCode

如果需要,则指定当连接器记入 ALEAUD 消息 IDoc(ALEAUD01)时要使用的消息代码。在接收伙伴概要文件中配置此消息代码。仅当 AleUpdateStatus 已设置为 true 时您才能为此属性定义值。

有关更多信息,请参阅配置 SAP 以更新 IDoc 状态

AleSuccessCode

指定“已记入应用程序文档”的成功状态码。要使连接器在 ALE 模块已检索 IDoc 对象进行事件处理之后更新 SAP 成功状态码,您必须为此属性指定值(5253)。SAP 将此值转换为状态 41(在接收系统中已创建应用程序文件)。

有关更多信息,请参阅ALE 模块概述

AleFailureCode

指定分派失败的状态码。要使连接器在 ALE 模块已检索 IDoc 对象进行事件处理之后更新 SAP 失败状态码,您必须为此属性指定值(6858)。SAP 将此值转换为 40

有关更多信息,请参阅ALE 模块概述

AleSuccessText

指定成功的“已记入应用程序文档”的描述文本。即使当您将 AleUpdateStatus 设置为 true 时,为此属性指定值也是可选的。

有关更多信息,请参阅ALE 模块概述

AleFailureText

指定分派失败的描述文本。即使当您将 AleUpdateStatus 设置为 true 时,为此属性指定值也是可选的。

有关更多信息,请参阅ALE 模块概述

ApplicationPassword

SAP 应用程序中连接器的用户帐户的密码。缺省值为 SOFTWARE

ApplicationUserName

SAP 应用程序中连接器的用户帐户的名称。缺省值为 CROSSWORLDS

ArchiveDays

ArchiveDays 连接器配置属性确定应在多少天之后从请求目录中删除 TIDManagement 文件。内部保持的缺省值是 7 天。还可以指定部分日期值,例如,1.234

Client

连接器登录所使用的客户机号,通常是 100

Group

当配置连接器以获取负载均衡时,指定表示一组应用程序服务器的登录组的名称。有关更多信息,请参阅利用负载均衡

gwService

网关服务器标识符;通常为 sapgw0000 是运行 SAP 网关的服务器(通常是应用程序服务器)的系统号,如果您具有多个服务器,则可能不是 00。缺省值为 sapgw00

Hostname

当配置连接器以获取负载均衡时,指定消息服务器的名称。当配置连接器以在没有负载均衡的情况下运行时,指定服务器登录的应用程序服务器的 IP 地址或名称。在这两种情况下,连接器假定网关主机的名称与为此属性指定的值相同。

InDoubtEvents

InDoubtEvents 描述如何处理事件表中正在进行的事件。Reprocess 重新处理事件表中正在进行的事件。FailOnStartup 在找到正在进行的事件时将关闭连接器并将一条致命错误写入日志。LogError 将一个错误写入日志,以通知正在进行的事件在事件表中。Ignore 忽略正在进行的事件。

Language

连接器登录所用的语言。缺省值为 E,表示英语。

MaxNumberOfConnections

连接器和 SAP 应用程序之间可能的最大并发交互数。这些交互包括轮询事件和处理服务调用请求。仅 ABAP 扩展、BAPI 和 ALE 模块使用此属性。ALE 模块仅将此属性用于服务调用请求。

因为每个交互都使用 SAP 应用程序服务器上的一个对话进程,所以连接数不能超过可用的对话进程数。有关更多信息,请参阅处理多个并发交互

如果没有为此属性指定值,则连接器使用缺省值 2。

Modules

标识由连接器用来执行 init()pollForEvents()Terminate() 请求的模块。特别是,它指定由可视连接器框架使用的连接器模块。通过用逗号分隔每个值来指定多个连接器模块。不要添加空格。

受支持的连接器模块和指定它们的语法如下:

ABAP 扩展模块 - Extension

ALE 模块 - ALE

BAPI 模块 - Bapi

RFC 服务器模块 - RfcServer

Namespace

指定连接器是否使用在连接器的名称空间 /CWLD/ 中定义的 ABAP 组件。该值必须设置为 true ,以便连接器使用在该名称空间中定义的 ABAP 组件。缺省值是 true

NumberOfListeners

指定当初始化连接器时创建的侦听器线程数。侦听器线程一次可以处理一个请求。由于每个侦听器线程一次处理单个事件;因此,如果您具有多个侦听器线程,则连接器可以同时处理多个事件。缺省值为 1。

建议您不要让侦听器线程数超过 SAP 中可用的工作进程数。

PollQuantity

定义单个轮询选取的最大事件数。缺省值为 20

RefreshLogonCycle

指定是否要对 SAP 客户机连接释放所有资源。缺省值为 false

RfcProgramId

连接器在 SAP 网关中注册的标识,以便侦听器线程可以处理来自 RFC 支持功能的事件。此值必须与 SAP 应用程序(事务 SM59)中注册的程序标识匹配。缺省值是 CWLDSERVER

有关在 SAP 应用程序中配置程序标识的更多信息,请参阅向 SAP 网关注册 RFC 服务器模块

RfcTraceOn

指定是否生成详细说明每个侦听器线程的 RFC 活动的文本文件。您可以指定值 truefalse。值 true 激活跟踪并生成一个文本文件。建议您仅在开发环境中使用这些文本文件,因为这些文件可能会快速增长。缺省值为 false

SAPALE_Archive_Queue

指定在 ALE 模块处理完事件之后归档 TID 和 IDoc 数据的 WebSphere MQ 队列。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPALE_Event_Queue

指定在 ALE 模块处理事件期间存储 TID 和 IDoc 数据的 WebSphere MQ 队列。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPALE_Wip_Queue

指定当 ALE 模块构建事件队列的 MQ 消息时保存 TID 和 IDoc 数据的 WebSphere MQ 正在进行的工作(wip)队列。连接器在接收到事件的所有数据之后,它将此队列中的数据移至 SAPALE_Event_Queue。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPALE_Error_Queue

定义一个队列来处理在 WIP 队列和事件队列之间失败的 MQ 消息。有关更多信息,请参阅ALE 模块概述

SAPALE_Unsubscribed_Queue

定义一个队列来收集未预订的 IDoc 对象。未预订的 IDoc 对象先前放置在“归档”队列中。可以使用事件管理实用程序重新提交这些消息。现在,连接器在处理从 SAP 到连接器的数据时检查预订,这导致在启动协作前事务保留在 SAP 中。有关更多信息,请参阅ALE 模块概述

SAPSystemID

当配置连接器以获取负载均衡时,指定 SAP 系统的逻辑名,它也称为 R3name。有关更多信息,请参阅利用负载均衡

SAPtid_MQChannel

指定 WebSphere MQ 队列管理器的客户机通道。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPtid_MQPort

指定用来与 WebSphere MQ 队列管理器通信的端口,该队列管理器处理 ALE 模块的队列。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPtid_Queue

指定包含 TID 和 TID 状态的消息所驻留的 WebSphere MQ 队列。ALE 模块仅在处理请求时才使用此属性。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPtid_QueueManager

存储 TID 和 IDoc 数据的队列的 WebSphere MQ 队列管理器的名称。ALE 模块使用此属性来处理事件和请求。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPtid_QueueManagerHost

WebSphere MQ 队列管理器驻留的主机的名称。ALE 模块使用此属性来处理事件和请求。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPtid_QueueManagerLogin

登录到 WebSphere MQ 队列管理器的用户名。ALE 模块使用此属性来处理事件和请求。有关更多信息,请参阅ALE 模块概述

没有缺省值。

SAPtid_QueueManagerPassword

登录到 WebSphere MQ 队列管理器的用户的密码。ALE 模块使用此属性来处理事件和请求。有关更多信息,请参阅ALE 模块概述

没有缺省值。

Sysnr

应用程序服务器的系统号。该值是一个两位数,通常为 00。缺省值为 00

DateTimeFormat

保留与 DATETIME 字段值一起提供的定界符。如果设置为 Legacy,则连接器将保留 DATETIME 字段的定界符。否则,将除去定界符,并且值的长度将遵照属性定义长度。

TransIdCollabName

重要提示:
连接器不再支持此属性。

UpdateIDocStatus

指出是否所有消息类型都需要审计跟踪。

IDocSuccessCode

分派成功的标准 IDoc 状态码。

IDocFailureCode

分派失败的标准 IDoc 状态码。

IDocSuccessText

与分派成功的 IDocSuccessCode 相关联的 IDoc 状态消息文本。

IDocFailureText

与分派失败的 IDocFailureCode 相关联的 IDoc 状态消息文本。

UseDefaults

在执行“创建”或“更新”操作时,如果 UseDefaults 设置为 true,则集成代理程序的适配器框架检查是否为标记为必需的每个业务对象属性提供了有效值或缺省值。如果提供了值,则“创建”或“更新”操作成功。如果该参数设置为 false ,则连接器仅检查有效值,并在未提供有效值时使“创建”或“更新”操作失败。缺省值为 false

Copyright IBM Corp. 1997, 2004