1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.0.20 | 新增简道云输出算子，可将数据输出到简道云中，供简道云使用 支持将数据输出到包含部分控件类型的简道云表单中，详情请参见本文 2.1 节内容 |
| 4.0.28 |
|
| 4.0.29 | 主键冲突策略中主键相同，停止写入并报错修改为主键相同，记录为脏数据 |
| 4.1.5.4 | 支持将数据输出到：不包含「选择数据、手写签名、图片、附件」的简道云表单 |
1.2 应用场景
在制作简道云表单时，很多数据需要从业务系统取数，此时需要将数据先同步到简道云中，再在简道云中进行使用。
1.3 功能简介
注：若用户不需要对数据进行复杂处理，且只需要向简道云表单中新增数据，可使用 数据同步 节点实现。
「简道云输出」算子可将处理后的数据同步到简道云表单中。
效果如下图所示：
1.4 注意事项
简道云表单无法存储 null 值，null 值和空字符串上传到简道云都会被转为空字符串。
2. 功能说明
2.1 支持的控件类型
简道云表单中包含以下控件类型时，「简道云输出」算子支持将数据输入到指定表单中。
4.1.5.3 版本之前支持的控件类型如下表所示：
| 分类 | 控件类型 |
|---|---|
| 基础字段 | 单行文本 |
| 多行文本 | |
| 数字 | |
日期时间 注：写入日期时间控件中的字段需要时yyyy-MM-dd格式。 | |
| 单选按钮组 | |
| 下拉框 | |
| 增强字段 | 子表单 |
| 手机 | |
| 部门成员字段 | 成员单选 |
| 部门单选 |
注：4.1.5.3 及之后的版本支持使用除「选择数据、手写签名、图片、附件」外所有指定表单的控件类型。
写入简道云不同控件中的字段类型，可以通过字段映射获取到，访问数据接口时，值格式需要根据对应字段要求设置：
写入复选框组件的字段需要使用 SparkSQL 中的 collect_list、concat_ws 函数拼接，详情参见本文 3.2 节。
| 控件类型 | 字段类型 | 数据类型 | 需要准备的写入数据样式 | 实际传入接口 | 说明 |
|---|---|---|---|---|---|
| 复选框组 | checkboxgroup | Array | [“选项1”,“选项2”] | [“选项1”,“选项2”] | |
| 下拉复选框 | combocheck | Array | [“选项1”,“选项2”] | [“选项1”,“选项2”] | |
| 地址 | address | JSON | { "province": "江苏省", "city": "无锡市", "district": "梁溪区", "detail": "清扬路138号茂业天地" } | { "province": "江苏省", "city": "无锡市", "district": "梁溪区", "detail": "清扬路138号茂业天地" } | |
| 定位 | location | JSON | { "province": "江苏省", "city": "无锡市", "district": "梁溪区", "detail": "清扬路138号茂业天地", "lnglatXY": [ 120.31237, 31.49099 ] } | { "province": "江苏省", "city": "无锡市", "district": "梁溪区", "detail": "清扬路138号茂业天地", "lnglatXY": [ 120.31237, 31.49099 ] } | lnglatXY 表示[经度, 纬度] |
| 图片 | image | Array | [ { "name": "image1.png", "size": 262144, "mime": "image/png", "url": "https://files.jiandaoyun.com/cqbrmcwhxm" }, { "name": "image2.png", "size": 262100, "mime": "image/png", "url": "https://files.jiandaoyun.com/cqbrywmwh" } ] | ["6b559cf1-b16c-43bd-a211-8fa8fdeae2ef","6b559cf1-b16c-43bd-a211-646ab85da8cb"] --文件key数组 | 数据中包含的url为图片链接，15天内有效 |
| 附件 | upload | Array | [ { "name": "产品说明文档.pdf", "size": 524288, "mime": "application/pdf", "url": "https://files.jiandaoyun.com/ojiwvfeyt" }， [ { "name": "开发架构文档.pdf", "size": 524288, "mime": "application/pdf", "url": "https://files.jiandaoyun.com/mst" } ] | ["6b559cf1-b16c-43bd-a211-8fa8fdeae2ef","6b559cf1-b16c-43bd-a211-646ab85da8cb"] --文件key数组 | 数据中包含的url为附件链接，15天内有效 |
| 成员多选 | usergroup | Array | [ { "name": "小简", "username": "xiaojian", "status": 1, "type": 0, "departments": [1, 3], "integrate_id": "xiaojian" } ] | ["jian", "dao"] --成员的username数组 | status 对应的逻辑: -1 离职 0 未加入 1 已加入 |
| 部门多选 | deptgroup | Array | [ { "name": "经理部", "dept_no": 1, "type": 0, "parent_no": 2, "status": 1, "integrate_id": 1 } ] | [ 1, 2 ] --部门的dept_no数组 |
4.1.5.3 及之后的版本支持部分字段写入 crm 套件表单：
注：系统字段不支持写入。
| 字段类型 | 传参 | 返回值 |
|---|---|---|
| company | 和文本一致 | 和文本一致 |
| leads_pool | ObjectId | { "pool_id": "", "name": "" } |
| account_pool | ObjectId | { "pool_id": "", "name": "" } |
| sale_stage | { "stage_id": "" } | { "template_id": "", "stage_id": "", "name": "" } |
| link_object | { "link_form": "", "link_id": "" } | { "link_form": "", "link_id": "", "name": "" } |
2.2 数据去向与映射
| 设置项 | 说明 |
|---|---|
| 数据连接 | 只展示已配置过数据连接且当前用户有数据连接使用权限的选项 |
| 简道云应用 | 下拉展示数据连接中包含的简道云应用 |
| 应用表单 | 下拉展示对应应用下所有简道云表单 |
| 字段映射 | 详情可参见：数据同步功能说明 文档的 3.2 节内容 |
2.3 写入方式
| 设置项 | 说明 |
|---|---|
| 写入方式 | 有两种写入方式：
注：写入方式「清空目标表，再写入数据」灰化，不可选择 插入/更新/删除数据详细说明：
|
| 标识字段&标识值 | 仅写入方式为「基于标识字段，追加/更新/删除数据」可见
具体可参见：数据比对 |
| 主键映射 | 仅勾选更新或删除时出现此选项，不允许为空，用户可从数据流内自行选择字段，默认选择数据流内字段名为 _id 的字段 |
| 更多配置 | 提供「触发智能助手」、「发起流程」（仅流程表单插入数据时支持）选项，复选框，默认不选 |
3. 简道云不同控件类型使用说明
3.1 输出至成员单选、部门单选控件
数据要同步到的简道云表单中包含「成员单选」、「部门单选」控件时，要同步的数据与目标表单字段映射关系如下表所示：
注：username、dept_no 具体介绍请参见：通讯录接口
| 待同步的数据应包含字段 | 简道云表单对应字段 |
|---|---|
| username（成员编号） | 成员单选 |
| dept_no（部门编号） | 部门单选 |
因此，待同步的数据中需要包含username（成员编号）、dept_no（部门编号）信息，才能成功同步到包含「成员单选」、「部门单选」控件的简道云表单中。
一般需要待同步的数据与包含简道云部门编号、成员编号的表信息关联后，再同步到简道云表单中。
如下表所示，username 字段对应简道云表单中的成员单选字段，dept_no 字段对应简道云表单中的部门单选字段。
示例详情可参见 示例二：简道云表单中包含部门成员字段
| 待同步的数据应包含字段示例 | 简道云表单对应字段示例 |
|---|---|
| |
3.2 输出至简道云复选框组
源表数据中本身就是数组形式，需要输出到简道云的「复选框组」字段，则直接使用简道云输出配置字段映射即可。
源表数据不符合简道云字段形式，需要输出到简道云的「复选框组」字段，则需要使用 SparkSQL 中的 collect_list、concat_ws 函数拼接复选框组文本，如下图所示：
输入语句：
select $[DB表输入].`合同类型`,CONCAT('["',CONCAT_WS('","',COLLECT_LIST($[DB表输入].`客户ID`)),'"]') AS data
from $[DB表输入]
group by $[DB表输入].`合同类型`
拼接出的要输出至简道云复选框组的数组如下图所示：
然后即可将数据使用简道云输出。
