全新体验：自定义函数（二）

学习目标

完成本单元后，您将能够：

轻松获取单据或者其他模块报表的数据，将所需数据尽收囊中。

四、补充说明

（一）取数来源为基础资料

实例如下：

1.设置如下

2.效果如下

（二）取数来源为报表

注意：由于取数的报表来源为后台数据库存放的固定表，该固定表是可以在bos设计器中发布到前端进行查询

以下以银行存款余额表（该表是后台表，已经从bos设计器中发布至前端）取数举例说明：

1.配置如下：

由于该表，没有部门字段，所以参数直接取了核算组织的字段

2.取数如下：

（三）取数来源为自定义SQL

参考该帖子：https://vip.kingdee.com/article/21047?channel_level=kdclub&isMapping=1

1.注意点：

（1）自定义Sql必须符合KSQL语法；

（2）多选类型的参数，在Sql中需要使用表变量，（表变量的使用，参考KSQL语法）；

2.自定义SQL取数设置说明：

（1）打开自定义函数新增界面，取数来源类型选择“自定义Sql”，弹出“自定义SQL”界面，分别在SELECT、FROM、WHERE 填入相应的字句，点击“解析”按钮（分析当前sql是否符合KSql语法），点击“确定”返回；

（2）在取数参数界面设置Sql用到的参数。（如果在参数列表没有找到对应的参数，需要到“取数参数管理”添加参数）

（四）取数来源为自定义接口

1.自定义接口取数自定义取数实现类编写说明

（1）自定义接口的类需要继承AbstractCustomServicePlugIn，该类的完整路径是Kingdee.BOS.App.KDSCaculateService.Function.AbstractCustomServicePlugIn；

（2）基类AbstractCustomServicePlugIn包含MinArgs（最少参数个数），MaxArgs（最多参数个数）两个抽象属性，必须在取数实现类进行重写并设置取数函数需要的参数个数，如果取数公式传递的参数个数不符合条件直接返回错误；

（3）基类AbstractCustomServicePlugIn包含GetFunctionValue（计算公式值）抽象函数，在取数实现类通过该函数实现具体的取数逻辑；

（4）基类AbstractCustomServicePlugIn包含SetDefaultValue（设置默认参数），Validate（校验参数有效性）两个虚函数，调用顺序为先“设置默认参数”再“校验参数有效性”。

2.自定义接口取数设置说明：

（1）将写好的DLL文件放到服务器网站的Bin目录下；

（2）打开自定义函数新增界面，取数来源类型选择“自定义接口”，弹出“选择自定义取数接口”界面，在DLL文件名输入DLL文件的名称，点击“解析”按钮，选择特定的接口实现类，点击“确定”返回；

（3）在取数参数设置该接口需要的参数，（如果在参数列表没有找到对应的参数，需要到“取数参数管理”添加参数）注意参数的顺序要和接口中使用的参数顺序一致，对于选择型的参数“参数类型”决定返回参数的样式

单选：只能单选，返回单个编码

范围：可以多选，用分号分割最小与最大的编码

多选：可以多选，用逗号分割所有选择的编码。

综上所述：

阿米巴报表通过自定义函数生成取数公式，建立了报表与业务数据的桥梁。根据客户的实际需求，自行定义取数公式，从而组合成企业所需管理信息。

全新体验：自定义函数（二）