xxh-wfd-vue 2.1.2 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -13,7 +13,8 @@ https://guozhaolong.github.io/wfd-vue/
13
13
  ```
14
14
  <template>
15
15
  <div id="app">
16
- <wfd-vue ref="wfd" :data="demoData" :height="600" :users="candidateUsers" :groups="candidateGroups" :categorys="categorys" :lang="lang" />
16
+ <wfd-vue ref="wfd" :data="demoData" :height="600" :users="candidateUsers" :groups="candidateGroups"
17
+ :categorys="categorys" :service-delegates="serviceDelegates" :lang="lang" />
17
18
  </div>
18
19
  </template>
19
20
 
@@ -28,9 +29,14 @@ export default {
28
29
  return {
29
30
  lang: "zh",
30
31
  demoData: {...},
31
- candidateUsers: [...],
32
+ candidateUsers: [...], // [{ value: "1", label: "Tom" }, ...]
32
33
  candidateGroups: [...],
33
- categorys: [...]
34
+ categorys: [...],
35
+ // 服务任务(serviceTask)的委托表达式下拉选项
36
+ serviceDelegates: [
37
+ { value: "sendNoticeDelegate", label: "发送通知" },
38
+ { value: "syncDataDelegate", label: "同步数据" },
39
+ ]
34
40
  }
35
41
  }
36
42
  }
@@ -44,15 +50,44 @@ export default {
44
50
  * mode: view为只读,edit为可编辑
45
51
  * lang: zh为中文,en为英文
46
52
  * isView: 是否为预览模式(隐藏工具栏和属性栏)
47
- * users: 选择审批人时对应的数据,数组内对象以id为键,name为值
48
- * groups: 选择审批组时对应的数据,数组内对象以id为键,name为值
49
- * categorys: 选择分类时对应的数据,数组内对象以id为键,name为值
53
+ * users: 选择审批人时对应的数据,数组内对象为 `{ value, label }` 结构
54
+ * groups: 选择审批组时对应的数据,数组内对象为 `{ value, label }` 结构
55
+ * role: 选择角色时对应的数据,数组内对象为 `{ value, label }` 结构
56
+ * categorys: 选择分类时对应的数据,数组内对象为 `{ value, label }` 结构
57
+ * diction: 权限相关数据字典
58
+ * customParams: 用户任务(userTask)「自定义参数」分配方式的候选参数,数组内对象为 `{ value, label }` 结构
59
+ * signalDefs: 信号事件(signalStart/signalCatch)的信号定义
60
+ * serviceDelegates: 服务任务(serviceTask)「委托表达式」下拉框的候选表达式,数组内对象为 `{ value, label }` 结构
50
61
 
51
62
  ###### 方法
52
63
  * save(): 调用this.$refs['wfd'].graph.save()生成json
53
64
  * saveXML(): 调用this.$refs['wfd'].graph.saveXML(createFile)生成Flowable XML,createFile参数是否同时生成xml文件,默认为true
54
65
  * saveImg(): 调用this.$refs['wfd'].graph.saveImg(createFile)生成图片,createFile参数表示是否生成图片文件,默认为true,该函数返回值为图片base64
55
66
 
67
+ ### 服务任务的委托表达式(serviceDelegates)
68
+
69
+ 服务任务(serviceTask)属性面板中的「委托表达式」为下拉框,选项由 `serviceDelegates` 属性传入:
70
+
71
+ ```js
72
+ serviceDelegates: [
73
+ { value: "sendNoticeDelegate", label: "发送通知" },
74
+ { value: "syncDataDelegate", label: "同步数据" },
75
+ // 统一入口形态(2.3.0+):多个业务动作共用一个委托 Bean,
76
+ // 通过附加参数(fields)区分路由键,序列化为服务任务的 flowable:field 扩展
77
+ { value: "materialInbound", label: "物资入库",
78
+ expression: "businessActionDelegate",
79
+ fields: { delegateAction: "materialInbound" } },
80
+ ]
81
+ ```
82
+
83
+ 注意事项:
84
+ * `value` 为表达式内容,**不需要**带 `${}`;导出 XML 时会自动包装为 `flowable:delegateExpression="${sendNoticeDelegate}"`。
85
+ 带 `expression` 的选项以 `expression` 为真实委托表达式,`value` 仅作下拉唯一标识(同一 expression 可有多个选项)。
86
+ * 带 `fields` 的选项选中后,`fields` 会随模型保存(节点 `delegateFields`),导出 XML 时序列化为
87
+ `<extensionElements><flowable:field name="..."><flowable:string>...</flowable:string></flowable:field></extensionElements>`,
88
+ 供后端从 BPMN 模型字段扩展读取;切换为无 `fields` 的选项会清除已附加参数。
89
+ * 该下拉框为纯选择模式,不支持手动输入;若导入的旧数据中表达式不在候选列表内,界面将显示为空(数据本身不受影响,导出仍按原值输出)。
90
+
56
91
 
57
92
  ### Run Example
58
93
  ```