flowable modler为任务节点增加自定义属性-CFANZ编程社区

如何在modler设计器中为任务节点，添加自定义的属性。

文章目录

1、modler设计器中所有元素的定义
2、flowable如何处理stencilset_bpmn.json文件
3、为UserTask任务节点添加一个扩展属性

3.1. 添加属性的名称
3.2. 为任务节点添加扩展属性
3.3. 查看效果

1、modler设计器中所有元素的定义

我们在使用modler设计器的时候，这个设计器需要依赖一个叫做stencilset_bpmn.json的文件，相信只要大家做过activiti工作流，肯定知道这个文件了，这个文件非常的重要。该文件中定义了所有modler设计器需要用到的页面元素定义，比如我们常用的任务节点（UserTask）、开始节点（startevent）、结束节点(endevent)。这些活动节点中所使用到的属性也定义在stencilset_bpmn.json文件。当然了，只要大家想汉化Flowable中的modler设计器，也是将该文件中对应的英文修改为对应的中文即可。

2、flowable如何处理stencilset_bpmn.json文件

在Flowable的源码包中有这样的一个接口，用来访问项目中的stencilset_bpmn.json文件并返回到前端页面。该接口的名称是StencilSetResource.java 核心代码如下：

@RestController
public class StencilSetResource {

    private static final Logger LOGGER = LoggerFactory.getLogger(StencilSetResource.class);

    @Autowired
    protected ObjectMapper objectMapper;

    @RequestMapping(value = "/rest/stencil-sets/editor", method = RequestMethod.GET, produces = "application/json")
    public JsonNode getStencilSetForEditor() {
        try {
            JsonNode stencilNode = objectMapper.readTree(this.getClass().getClassLoader().getResourceAsStream("stencilset_bpmn.json"));
            return stencilNode;
        } catch (Exception e) {
            LOGGER.error("Error reading bpmn stencil set json", e);
            throw new InternalServerErrorException("Error reading bpmn stencil set json");
        }
    }   
}

上面展示的代码处理逻辑非常简单，直接使用类加载器获取项目根目录中的stencilset_bpmn.json文件并解析返回。

3、为UserTask任务节点添加一个扩展属性

接下来，我们在stencilset_bpmn.json中为任务节点扩展一个属性，打开stencilset_bpmn.json开始如下的操作：

3.1. 添加属性的名称

 {
    "name" : "shareniu",
    "properties" : [ {
      "id" : "shareniu",
      "type" : "String",
      "title" : "分享牛自定义属性",
      "value" : "shareniu",
      "description" : "Unique identifier of the element.",
      "popular" : true
    } ]
  },

注意：这是一个数组，位于propertyPackages属性中

3.2. 为任务节点添加扩展属性

接下来，我们继续操作stencilset_bpmn.json文件，查找到userTask任务节点如下所示：

{
    "type" : "node",
    "id" : "UserTask",
    "title" : "任务节点",
    "description" : "任务节点",
    "icon" : "activity/list/type.user.png",
    "groups" : [ "Activities" ],
    "propertyPackages" : ["shareniu", "overrideidpackage", "namepackage", "documentationpackage", "asynchronousdefinitionpackage", "exclusivedefinitionpackage", "executionlistenerspackage", "multiinstance_typepackage", "multiinstance_cardinalitypackage", "multiinstance_collectionpackage", "multiinstance_variablepackage", "multiinstance_conditionpackage", "isforcompensationpackage", "usertaskassignmentpackage", "formkeydefinitionpackage", "formreferencepackage", "duedatedefinitionpackage", "prioritydefinitionpackage", "formpropertiespackage", "tasklistenerspackage", "skipexpressionpackage" ],
    "hiddenPropertyPackages" : [ ],
    "roles" : [ "Activity", "sequence_start", "sequence_end", "ActivitiesMorph", "all" ]
  }

propertyPackages数组中我们增加了自定义的属性shareniu。