自定义函数使用说明

新建/编辑自定义函数

新建和编辑自定义函数

填写函数名称、APIName,选择命名空间(全局/按钮/流程)、返回值类型、绑定对象和函数描述;

属性说明:

1.函数名称(必填):设置函数的名称,以便使用时可以快速知道函数功能;

2.命名空间(必填):命名空间可以理解为自定义函数的使用场景,如下:

  a)全局:即系统预制模板函数,用户无法创建,业务侧在使用模板函数时,在模板基础上复制一份新的函数关联到调用方;

  b)按钮:自定义对象中的按钮,可在自定义对象中,加入执行动作函数或执行后动作操作;

      按钮的类型可分为两种:校验性和返回型;

    1)校验型:可以放到操作前置动作,阻塞操作进行,返回值为YES/NO+业务参数(比如XX产品库存不足:可用库存100,超过库存订单不允许创建);

    2)返回型:可以放到操作后,根据函数逻辑进行取值,把值返回给前端,在界面展示;

  c)流程:即,在工作流管理中添加自定义函数,可以实现流程的后动作操作;

3.返回值类型(必填):全局和按钮模式可以设置返回值类型为字符串(String)、字典(Map)和无返回值三种类型;流程模式只能默认为无返回值类型,不可更改;

4.绑定对象(必填):设置函数要绑定的对象,以便于函数操作或获取绑定对象的属性字段;

5.描述(选填):描述所编写的自定义函数;

函数编辑器

在函数编辑器中,可以添加函数脚本进行功能实现逻辑编写;比如创建订单时,从其他系统中查询库存信息等;

1.编辑器的引导页:

函数编辑器

2.设置参数:

参数输入能力–调用方可以根据函数的定义,传递参数。

a)自定义函数默认收到的参数

  当前对象

  当前数据,如果是新建或者编辑页面,可以传当前页面下的值,该值可能与数据库的值不一致(如果是流程后动作触发,还需要传递流程数据)

  操作人

  触发时间

  触发点

b)调用方传递的参数

  如果自定义函数定义了输入参数,自定义函数提供参数传递的配置页面,如下图:

参数设置

  1)确定自定义函数需要输入的相关信息:

    参数数量;

    类型(必填):String、BigDecimal、Boolean、DateTime、Date、Time

    名称(必填):参数名称

    默认值(选填):

    显示名称(选填):

  2)调用方提供可以传递的变量列表;

  3)调用方将可以提供的变量和函数要求的参数互相匹配;

3.运行脚本: ;运行脚本时,可以选择数据源,并会输出运行日志,包括返回值和运行错误提示;

4.编辑器大小缩放:

在编辑器的右上角有个扩展按钮,可以实现编辑器放大和缩小,方便用户编辑代码时可以更清晰展示代码;

5.错误代码:

自定义函数管理

自定义函数管理页面,如下图:

自定义函数列表页

在管理页面中:

1、可以查看自定义函数的相关信息,包括:函数名称、APIName、命名空间、绑定对象、返回值类型、创建时间、调用方、状态和可以进行的操作等;

2、可以根据命名空间和绑定对象筛选出对象的自定义函数,也可根据函数名称快速查找出对应的自定义函数;

3、可以进行新建、编辑和禁用自定义函数,自定义函数只有禁用后才能删除;

4、已经被使用的自定义函数会展示出调用方是按钮还是流程,并且无法在管理页面进行操作,只能在调用方进行编辑或解除关系;

系统中的应用

  • 自定义对象中的应用

    在自定义对象中,可以设置自定义函数按钮,实现用户点击按钮后出发的操作自定义函数功能逻辑;

  • 工作流管理中的应用

    在工作流中的条件过滤后的执行动作中,可以实现流程的后动作操作;

results matching ""

    No results matching ""