了解适用于 Oracle 电子商务套件的 BizTalk 适配器绑定属性

适用于 Oracle 电子商务套件的 Microsoft BizTalk 适配器显示多个绑定属性。 通过设置这些属性,可以控制适配器的一些行为。 本部分介绍 Oracle 电子商务适配器绑定属性。 它还演示了如何使用 .NET 编程或在物理端口绑定上设置BizTalk Server访问它们。

适配器绑定属性

Oracle 电子商务套件是基础 Oracle 数据库上的应用程序层。 某些绑定属性在与 Oracle E-Business Suite 交互时配置适配器的行为,而其他属性在与 Oracle 数据库交互时配置该行为。 下表显示了按类别分组的所有 Oracle 电子商务适配器绑定属性。 类别是指以下节点:每个绑定属性都显示在不同应用程序呈现的对话框中,以配置适配器 (或绑定) 。

绑定属性 类别 说明 .NET 类型
ClientCredentialType 常规 指定在建立与 Oracle 电子商务套件的连接时指定的凭据集。 可能的值为 Database 和EBusiness

- 如果设置为 "数据库",适配器客户端必须指定数据库凭据来建立连接,并指定 OracleUserNameOraclePassword 绑定属性的 E-Business Suite 凭据。

- 如果设置为 EBusiness,适配器客户端必须指定 E-Business Suite 凭据,以建立 连接以及 OracleUserNameOraclePassword 绑定属性的数据库凭据。

重要: 如果 ClientCredentialType 绑定属性设置为 EBusiness,则指定 OracleUserNameOraclePassword 绑定属性的数据库用户名和密码是必需的。

默认值为 Database
枚举 (ClientCredential)
CloseTimeout 常规 WCF 连接关闭超时。 指定一个时间跨度值,该值指示为完成内部 WCF 通道关闭操作提供的时间间隔。 默认值为 1 分钟。 不支持。 System.TimeSpan
EnableBizTalkCompatibilityMode 常规 指定适配器如何为数据集生成架构。 将此选项设置为 True 可正确生成 DataSet 的架构。

使用来自 BizTalk Server 的适配器时,必须始终将 属性设置为 True。 使用来自 Visual Studio 的适配器时,必须始终将 属性设置为 False
bool (System.Boolean)
InboundOperationType 常规 指定是否要执行轮询 通知 入站 操作。 默认值为 "轮询"

有关轮询详细信息 请参阅 对使用轮询的入站调用的支持。 有关通知详细信息 请参阅使用数据库更改适配器接收数据库 更改Oracle Database注意事项
enum
名称 常规 一个只读值,该值返回插件中添加适配器服务引用Visual Studio用于保存 WCF 客户端类的文件的名称。 "添加适配器服务引用插件"通过向 Name 属性的值追加"Client"来形成 文件名 。 返回的值为"OracleEBSBinding";对于此值,生成的文件将命名为"OracleEBSBindingClient"。 字符串
OpenTimeout 常规 WCF 连接打开超时。 指定一个时间跨度值,该值指示为内部通道打开操作完成提供的时间间隔。 默认值为 1 分钟。

重要: Oracle 电子商务适配器始终使用 OpenTimeout 在打开与 Oracle 数据库的连接时设置连接打开超时。 适配器忽略在打开 (() )时传递的任何 System.TimeSpan 超时值。
System.TimeSpan
ReceiveTimeout 常规 WCF 消息接收超时。 指定一个时间跨度值,该值指示适配器等待入站消息的最大时间间隔。 默认值为 10 分钟。

重要: 对于轮询等入站操作,建议将超时设置为最大可能值,即 24.20:31:23.6470000 (24) 。 将适配器与 BizTalk Server时,将超时设置为较大的值不会影响适配器的功能。
System.TimeSpan
SendTimeout 常规 WCF 消息发送超时。 指定一个时间跨度值,该值指示为完成内部通道发送操作提供的时间间隔。 默认值为 5 分钟。 System.TimeSpan
UseAmbientTransaction 常规 指定 Oracle 电子商务适配器是否使用调用方提供的事务上下文执行操作。 默认值 为 true,这意味着适配器始终在事务上下文中执行操作,前提是客户端提供事务上下文。 如果有其他资源参与该事务,则创建的连接在 System.Transaction 中登记,并提升为 MSDTC 事务。

