Q-Source

使用场景

Q-Source用于将轻流系统外的数据导入轻流系统和流程中。

使用限制

  1. Q-Source为轻流alpha版本功能
  2. 目前Q-Source只支持JSON、XML、纯文本三种格式的推送数据
  3. Q-Source只接收POST Method的HTTP请求

使用方法

  1. 首先需要在插件中心中开启Q-Source,如果Q-Source在插件中心中被关闭,即使是在开启状态设置的Q-Source也不会生效。
  2. 在管理应用->流程->申请人节点->高级设置中添加Q-Source的配置

Q-Source将根据此处设置的规则解析接收到的postBody,并将解析的结果向对应的字段赋值(规则见下文赋值规则部分)生成一条申请并进入此应用的流程。

注意:

(1) 如果赋值规则中没有设置申请人,该申请的申请人会被设置为[匿名用户],规则和未登录用户填写一张所有人可填的应用时的表现相同。

(2) 此处设置的正则表达式在解析时是作为字符串解析的,请注意转义

(3) 目前Q-Source仅支持部分类型字段的解析,具体的赋值规则见下文赋值规则部分

*至此Q-Source在轻流系统中的设置结束。

3.在需要推送数据到轻流的系统(以下称为数据源系统)中将数据推送到Q-Source设置时生成的URL,目前只支持HTTP协议的POST Method。(测试时可以使用轻流流程中Q-Robot->Webhook功能将URL设置为Q-Source的URL)

具体的设置方式不同的数据源系统各有差异,需要自行查看数据源系统的帮助文档。此处仅以问卷星为例,在用户需要将问卷星的数据推送到轻流的时候,只需要将轻流的Q-Source URL复制到问卷星的数据推送API的URL中即可,此后用户填写完问卷之后问卷数据就会被推送到轻流经过Q-Source规则的解析后生成一条新的申请被添加到轻流流程中。

注意事项:

(1): 来自Q-Source的申请,在查看此条申请的流程日志时,会在申请人节点的节点名右侧显示Q-Source的名称,此名称显示的是申请生成时的Q-Source名称,如果后面这条Q-Source的标题被修改,此处也不会修改。

(2): Q-Source添加申请时不受表单密码,申请人范围限制,但是如果轻流系统接收到Q-Source申请时Q-Source所属应用已关闭或已删除或不在可申请的时间范围时,将不会添加申请。

(3) 日期和起止时间字段,字段的值必须满足”yyyy-mm-dd hh:mm:ss”格式,不需要时分秒可以把时分秒部分设置为”00:00:00″

赋值规则
  1. 不支持的字段: 表格、富文本、描述文字、q-linker、附件上传、定位和地址
  2. 无法解析或者解析到空值,则赋空值
  3. 左边是单值类型,右边返回数组类型,默认选择数组中第一个值作为结果
  4. 自定义值赋值,和qrobot添加数据同
  5. 部门字段和成员字段可选范围限制的处理和qrobot保持一致
  6. 申请人和成员字段的值只接受邮箱

       

相关文章