Activiti FormService使用及表单的介绍

StartFormData getStartFormData(String processDefinitionId);

StartFormData startFormData = formService.getStartFormData(流程定义id)

查看startFormData的实体类定义，可以发现它集成的父类是FormData，而FormData中有一项属性List formProperties

以下是FormProperty的源码结构

public interface FormProperty extends Serializable {

String getId();

String getName();

FormType getType();

String getValue();

boolean isReadable();

boolean isWritable();

boolean isRequired();

}

看到这里，我们已经可以知道流程启动节点的表单内容了,那么接下来根据这些内容去维护一个公共的动态表单页面即可。

可能在写页面代码时，会碰到一个问题，就是日期格式。因为我们在流程定义文件中是有维护日期格式的，但是在FormProperty中并没有这一属性项。

同时还有枚举类型的枚举项，参看以下代码：

@RequestMapping(value = “startForm/{procDefId}”)

public String startForm(@PathVariable(value = “procDefId”) String procDefId, Model model) {

Map<String, Map<String, String>> result = Maps.newHashMap();

Map<String,String> datePatterns = Maps.newHashMap();

StartFormData startFormData = formService.getStartFormData(procDefId);

List formProperties = startFormData.getFormProperties();

for (FormProperty formProperty : formProperties) {

if(“enum”.equals(formProperty.getType().getName())){

Map<String, String> values;

values = (Map<String, String>) formProperty.getType().getInformation(“values”);

if (values != null) {

for (Map.Entry<String, String> enumEntry : values.entrySet())

logger.debug(“enum, key: {}, value: {}”, enumEntry.getKey(), enumEntry.getValue());

result.put(“enum_” + formProperty.getId(), values);

}

}else if(“date”.equals(formProperty.getType().getName())){

datePatterns.put(“pattern_”+formProperty.getId(), (String)formProperty.getType().getInformation(“datePattern”));

logger.debug(“date,key:{},pattern:{}”,formProperty.getId(),formProperty.getType().getInformation(“datePattern”));

}

}

model.addAttribute(“datePatterns”,datePatterns);

model.addAttribute(“result”, result);

model.addAttribute(“list”, formProperties);

model.addAttribute(“formData”, startFormData);

return “modules/act/dynamicStartForm”;

}

这段代码是获取动态表单启动界面的信息。其中(String)formProperty.getType().getInformation("datePattern")是获取日期格式的，(Map<String, String>) formProperty.getType().getInformation("values");是获取枚举类型的枚举项的

接下来就是页面的事情了。

3、根据taskId获取流程任务中的表单内容

TaskFormData getTaskFormData(String taskId);

FormService中的这个API方法，提供了流程任务中的表单内容的定义。

上面详细讲解了FormProperty的使用，那么相似的，我们可以按照类似的操作获取到对应的信息

4、动态表单定义额外的变量类型

在流程定义文件中，每个字段都有一个指定的类型，目前Activiti默认支持的类型有String,long,enum,date,boolean,collection。而在实际的应用中，默认的类型往往是不够用的，如果需要其他类型的字段，我们该如何处理呢？activiti是允许自定义表单字段类型的。具体实现如下:

<activiti:formProperty id=“user” name=“用户名” required=“true” type=“users”/>

比如，我们定义一个一个类型是users，我们的需求是可以输入多个用户名，以逗号隔开。

接下来，去定义一个表单类型users的解析类，用来转换表单值。

5、定义表单类型的解析类

注意：所有自定义的表单字段都需要继承一个表达类型抽象类”org.activiti.engine.form.AbstractFormType”

/**

• 多用户的表单类型,loginName中间以’,'隔开

• @author Jonathan

• @version 2016/9/22 17:00

• @since JDK 7.0+

*/

public class UsersFormType extends AbstractFormType {

/**

• 把字符串的值转换为集合对象

• @param propertyValue

• @return

*/

@Override

public Object convertFormValueToModelValue(String propertyValue) {

String[] split = StringUtils.split(propertyValue, “,”);

return Arrays.asList(split);

}

/**

• 把集合对象的值转换为字符串

• @param modelValue

• @return

*/

@Override

public String convertModelValueToFormValue(Object modelValue) {

if(modelValue==null){

return null;

}

return modelValue.toString();

}

/**

• 定义表单类型的标识符

• @return

*/

@Override

public String getName() {

return “users”;

}

}

6、在流程引擎中注册解析类

自定义表单类型的解析类定义完成后，还需要在流程引擎中注册，否则引擎会提示未找到对应的类型转换类。注册表单字段类型的配置如下:

…

到此，我们就可以使用名为users的表单字段类型了。

7、动态表单的流程启动和处理

在上章RuntimeService介绍中，提到了一个FormService中的两个API操作:

ProcessInstance submitStartFormData(String processDefinitionId, Map<String, String> properties);

ProcessInstance submitStartFormData(String processDefinitionId, String businessKey, Map<String, String> properties);

都是用来启动流程的，其中最后一个参数Map。

二、普通表单

流程定义代码：

其中activiti:formKey就是来定义我们启动界面或者某个任务环节处理界面的对应的表单标识的key

所以，普通表单的启动界面和任务处理界面都是需要我们自己来定义维护的，因此布局肯定比动态表单要优美很多。

那么如何去获取activiti:formKey中对应的内容呢，仍旧是FormService提供了对应的API