对界面表和界面视图的操作

适用于 Oracle 电子商务套件的 Microsoft BizTalk 适配器针对每个接口表显示一组标准操作, (选择、插入、更新和删除) ,以及 Oracle E-Business Suite 中每个接口视图的“选择”操作。 通过使用这些操作,可以在目标接口表上执行由 WHERE 子句限定的 SELECT、INSERT、UPDATE 和 DELETE 语句,以及由目标接口视图上的 WHERE 子句限定的 SELECT 语句。 这些操作也称为数据操作语言 (DML) 操作。

重要

必须先在 Oracle 电子商务适配器中为这些项目设置应用程序上下文,然后才能对接口表和接口视图执行操作。 这是因为,设置应用程序上下文可以通过设置用户首选项 ((例如责任、组织和语言设置) 和项目的访问控制)来促进 Oracle E-Business Suite 中的安全事务。 有关应用程序上下文以及如何设置它的详细信息,请参阅 设置应用程序上下文

支持的 DML 操作

下表显示了 Oracle 电子商务适配器支持的 DML 操作:

操作 说明
Select 基于提供的列名列表和指定 SQL WHERE 子句的筛选器字符串,对目标接口表或接口视图执行选择操作。

Select 操作的返回值是包含指定列和行的强类型结果集。
插入 对目标接口表执行 Insert 操作。 Insert 操作支持基于提供的记录集将多条记录插入到目标接口表中。

Insert 操作的返回值是插入的行数。

InlineValue

对于 Insert 操作中的所有简单数据记录,可以选择通过为名为 InlineValue 的可选属性指定值来替代记录的值。 InlineValue 属性可用于将计算值插入接口表中,例如使用序列填充主键列或使用 SYSDATE 将系统日期 () 插入日期列。 例如,在以下 INSERT 语句中:

<Insert xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/InterfaceTables/AR/AR_ARCHIVE_PURGE_INTERIM"> <RECORDSET> <InsertRecord xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/TableViewRecord/AR/AR_ARCHIVE_PURGE_INTERIM"> <TRNS_DATE InlineValue="sysdate">2008-06-21T15:52:19</TRNS_DATE> <EMPNAME>John</EMPNAME> </InsertRecord> </RECORDSET> </Insert>

即使“2008-06-21T15:52:19”指定为TRNS_DATE的值, InlineValue 属性“SYSDATE” (系统日期) 的值也会插入目标接口表中。

使用 InlineValue 属性时:

- 避免对 InlineValue 属性使用常量值。 例如,在 INSERT 语句中,如果指定 <EMPNAME InlineValue="John"/> ,则会导致错误。 这是因为 InlineValue 属性的值按原样传递给 Oracle,在本例中 ,John 传递到 Oracle E-Business Suite,该套件不是预期值, (预期值为 “John”) 。 必须在员工姓名周围使用单引号。 例如:<EMPNAME InlineValue="’John’"/>

- 如果要对 InlineValue 属性使用 select 查询,则必须将 SELECT 语句括在括号中,并确保 select 查询仅提取一条记录。 例如:<EMPNAME InlineValue="(SELECT NAME FROM MS_SAMPLE_EMPLOYEES WHERE ID=123)"/>

注意: 如果某个元素在 Oracle E-Business Suite 中标记为 NOT NULL,则即使已指定内联值,也必须为该元素指定值。 如果不这样做,将导致架构验证失败。
更新 对目标接口表执行 Update 操作。 要更新的记录由指定 SQL WHERE 子句的筛选器字符串指定。 更新的值在模板记录中指定。

更新操作的返回值是更新的行数。
删除 基于筛选器字符串中指定的 SQL WHERE 子句对目标接口表执行 Delete 操作。

Delete 操作的返回值是删除的行数。

重要详细信息

  • Oracle E-Business 适配器针对每个表 (选择、插入、更新和删除) 以及基础 Oracle 数据库中每个视图的 Select 操作显示相同的一组标准操作。 上述 DML 操作也对基础 Oracle 数据库表和视图有效。

    • 无需设置应用程序上下文即可对 Oracle 数据库中的表和视图执行操作。 但是,对于自定义 Oracle E-Business Suite 应用程序,用户可以将基数据库表注册为接口表,也可能不注册。 如果数据库表未注册为接口表,则在设计时使用“使用适配器服务加载项”、“添加适配器元数据向导”或“添加适配器服务引用插件”时,它可在“基于项目的视图”节点的“表”子节点下或“基于架构的视图”节点中使用。
      这些表与 Oracle 电子商务应用程序相关联。 因此,对于对这些表执行的任何操作,必须设置应用程序上下文。 请参阅此处的“设置应用程序上下文”输入链接说明

另请参阅

可以使用适配器执行哪些操作?