但是,在某些情况下,你可能不希望适配器在事务上下文中执行操作。 例如:

- 在 Oracle 数据库上执行简单的 SELECT 操作 (发送端口上)

- 指定一个轮询语句,该语句执行 SELECT 操作并且不涉及通过 DELETE 语句或在接收端口上调用存储过程 (表的任何更改)

这两个操作不会对数据库表进行任何更新,因此,将这些操作提升为使用 MSDTC 事务可能会降低性能开销。 在这种情况下,可以将绑定属性设置为 false ,以便 Oracle 电子商务适配器不会在事务上下文中执行操作。

注意: 仅在不更改数据库的操作中,才建议不要在事务上下文中执行操作。 对于更新数据库中的数据的操作,建议将绑定属性设置为 true,否则可能会遇到消息丢失或重复消息,具体取决于是执行入站操作还是出站操作。
bool (System.Boolean)
DataFetchSize 缓冲区管理 ODP.NET 属性。 指定在一次服务器往返 ODP.NET 从结果集提取的数据量(以字节为单位)。 默认值为 65536。 此属性用于性能优化。 long (System.Int64)
InsertBatchSize 缓冲区管理 指定多个记录插入运算的批大小。 默认值为 20。 对于大于 1 的 InsertBatchSize 值,Oracle 电子商务适配器将指定的记录数批处理为单个 ODP.NET 调用。 如果"插入"操作中的记录数不是批大小的倍数,则最后一批包含的记录数将少于批大小值。 例如,如果插入消息有 10 条记录, 并且 InsertBatchSize 设置为 1,则适配器将读取单个记录并将其写入 Oracle 数据库。 因此,适配器对 Oracle 数据库执行 10 个单独的操作。 同样,如果插入消息有 10 条记录, 并且 InsertBatchSize 设置为 5,则适配器将一次读取 5 条记录并将其写入 Oracle 数据库,因此只执行 2 个插入操作。

InsertBatchSize 选择好的值可以极大地提高多个记录插入操作适配器的性能。
int (System.Int32)
LongDatatypeColumnSize 缓冲区管理 指定 Oracle long 数据类型列的最大大小(以字节为单位)。 此绑定属性的最大值可以是 32512。 默认值为 0。 如果不对 long 数据类型执行运算,则必须使用默认值。 如果需要,则必须为此绑定属性显式设置适当的值:

- 执行包含 long 数据类型的参数存储过程。

- 对包含具有长数据类型的列的表执行 Select 操作,SELECT 语句不包含主键列。

如果要设置此绑定属性的最大值,将该值设置为 -1

注意: 此绑定属性已弃用。
int
MaxOutputAssociativeArrayElements 缓冲区管理 指定适配器在执行在响应中返回关联数组的操作时创建的关联数组的大小。 适配器将数组的大小与 ODP.NET,而该大小又根据数组大小创建缓冲区。 默认值为 32。

当执行涉及 PL/表类型的操作时,SQL属性很有用。
int (System.Int32)
MetadataPooling 缓冲区管理 ODP.NET 属性。 指定是否 ODP.NET 执行查询的元数据信息。 默认值为 true,这将启用元数据池。 Caching此信息可提高性能;但是,如果 Oracle 系统上对基础 Oracle 项目进行更改,则此已池元数据将不同步。这可能会导致对 Oracle 系统执行的操作返回意外异常。 此属性用于性能优化。 bool (System.Boolean)
StatementCachePurge 缓冲区管理 ODP.NET 属性。 指定当 ODP.NET 连接池时,是否清除与连接关联的语句缓存。 默认值为 false,这将禁用语句缓存清除。 此属性用于性能优化。 bool (System.Boolean)
StatementCacheSize 缓冲区管理 ODP.NET 属性。 指定每个连接可以缓存的最大语句 ODP.NET 数。 将此属性设置为非零值可启用连接语句缓存。 默认值为 10。 此属性用于性能优化。 int (System.Int32)
OracleConnectionClientId 调试 指定适配器用于 (Oracle) 的客户端标识符和 ID。 如果已启用 Oracle 服务器端跟踪,并且想要有选择地跟踪特定客户端 ID 的操作,则这很有用。 这还允许基于客户端 ID 筛选和查看 Oracle 服务器跟踪。 字符串
EnablePerformanceCounters 诊断 指定是否启用 WCF LOB 适配器 SDK 性能计数器和 Oracle 电子商务适配器 LOB 延迟性能计数器。 默认值为 False;禁用性能计数器。 LOB 延迟性能计数器测量 Oracle 电子商务适配器调用 Oracle 电子商务套件所花费的总时间。 bool (System.Boolean)
EnableSafeTyping Metadata 启用或禁用安全键入。 默认值为 false;已禁用安全类型。 此功能控制适配器如何显示某些 Oracle 数据类型。 有关安全键入详细信息,请参阅 基本 Oracle 数据类型 bool (System.Boolean)
UseSchemaInNameSpace Metadata 指定架构名称是否 (SCOTT、HR 等) 包含在基础数据库项目的 xml 命名空间中以用于操作及其关联类型。 默认值为 True;架构名称包含在 命名空间中。 命名空间中不包含方案名称的优点是,如果两个不同架构中具有同名的表 (例如 EMP) ,则同一 XML 可用于对两个表执行简单的 SQL 操作 (插入、更新、删除、选择) 。

