适用于 Oracle 电子商务套件的 Microsoft BizTalk 适配器显示多个绑定属性。 通过设置这些属性,可以控制适配器的某些行为。 本部分介绍 Oracle 电子商务适配器绑定属性。 它还演示了如何使用 .NET 编程或通过在BizTalk Server物理端口绑定上设置属性来访问它们。
适配器绑定属性
Oracle 电子商务套件是基础 Oracle 数据库上的一个应用层。 某些绑定属性在与 Oracle 电子商务套件交互时配置适配器的行为,而其他属性在与 Oracle 数据库交互时配置该行为。 下表显示了按类别分组的所有 Oracle 电子商务适配器绑定属性。 类别是指每个绑定属性显示在由不同应用程序提供的对话框中的节点,这些属性用于配置适配器 (或绑定) 。
Binding 属性 | 类别 | 说明 | .NET 类型 |
---|---|---|---|
ClientCredentialType | 常规 | 指定在与 Oracle 电子商务套件建立连接时指定的凭据集。 可能的值为 Database 和 EBusiness。 - 如果设置为 “数据库”,适配器客户端必须指定用于建立连接的数据库凭据,以及 OracleUserName 和 OraclePassword 绑定属性的 E-Business 套件凭据。 - 如果设置为 EBusiness,适配器客户端必须指定 E-Business Suite 凭据以建立连接以及 OracleUserName 和 OraclePassword 绑定属性的数据库凭据。 重要: 如果将 ClientCredentialType 绑定属性设置为 EBusiness,则为 OracleUserName 和 OraclePassword 绑定属性指定数据库用户名和密码是必需的。 默认值为 Database。 |
enum (ClientCredential) |
CloseTimeout | 常规 | WCF 连接关闭超时。 指定一个时间跨度值,该值指示为完成内部 WCF 通道关闭操作提供的时间间隔。 默认值为 1 分钟。 不支持。 | System.TimeSpan |
EnableBizTalkCompatibilityMode | 常规 | 指定适配器如何为数据集生成架构。 将此设置为 True 可正确生成 DataSet 的架构。 使用 BizTalk Server 中的适配器时,必须始终将 属性设置为 True。 使用 Visual Studio 中的适配器时,必须始终将 属性设置为 False。 |
bool (System.Boolean) |
InboundOperationType | 常规 | 指定是要执行 轮询 还是 通知 入站操作。 默认值为 轮询。 有关 轮询的详细信息, 请参阅 支持使用轮询的入站调用。 有关 通知的详细信息,请参阅 使用 Oracle 数据库适配器接收数据库更改通知的注意事项。 |
枚举 |
名称 | 常规 | 一个只读值,返回由添加适配器服务引用 Visual Studio 插件生成的文件的名称,用于保存 WCF 客户端类。 添加适配器服务引用插件通过将“Client”追加到 Name 属性的值来形成文件名。 返回的值为“OracleEBSBinding”;对于此值,生成的文件将命名为“OracleEBSBindingClient”。 | 字符串 |
OpenTimeout | 常规 | WCF 连接打开超时。 指定一个时间跨度值,该值指示为完成内部通道打开操作提供的时间间隔。 默认值为 1 分钟。 重要: Oracle 电子商务适配器在打开与 Oracle 数据库的连接时,始终使用 OpenTimeout 设置连接打开超时。 适配器会忽略打开通信对象(如通道)时传递 (System.TimeSpan) 参数的任何超时。 |
System.TimeSpan |
ReceiveTimeout | 常规 | WCF 消息接收超时。 指定一个时间跨度值,该值指示适配器等待入站消息的最大时间间隔。 默认值为 10 分钟。 重要: 对于轮询等入站操作,建议将超时设置为最大可能值,即 24.20:31:23.64700000 (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 数据类型参数的存储过程。 - 对包含具有长数据类型的列且 SELECT 语句不包含主键列的表执行 Select 操作。 如果要设置此绑定属性的最大值,请将该值设置为 -1。 注意: 此绑定属性已弃用。 |
int |
MaxOutputAssociativeArrayElements | 缓冲区管理 | 指定适配器在执行在响应中返回关联数组的操作时创建的关联数组的大小。 适配器将数组的大小传达给 ODP.NET,后者又根据数组大小创建缓冲区。 默认值为 32。 执行涉及 PL/SQL 表类型的操作时,此绑定属性非常有用。 |
int (System.Int32) |
MetadataPooling | 缓冲区管理 | ODP.NET 属性。 指定 ODP.NET 是否缓存已执行的查询的元数据信息。 默认值为 true,这将启用元数据池。 缓存此信息可提高性能;但是,如果在 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 | 元数据 | 启用或禁用安全键入。 默认值为 false;安全键入已禁用。 此功能控制适配器如何显示某些 Oracle 数据类型。 有关安全键入的详细信息,请参阅 基本 Oracle 数据类型。 | bool (System.Boolean) |
UseSchemaInNameSpace | 元数据 | 指定架构名称 (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 电子商务套件实例可以安装多个语言包。 因此,如果适配器从具有多语言支持的 Oracle 电子商务套件实例检索元数据 (MLS) ,则适配器必须显示与登录用户喜欢的语言设置相同的信息。 MlsSettings 绑定属性使适配器客户端能够指定特定于 MLS 的选项。 可以在设计时和运行时指定此绑定属性。 MlsSettings 绑定属性是一个复杂的绑定属性,而该属性又包含更多绑定属性。 所有这些绑定属性都是可选的。 适配器按以下方式使用绑定属性来设置 MLS 上下文: - 对于具有指定值的绑定属性,适配器使用这些值来设置 MLS 上下文。 - 对于未指定值的绑定属性,适配器在安装了适配器的同一台计算机上使用 ODP.NET 客户端的 MLS 设置。 下表列出了属于 MlsSettings 绑定属性的绑定属性。 所有这些属性都是可选的。 日历:指定日历系统。 此绑定属性映射到 ODP.NET 客户端中的 NLS_CALENDAR 设置。 比较:为 PL/SQL 块中的 WHERE 子句和比较指定比较方法。 此绑定属性映射到 ODP.NET 客户端中的NLS_COMP设置。 Currency:指定要用作 L 数字格式元素的本地货币符号的字符串。 有关 Oracle 中各种数字格式元素和格式模型的信息,请参阅 https://go.microsoft.com/fwlink/?LinkId=135807。 此绑定属性映射到 ODP.NET 客户端中的 NLS_CURRENCY 设置。 DateFormat:指定显示日期时采用的格式。 此绑定属性映射到 ODP.NET 客户端中的NLS_DATE_FORMAT设置。 DateLanguage:指定日期和月份名称的语言。 此绑定属性映射到 ODP.NET 客户端中的NLS_DATE_LANGUAGE设置 DualCurrency:指定 U 数字格式元素的双货币符号,例如 Euro。 有关 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设置。 语言:指定要在 MLS 上下文中设置的语言。 此绑定属性映射到 ODP.NET 客户端中的NLS_LANGUAGE设置。 重要:OracleEBSResponsibilityName 绑定属性的值必须使用为 Language 绑定属性指定的相同语言指定。 例如,如果将 Language 绑定属性设置为西班牙语,则为 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设置。 TimeZone:指定时区区域名称。 此绑定属性映射到 ODP.NET 客户端中的TIME_ZONE设置。 |
枚举 |
NotificationPort | 通知 | 指定 ODP.NET 必须打开才能侦听 Oracle 数据库中的数据库更改通知的端口号。 默认值为 -1,表示 ODP.NET 使用有效的、随机的、未使用的端口号。 重要: 如果 Windows 防火墙处于打开状态,适配器客户端将不会收到数据库更改通知。 此外,不建议关闭 Windows 防火墙以接收通知。 因此,若要在不影响客户端计算机安全性的情况下接收通知,建议将正整数值指定为端口号,然后将该端口号添加到 Windows 防火墙例外列表。 如果将此绑定属性设置为默认值 -1,ODP.NET 使用随机端口,适配器客户端将不知道要添加到 Windows 防火墙例外列表的端口。 有关如何将端口添加到 Windows 防火墙例外列表的说明,请参阅 https://go.microsoft.com/fwlink/?LinkID=196959。 谨慎: 如果应用程序域中有多个应用程序使用 Oracle E-Business 适配器接收通知,则必须将所有应用程序的 NotificationPort 绑定属性设置为相同的端口号。 这是因为 ODP.NET 只创建一个侦听程序,用于侦听应用程序域中的一个端口。 |
int (System.Int32) |
NotificationStatement | 通知 | 指定用于注册以从 Oracle 数据库获取通知的 SELECT 语句。 一个示例 SELECT 语句可能类似于以下内容。SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’ 注意: 必须指定数据库对象名称和架构名称。 例如, SCOTT.ACCOUNTACTIVITY 。仅当指定 SELECT 语句的结果集发生更改时,适配器才会从 Oracle 数据库获取通知消息。 |
字符串 |
NotifyOnListenerStart | 通知 | 指定适配器是否在侦听器启动时向适配器客户端发送通知消息,通知接收位置正在运行。 默认值为 True。 | bool (System.Boolean) |
ConnectionLifetime | Oracle 连接池 | ODP.NET 属性。 指定连接的最大持续时间(以秒为单位)。 默认值为 0。 此属性用于性能优化。 | int (System.Int32) |
DecrPoolSize | Oracle 连接池 | ODP.NET 属性。 指定未使用过多的已建立连接时关闭的连接数。 默认值为 1。 这用于性能优化。 | int (System.Int32) |
IncrPoolSize | Oracle 连接池 | ODP.NET 属性。 指定在请求新连接且 ODP.NET 连接池中没有可用连接时要创建新连接的数目。 默认值为 5。 此属性用于性能优化。 | int (System.Int32) |
MaxPoolSize | Oracle 连接池 | ODP.NET 属性。 指定 ODP.NET 连接池中的最大连接数。 默认值为 100。 此属性用于性能优化。 重要: 必须明智地设置 MaxPoolSize 。 如果此值设置得太大,则可能会耗尽 ODP.NET 可用的连接数。 |
int (System.Int32) |
MinPoolSize | Oracle 连接池 | ODP.NET 属性。 指定 ODP.NET 连接池中的最小连接数。 默认值为 1。 此属性用于性能优化。 | int (System.Int32) |
UseOracleConnectionPool | Oracle 连接池 | ODP.NET 属性。 指定是否使用 ODP.NET 连接池。 默认值为 true,这将启用连接池。 Oracle E-Business 适配器使用 ODP.NET 连接池来实现连接池。 | bool (System.Boolean) |
ApplicationShortName | OracleEBS | Oracle E-Business Suite 应用程序的短名称。 在为某些 PL/SQL API 以及数据库表或视图设置应用程序上下文时,必须提供应用程序短名称。 但是,为什么我们需要仅为某些 PL/SQL API 以及数据库表或视图设置应用程序上下文? - PL/SQL API 与 Oracle 数据库和 Oracle 电子商务套件中的应用程序相关联,在使用使用适配器服务外接程序或添加适配器服务引用插件时,也可在“基于项目的视图”和 Schema-Based 视图“节点下使用。 在执行与 Oracle 数据库关联的 PL/SQL API 时,无需设置此绑定属性。 但是,在执行与 Oracle E-Business Suite 应用程序关联的 PL/SQL API 时,必须通过为此绑定属性指定有效值来设置应用程序上下文。 - 对于自定义 Oracle E-Business Suite 应用程序,用户可以将基础数据库表注册为接口表,也可能不注册。 如果数据库表未注册为接口表,则在设计时,它将在“数据库”节点下可用,同时使用使用适配器服务加载项或添加适配器服务引用插件。 但是,由于这些表与 Oracle 电子商务应用程序相关联,因此对于这些表的任何操作,必须设置应用程序上下文。 因此,若要对 PL/SQL API 以及属于 Oracle E-Business Suite 的数据库表或视图执行任何操作,必须始终指定应用程序短名称。 重要: 在执行 PL/SQL API 或对与 Oracle E-Business Suite 应用程序关联的数据库表或视图执行任何操作时,还必须: - 将 ClientCredentialType 绑定属性设置为 EBusiness, - 设置 OracleUserName、 OraclePassword 绑定属性以指定要连接到 Oracle 电子商务套件的凭据,以及 - 将 OracleEBSResponsibilityName 绑定属性设置为适当的责任名称。 通过设置这些绑定属性,可以通知适配器正在操作的 PL/SQL API 或数据库表或视图与 Oracle E-Business Suite 应用程序关联,因此 ApplicationShortName 绑定属性变得是必需的。 相反,如果正在执行 PL/SQL API,或者对与 Oracle E-Business Suite 应用程序关联的数据库表或视图执行任何操作,并且未正确设置 ClientCredentialType、 OracleUserName、 OraclePassword 和 OracleEBSResponsibilityName 绑定属性,适配器将忽略 ApplicationShortName,即使已设置,并假定要对其执行操作的 PL/SQL API 或数据库表属于 Oracle 数据库。 |
字符串 |
OracleEBSOrganizationId | OracleEBS | 指定 Oracle E-Business Suite 应用程序所属的组织 ID。 此属性是可选的,仅在以下情况下才被视为: - ClientCredentialType 绑定属性设置为 EBusiness,并且 - 正确指定 OracleUserName、 OraclePassword 和 OracleEBSResponsibilityName 绑定属性。 |
字符串 |
OracleEBSResponsibilityKey | OracleEBS | 与 Oracle E-Business Suite 用户关联的责任密钥。 与 OracleEBSResponsibilityName 绑定属性) (责任名称不同,责任键不依赖于指定的语言。 这意味着在设置 MLS 上下文时,无需根据 语言 绑定属性中指定的值,以不同语言指定责任键。 重要提示: - 为 OracleEBSResponsibilityKey 绑定属性指定的值将替代为 OracleEBSResponsibilityName 绑定属性指定的值。 - 如果要对多种语言的数据执行操作,并且不想在每种语言中指定责任名称,则应在对接口表执行操作、从接口视图中选择值或执行并发程序或请求集时指定此绑定属性的值。 当然,即使仅处理英语数据,也始终可以使用此绑定属性。 |
字符串 |
OracleEBSResponsibilityName | OracleEBS | 与 Oracle E-Business Suite 用户关联的责任的名称。 责任名称取决于指定的语言。 这意味着,如果通过为 Language 绑定属性指定值来设置 MLS 上下文,则必须使用为 Language 绑定属性指定的相同语言指定 OracleEBSResponsibilityName 绑定属性的值。 例如,如果将 Language 绑定属性设置为西班牙语,则为 OracleEBSResponsibilityName 绑定属性指定的责任名称也必须是西班牙语。 重要: 在对接口表执行操作、从接口视图中选择值或执行并发程序时,必须为此绑定属性指定值。 |
字符串 |
OraclePassword | OracleEBS | - 如果 ClientCredentialType 绑定属性设置为 Database,则此属性指定 Oracle 数据库用户的密码。 - 如果 ClientCredentialType 绑定属性设置为 EBusiness,则此属性指定 Oracle E-Business Suite 用户的密码。 Oracle 电子商务适配器不会保留连接到 Oracle E-Business Suite 时为 OraclePassword 绑定属性输入的值大小写。 密码使用 SQL*Plus 的标准规则传递到 Oracle E-Business Suite。 但是,如果希望保留密码大小写,或者想要输入包含特殊字符的密码,则必须在双引号内指定值。 重要提示: - 在对接口表执行操作、从接口视图中选择值、执行并发程序或执行与 Oracle E-Business Suite 应用程序关联的 PL/SQL API 时,必须将 ClientCredentialType 绑定属性设置为 EBusiness ,然后指定连接到 Oracle E-Business Suite 的有效密码。 - OraclePassword 绑定属性在绑定文件 (XML 文件) 或由于使用使用适配器服务 BizTalk 项目加载项或添加适配器服务参考 Visual Studio 插件而生成的 app.config 文件中不可用。 |
字符串 |
OracleUserName | OracleEBS | - 如果 ClientCredentialType 绑定属性设置为 Database,则此属性指定用于对 Oracle 数据库进行身份验证的用户名。 - 如果 ClientCredentialType 绑定属性设置为 EBusiness,则此属性指定用于在 Oracle E-Business Suite 上进行身份验证的用户名。 Oracle 电子商务适配器不会保留连接到 Oracle E-Business Suite 时为 OracleUserName 绑定属性输入的值大小写。 使用 SQL*Plus 的标准规则将用户名传递到 Oracle E-Business Suite。 但是,如果希望保留用户名大小写,或者想要输入包含特殊字符的用户名,则必须在双引号内指定值。 重要: 在对接口表执行操作、从接口视图中选择值、执行并发程序或执行与 Oracle 电子商务套件应用程序关联的 PL/SQL API 时,必须将 ClientCredentialType 绑定属性设置为 EBusiness ,然后指定有效的用户名以连接到 Oracle E-Business Suite。 |
字符串 |
PolledDataAvailableStatement | 轮询 | 指定执行以确定是否有任何数据可用于轮询特定表的 SELECT 语句。 指定的语句必须返回由行和列组成的结果集。 结果集第一个单元格中的值指示适配器是否执行为 PollingInput 绑定属性指定的值。 如果结果的第一个单元格包含正值,适配器将执行轮询语句。 例如,此绑定属性的有效语句为:Select * from <table_name> 提示: 如果希望适配器继续轮询而不考虑要轮询的表是否包含数据,可以将此绑定属性的值指定为 Select 1 FROM DUAL 。注意: 不得为此绑定属性指定存储过程。 此外,此语句不得修改基础 Oracle 数据库。 |
字符串 |
PollingAction | 轮询 | 指定轮询操作的操作。 可以使用使用适配器服务外接程序从为操作生成的元数据中确定特定操作的轮询操作。 | 字符串 |
PollingInput | 轮询 | 指定轮询语句。 可以指定用于轮询的简单 SELECT 语句或存储过程。 如果要轮询表或视图,则必须为此绑定属性指定 SELECT 语句。 如果要使用存储过程进行轮询,则必须为此绑定属性指定整个请求消息。 请求消息必须与发送到适配器以调用存储过程作为出站操作的相同。 注意: 仅当 PolledDataAvailableStatement 绑定属性执行的语句返回一些数据时,才会执行为此绑定属性指定的 SQL 语句或存储过程。 重要: Oracle E-Business 适配器执行轮询语句和轮询后语句 ((如果) 在 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”的节点的传递值。 在这种情况下,如果为标记为“nil”的节点指定了) ,则会考虑 Oracle (中的默认值。 如果设置为 false,适配器将显式传递这些节点的 null 值。 注意: - 对于请求 XML 中不存在的节点,适配器始终跳过传递值,而不考虑 SkipNilNodes 绑定属性的值。 - 对于 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 中不可用。 |
字符串 |
GeneratedUserTypesAssemblyKeyFilePath | UDT .NET 类型生成 - 设计时 | 指定适配器用于创建强类型程序集的密钥文件的名称和路径。 此绑定属性是可选的,仅在生成元数据时是必需的。 注意:配置 WCF-OracleEBS 接收或发送端口时,此绑定属性在 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 E-Business Suite 连接 URI 是否可以包含用户凭据。 默认值为 false,这会禁用连接 URI 中的用户凭据。 如果 AcceptCredentialsInUri 为 false ,并且 Oracle 连接 URI 包含用户凭据,则 Oracle 电子商务适配器将引发异常。 如果必须在 URI 中指定凭据,可以将 AcceptCredentialsInUri 设置为 true 。 有关详细信息,请参阅 创建 Oracle 电子商务套件连接 URI。 | bool (System.Boolean) |
如何设置绑定属性?
指定与 Oracle 电子商务套件的连接时,可以设置绑定属性。 有关如何在以下内容时设置绑定属性的信息:
使用适配器服务 BizTalk 项目外接程序或添加适配器服务引用 Visual Studio 插件,请参阅 此处输入链接说明。
在BizTalk Server解决方案中配置发送端口或接收端口 (位置) ,请参阅手动配置到 Oracle 电子商务适配器的物理端口绑定。
在编程解决方案中使用 WCF 通道模型,请参阅 在 Visual Studio 中连接到 Oracle 电子商务套件。
在编程解决方案中使用 WCF 服务模型,请参阅 在 Visual Studio 中连接到 Oracle 电子商务套件。
重要
在使用使用适配器服务 BizTalk 项目外接程序或添加适配器服务引用 Visual Studio 插件时,如果未为字符串类型的绑定属性指定值,并且其默认值为 null,则该绑定属性将分别在 xml 文件) 或 app.config 文件的绑定文件中 (不可用。 如果需要,必须在绑定文件或 app.config 文件中手动添加绑定属性及其值。
但是, OraclePassword 绑定属性在绑定文件或 app.config 文件中不可用,即使在使用使用适配器服务 BizTalk 项目外接程序或添加适配器服务引用 Visual Studio 插件时为此绑定属性指定值也是如此。