c#程序通过sapnetconnector3 与SAP进行交互的实例，及helper代码

使用C#和SAP .NET Connector 3与SAP系统进行交互的示例

SAP .NET Connector (SAP NCo) 是一个库，它允许.NET 应用程序与SAP系统进行通信。通过SAP NCo，开发者可以调用远程功能的ABAP代码（RFC），发送和接收IDoc，以及使用BAPI和其他SAP接口。

以下是一个简单的示例，展示了如何使用C#和SAP .NET Connector 3来调用SAP中的一个远程功能模块。在这个例子中，我们将调用一个简单的RFC函数（例如RFC_PING），该函数通常用于测试RFC连接。

首先，确保你已经安装了SAP .NET Connector 3，并且配置了正确的SAP连接参数，比如SAP服务器的IP地址、系统编号、客户端ID、用户名和密码等。

然后，在Visual Studio中创建一个新的C#控制台应用程序项目，并添加对SAP NCo库的引用。

示例代码：

csharp
using System;
using SAP.Middleware.Connector;

namespace SAPConnectionExample
{
class Program
{
static void Main(string[] args)
{
try
{
// SAP系统连接参数
RfcConfigParameters rfcParams = new RfcConfigParameters();
rfcParams[RfcConfigParameters.Name] = “SAPConnection”;
rfcParams[RfcConfigParameters.AppServerHost] = “your_sap_server_ip”;
rfcParams[RfcConfigParameters.SystemNumber] = “00”;
rfcParams[RfcConfigParameters.Client] = “100”;
rfcParams[RfcConfigParameters.User] = “your_sap_username”;
rfcParams[RfcConfigParameters.Password] = “your_sap_password”;
rfcParams[RfcConfigParameters.Language] = “EN”;
rfcParams[RfcConfigParameters.PoolSize] = “5”;

            // 创建SAP连接  
            RfcDestination rfcDestination = RfcDestinationManager.GetDestination(rfcParams);  
            rfcDestination.RepositoryLocation = RfcRepositoryLocation.Local;  

            // 创建RFC功能  
            IRfcFunction rfcFunction = rfcDestination.Repository.CreateFunction("RFC_PING");  

            // 调用RFC功能  
            rfcFunction.Invoke(rfcDestination);  

            // 获取RFC返回结果  
            IRfcTable returnTable = rfcFunction.GetTable("RFC_PING");  

            // RFC_PING函数可能没有返回表，但它可以返回一个简单的响应。  
            // 这里我们假设它返回一个表，但通常我们会检查特定的返回值字段。  
            // 例如: string response = rfcFunction.GetValue("RFCSI_EXPORT").ToString();  

            // 遍历返回表（如果有的话）  
            foreach (IRfcStructure row in returnTable)  
            {  
                // 处理返回数据  
                Console.WriteLine(row.ToString());  
            }  

            Console.WriteLine("RFC call successful!");  
        }  
        catch (RfcAbapException ex)  
        {  
            // 处理SAP错误  
            Console.WriteLine("SAP returned an error: " + ex.Message);  
        }  
        catch (RfcAbapRuntimeException ex)  
        {  
            // 处理SAP运行时错误  
            Console.WriteLine("SAP runtime error: " + ex.Message);  
        }  
        catch (RfcBaseException ex)  
        {  
            // 处理其他SAP NCo错误  
            Console.WriteLine("SAP NCo error occurred: " + ex.Message);  
        }  
        catch (Exception ex)  
        {  
            // 处理常规.NET错误  
            Console.WriteLine("An error occurred: " + ex.Message);  
        }  

        Console.WriteLine("Press any key to exit...");  
        Console.ReadKey();  
    }  
}  

}
注意：

在上面的代码中，RFC_PING函数通常不返回表，而是返回一个简单的结构或值。这里使用GetTable是为了展示如何获取表，但在这个特定情况下，它可能不适用。你应该检查RFC函数的文档，了解它返回的确切参数。

SAP NCo的RfcDestinationManager.GetDestination方法也可以直接接受一个连接字符串作为参数，而不是RfcConfigParameters对象。连接字符串包含了所有必要的连接信息，并且是以特定格式编码的。

确保SAP服务器的IP地址、系统编号、客户端ID、用户名和密码是正确的，并且你有权访问SAP系统和调用RFC函数。

在实际的生产环境中，你应该避免在代码中硬编码SAP连接参数。相反，应该使用配置文件或环境变量来安全地存储这些敏感信息。

