使用 vs2010 和 SAP .NET Connector 3.0 的示例
要求:
- Visual Studio .NET 2010(免费的 c# Express 版本就可以)
- SAP .NET Connector 3.0(您通常可以从您手头项目的客户那里获取它)
安装
确定适合您平台的正确版本。您可能会遇到以下情况:
..对于 Windows 7 64 位安装,我们将使用sapnco30dotnet40P_12-20007348.zip
.
展开存档,然后启动.msi
安装文件。
.. 按照安装过程进行操作,保留所有默认选项(下一步.. 下一步.. 下一步.. 完成)。
参考文献
打开 Visual Studio 并创建一个新项目(或打开您自己的项目)。
In the Solution Explorer
面板,通常在您的右侧,右键单击References
并选择Add Reference
:
..然后,选择Browse
选项卡,导航到 SAP Connector 安装文件夹,然后选择两者sapnco.dll
and sapnco_utils.dll
:
现在您已在 Visual Studio 项目中正确引用了 SAP .NET Connector,您可以为其编写代码。
连接中
首先创建一个目标配置类(将连接参数替换为客户端提供的参数):
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using SAP.Middleware.Connector; // your sap connector
namespace WindowsFormsSapApplication1
{
public class ECCDestinationConfig : IDestinationConfiguration
{
public bool ChangeEventsSupported()
{
return false;
}
public event RfcDestinationManager.ConfigurationChangeHandler ConfigurationChanged;
public RfcConfigParameters GetParameters(string destinationName)
{
RfcConfigParameters parms = new RfcConfigParameters();
if (destinationName.Equals("mySAPdestination"))
{
parms.Add(RfcConfigParameters.AppServerHost, "sapnode.mycompany.net");
parms.Add(RfcConfigParameters.SystemNumber, "21");
parms.Add(RfcConfigParameters.SystemID, "CF1");
parms.Add(RfcConfigParameters.User, "mySAPuser");
parms.Add(RfcConfigParameters.Password, "mySAPpassword");
parms.Add(RfcConfigParameters.Client, "100");
parms.Add(RfcConfigParameters.Language, "EN");
parms.Add(RfcConfigParameters.PoolSize, "5");
}
return parms;
}
}
}
..然后,连接到 SAP 并调用函数。假设您要检索公司列表,使用BAPI_COMPANYCODE_GETLIST
SAP功能:
public void GetCompanies() {
ECCDestinationConfig cfg = new ECCDestinationConfig();
RfcDestinationManager.RegisterDestinationConfiguration(cfg);
RfcDestination dest = RfcDestinationManager.GetDestination("mySAPdestination");
RfcRepository repo = dest.Repository;
IRfcFunction testfn = repo.CreateFunction("BAPI_COMPANYCODE_GETLIST");
testfn.Invoke(dest);
var companyCodeList = testfn.GetTable("COMPANYCODE_LIST");
// companyCodeList now contains a table with companies and codes
}
让生活更轻松
在上面的例子中,GetTable
函数返回一个SAP您可能喜欢或不喜欢的表。有一个方便的扩展可以将该表转换为熟悉的 .NETDataTable
, 如下:
public static class IRfcTableExtentions
{
/// <summary>
/// Converts SAP table to .NET DataTable table
/// </summary>
/// <param name="sapTable">The SAP table to convert.</param>
/// <returns></returns>
public static DataTable ToDataTable(this IRfcTable sapTable, string name)
{
DataTable adoTable = new DataTable(name);
//... Create ADO.Net table.
for (int liElement = 0; liElement < sapTable.ElementCount; liElement++)
{
RfcElementMetadata metadata = sapTable.GetElementMetadata(liElement);
adoTable.Columns.Add(metadata.Name, GetDataType(metadata.DataType));
}
//Transfer rows from SAP Table ADO.Net table.
foreach (IRfcStructure row in sapTable)
{
DataRow ldr = adoTable.NewRow();
for (int liElement = 0; liElement < sapTable.ElementCount; liElement++)
{
RfcElementMetadata metadata = sapTable.GetElementMetadata(liElement);
switch (metadata.DataType)
{
case RfcDataType.DATE:
ldr[metadata.Name] = row.GetString(metadata.Name).Substring(0, 4) + row.GetString(metadata.Name).Substring(5, 2) + row.GetString(metadata.Name).Substring(8, 2);
break;
case RfcDataType.BCD:
ldr[metadata.Name] = row.GetDecimal(metadata.Name);
break;
case RfcDataType.CHAR:
ldr[metadata.Name] = row.GetString(metadata.Name);
break;
case RfcDataType.STRING:
ldr[metadata.Name] = row.GetString(metadata.Name);
break;
case RfcDataType.INT2:
ldr[metadata.Name] = row.GetInt(metadata.Name);
break;
case RfcDataType.INT4:
ldr[metadata.Name] = row.GetInt(metadata.Name);
break;
case RfcDataType.FLOAT:
ldr[metadata.Name] = row.GetDouble(metadata.Name);
break;
default:
ldr[metadata.Name] = row.GetString(metadata.Name);
break;
}
}
adoTable.Rows.Add(ldr);
}
return adoTable;
}
private static Type GetDataType(RfcDataType rfcDataType)
{
switch (rfcDataType)
{
case RfcDataType.DATE:
return typeof(string);
case RfcDataType.CHAR:
return typeof(string);
case RfcDataType.STRING:
return typeof(string);
case RfcDataType.BCD:
return typeof(decimal);
case RfcDataType.INT2:
return typeof(int);
case RfcDataType.INT4:
return typeof(int);
case RfcDataType.FLOAT:
return typeof(double);
default:
return typeof(string);
}
}
}
参考:http://antswift.wordpress.com/2011/12/22/irfctable-to-net-datatable-extention-method/ http://antswift.wordpress.com/2011/12/22/irfctable-to-net-datatable-extention-method/
添加上述扩展后,您现在可以将结果转换为DataTable
:
// get the regular SAP structured table..
var companyCodeList = testfn.GetTable("COMPANYCODE_LIST");
// turn it into a DataTable..
var companyDataTable = companyCodeList.ToDataTable();
// use it
SomeForm.DataGridView.DataSource=companyDataTable;
Notes
- 虽然此示例基于 vs2010,但其他 Visual Studio 版本应该可以正常运行。
- It appears连接器中的 SAP 函数名称应始终为大写。
- 如果您的 SAP Connector 架构有误,例如如果您安装 64 位版本,然后尝试编译 32 位 x86,您将收到如下错误:“无法加载文件或程序集“sapnco,Version=3.0.0.42,Culture=neutral,PublicKeyToken=50436dca5c7f7d23”或其依赖项之一。尝试加载格式不正确的程序。”这个是正常的;只需安装正确的版本即可。
补充阅读
- http://service.sap.com/connectors http://service.sap.com/connectors
- http://antswift.wordpress.com/2011/12/22/connecting-to-sap-and-retriving-data-using-version-3-0-of-the-sap-net-connector/ http://antswift.wordpress.com/2011/12/22/connecting-to-sap-and-retrieving-data-using-version-3-0-of-the-sap-net-connector/
- http://www.codeproject.com/Tips/521485/SAP-Integration-with-Net-4-0-SAP-Connection-Manage http://www.codeproject.com/Tips/521485/SAP-Integration-with-Net-4-0-SAP-Connection-Manage
- http://www.dataxstream.com/2011/11/nco-3-rfc-client-vb-net-step-by-step/ http://www.dataxstream.com/2011/11/nco-3-rfc-client-vb-net-step-by-step/