使用 SAP 适配器的 WCF 通道模型概述

2025-06-05

要在 SAP 系统上调用 RFC、tRFC 或 BAPI，或将 IDOC 发送到 SAP 系统，您的代码会作为 WCF 客户端，向适配器发送出站操作。在 WCF 通道模型中，代码通过通道发送请求消息来调用适配器上的操作。

为了在 SAP 系统中充当 tRFC 或 RFC 服务器，您的代码会作为一个 WCF 服务运行。也就是说，适配器会在您的代码上调用入站操作，例如调用 RFC 或 ReceiveIdoc 操作（以字符串格式从 SAP 系统接收 IDOC）。在这种情况下，您的代码通过适配器的通道接收针对操作的请求消息。

本节中的主题概述了如何结合使用 SAP 适配器和 WCF 通道模型。

WCF 通道模型概述

客户端和服务通过交换 SOAP 消息进行通信。 WCF 通道模型是此消息交换的低级别抽象。它提供接口和类型，使你能够使用称为通道堆栈的分层协议堆栈发送和接收消息。堆栈的每个层都由一个通道组成，并且每个通道都是从 WCF 绑定创建的。传输通道在最低层。传输通道在服务与客户端之间实现基础传输机制，并将每个消息作为 System.ServiceModel.Message 呈现给较高层（最终使用的应用程序）。 WCF Message 类是 SOAP 消息的抽象。 WCF 提供了多个通道接口（称为通道形状），这些接口对基本 SOAP 消息交换模式（如请求-答复或单向）进行建模。 WCF 传输绑定提供一个或多个通道形状的实现，较高层可用于发送和接收消息。有关 WCF 通道模型的详细信息，请参阅通道模型概述。

SAP 适配器是一个 WCF 自定义传输绑定，将 SAP 系统公开为 WCF 服务。

SAP 适配器支持的通道形状

适配器实现以下 WCF 通道形状：

IRequestChannel （System.ServiceModel.Channels.IRequestChannel）。 IRequestChannel 接口用于实现请求-回复消息交换的客户端功能。可以使用 IRequestChannel 来执行需要响应的操作，例如在 SAP 系统上调用返回数据的 RFC。
IOutputChannel （System.ServiceModel.Channels.IOutputChannel）。此模型执行单向消息交换的客户端功能。可以使用 IOutputChannel 来调用一个不需要接收响应的操作，例如，在不返回任何数据的 SAP 系统上调用一个 RFC。
IReplyChannel （System.ServiceModel.Channels.IReplyChannel）。此形状实现请求-答复消息交换的服务端。可以使用 IReplyChannel 实现 RFC 或 tRFC 服务器，或者从 SAP 系统接收 IDOC。

与任何 WCF 绑定一样，SAP 适配器使用工厂模式向应用程序代码提供通道。使用 Microsoft.Adapters.SAPBinding 对象创建以下项的实例：
System.ServiceModel.ChannelFactory<IRequestChannel> 提供 IRequestChannel 通道，可用于对适配器调用请求-响应作。
System.ServiceModel.ChannelFactory<IOutputChannel> 提供可用于在适配器上调用单向作的 IOutputChannel 通道。
System.ServiceModel.IChannelListener<IReplyChannel> 提供 IReplyChannel 通道，可用于从适配器接收请求-响应操作。

在 WCF 通道模型中为 SAP 适配器创建消息

在 WCF 中， System.ServiceModel.Channels.Message 类提供 SOAP 消息的内存表示形式。通过调用静态 Message.Create 方法创建消息实例。

SOAP 消息有两个重要部分，必须在构造要发送到 SAP 适配器的消息实例时指定该消息实例。

消息操作是 SOAP 消息标头的一部分的字符串。消息操作用于识别应在 SAP 适配器上调用的操作。下面显示了指定用于调用 SAP 系统上的 SD_RFC_CUSTOMER_GET RFC 的消息操作：http://Microsoft.LobServices.Sap/2007/03/Rfc/SD_RFC_CUSTOMER_GET.
消息正文包含操作的参数数据。消息正文由格式正确的 XML 组成，这些 XML 符合 SAP 适配器针对请求操作所期望的消息架构。以下消息正文包含 SAP 系统上SD_RFC_CUSTOMER_GET RFC 的参数。
```
<SD_RFC_CUSTOMER_GET xmlns=\"http://Microsoft.LobServices.Sap/2007/03/Rfc/\"> <KUNNR i:nil=\"true\" xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\"> </KUNNR> <NAME1>AB*</NAME1> <CUSTOMER_T> </CUSTOMER_T> </SD_RFC_CUSTOMER_GET>  
```
有关 SAP 适配器的消息架构和操作的消息动作的信息，请参阅适用于 mySAP Business Suite 的 BizTalk 适配器的消息和消息架构。

Message.Create 方法已重载，并提供许多不同的选项来提供消息正文。以下代码展示如何使用 System.Xml.XmlReader 提供消息正文来创建 Message 实例。在此代码中，从字符串常量读取消息正文。

//create an XML message to send to the SAP system  
//We are invoking the SD_RFC_CUSTOMER_GET RFC.  
//The XML below specifies that we want to search for customers with names starting with "AB"  
string inputXml = "<SD_RFC_CUSTOMER_GET xmlns=\"http://Microsoft.LobServices.Sap/2007/03/Rfc/\"> <KUNNR i:nil=\"true\" xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\"> </KUNNR> <NAME1>AB*</NAME1> <CUSTOMER_T> </CUSTOMER_T> </SD_RFC_CUSTOMER_GET>";  
  
//create an XML reader from the input XML  
XmlReader reader = XmlReader.Create(new MemoryStream(Encoding.Default.GetBytes(inputXml)));  
  
//create a WCF message from the XML reader  
Message inputMessge = Message.CreateMessage(MessageVersion.Soap11, "http://Microsoft.LobServices.Sap/2007/03/Rfc/SD_RFC_CUSTOMER_GET", reader);

重要

您必须在消息实例中提供一个消息操作。创建消息实例时通常执行此作。

WCF 通道模型中 SAP 适配器的流支持

如何创建和使用与 SAP 适配器交换的消息，这将决定消息在代码和适配器之间的流式传输方式。

节点流式处理

节点流式处理是除 SendIdoc 和 ReceiveIdoc 作业以外的所有作业支持的唯一流式处理级别。

若要为消息执行节点流处理，请执行以下步骤：

使用 XmlReader 创建出站消息来提供消息正文。
使用 XmlReader 消耗入站消息。通过在入站消息上调用 GetReaderAtBodyContents 方法来获取读取器。

节点值流式处理

由于 SendIdoc 和 ReceiveIdoc 操作在单个 XML 节点（<idocData>）中以字符串形式包含 IDOC 数据，因此适配器支持对这些操作进行节点值流式处理。

若要对这些操作执行节点值流式处理，可以：

创建 SendIdoc 请求消息（出站），使用实现节点值流式处理来提供消息正文的 BodyWriter。
通过使用实现节点值流式处理的 XmlDictionaryWriter 对消息调用 WriteBodyContents 方法来消费 ReceiveIdoc 请求消息（入站）。

有关使用 WCF 通道模型流式传输平面文件（字符串）IDOC 的详细信息，请参阅使用 WCF 通道模型的 SAP 中的流式处理 Flat-File IDOC。

另请参阅

使用 WCF 通道模型开发应用程序

通过