例如,如果 UseSchemaInNamespace 属性为 true,则这些操作在 SCOTT 上的命名空间。EMP 表为 http://schemas.microsoft.com/OracleEBS/Tables/SCOTT/EMP;如果为 false,则命名空间为 http://schemas.microsoft.com/OracleEBS/Tables/EMP

重要: 消息操作不受 UseSchemaInNamesapce 绑定属性的影响;它始终包含架构名称。

重要: 强烈建议在生成元数据时将此绑定属性设置为 True 。 如果将此属性设置为 false,则 Oracle 架构名称 (例如,SCOTT) 在生成的架构的 XML 命名空间中不可用。 因此,如果在两个不同的 Oracle 架构中具有两个同名的表,并且它们被添加到同一个 BizTalk 项目中,则 BizTalk 项目将无法生成和部署。 如果要在同一 BizTalk 项目中包含此类架构,则必须手动编辑它们,以在 XML 命名空间中包括 Oracle 架构名称。
bool (System.Boolean)
MlsSettings 多语言支持 Oracle 电子商务套件实例可以安装多个语言包。 因此,如果适配器从具有多语言支持 (MLS) 的 Oracle E-Business Suite 实例检索元数据,则适配器必须提供与登录用户首选的语言设置相同的信息。

MlsSettings 绑定属性使适配器客户端能够指定特定于 MLS 的选项。 可以在设计时和运行时指定此绑定属性。 MlsSettings 绑定属性是一个复杂的绑定属性,而该属性又包含更多绑定属性。 所有这些绑定属性都是可选的。 适配器以下列方式使用绑定属性来设置 MLS 上下文:

- 对于指定了值的绑定属性,适配器使用这些值设置 MLS 上下文。

- 对于未指定值的绑定属性,适配器对安装适配器的同一 ODP.NET 客户端使用 MLS 设置。

下表列出了属于 MlsSettings 绑定属性的绑定属性。 所有这些属性都是可选的。

日历:指定日历系统。 此绑定属性映射到 NLS_CALENDAR 客户端中的 ODP.NET 设置。

比较:为 PL/SQL 块中的 WHERE 子句指定比较方法。 此绑定属性映射到 NLS_COMP 客户端中的 ODP.NET 设置。

货币:指定要用作 L 数字格式元素的本地货币符号的字符串。 有关 Oracle 中各种数字格式元素和格式模型的信息,请参阅 https://go.microsoft.com/fwlink/?LinkId=135807。 此绑定属性映射到 NLS_CURRENCY 客户端中的 ODP.NET 设置。

DateFormat:指定呈现日期的格式。 此绑定属性映射到 ODP.NET 客户端中的 NLS_DATE_FORMAT 设置。

DateLanguage:指定日期和月份名称的语言。 此绑定属性映射到 ODP.NET 客户端中的 NLS_DATE_LANGUAGE 设置

DualCurrency:指定 U 数字格式元素的双重货币符号,如欧元。 有关 Oracle 中各种数字格式元素和格式模型的信息,请参阅 https://go.microsoft.com/fwlink/?LinkId=135807 。 此绑定属性映射到 ODP.NET 客户端中的 NLS_DUAL_CURRENCY 设置。

