对上一篇文中涉及的重要对象进行讲解。我们知道,SAP函数的参数,从方向来说,包括import/export/changing,从数据结构来说,包括单值型/结构型/表参数。NCo3.0对SAP函数相关对象的设计,也是这样的。我们从两个角度来看。第一个角度: Container和Element,函数、结构、表、ABAP对象是container,Container能包含其他对象,比如函数有参数,结构有字段。比较容易理解。如果对象不包含其他对象,就是一个element。
第二个角度:每一个对象都有meta data(元数据)。比如字段,元数据包括数据类型、长度等。SAP对meta data,设计为抽象类,对对象设计为接口。
IRfcFunction
IRfcFunction继承自IRfcDataContainer,实现了IEnumerable接口。常用的方法如下:
- GetTable(string tableName): 根据table参数名,获取Table参数, 方法来自父类IRfcDataContainer
- GetStructure(string paramName): 根据参数名,获取structure参数, 方法来自父类IRfcDataContainer
- SetValue(string paramName, int/string value): 对参数赋值,可以设置的值有多种数据类型,因此有多个重载的版本。
- GetElementMetaData(int index): 根据索引获取元数据的值
GetElementMetaData方法示例
获取函数参数的相关信息
public void ListFunctionParameters(String fmName)
{
RfcDestination dest = DestinationProvider.GetDestination();
IRfcFunction fm = dest.Repository.CreateFunction(fmName);
for (int i = 0; i < fm.ElementCount; i++) {
RfcElementMetadata elementMeta = fm.GetElementMetadata(i);
if (elementMeta.GetType() == typeof(RfcParameterMetadata)) {
RfcParameterMetadata param = (RfcParameterMetadata)elementMeta;
System.Console.WriteLine("Name: " + param.Name);
System.Console.WriteLine("Data type: " + param.DataType);
System.Console.WriteLine("UcLength: " + param.UcLength);
System.Console.WriteLine("NucLength: " + param.NucLength);
System.Console.WriteLine("Documentation: " + param.Documentation);
System.Console.WriteLine("--------------------------");
}
}
}
单元测试
[TestMethod]
public void Test_ListFunctionParameters()
{
RfcCall rfc = new RfcCall();
rfc.ListFunctionParameters("RFC_READ_TABLE");
}
RfcFunctionMetaData
前面我们从Repository直接创建函数,另外一种常用的方法是用RfcFunctionMetaData,代码如下:
public ArrayList GetCocdInfo2(String cocd)
{
var list = new ArrayList(); // return value
RfcDestination dest = DestinationProvider.GetDestination();
RfcFunctionMetadata fmMeta = dest.Repository.GetFunctionMetadata("BAPI_COMPANYCODE_GETDETAIL");
IRfcFunction fm = fmMeta.CreateFunction();
fm.SetValue("COMPANYCODEID", cocd);
fm.Invoke(dest);
IRfcStructure cocdDetail = fm.GetStructure("COMPANYCODE_DETAIL");
list = Utils.ToArrayList(cocdDetail);
return list;
}