示例代码中的异常处理是为了展示如何捕获不同类型的错误。在实际应用中，你可能需要根据具体需求进行更详细的错误处理。

请确保在运行代码之前，你已经正确配置了SAP连接参数，并且已经安装了SAP .NET Connector 3库。如果你遇到任何问题，请检查SAP NCo的文档和SAP系统的日志以获取更多信息。

定义要给SAP传送的数据列表

在与SAP进行数据交互之前，我们通常需要定义好要传送的数据格式，确保这些数据能够符合SAP系统的要求。在C#中，我们通常会将要传送的数据组织成列表或数组的形式，然后再将这些数据转换成SAP能够识别的Table类型数据。

以下是一个例子，展示如何将C#中的List数据转换成SAP可以识别的Table数据：

csharp
using SAP.Middleware.Connector;

// 假设我们有一个订单行的List
List orderLines = new List
{
new OrderLine { ItemNumber = “001”, Material = “MAT123”, Quantity = 10 },
new OrderLine { ItemNumber = “002”, Material = “MAT456”, Quantity = 20 }
// … 其他订单行
};

// 创建SAP函数
IRfcFunction rfcFunction = rfcDestination.Repository.CreateFunction(“BAPI_FUNCTION_NAME”);

// 获取SAP函数的Table参数
IRfcTable orderItemsTable = rfcFunction.GetTable(“ORDER_ITEM_IN”);

// 遍历List，将数据填充到SAP的Table中
foreach (var orderLine in orderLines)
{
IRfcStructure orderItem = orderItemsTable.Append();
orderItem.SetValue(“ITM_NUMBER”, orderLine.ItemNumber);
orderItem.SetValue(“MATERIAL”, orderLine.Material);
orderItem.SetValue(“QUANTITY”, orderLine.Quantity);
// … 设置其他字段
}

// 接下来可以调用该函数将数据发送到SAP系统
在这个例子中，OrderLine是一个自定义的类，包含了订单行的相关信息，比如ItemNumber、Material和Quantity等字段。我们通过遍历这个List，将每一条订单行的数据填充到SAP的Table参数中。

C#与SAP进行数据交互（C# -> SAP）返回多个字符串

当C#调用SAP函数并期望返回多个字符串时，通常这些字符串会以某种形式包含在SAP函数的返回参数中。下面是一个调用SAP函数并处理返回字符串的例子：

csharp
IRfcFunction rfcFunction = rfcDestination.Repository.CreateFunction(“RFC_FUNCTION_RETURN_STRINGS”);

// 设置SAP函数的输入参数（如果有的话）
// rfcFunction.SetValue(“INPUT_PARAM”, “value”);

rfcFunction.Invoke(rfcDestination);

// 假设函数返回了一个名为RETURN_STRINGS的表，表中包含了多个字符串
IRfcTable returnStringsTable = rfcFunction.GetTable(“RETURN_STRINGS”);

List returnedStrings = new List();

foreach (IRfcStructure returnStringStruct in returnStringsTable)
{
// 假设表中有一个名为"STRING_VALUE"的字段包含了返回的字符串
string stringValue = returnStringStruct.GetString(“STRING_VALUE”);
returnedStrings.Add(stringValue);
}

// 现在returnedStrings列表中包含了所有从SAP返回的字符串
C#与SAP进行数据交互（C# -> SAP）返回Table

当C#调用SAP函数并期望返回一个Table类型的数据时，处理过程与上面处理返回字符串类似，只是我们需要遍历返回的Table并提取所需的数据。下面是一个例子：

csharp
IRfcFunction rfcFunction = rfcDestination.Repository.CreateFunction(“RFC_FUNCTION_RETURN_TABLE”);

// 调用SAP函数
rfcFunction.Invoke(rfcDestination);

// 获取返回的Table
IRfcTable resultTable = rfcFunction.GetTable(“RESULT_TABLE”);

// 遍历Table并处理数据
foreach (IRfcStructure resultRow in resultTable)
{
// 假设返回的Table中有字段FIELD1和FIELD2
string field1Value = resultRow.GetString(“FIELD1”);
decimal field2Value = resultRow.GetDecimal(“FIELD2”);

// 处理每一行的数据  
Console.WriteLine($"FIELD1: {field1Value}, FIELD2: {field2Value}");  

}
在这个例子中，我们调用了SAP函数，并获取了名为RESULT_TABLE的返回Table。然后我们遍历了这个Table，并提取了每一行中FIELD1和FIELD2字段的值。

实例代码可参加请见附件