ISOCurrency:指定要用作 C 数字格式元素的国际货币符号的字符串。 有关 Oracle 中各种数字格式元素和格式模型的信息,请参阅 https://go.microsoft.com/fwlink/?LinkId=135807 。 此绑定属性映射到 ODP.NET 客户端中的 NLS_ISO_CURRENCY 设置。

Language:指定要设置为 MLS 上下文的一部分的语言。 此绑定属性映射到 ODP.NET 客户端中的 NLS_LANGUAGE 设置。

重要提示:OracleEBSResponsibilityName绑定属性的值必须以语言绑定属性指定的相同语言指定。 例如,如果将 语言 绑定属性设置为西班牙语,则为 OracleEBSResponsibilityName 绑定属性指定的责任名称还必须为西班牙语。

LengthSemantics:允许使用 (默认) 长度语义创建 CHAR 和 VARCHAR2 列。 此绑定属性映射到 ODP.NET 客户端中的 NLS_LENGTH_SEMANTICS 设置。

NCharConversionException:指定在隐式或显式字符类型转换期间数据丢失是否会报告错误。 默认值为 True。 此绑定属性映射到 ODP.NET 客户端中的 NLS_NCHAR_CONV_EXCP 设置。

NumericCharacters:指定十进制字符和组分隔符。 此绑定属性映射到 ODP.NET 客户端中的 NLS_NUMERIC_CHARACTERS 设置。

Sort:指定字符数据的排序类型。 此绑定属性映射到 ODP.NET 客户端中的 NLS_SORT 设置。

区域:指定区域的日期和数字格式的约定。 此绑定属性映射到 ODP.NET 客户端中的 NLS_TERRITORY 设置。

TimeStampFormat:指定 TimeStamp 数据类型的字符串格式。 此绑定属性映射到 ODP.NET 客户端中的 NLS_TIMESTAMP_FORMAT 设置。

TimeStampTZFormat:指定 TimeStampTZ 数据类型的字符串格式。 此绑定属性映射到 ODP.NET 客户端中的 NLS_TIMESTAMP_TZ_FORMAT 设置。

时区:指定时区区域名称。 此绑定属性映射到 ODP.NET 客户端中的 TIME_ZONE 设置。
enum
NotificationPort 通知 指定 ODP.NET 必须打开的端口号,以便侦听 Oracle 数据库中的数据库更改通知。 默认值为-1,表示 ODP.NET 使用有效的、随机的、未使用的端口号。

重要提示:如果打开 Windows 防火墙,则适配器客户端将不会收到数据库更改通知。 同时,不建议关闭 Windows 防火墙接收通知。 因此,若要接收通知而不影响客户端计算机的安全性,我们建议将一个正整数值指定为端口号,然后将该端口号添加到 Windows 防火墙例外列表中。 如果将此绑定属性设置为默认值-1,则 ODP.NET 将使用随机端口,并且适配器客户端将不知道要将哪个端口添加到 Windows 防火墙例外列表中。 有关如何将端口添加到 Windows 防火墙例外列表的说明,请参阅 https://go.microsoft.com/fwlink/?LinkID=196959

警告: 如果使用 Oracle 电子商务适配器接收通知的应用程序域中有多个应用程序,则必须将所有应用程序的 NotificationPort 绑定属性设置为相同的端口号。 这是因为,ODP.NET 只创建一个侦听应用程序域中一个端口的侦听程序。
int (System.object)
NotificationStatement 通知 指定用于注册从 Oracle 数据库获取通知的 SELECT 语句。 示例 SELECT 语句可能类似于以下内容。

SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’

注意: 您必须指定数据库对象名称和架构名称。 例如,SCOTT.ACCOUNTACTIVITY

