SAP接口编程之 NCo3.0系列(05) : Table作为输入参数

要点讲解

如果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([email protected])
 * 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);
        }
    }
}