Question

表单引擎用户手册中提供了关于表单定义与Flowable表单引擎的完整信息。 可以使用Flowable表单设计器创建表单定义。表单设计器是Flowable Modeler web应用的一部分。也可以直接使用JSON编辑器创建表单定义。 表单引擎用户手册中介绍了表单定义JSON的完整结构。表单支持下列表单字段类型：

• Text: 渲染为文本框

• Multiline text: 渲染为多行文本框

• Number: 渲染为只允许数字值的文本框

• CheckBox: 渲染为复选框

• Date: 渲染为日期框

• Dropdown: 渲染为下拉选择框，候选值由字段定义配置

• Radio buttons: 渲染为单选按钮，候选值由字段定义配置

• People: 渲染为选人框，可以选择用户身份表中的用户

• Group of people: 渲染为选组框，可以选择组身份表中的组

• Upload: 渲染为上传框

• Expression: 渲染为一个标签，可以在标签文字中使用JUEL表达式，以使用变量及/或其他动态值

Flowable Task应用可以用表单定义JSON渲染出html表单。 也可以使用Flowable API，自行获取表单定义JSON。

FormModel RuntimeService.getStartFormModel(String processDefinitionId, String processInstanceId)

或

FormModel TaskService.getTaskFormModel(String taskId)

FormModel对象是一个代表了表单定义JSON的Java对象。

可以调用下列API，使用启动表单定义以启动流程实例：

ProcessInstance RuntimeService.startProcessInstanceWithForm(String processDefinitionId, String outcome,
  Map<String, Object> variables, String processInstanceName)

如果在流程定义的（某一个或多个）启动事件上定义了表单定义，则可以使用这个方法，使用启动表单中填写的值启动流程实例。 Flowable Task应用使用同样的方法，用表单启动流程实例。 通过变量map传入所有需要的表单值，也可以指定表单输出字符串及流程实例名。

类似的，可以调用下列API，使用表单完成用户任务：

void TaskService.completeTaskWithForm(String taskId, String formDefinitionId,
  String outcome, Map<String, Object> variables)

再次强调，要获取关于表单定义的更多信息，请查看表单引擎用户手册。