仅当指定 SELECT 语句的结果集更改时,适配器才从 Oracle 数据库获取通知消息。
字符串
NotifyOnListenerStart 通知 指定在侦听器启动时适配器是否向适配器客户端发送通知消息,并通知接收位置正在运行。 默认值为 True。 bool (System.object)
ConnectionLifetime Oracle 连接池 ODP.NET 属性。 指定连接的最长持续时间(以秒为单位)。 默认值为 0。 此属性用于优化性能。 int (System.object)
DecrPoolSize Oracle 连接池 ODP.NET 属性。 指定在未使用过多的已建立连接时关闭的连接数。 默认值为 1。 这用于优化性能。 int (System.object)
IncrPoolSize Oracle 连接池 ODP.NET 属性。 指定在请求新连接且 ODP.NET 连接池中没有可用连接时要创建的新连接数。 默认值为 5。 此属性用于优化性能。 int (System.object)
MaxPoolSize Oracle 连接池 ODP.NET 属性。 指定 ODP.NET 连接池中的最大连接数。 默认值为 100。 此属性用于优化性能。

重要提示: 必须慎用 MaxPoolSize 设置。 如果此值设置太大,则可能会耗尽 ODP.NET 中可用的连接数。
int (System.object)
MinPoolSize Oracle 连接池 ODP.NET 属性。 指定 ODP.NET 连接池中的最小连接数。 默认值为 1。 此属性用于优化性能。 int (System.object)
UseOracleConnectionPool Oracle 连接池 ODP.NET 属性。 指定是否使用 ODP.NET 连接池。 默认值为 true,这将启用连接池。 Oracle 电子商务适配器通过使用 ODP.NET 连接池实现连接池。 bool (System.object)
ApplicationShortName OracleEBS Oracle 电子商务套件应用程序的短名称。 为某些 PL/SQL API 以及数据库表或视图设置应用程序上下文时,必须提供应用程序的短名称。 但是,为什么我们需要仅为某些 PL/SQL API 以及数据库表或视图设置应用程序上下文?

- 与 Oracle 数据库和 Oracle 电子商务套件中的应用程序关联的 PL/SQL API 在设计时也可在"基于项目的视图"和"Schema-Based 视图"节点下使用,同时使用"使用适配器服务外接程序"或"添加适配器服务引用插件"。 执行与 Oracle SQL关联的 PL/SQL API 时,无需设置此绑定属性。 但是,在执行与 Oracle SQL Suite 应用程序关联的 PL/SQL API 时,必须通过为此绑定属性指定有效值来设置应用程序上下文。

- 对于自定义 Oracle E-Business Suite 应用程序,用户可能会或可能不会将基本数据库表注册为接口表。 如果数据库表未注册为接口表,则使用"使用适配器服务外接程序"或"添加适配器服务引用插件"时,它将在设计时在"数据库"节点下可用。 但是,由于这些表与 Oracle 电子商务应用程序相关联,因此,对于这些表的任何操作,都必须设置应用程序上下文。

因此,若要对 PL/SQL API 以及属于 Oracle 电子商务套件的数据库表或视图执行任何操作,必须始终指定应用程序的短名称。

重要:在执行 PL/SQL API 或对与 Oracle 电子商务套件应用程序关联的数据库表或视图执行任何操作时,还必须:

- 将 ClientCredentialType 绑定属性设置为 EBusiness

- 设置 OracleUserNameOraclePassword 绑定属性以指定用于连接到 Oracle 电子商务套件的凭据,以及

- 将 OracleEBSResponsibilityName 绑定属性设置为适当的责任名称。

通过设置这些绑定属性,可以通知适配器 PL/SQL API 或数据库表或视图,你正在操作的应用程序与 Oracle 电子商务套件应用程序相关联,因此 ApplicationShortName 绑定属性是必需的。 相反,如果要对与 Oracle 电子商务套件应用程序关联的数据库表或视图执行 PL/SQL API 或任何操作,并且未正确设置 ClientCredentialTypeOracleUserNameOraclePasswordOracleEBSResponsibilityName 绑定属性,则适配器将忽略 ApplicationShortName,即使设置了 ApplicationShortName,并且假定 PL/SQL 要执行运算的 API 或数据库表属于 Oracle 数据库。
字符串
OracleEBSOrganizationId OracleEBS 指定 Oracle 电子商务套件应用程序所属的组织 ID。 此属性是可选的,并且仅在:

- ClientCredentialType 绑定属性设置为 EBusiness,并且

- 正确指定了 OracleUserNameOraclePasswordOracleEBSResponsibilityName 绑定属性。
字符串
OracleEBSResponsibilityKey OracleEBS 与 Oracle E-Business Suite 用户关联的责任密钥。

