功能简介

将用户已有的外部数据源和轻流的应用关联起来，轻流定期将外部数据源的变更（增、改、删）同步到轻流中。

例：用户在轻流外已有一个客户数据库，用户企业内部对客户信息的改动都会修改这个客户数据库，同时用户在轻流的审批流程中需要使用这些客户数据，此时可以在轻流中创建一个客户数据库应用，同时通过QSource主动轮询将该应用和用户已有的客户数据库关联起来，定时将客户数据库的改动同步到轻流中。下面将介绍具体的关联方式。

(ps: QSource主动轮询功能为单独付费功能，不包含在已有的alpha版本中，如果需要试用，可向轻流商务人员提交申请。)

配置详解

1. 添加数据来源

如下图，QSource主动模式在 表单编辑->添加流程->申请人节点->高级设置->数据来源 中添加 (注意:一个应用最多只能添加2个主动模式的QSource.)

2. 模式切换到主动模式

3. 配置项目详解

（1）同步数据是否进入流程：从外部数据源同步到的数据是否进入轻流的审批流程，如果选择否，数据添加后会直接设置为已通过状态，如果选择是，数据会进入应用设置的审批流程。

（2）轮询间隔：每隔多长时间同步一次数据，轮询间隔单位为小时，且只能为正整数。

（3）开始时间：同步开始时间，开始时间如果在应用发布时间之后，则会被设置为从开始时间加上轮询间隔直到得到一个应用发布时间之后的开始时间。

（4）同步处理

i： 添加新数据：将同步到的新数据添加到轻流中

ii： 更新已有数据：如果同步到的数据在轻流中已存在，则更新轻流应用中的数据

iii：删除未同步到的数据：将该应用中没有和外部数据匹配上的数据全部删除

ps: 轻流数据和外部数据是否为同一条数据由下面将要配置的数据标识位决定。

（5）是否开启分页加载：开启后在下方的接口参数中填入 {{PAGE_INDEX}} 视为页码，轻流会自动从起始页码开始递增以获取新的数据,直到请求的数据为空或者上一页的数据与当页的数据相同为止,否则只会按照配置请求一次。(可插入的接口参数为: QueryParam,Header, JSONBody, formBody)

（6）URL， QueryParam， Header，Method, Body: 轻流通过http请求外部数据源的数据，前面列出的配置部分为http请求的配置。

（7）返回内容是否为数组：QSource主动轮询只接收JSON格式的返回数据，且要求返回的JSON数据是数组结构，如果返回数据不是数据结构，需要输入一个JSONPath,轻流将使用输入的JSONPath解析接收到的返回数据，请务必保证解析到的是一个数组结构，否则如果在[同步处理]选择了[删除未同步到的数据]将会删除应用中的所有数据。

（8）返回内容解析：此解析是针对接收到的返回数据的每一个数组元素的解析，例：接受到的返回数据为下图结构，此时如果希望将[email]的内容填入轻流表单的一个单行文字字段，需要输入的JSONPath为：$.testResult.email，如下图。轻流会通过此处设置的内容解析规则，将数据源返回的数据填入轻流表单中，生成或更新表单数据。

（9）数据标识位：此处仅可选择设置了[返回内容解析]的表单字段，通过对比该字段的值和通过该字段设置的[返回内容解析]解析到的值做对比，相同时视为同一条数据。

（10）主动触发：添加完毕后，点击主动触发按钮可以主动触发一次QSource主动轮询，但是每个主动模式的QSource每次主动触发最低间隔为30分钟。

（11）开启状态：只有处于开启状态的QSource主动轮询才会启动。

1. QSource主动模式不支持同步以下字段类型的数据： 表格、富文本、描述文字、Q-Linker、附件上传、OCR、定位和地址