重要
为了简洁起见，本主题仅介绍如何以增量方式接收通知。 在业务场景中，理想情况下，业务流程必须包含逻辑，以提取收到的通知消息类型，然后执行任何后续操作。 换句话说，本主题中所述的业务流程必须基于进程通知消息中所述的业务流程构建 ，才能在 Oracle E-Business Suite 中完成特定任务。
本主题演示如何将 Oracle 电子商务适配器配置为从 Oracle 接收增量查询通知消息。 为了演示增量通知，我们考虑一个名为 ACCOUNTACTIVITY 的表，并包含一个名为“已处理”的列。 将新记录插入此表时，“已处理”列的值将设置为“n”。 可以通过执行以下作将适配器配置为接收增量通知：
使用 SELECT 语句注册通知，该语句检索所有“已处理”列为“n”的记录。 为此，可以指定 NotificationStatement 绑定属性的 SELECT 语句。
对于已收到通知的行，将“已处理”列更新为“y”。
本主题演示如何创建 BizTalk 业务流程并配置 BizTalk 应用程序以实现此目的。
通过 Oracle 电子商务适配器绑定属性来配置通知
下表汇总了用于配置从 Oracle E-Business Suite 接收通知的 Oracle E-Business 适配器绑定属性。 在 BizTalk Server 管理控制台中配置接收端口时，必须指定这些绑定属性。
注释
在为 通知 生成架构时，可以选择指定这些绑定属性，即使这并非必需。 如果您这样做，适配器服务附加组件在生成元数据时生成的端口绑定文件中也会包含您为绑定属性指定的值。 稍后可以在 BizTalk Server 管理控制台中导入此绑定文件，以创建已配置绑定属性的 WCF-custom 或 WCF-OracleEBS 接收端口。 有关使用绑定文件创建接收端口的详细信息，请参阅 使用端口绑定文件配置物理端口绑定到 Oracle E-Business Suite。
| Binding 属性 | DESCRIPTION |
|---|---|
| InboundOperationType | 指定要执行的入站操作。 若要接收通知消息，请将此项设置为 “通知”。 |
| NotificationPort | 指定 ODP.NET 必须打开的端口号，以侦听 Oracle 数据库中的数据库更改通知。 |
| NotificationStatement | 指定用于注册查询通知的 SELECT 语句。 仅当指定 SELECT 语句的结果集发生更改时，适配器才会收到通知消息。 |
| NotifyOnListenerStart | 指定适配器在启动侦听器时是否向适配器客户端发送通知。 |
有关这些属性的更完整说明，请参阅 有关 Oracle 电子商务套件绑定属性的 BizTalk 适配器的信息。 有关如何使用 Oracle 电子商务适配器从 Oracle E-Business Suite 接收通知的完整说明，请阅读进一步。
本主题如何演示如何接收通知消息
在本主题中，为了演示 Oracle E-Business 适配器如何支持从 Oracle E-Business Suite 接收增量数据库更改通知消息，我们将该适配器配置为接收对 ACCOUNTACTIVTY 表更改的通知。 假设 ACCOUNTACTIVITY 表包含列 TID、Account 和 Processed。 每当添加新记录时，“已处理”列的值将设置为“n”。 因此，若要获取增量通知，必须执行以下任务作为 BizTalk 业务流程的一部分：
获取“已处理”为“n”的所有记录的通知。 可以通过将 SELECT 语句指定为通知语句来执行此作。
收到特定记录的通知后，将“已处理”设置为“y”。 为此，可以执行更新“已处理”列的存储过程PROCESS_RECORDS。
为了演示如何接收增量通知，我们可以进行以下操作：
为 ACCOUNTACTIVITY 表上的 通知（入站操作）和 PROCESS_RECORDS（出站操作）生成模式。
创建具有以下内容的编排：
用于接收通知消息的接收位置。 你可以通过将 SELECT 语句指定如下来配置通知：
SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’注释
必须指定表名以及架构名称。 例如，
SCOTT.ACCOUNTACTIVITY。用于更新已发送通知的行的发送端口。 你将在此端口上执行PROCESS_RECORDS存储过程，将接收通知的记录的“已处理”列的值设置为“y”。
请注意，在接收通知消息后必须执行此作，以便更新已处理的行。 若要消除等待通知响应的开销，并避免手动抛出请求消息来执行PROCESS_RECORDS过程，你将在编排流程中直接生成PROCESS_RECORDS过程的请求消息。 为此，可以在编排中使用 构造消息 形状。
如何从 Oracle 电子商务套件接收通知消息
在 Oracle E-Business Suite 上使用 Oracle E-Business 适配器和 BizTalk Server 执行操作，涉及 构建基块中描述的过程任务，以创建 Oracle E-Business Suite 应用程序。 若要将适配器配置为接收通知消息，这些任务包括：
创建 BizTalk 项目，然后为 ACCOUNTACTIVITY 表上的 通知 （入站作）和 PROCESS_RECORDS 过程（出站作）生成架构。 （可选）可以为 InboundOperationType、 NotificationPort 和 NotificationStatement 绑定属性指定值。
在 BizTalk 项目中创建一条消息，用于从 Oracle E-Business Suite 接收通知。
在 BizTalk 项目中创建消息，用于执行PROCESS_RECORDS存储过程和接收响应消息。
创建一个执行以下操作的编排：
从 Oracle 电子商务套件接收通知消息。
创建一条消息以执行PROCESS_RECORDS过程。
将此消息发送到 Oracle 电子商务套件，以选择和更新记录并接收响应。
生成和部署 BizTalk 项目。
通过创建物理发送和接收端口来配置 BizTalk 应用程序。
注释
对于入站操作（如接收通知消息），只能配置单向 WCF-Custom 或 WCF-OracleEBS 接收端口。 入站操作不支持双向接收端口。
启动 BizTalk 应用程序。
本主题提供执行这些任务的说明。
生成架构
必须为 通知 操作及 PROCESS_RECORDS 过程生成架构。 有关如何生成架构的详细信息，请参阅 在 Visual Studio 中检索 Oracle 电子商务套件的元数据。 生成架构时执行以下任务。 如果不想在设计时指定绑定属性，请跳过第一步。
生成架构时，指定 InboundOperationType、 NotificationPort 和 NotificationStatement 绑定属性的值。 有关此绑定属性的详细信息，请参阅 有关 Oracle 电子商务套件绑定属性的 BizTalk 适配器的信息。 有关如何指定绑定属性的说明，请参阅 配置 Oracle E-Business Suite 的绑定属性。
选择合同类型为服务（入站操作）。
为 通知 生成模式。
选择合同类型为客户（出站操作）。
为 PROCESS_RECORDS 过程生成架构。 此过程在 ACCOUNT_PKG 包下提供。
定义消息和消息类型
前面生成的架构描述了业务流程中消息所需的“类型”。 消息通常是变量，类型由相应的架构定义。 生成架构后，必须将其链接到 BizTalk 项目的业务流程视图中的消息。
对于本主题，必须创建三条消息：一条消息用于从 Oracle E-Business Suite 接收通知，一条消息用于执行PROCESS_RECORDS过程，一条消息用于接收该过程的响应。
执行以下步骤以创建消息并将其链接到架构。
创建消息并链接到架构
将一项编排添加到 BizTalk 项目中。 在解决方案资源管理器中，右键单击 BizTalk 项目名称，指向 “添加”，然后单击“ 新建项”。 键入 BizTalk 业务流程的名称，然后单击“添加”。
打开 BizTalk 项目的业务流程视图窗口（如果尚未打开）。 单击 “视图”，指向 “其他窗口”，然后单击 “编排视图”。
在 业务流程视图中，右键单击 “消息”，然后单击“ 新建消息”。
右键单击新创建的消息，然后选择“ 属性窗口”。
在Message_1的“属性”窗格中，执行以下作：
用这个 要执行的操作 标识符 键入 NotifyReceive。消息类型 从下拉列表中，展开 “架构”，然后选择 OracleNotifyIncremental.OracleEBSBinding.Notification，其中 OracleNotifyIncremental 是 BizTalk 项目的名称。 OracleEBSBinding 是为 通知 操作生成的架构。 重复步骤 3 以创建两个新消息。 在新消息的 “属性 ”窗格中，执行以下作：
将标识符设置为 将消息类型设置为 程序 OracleNotifyIncremental.OracleEBSBinding1.PROCESS_RECORDS，其中 OracleEBSBinding1 是为 PROCESS_RECORDS 过程生成的架构。 过程响应 OracleNotifyIncremental.OracleEBSBinding1.PROCESS_RECORDSResponse
设置业务流程
必须创建 BizTalk 业务流程才能使用 BizTalk Server 从 Oracle E-Business Suite 接收通知消息，然后更新接收通知的行。 在此业务流程中，适配器根据为 NotificationStatement 绑定属性指定的 SELECT 语句接收通知消息。 通知消息在 FILE 位置接收。 收到响应后，业务流程将构造一条消息来调用PROCESS_RECORDS过程，该过程会更新接收通知的行。 此消息的响应也在同一 FILE 位置接收。
因此，编排必须包含以下各项：
单向接收通知消息的 WCF-Custom 或 WCF-OracleEBS 端口。
双向 WCF-Custom 或 WCF-OracleEBS 发送端口用于发送消息来执行PROCESS_RECORDS过程。
构造 消息 形状，用于构造消息，以在业务流程中执行PROCESS_RECORDS过程。
文件发送端口，用于保存通知消息和PROCESS_RECORDS过程的响应。
接收和发送形状。
示例编排如下所示。
添加消息形状
请确保为每个邮件形状指定以下属性。 “形状”列中列出的名称是消息形状的名称，如上述编排中所显示。
| 形状 | 形状类型 | 性能 |
|---|---|---|
| 接收通知 | 接收 | - 将 变量名 设置为 ReceiveNotification - 将 “激活 ”设置为 True |
| 保存通知 | 发送 | - 将 名称 设置为 保存通知 |
| SendProcMessage | 发送 | - 将 名称 设置为 SendProcMessage |
| 接收处理响应 | 接收 | - 将 名称 设置为 ReceiveProcResponse |
| SaveProcResponse | 发送 | - 将 名称 设置为 SaveProcResponse |
添加构建信息格式
可以使用 构造消息 形状在业务流程中生成请求消息来执行PROCESS_RECORDS过程。 为此，必须在业务流程中添加一个构造消息图形和一个消息分配图形。 对于此示例， “消息分配” 形状调用代码，该代码将生成发送到 Oracle E-Business Suite 以执行该过程的消息。 “消息分配”形状还会设置要发送到 Oracle 电子商务套件的消息的动作。
对于构造消息形状，请将 Message Constructed 属性设置为 Procedure。
生成响应的代码可以是与 BizTalk 项目相同的 Visual Studio 解决方案的一部分。 生成响应消息的示例代码如下所示。
namespace MessageCreator
{
public class MessageCreator
{
private static XmlDocument Message;
private static string XmlFileLocation;
private static string ResponseDoc;
public static XmlDocument XMLMessageCreator()
{
XmlFileLocation = "C:\\TestLocation\\MessageIn";
try
{
ResponseDoc = (Directory.GetFiles(XmlFileLocation, "*.xml", SearchOption.TopDirectoryOnly))[0];
}
catch (Exception ex)
{
Console.WriteLine("Trying to get XML from: " + XmlFileLocation);
Console.WriteLine("EXCEPTION: " + ex.ToString());
throw ex;
}
//Create Message From XML
Message = new XmlDocument();
Message.PreserveWhitespace = true;
Message.Load(ResponseDoc);
return Message;
}
}
}
要使上述代码摘录能够生成请求消息，必须在XmlFileLocation变量指定的位置有用于PROCESS_RECORDS过程的XML请求消息。
注释
生成项目后，将在项目目录中创建 MessageCreator.dll。 必须将此 DLL 添加到全局程序集缓存（GAC）。 此外，必须在 BizTalk 项目中将 MessageCreator.dll 添加为引用。
添加以下表达式以从 消息分配 形状调用此代码，并设置消息的操作。 若要添加表达式，请双击 “消息分配” 形状以打开表达式编辑器。
Procedure = MessageCreator.MessageCreator.XMLMessageCreator();
Procedure(WCF.Action) = "PackageApis/SCOTT/ACCOUNT_PKG/PROCESS_RECORDS";
添加端口
请确保为每个逻辑端口指定以下属性。 端口列中列出的名称是在编排中显示的端口的名称。
| 港口 | 性能 |
|---|---|
| OracleNotifyPort | - 将 标识符 设置为 OracleNotifyPort - 将 类型 设置为 OracleNotifyPortType - 将 通信模式 设置为 单向 - 将通信方向设置为接收 |
| 保存消息端口 | - 将 标识符 设置为 SaveMessagePort - 将 类型 设置为 SaveMessagePortType - 将 通信模式 设置为 单向 - 将通信方向设置为发送 - 创建操作 通知。 此操作用于通知消息。 - 创建一个操作过程。 此操作用于选择响应消息。 |
| OracleOutboundPort | - 将 标识符 设置为 OracleOutboundPort - 将 类型 设置为 OracleOutboundPortType - 将 通信模式 设置为 请求-响应 - 将 通信方向 设置为 发送接收 |
为动作形状指定消息并连接至端口
下表列出了为操作形状指定消息及将消息链接到端口时需要设置的属性及其值。 Shape 列中列出的名称是前文提到的业务编排中显示的消息形状的名称。
| 形状 | 性能 |
|---|---|
| 接收通知 | - 将 消息 设置为 NotifyReceive - 将 操作 设置为 OracleNotifyPort.Notify.Request |
| 保存通知 | - 将 消息 设置为 NotifyReceive - 将 操作 设置为 SaveMessagePort.Notify.Request |
| SendProcMessage | - 将 消息 设置为 过程 - 将操作设置为OracleOutboundPort.Procedure.Request |
| 接收处理响应 | - 将 消息 设置为 ProcedureResponse - 将 操作 设置为 OracleOutboundPort.Procedure.Response |
| SaveProcResponse | - 将 消息 设置为 ProedureResponse - 将 Operation 设置为 SaveMessagePort.Procedure.Request |
指定这些属性后，消息形状符和端口被连接，您的编排已完成。
现在必须生成 BizTalk 解决方案并将其部署到 BizTalk Server。 有关详细信息，请参阅以下位置 https://go.microsoft.com/fwlink/?LinkId=102359的“生成和运行业务流程”。
配置 BizTalk 应用程序
部署 BizTalk 项目后，前面创建的业务流程将列在 BizTalk Server 管理控制台中的 “业务流程 ”窗格下。 必须使用 BizTalk Server 管理控制台来配置应用程序。 有关配置应用程序的详细信息，请参阅以下位置 https://go.microsoft.com/fwlink/?LinkID=196961的“如何配置应用程序”。
配置应用程序涉及：
为应用程序选择主机。
将业务流程中创建的端口映射到 BizTalk Server 管理控制台中的物理端口。 对于此编排，必须：
定义物理 WCF-Custom 或 WCF-OracleEBS 单向接收端口。 此端口侦听来自 Oracle E-Business Suite 的通知。 有关如何创建接收端口的信息，请参阅 手动配置到 Oracle 电子商务适配器的物理端口绑定。 请确保为接收端口指定以下绑定属性。
重要
如果在设计时指定绑定属性，则无需执行此步骤。 在这种情况下，可以通过导入由“Consume Adapter Service”外接程序创建的绑定文件，来设置所需绑定属性的接收端口。 有关详细信息，请参阅 使用端口绑定文件配置物理端口绑定到 Oracle E-Business Suite。
Binding 属性 价值 InboundOperationType 将此设置为 “通知”。 NotificationPort 指定 ODP.NET 必须打开的端口号，以侦听 Oracle 数据库中的数据库更改通知。 将此设置为必须添加到 Windows 防火墙例外列表的相同端口号。 有关如何将端口添加到 Windows 防火墙例外列表的说明，请参阅 https://go.microsoft.com/fwlink/?LinkID=196959。
重要： 如果将此项设置为默认值 -1，则必须完全禁用 Windows 防火墙才能接收通知消息。NotificationStatement 将此设置为：
SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’
注意： 必须指定表名以及架构名称。 例如，SCOTT.ACCOUNTACTIVITY。NotifyOnListenerStart 将此设置为 True。 有关不同绑定属性的详细信息，请参阅 有关 Oracle 电子商务套件绑定属性的 BizTalk 适配器的信息。
重要
如果要为接口表配置通知，则必须通过指定必要的绑定属性来设置应用程序上下文。 有关设置应用程序上下文的详细信息，请参阅 “设置应用程序上下文”。
注释
建议在使用 Oracle 电子商务适配器执行入站作时配置事务隔离级别和事务超时。 可以通过在配置 WCF-Custom 或 WCF-OracleEBS 接收端口时添加服务行为来执行此作。 有关如何添加服务行为的说明，请参阅 使用 Oracle E-Business Suite 配置事务隔离级别和事务超时。
定义物理 WCF-Custom 或 WCF-OracleEBS 发送端口以将消息发送到 Oracle E-Business Suite 以执行PROCESS_REOCRDS过程。 还必须在发送端口中指定操作。
定义硬盘上的一个位置和一个相应的文件端口，BizTalk 业务流程将把来自 Oracle E-Business Suite 的消息投放到那里。 这些将是从 Oracle E-Business Suite 接收到的通知消息，以及通过 WCF-Custom 或 WCF-OracleEBS 发送端口执行的 PROCESS_RECORDS 过程相关的消息。
启动应用程序
必须启动 BizTalk 应用程序，以便从 Oracle E-Business Suite 接收通知消息并执行PROCESS_RECORDS过程。 有关启动 BizTalk 应用程序的说明，请参阅 https://go.microsoft.com/fwlink/?LinkId=102387 处的“如何启动编排”。
在此阶段，请确保：
WCF-Custom 或 WCF-OracleEBS 单向接收的端口，用于从 Oracle E-Business Suite 接收通知消息，正在运行。
WCF-Custom 或 WCF-OracleEBS 发送端口正在运行以执行 PROCESS_RECORDS 过程。
从 Oracle 电子商务套件接收消息的 FILE 发送端口正在运行。
正在运行该操作的 BizTalk 业务流程。
执行操作
假设 ACCOUNTACTIVITY 表已有一些记录。 此外，请确保在 C：\TestLocation\MessageIn 上提供了执行PROCESS_RECORDS过程的 XML 消息。 XML 文件应如下所示：
<PROCESS_RECORDS xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/PackageApis/SCOTT/ACCOUNT_PKG" />
启动 BizTalk 业务流程后，将按相同的顺序发生以下一组动作：
适配器收到类似于以下内容的通知消息：
<?xml version="1.0" encoding="utf-8" ?> <Notification xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/Notification/"> <Info>ListenerStarted</Info> <Source>OracleEBSBinding</Source> <Type>Startup</Type> </Notification>此消息通知接收端口用于接收通知消息，且端口已启动。 请注意，元素的值
<Info>为“ListnerStarted”。适配器执行PROCESS_RECORDS过程。 Oracle 电子商务套件的下一个响应是针对该过程的。
<?xml version="1.0" encoding="utf-8" ?> <PROCESS_RECORDSResponse xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/PackageApis/SCOTT/ACCOUNT_PKG"> <TABLE_DATA> <xs:schema id="NewDataSet" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"> <xs:element msdata:IsDataSet="true" name="NewDataSet"> <xs:complexType> <xs:sequence> <xs:element minOccurs="0" maxOccurs="unbounded" name="NewTable"> <xs:complexType> <xs:sequence> <xs:element minOccurs="0" name="TID" type="xs:decimal" /> <xs:element minOccurs="0" name="ACCOUNT" type="xs:decimal" /> <xs:element minOccurs="0" name="PROCESSED" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> <diffgr:diffgram xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"> <NewDataSet xmlns=""> <NewTable> <TID>1</TID> <ACCOUNT>100001</ACCOUNT> <PROCESSED>n</PROCESSED> </NewTable> <NewTable> ...... ...... </NewTable> ...... ...... </NewDataSet> </diffgr:diffgram> </TABLE_DATA> </PROCESS_RECORDSResponse>这是对作为 PROCESS_RECORDS 过程一部分的 SELECT 语句执行所得的响应。
PROCESS_RECORDS过程还会更新行，以将 PROCESSED 设置为“y”。 因此，适配器会收到更新操作的另一条通知。
<?xml version="1.0" encoding="utf-8" ?> <Notification xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/Notification/"> <Details> <NotificationDetails> <ResourceName>SCOTT.ACCOUNTACTIVITY</ResourceName> <Info>32</Info> <QueryId>0</QueryId> </NotificationDetails> </Details> <Info>Update</Info> <ResourceNames> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">SCOTT.ACCOUNTACTIVITY</string> </ResourceNames> <Source>Data</Source> <Type>Change</Type> </Notification>请注意，该
Info元素包含“Update”。第二个通知后，适配器再次执行PROCESS_RECORDS过程。 但是，现在由于没有将 PROCESSED 列设置为“n”的记录，此过程将返回一个类似于以下内容的空响应。
<?xml version="1.0" encoding="utf-8" ?> <PROCESS_RECORDSResponse xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/PackageApis/SCOTT/ACCOUNT_PKG"> <TABLE_DATA> <xs:schema id="NewDataSet" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"> <xs:element msdata:IsDataSet="true" name="NewDataSet"> <xs:complexType> <xs:sequence> <xs:element minOccurs="0" maxOccurs="unbounded" name="NewTable"> <xs:complexType> <xs:sequence> <xs:element minOccurs="0" name="TID" type="xs:decimal" /> <xs:element minOccurs="0" name="ACCOUNT" type="xs:decimal" /> <xs:element minOccurs="0" name="PROCESSED" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> <diffgr:diffgram xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"> <NewDataSet xmlns="" /> </diffgr:diffgram> </TABLE_DATA> </PROCESS_RECORDSResponse>
最佳做法
部署并配置 BizTalk 项目后，可以将配置设置导出到名为绑定文件的 XML 文件。 生成绑定文件后，可以从该文件导入配置设置，以便无需为同一业务流程创建发送端口和接收端口。 有关文件绑定的详细信息，请参阅 在 Oracle E-Business Suite 中重用适配器绑定。