OracleEBSResponsibilityName 绑定属性 (的名称不同) ,责任键不依赖于指定的语言。 这意味着,在设置 MLS 上下文时,不需要根据语言绑定属性中指定的值以不同语言指定责任键。

重要提示:

- 为 OracleEBSResponsibilityKey 绑定属性指定的值将替代 为 OracleEBSResponsibilityName 绑定属性指定的值。

- 如果要对多种语言的数据执行操作,并且不想指定每种语言的责任名称,则应该在对接口表执行操作、从接口视图中选择值或执行并发程序或请求集时为此绑定属性指定值。 当然,即使只处理英语数据,也始终可以使用此绑定属性。
字符串
OracleEBSResponsibilityName OracleEBS 与 Oracle 电子商务套件用户关联的责任的名称。

责任名称取决于指定的语言。 这意味着,如果要通过指定 Language 绑定属性的值来设置 MLS 上下文,则必须使用为 Language 绑定属性指定的相同语言指定 OracleEBSResponsibilityName 绑定属性的值。 例如,如果将 Language 绑定属性 设置为西班牙语,则为 OracleEBSResponsibilityName 绑定属性指定的责任名称也必须为西班牙语。

重要: 对接口表执行运算、从接口视图中选择值或执行并发程序时,必须为此绑定属性指定值。
字符串
OraclePassword OracleEBS - 如果 ClientCredentialType 绑定属性设置为 Database,则此属性指定 Oracle 数据库用户的密码。

- 如果 ClientCredentialType 绑定属性设置为 EBusiness,则此属性指定 Oracle 电子商务套件用户的密码。

Oracle 电子商务适配器在连接到 Oracle 电子商务套件时不会保留 为 OraclePassword 绑定属性输入的值的情况。 使用标准规则 #A0*Plus#A1 将密码SQL Oracle 电子商务套件。 但是,如果希望保留密码大小写,或者要输入包含特殊字符的密码,则必须在双引号内指定值。

重要提示:

- 对接口表执行操作、从接口视图中选择值、执行并发程序或执行与 Oracle E-Business Suite 应用程序关联的 PL/SQL API 时,必须将 ClientCredentialType 绑定属性设置为 EBusiness,然后指定连接到 Oracle E-Business Suite 的有效密码。

- OraclePassword 绑定属性在绑定文件 (XML 文件) 中不可用,或在通过使用使用适配器服务 BizTalk Project 外接程序或添加适配器服务引用 Visual Studio 插件而生成的 app.config 文件中不可用。
字符串
OracleUserName OracleEBS - 如果 ClientCredentialType 绑定属性设置为 Database,此属性将指定在 Oracle 数据库上进行身份验证的用户名。

- 如果 ClientCredentialType 绑定属性设置为 EBusiness,此属性将指定在 Oracle 电子商务套件上进行身份验证的用户名。

Oracle 电子商务适配器在连接到 Oracle 电子商务套件时不会保留 为 OracleUserName 绑定属性输入的值的情况。 使用标准规则 #A0*Plus#A1 将用户名SQL Oracle 电子商务套件。 但是,如果希望保留用户名的大小写,或者要输入包含特殊字符的用户名,则必须在双引号内指定值。

重要:对接口表执行操作、从接口视图中选择值、执行并发程序或执行与 Oracle 电子商务套件应用程序关联的 PL/SQL API 时,必须将 ClientCredentialType 绑定属性设置为 EBusiness,然后指定有效的用户名以连接到 Oracle 电子商务套件。
字符串
PolledDataAvailableStatement 轮询 指定执行的 SELECT 语句,以确定是否有数据可用于轮询特定表。 指定的语句必须返回由行和列组成的结果集。 结果集的第一个单元格中的值指示适配器是否执行 为 PollingInput 绑定属性指定的值。 如果结果的第一个单元格包含正值,适配器将执行轮询语句。 例如,此绑定属性的有效语句将为:

Select * from <table_name>

提示: 如果希望适配器继续轮询,而不考虑所轮询的表是否具有数据,可以将此绑定属性的值指定为 Select 1 FROM DUAL

