activiti modeler 任务节点自定义属性扩展

在工作中使用Activiti modeler时难免会遇到局限，如usertask中的属性，完全不够用，这时需要我们去扩展。

　　activiti modeler通过读取stencilset.json生成编辑器UI，在界面上的扩展需要了解stencilset.json配置文件，它定义元素的属性，规则的配置文件，页面的展示就是根据这个配置文件生成的。

配置文件说明：

--属性的定义

"propertyPackages" : [ {

    "name" : "process_idpackage",

    "properties" : [ {

        "id" : "name",      ---id

        "type" : "String",  --类型，在赋值的时候会根据类型展示各种输入框，根据properties.js

        "title" : "名称",  --显示的标题

        "value" : "",      --值

        "description" : "BPMN元素的描述性名称.", --描述

        "category":"property", --分类，空的话位popular

        "popular" : true,         --是否显示

        "refToView" : "text_name" --触发svg里面的效果

    }]

--节点的定义

"type" : "node",

    "id" : "MailTask",

    "title" : "邮件任务",--标题

    "description" : "邮件任务", --描述

    "view" : "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n</svg>", --svg的xml

    "icon" : "activity/list/type.send.png",        --图标

    "groups" : [ "任务" ], --归属的组

    "propertyPackages" : [ "overrideidpackage" ],--属性

    "hiddenPropertyPackages" : [ ],

    "roles" : [ "Activity" ] --规则

配置步骤说明：

　　在stencilset.json文件中添加属性（各种类型可参照其它属性编写），如图：

 

　　并引用到UserTask节点中，如图：

 

　　这样，ORYX Designer会自动解析该JSON文件并在UI中展示新添加的属性，如图：

 

　　接着，我们需要将UI上扩展的属性与activiti进行绑定。不难发现，BpmnJsonConverter起着至关重要的作用，activiti modeler将页面编辑器的数据保存为Json格式文件存储到数据库中，回显也是通过读取该文件，BpmnJsonConverter用于转换BPMN与JSON供activiti解析界面属性并应用。

　　在UserTask中扩展属性，默认的任务节点Json数据解析类UserTaskJsonConverter，因为它不认识skiprepetition，所以需要定义一个类替换它，以此达到解析自定义属性的目的。

　　

public class CustomUserTaskJsonConverter extends UserTaskJsonConverter implements CustomStencilConstants{
    
    @Override
    protected void convertElementToJson(ObjectNode propertiesNode, BaseElement baseElement) {
        super.convertElementToJson(propertiesNode, baseElement);
        UserTask userTask = (UserTask) baseElement;
        
        //解析新增属性的业务逻辑
                ......
    }
    
    @Override
    protected FlowElement convertJsonToElement(JsonNode elementNode, JsonNode modelNode, Map<String, JsonNode> shapeMap) {
        FlowElement flowElement = super.convertJsonToElement(elementNode,
                modelNode, shapeMap);
        //解析新增属性的业务逻辑
        ......
        return task;
    }
    
    public static void fillTypes(Map<String, Class<? extends BaseBpmnJsonConverter>> convertersToBpmnMap,
            Map<Class<? extends BaseElement>, Class<? extends BaseBpmnJsonConverter>> convertersToJsonMap) {
    
        fillJsonTypes(convertersToBpmnMap);
        fillBpmnTypes(convertersToJsonMap);
    }
  
    public static void fillJsonTypes(Map<String, Class<? extends BaseBpmnJsonConverter>> convertersToBpmnMap) {
        convertersToBpmnMap.put(STENCIL_TASK_USER, CustomUserTaskJsonConverter.class);
    }
  
    public static void fillBpmnTypes(Map<Class<? extends BaseElement>, Class<? extends BaseBpmnJsonConverter>> convertersToJsonMap) {
        convertersToJsonMap.put(UserTask.class, CustomUserTaskJsonConverter.class);
    }
    
}

　　最后，在部署流程时，待BpmnJsonConverter初始化完成后替换掉UserTaskJsonConverter就OK了。

BpmnJsonConverter jsonConverter = new BpmnJsonConverter();
            
// TODO:UserTask自定义扩展属性
BpmnJsonConverterProperties bjcp = new BpmnJsonConverterProperties();
CustomUserTaskJsonConverter.fillTypes(bjcp.getConvertersToBpmnMap, bjcp.getConvertersToJsonMap);
            
JsonNode editorNode = new ObjectMapper().readTree(repositoryService.getModelEditorSource(modelData.getId()));
BpmnModel bpmnModel = jsonConverter.convertToBpmnModel(editorNode);

　　效果图：