要点讲解
如果table作为输入参数，需要用户填充每一行的内容。用法说明如下。我们仍然以RFC_READ_TABLE这个函数为例。关于函数参数的说明，请参照本系列之前的文档，或自行google。
接着上一篇的文档和代码，使用RFC_READ_TABLE函数读取SKA1表科目表为Z900的数据，输出KTOPL和SAKNR这两个字段。
在TableManipulation.cs中增加一个ReadTable方法：
public DataTable ReadTable()
{
// purpose:
// read table SKA1 with criteria: KTOPL = Z900
// and returns a DataTable
RfcDestination dest = DestinationProvider.GetDestination();
IRfcFunction fm = dest.Repository.CreateFunction("RFC_READ_TABLE");
fm.SetValue("QUERY_TABLE", "SKA1");
fm.SetValue("DELIMITER", "~");
// OPTIONS table parameter
IRfcTable options = fm.GetTable("OPTIONS");
options.Append(); // create a new row
options.CurrentRow.SetValue(0, "KTOPL = 'Z900' ");
// FIELDS table parameter
IRfcTable fields = fm.GetTable("FIELDS");
fields.Append();
fields.CurrentRow.SetValue(0, "KTOPL");
fields.Append();
fields.CurrentRow.SetValue(0, "SAKNR");
fm.Invoke(dest);
// DATA table paramter (output)
IRfcTable data = fm.GetTable("DATA");
DataTable dTable = Utils.ToDataTable(data);
return dTable;
}
options这个table parameter用于设置数据选择的条件。我们使用的条件是KTOPL = 'Z900'。注意相关代码片段：
IRfcTable options = fm.GetTable("OPTIONS");
options.Append(); // create a new row
options.CurrentRow.SetValue(0, "KTOPL = 'Z900' ");
options.CurrentRow返回的是一个IRfcStructure，注意现在的代码是根据位置索引（从0开始）来设置elemnet的值。如果我们使用SE37查看RFC_READ_TABLE的参数，我们可以看到options表参数类型为RFC_DB_OPT，只有一个字段：TEXT。NCo3.0的SetXXX()方法和GetXXX()方法一样，既可以通过索引，也可以通过字段名。所以代码也可以这样：
IRfcTable options = fm.GetTable("OPTIONS");
options.Append(); // create a new row
options.CurrentRow.SetValue("TEXT", "KTOPL = 'Z900' ");
当然，因为NCo3.0内部通过CurrentIndex来标记当前行，所以代码可以进一步简化为这样（可读性不好）：
IRfcTable options = fm.GetTable("OPTIONS");
options.Append(); // create a new row
options.SetValue("TEXT", "KTOPL = 'Z900' ");
完整代码
// File name: TableManipulation.cs
/**
* Author: Stone Wang(stone.wangmin@qq.com)
* Date: 2016/3/26
*/
using SAP.Middleware.Connector;
using NCo02;
using System.Data;
namespace NCo03
{
public class TableManipulation
{
public DataTable ReadTable()
{
// purpose:
// read table SKA1 with criteria: KTOPL = Z900
// and returns a DataTable
RfcDestination dest = DestinationProvider.GetDestination();
IRfcFunction fm = dest.Repository.CreateFunction("RFC_READ_TABLE");
fm.SetValue("QUERY_TABLE", "SKA1");
fm.SetValue("DELIMITER", "~");
// OPTIONS table parameter
IRfcTable options = fm.GetTable("OPTIONS");
options.Append(); // create a new row
options.SetValue("TEXT", "KTOPL = 'Z900' ");
// FIELDS table parameter
IRfcTable fields = fm.GetTable("FIELDS");
fields.Append();
fields.CurrentRow.SetValue("FIELDNAME", "KTOPL");
fields.Append();
fields.CurrentRow.SetValue("FIELDNAME", "SAKNR");
fm.Invoke(dest);
// DATA table paramter (output)
IRfcTable data = fm.GetTable("DATA");
DataTable dTable = Utils.ToDataTable(data);
return dTable;
}
}
}
单元测试
// File name: TestTableManipulation.cs
using System;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using System.Data;
using NCo03;
namespace UnitTestProject1
{
[TestClass]
public class TestTableManipulation
{
[TestMethod]
public void Test_ReadTable()
{
TableManipulation rfc = new TableManipulation();
DataTable ska1 = rfc.ReadTable(); // ska1 table
Utils.PrintDataTable(ska1);
}
}
}