注意: 不能为此绑定属性指定存储过程。 此外,此语句不得修改基础 Oracle 数据库。
字符串
PollingAction 轮询 指定轮询操作的操作。 可以从使用适配器服务外接程序为操作生成的元数据中确定特定操作轮询操作。 字符串
PollingInput 轮询 指定轮询语句。 可以指定用于轮询的简单 SELECT 语句或存储过程。 如果要轮询表或视图,则必须为此绑定属性指定 SELECT 语句。 如果要使用存储过程进行轮询,则必须为此绑定属性指定整个请求消息。 请求消息必须与发送到适配器的相同,以将存储过程作为出站操作调用。

注意:只有在SQL DataAvailableStatement 绑定属性执行的语句返回某些数据时,才执行为此绑定属性指定的语句或存储过程。

重要: Oracle 电子商务适配器执行轮询语句和轮询后语句(如果 (在 Oracle 事务) 中指定)。 如果在 PollingInput 绑定属性中使用 SELECT 语句,建议在 SELECT 语句中指定 FOR UPDATE 子句。 这将确保在事务期间锁定所选记录,并且轮询后语句可以针对所选记录执行任何所需的更新。
字符串
PollingInterval 轮询 指定事务处理轮询间隔,即 Oracle 电子商务适配器对 Oracle 数据库执行 为 PollingInput 绑定属性指定的语句的间隔(以秒为单位)。 默认值为 30。 适配器将轮询间隔用于以下各项:

- 连续轮询之间的时间间隔。 此间隔用于运行轮询和轮询后查询。 如果在指定的时间间隔内执行这些查询,适配器将休眠该时间间隔的剩余时间。

- 轮询事务超时值。 此值必须设置为足够大,以包括轮询语句执行时间、轮询后语句 ((如果指定了) 执行时间)以及从客户端应用程序接收答复以提交事务的时间。

如果客户端应用程序在轮询间隔过期之前发送答复,则适配器将提交事务并等待,直到达到轮询间隔来执行下一次轮询。

如果客户端应用程序返回错误,适配器将终止事务。

如果轮询间隔在客户端应用程序发送答复之前过期,则事务将超时。
int (System.Int32)
PollWhileDataFound 轮询 指定 Oracle 电子商务适配器是否忽略轮询间隔,并持续轮询 Oracle 数据库(如果数据在要轮询的表中可用)。 如果表中没有可用数据,适配器将还原为在指定的轮询SQL执行该语句。 默认值为 false

假设轮询间隔设置为 60 秒,并且 为 PolledDataAvailableStatement 指定的语句返回可用于轮询的数据。 然后,适配器执行为 PollingInput 绑定属性指定的 语句。 假设适配器只需 10 秒来执行语句,现在必须等待 50 秒,然后再次执行 PolledDataAvailableStatement ,然后执行轮询语句。 相反,若要优化性能,可以将 PollWhileDataFound 绑定属性设置为 true ,以便适配器可以在上一个轮询周期结束后立即开始执行下一个轮询周期。

注意: 此绑定属性适用于对表和视图进行轮询和使用存储过程进行轮询。
字符串
PostPollStatement 轮询 指定在执行 PollingInput 绑定属性指定的语句后执行的语句块。 默认值为 null;不执行轮询后语句。 轮询后语句在轮询事务内执行。 轮询后语句的两个常见用途是:

- 更新轮询语句中返回的行中的列,以指示它们已处理,应从后续轮询查询中排除。

- 将已处理的记录移动到其他表。

重要: 如果指定了轮询后语句, 则 PollingInterval 应设置为足够大,使轮询后语句在间隔过期之前完成。

若要详细了解如何在轮询方案中使用绑定属性,请参阅基于轮询的数据更改通知概述。
字符串
SkipNilNodes 运行时行为 指定 Oracle 电子商务适配器是否跳过插入或更新请求 XML 中标记为"nil"的节点的值。 此绑定属性适用于在表中插入或更新记录,以及存储过程中的 RECORD 类型参数。 默认值 为 true,这意味着适配器将跳过为标记为"nil"的节点传递值。 在这种情况下,Oracle 中的默认值 (如果指定了) 则考虑标记为"nil"的节点。 如果设置为 false,适配器将显式传递这些节点的 null 值。

注意:

- 对于请求 XML 中不存在的节点,适配器始终跳过传递值,而不考虑 SkipNilNodes 绑定属性的值。

