使用场景

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. 申请人和成员字段的值只接受邮箱