特定于连接器的配置属性提供连接器在运行时需要的信息。特定于连接器的属性还提供了一种方式,更改连接器框架和特定于应用程序的连接器组件内静态信息或逻辑而不必重新编码和重新构建连接器。
表 52
是特定于连接器的配置属性的快速参考。模块列包含使用相关属性的连接器模块的列表。
名称 | 可能的值 | 缺省值 | 模块 |
---|---|---|---|
ABAPDebug | true 或 false | false | ABAP 扩展
BAPI HDR |
AleEventDir | path |
| ALE |
AleUpdateStatus | true 或 false | false | ALE |
AleSelectiveUpdate | IDocType:MessageType |
| ALE |
AleStatusMsgCode | 消息代码 |
| ALE |
AleSuccessCode | 52 或 53 | 52 | ALE |
AleFailureCode | 68 或 58 | 68 | ALE |
AleSuccessText | 成功文本 |
| ALE |
AleFailureText | 失败文本 |
| ALE |
ApplicationPassword |
| SOFTWARE | 全部 |
ApplicationUserName |
| CROSSWORLDS | 全部 |
ArchiveDays |
|
| ALE |
Client |
|
| 全部 |
Group | 表示一组应用程序服务器的登录组的任何有效名称 |
| 全部 |
gwService | 网关服务器标识 | sapgw00 | RFC 服务器 ALE |
Hostname | IP 地址或服务器名称 |
| 全部 |
Language |
| E | 全部 |
MaxNumberOfConnections |
| 2 | ABAP 扩展、
ALE(仅限于请求处理)和 BAPI HDR |
Modules | 模块名称 |
| 全部 |
Namespace | true 或 false | true | ABAP 扩展 |
NumberOfListeners | 任何正整数 | 1 | RFC 服务器和
ALE |
PollQuantity | 任何正整数 | 20 | ABAP 扩展和
ALE |
RefreshLogonCycle | true | true | 全部 |
RfcProgramId | 程序标识 | CWLDSERVER | RFC 服务器和
ALE |
RfcTraceOn | true 或 false | false | 全部 |
SAPALE_Archive_Queue | 任何有效的 MQ Series 队列名 |
| ALE |
SAPALE_Event_Queue | 任何有效的 MQ Series 队列名 |
| ALE |
SAPALE_Wip_Queue | 任何有效的 MQ Series 队列名 |
| ALE |
SAPALE_Error_Queue |
|
|
|
SAPALE_Unsubscribed_Queue |
|
|
|
SAPSystemID | SAP R/3 系统的逻辑名称 |
| 全部 |
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 | true 或 false | True | ALE |
IDocSuccessCode | 12 |
| ALE |
IDocFailureCode | 11 |
| ALE |
IDocSuccessText | 分派成功 |
| ALE |
IDocFailureText | 分派失败 |
| ALE |
UseDefaults | true 或 false | false | ABAP 扩展
ALE BAPI |
指定连接器在开始处理业务对象时是否对适当的功能模块调用 ABAP 调试器。当此属性设置为 true 时,连接器对以下连接器模块打开 ABAP 调试器:
仅当您已执行以下操作时,连接器才调用 ABAP 调试器:
缺省值是 false。
指定由 ALE 模块用来将事件写入日志和恢复事件的 event 目录的根目录(\ale)位置。当连接器首次启动时,如果它在启动连接器的目录中未找到该根目录,则它会创建该目录和 event 子目录:
例如,如果连接器位于 \connectors\SapConnector1(在产品目录中),则连接器创建以下目录:
\connectors\SapConnector1\ale
UNIX |
---|
如果您首次启动连接器时未在连接器的目录中,则连接器在您启动连接器的目录中创建该根目录,而不考虑此属性的值。 |
有关更多信息,请参阅ALE 模块概述。
缺省值为:
UNIX |
---|
$<ProductNameDir>/connectors/SAP/ale |
Windows |
---|
%ProductNameDir%\connectors\SAP\ale |
指定审计跟踪是否对于所有消息类型都是必需的。要使连接器在 ALE 模块已检索 IDoc 对象进行事件处理之后更新标准 SAP 状态码,必须将此属性设置为 true。
有关更多信息,请参阅ALE 模块概述。
缺省值是 false。
指定当配置连接器以更新标准 SAP 状态码时要更新哪些 IDocType 和 MessageType 组合。仅当 AleUpdateStatus 已设置为 true 时您才能为此属性定义值。
此属性的语法为:
IDocType:MessageType[,IDocType:MessageType [,...]]
其中冒号(:)定界符分隔每个 IDocType 和 MessageType,逗号(,)定界符分隔集合中的条目。以下示例举例说明了两个集合。在该示例中,MATMAS03 和 DEBMAS03 是 IDoc,MATMAS 和 DEBMAS 是消息类型:
MATMAS03:MATMAS,DEBMAS03:DEBMAS
有关更多信息,请参阅ALE 模块概述。
如果需要,则指定当连接器记入 ALEAUD 消息 IDoc(ALEAUD01)时要使用的消息代码。在接收伙伴概要文件中配置此消息代码。仅当 AleUpdateStatus 已设置为 true 时您才能为此属性定义值。
有关更多信息,请参阅配置 SAP 以更新 IDoc 状态。
指定“已记入应用程序文档”的成功状态码。要使连接器在 ALE 模块已检索 IDoc 对象进行事件处理之后更新 SAP 成功状态码,您必须为此属性指定值(52 或 53)。SAP 将此值转换为状态 41(在接收系统中已创建应用程序文件)。
有关更多信息,请参阅ALE 模块概述。
指定分派失败的状态码。要使连接器在 ALE 模块已检索 IDoc 对象进行事件处理之后更新 SAP 失败状态码,您必须为此属性指定值(68 或 58)。SAP 将此值转换为 40。
有关更多信息,请参阅ALE 模块概述。
指定成功的“已记入应用程序文档”的描述文本。即使当您将 AleUpdateStatus 设置为 true 时,为此属性指定值也是可选的。
有关更多信息,请参阅ALE 模块概述。
指定分派失败的描述文本。即使当您将 AleUpdateStatus 设置为 true 时,为此属性指定值也是可选的。
有关更多信息,请参阅ALE 模块概述。
SAP 应用程序中连接器的用户帐户的密码。缺省值为 SOFTWARE。
SAP 应用程序中连接器的用户帐户的名称。缺省值为 CROSSWORLDS。
ArchiveDays 连接器配置属性确定应在多少天之后从请求目录中删除“TID 管理”文件。内部保持的缺省值是 7 天。还可以指定部分日期值,例如,1.234。
连接器登录所使用的客户机号,通常是 100。
当配置连接器以获取负载均衡时,指定表示一组应用程序服务器的登录组的名称。有关更多信息,请参阅利用负载均衡。
网关服务器标识符;通常为 sapgw00。00 是运行 SAP 网关的服务器(通常是应用程序服务器)的系统号,如果您具有多个服务器,则可能不是 00。缺省值为 sapgw00。
当配置连接器以获取负载均衡时,指定消息服务器的名称。当配置连接器以在没有负载均衡的情况下运行时,指定服务器登录的应用程序服务器的 IP 地址或名称。在这两种情况下,连接器假定网关主机的名称与为此属性指定的值相同。
连接器登录所用的语言。缺省值为 E,表示英语。
连接器和 SAP 应用程序之间可能的最大并发交互数。这些交互包括轮询事件和处理服务调用请求。仅 ABAP 扩展、BAPI 和 ALE 模块使用此属性。ALE 模块仅将此属性用于服务调用请求。
因为每个交互都使用 SAP 应用程序服务器上的一个对话进程,所以连接数不能超过可用的对话进程数。有关更多信息,请参阅处理多个并发交互。
如果没有为此属性指定值,则连接器使用缺省值 2。
标识由连接器用来执行 init()、pollForEvents() 和 Terminate() 请求的模块。特别是,它指定由可视连接器框架使用的连接器模块。通过用逗号分隔每个值来指定多个连接器模块。不要添加空格。
受支持的连接器模块和指定它们的语法如下:
ABAP 扩展模块 - Extension
ALE 模块 - ALE
BAPI 模块 - Bapi
RFC 服务器模块 - RfcServer
分层动态检索模块 - Bapi
指定连接器是否使用在连接器的名称空间 /CWLD/ 中定义的 ABAP 组件。该值必须设置为 true ,以便连接器使用在该名称空间中定义的 ABAP 组件。缺省值是 true。
指定当初始化连接器时创建的侦听器线程数。侦听器线程一次可以处理一个请求。由于每个侦听器线程一次处理单个事件;因此,如果您具有多个侦听器线程,则连接器可以同时处理多个事件。缺省值为 1。
建议您不要让侦听器线程数超过 SAP 中可用的工作进程数。
定义单个轮询选取的最大事件数。缺省值为 20。
指定是否要对 SAP 客户机连接释放所有资源。缺省值为 false。
连接器在 SAP 网关中注册的标识,以便侦听器线程可以处理来自 RFC 支持功能的事件。此值必须与 SAP 应用程序(事务 SM59)中注册的程序标识匹配。缺省值是 CWLDSERVER。
有关在 SAP 应用程序中配置程序标识的更多信息,请参阅向 SAP 网关注册 RFC 服务器模块。
指定是否生成详细说明每个侦听器线程的 RFC 活动的文本文件。您可以指定值 true 或 false。值 true 激活跟踪并生成一个文本文件。建议您仅在开发环境中使用这些文本文件,因为这些文件可能会快速增长。缺省值为 false。
指定在 ALE 模块处理完事件之后归档 TID 和 IDoc 数据的 MQ Series 队列。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
指定在 ALE 模块处理事件期间存储 TID 和 IDoc 数据的 MQ Series 队列。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
指定当 ALE 模块构建事件队列的 MQ 消息时保存 TID 和 IDoc 数据的 MQ Series 正在进行的工作(wip)队列。连接器在接收到事件的所有数据之后,它将此队列中的数据移至 SAPALE_Event_Queue。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
定义一个队列来处理在 WIP 队列和事件队列之间失败的 MQ 消息。有关更多信息,请参阅ALE 模块概述。
定义一个队列来收集未预订的 IDoc 对象。未预订的 IDoc 对象先前放置在“归档”队列中。可以使用事件管理实用程序重新提交这些消息。现在,连接器在处理从 SAP 到连接器的数据时检查预订,这导致在启动协作前事务保留在 SAP 中。有关更多信息,请参阅ALE 模块概述。
当配置连接器以获取负载均衡时,指定 SAP R/3 系统的逻辑名,它也称为 R3name。有关更多信息,请参阅利用负载均衡。
指定 MQ Series 队列管理器的客户机通道。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
指定用来与 MQ Series 队列管理器通信的端口,该队列管理器处理 ALE 模块的队列。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
指定包含 TID 和 TID 状态的消息驻留的 MQ Series 队列。ALE 模块仅在处理请求时才使用此属性。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
存储 TID 和 IDoc 数据的队列的 MQ Series 队列管理器名称。ALE 模块使用此属性来处理事件和请求。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
MQ Series 队列管理器驻留的主机的名称。ALE 模块使用此属性来处理事件和请求。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
登录到 MQ Series 队列管理器的用户名。ALE 模块使用此属性来处理事件和请求。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
登录到 MQ Series 队列管理器的用户的密码。ALE 模块使用此属性来处理事件和请求。有关更多信息,请参阅ALE 模块概述。
没有缺省值。
应用程序服务器的系统号。该值是一个两位数,通常为 00。缺省值为 00。
保留与 DATE 和 TIME 字段值一起提供的定界符。如果设置为 Legacy,则连接器将保留 DATE 和 TIME 字段的定界符。否则,将除去定界符,并且值的长度将遵照属性定义长度。
指出是否所有消息类型都需要审计跟踪。
分派成功的标准 IDoc 状态码。
分派失败的标准 IDoc 状态码。
与分派成功的 IDocSuccessCode 相关联的 IDoc 状态消息文本。
与分派失败的 IDocFailureCode 相关联的 IDoc 状态消息文本。
在执行“创建”或“更新”操作时,如果 UseDefaults 设置为 true,则集成代理程序的适配器框架检查是否为标记为必需的每个业务对象属性提供了有效值或缺省值。如果提供了值,则“创建”或“更新”操作成功。如果该参数设置为 false ,则连接器仅检查有效值,并在未提供有效值时使“创建”或“更新”操作失败。缺省值为 false。