- 对于 RECORDS 的 PL/SQL 表,适配器始终为标记为"nil"或请求 XML 中不存在的节点传递 null 值,而不考虑 SkipNilNodes 绑定属性的值。

以下示例根据为此绑定属性设置的值解释适配器配置中的差异。 假设请求 XML 如下所示:

<EMPNO>1000</EMPNO> <ENAME>John</ENAME> <SAL nil=’true’></SAL>

如果 SkipNilNodes 设置为 true,适配器将执行以下命令:

INSERT INTO EMP (EMPNO, ENAME) VALUES (1000, “John”);

如果 SkipNilNodes 设置为 false,适配器将执行以下查询:

INSERT INTO EMP (EMPNO, ENAME, SAL) VALUES (1000, “John”, null);

请注意,在第二个语句中,适配器显式插入参数"SAL"的 null 值。
bool (System.Boolean)
GeneratedUserTypesAssemblyFilePath UDT .NET 类型生成 – 设计时间 指定适配器在生成元数据时生成的 DLL 的名称和路径,其中包含元数据中使用的所有 UDT。 如果要为使用 UDT 的包、存储过程或函数生成元数据,则必须指定 DLL 名称。 对于具有 UDT 的表和视图,指定 DLL 名称是可选的。 生成的 DLL 将保存到与可执行文件相同的位置。

只有在生成元数据时,才需要此绑定属性。

注意:

- 只能指定一个文件名。 对于元数据中所有 UDT,适配器将生成具有给定名称的单个文件。 如果未指定名称,适配器将生成具有 GUID 名称的 DLL。

- 配置 WCF-OracleEBS 接收或BizTalk Server时,此绑定属性在 BizTalk Server 中不可用。
字符串
GeneratedUserTypesAssemblyKeyFilePath UDT .NET 类型生成 – 设计时间 指定适配器用于创建强类型程序集的密钥文件的名称和路径。

此绑定属性是可选的,仅在生成元数据时是必需的。

注意:配置 WCF-OracleEBS 接收或BizTalk Server时,此绑定属性在 BizTalk Server 中不可用。
字符串
UserAssembliesLoadPath UDT .NET 类型生成 – 运行时 指定 DLL 的名称,用分号分隔,适配器在生成元数据时创建该名称。 这些 DLL 保存在生成元数据时为 GeneratedUserTypesAssemblyFilePath 绑定属性指定的位置。 必须手动将这些 DLL 复制到以下位置:

- 对于 BizTalk 项目:将 DLL 复制到与项目相同的BTSNTSvc.exe。 对于BizTalk Server,这通常在<>安装驱动器:\Program Files\Microsoft BizTalk Server 下提供。

- 对于 .NET 项目:将 DLL 复制到 .NET 项目文件夹中的 \bin\Development 文件夹。

仅在发送和接收消息以在 Oracle 电子商务套件上执行的操作时,才需要此绑定属性。
字符串
AcceptCredentialsInUri 未由"使用适配器服务外接程序"或"添加适配器服务引用插件"显示。 指定 Oracle 电子商务套件连接 URI 是否可以包含用户凭据。 默认值为 false,这将禁用连接 URI 中的用户凭据。 如果 AcceptCredentialsInUrifalse 且 Oracle 连接 URI 包含用户凭据,则 Oracle 电子商务适配器将引发异常。 如果必须在 URI 中指定凭据,可以将 AcceptCredentialsInUri 设置为 true。 有关详细信息,请参阅 创建 Oracle E-Business Suite 连接 URI bool (System.Boolean)

如何设置绑定属性?

指定与 Oracle 电子商务套件的连接时,可以设置绑定属性。 有关在设置绑定属性时如何设置的信息:

重要

使用"使用适配器服务 BizTalk Project 外接程序"或"添加适配器服务引用 Visual Studio 插件"时,如果不为字符串类型的绑定属性指定值,并且默认值为 null,则绑定文件 (XML 文件) 或 app.config 文件中将不可用。 如果需要,必须在绑定文件或 app.config 文件中手动添加绑定属性及其值。

但是,即使在使用"使用适配器服务 BizTalk Project 外接程序"或"添加适配器服务引用"Visual Studio 插件时为此绑定属性指定值,OraclePassword 绑定属性在绑定文件或 app.config 文件中也不可用。

另请参阅

开发活动