YonBuilder 开发之后端函数

2022-12-27
北京
本文字数：1653 字
阅读完需：约 5 分钟

在前几期的文章中我们已经介绍过如何在 YonBuilder 中使用前端函数实现数据过滤功能。相对应于前端函数，在 YonBuilder 中还可以使用后端函数实现对于程序的扩展。通过前端函数实现的更多的是与页面交互相关的功能，而后端函数主要是用于预制按钮功能的扩展开发，为相应的按钮赋予一些自定义的属性。

1. 预制按钮扩展开发

按钮的后端函数扩展开发是通过对按钮的规则链进行修改实现的。首先，我们选择一个具体的页面进入到单据设计器中。

在单据设计器中，选择一个相应的按钮，并在页面右侧的配置栏中，选中动作对按钮的执行命令进行配置。

点击配置即可进入到具体的规则链配置页面，此时可以看到按钮是有一系列系统预制规则的，通过点击规则右侧的按钮可以实现自定义规则的新增。

在新建了一条执行规则后，选中规则即可对其进行配置。由于我们想要绑定自定义的后端函数，因此在规则栏里选中执行函数，并在函数栏里选择新建函数来实现后端函数的新增。在选择新建函数后，下方会自动弹出函数的配置信息，填写函数名称并将勾选目录后即完成对于后端函数的新增。

有一点需要注意的是，右侧的规则信息配置中有一个选项为覆盖规则，如果勾选这一选项，则会用配置的自定义规则覆盖原有的预制规则。这里我们想要保留原有的规则，因此没有进行勾选。

新建了执行函数对应的后端函数后，再次点击执行函数可以看到此时的函数右侧出现了调试按钮，点击调试即可进入到后端函数配置页面。

在后端函数编辑页面中，页面左侧为系统预制的后端脚本，包括了多种脚本类型。通过选择插入后端脚本，可以快速的实现多种常见功能的配置，实现代码的复用，避免重复性工作。

右侧的实体属性中包括了实体对应的 uri，在涉及到实体 uri 的函数中需要进行相应的修改。而中间则是代码编辑字段，通过后端函数可以实现多种功能，包括对实体的操作、YonQL 语句查询等。

2. 自定义按钮开发

除了在系统预制的按钮中进行扩展开发之外，我们还可以自定义一个按钮的功能。首先，在单据设计器页面，将一个按钮拖拽至画布中，并点击右侧的动作对其进行配置。

这里简单实现一个查询物品名称为键盘的按钮功能，为了便于展示返回数据，通过 throw 方法将查询到的数据进行输出。具体代码如下：

1. let AbstractTrigger = require('AbstractTrigger');
2.   class MyTrigger extends AbstractTrigger {
3.     execute(context,param){
4.       var sql = "select * from GT48630AT26.GT48630AT26.zxy_inventory where item like \'键盘\'";
5.       var res = ObjectStore.queryByYonQL(sql);
6.       throw new Error(JSON.stringify(res));
7.       return {res};
8.     }
9.   }
10.   exports({"entryPoint":MyTrigger});