历史版本31 :简道云输出算子 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

FineDataLink 版本功能变动
4.0.20

新增简道云输出算子,可将数据输出到简道云中,供简道云使

支持将数据输出到包含部分控件类型的简道云表单中,详情请参见本文 2.1 节内容

4.0.28
  • 调整「写入方式」和「字段映射」的顺序

  • 调整写入方式名称

4.0.29主键冲突策略中主键相同,停止写入并报错修改为主键相同,记录为脏数据
4.1.5.4支持将数据输出到:不包含「选择数据、手写签名、图片、附件」的简道云表单

1.2 应用场景

在制作简道云表单时,很多数据需要从业务系统取数,此时需要将数据先同步到简道云中,再在简道云中进行使用。

1.3 功能简介

注:若用户不需要对数据进行复杂处理,且只需要向简道云表单中新增数据,可使用 数据同步 节点实现。

「简道云输出」算子可将处理后的数据同步到简道云表单中。

83.png

效果如下图所示:

86.png

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 节。

控件类型字段类型数据类型需要准备的写入数据样式实际传入接口说明
复选框组checkboxgroupArray[“选项1”,“选项2”][“选项1”,“选项2”]
下拉复选框combocheckArray[“选项1”,“选项2”][“选项1”,“选项2”]
地址addressJSON

{

"province": "江苏省",

"city": "无锡市",

"district": "梁溪区",

"detail": "清扬路138号茂业天地"

}

{

"province": "江苏省",

"city": "无锡市",

"district": "梁溪区",

"detail": "清扬路138号茂业天地"

}


定位locationJSON

{

"province": "江苏省",

"city": "无锡市",

"district": "梁溪区",

"detail": "清扬路138号茂业天地",

"lnglatXY": [

120.31237,

31.49099

]

}

{

"province": "江苏省",

"city": "无锡市",

"district": "梁溪区",

"detail": "清扬路138号茂业天地",

"lnglatXY": [

120.31237,

31.49099

]

}

lnglatXY 表示[经度, 纬度]
图片imageArray

[

{

"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天内有效
附件uploadArray

[

{

"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天内有效
成员多选usergroupArray

[

{

"name": "小简",

"username": "xiaojian",

"status": 1,

"type": 0,

"departments": [1, 3],

"integrate_id": "xiaojian"

}

]

["jian",  "dao"]

--成员的username数组

status 对应的逻辑:

-1 离职

0 未加入

1 已加入

部门多选deptgroupArray

[

{

"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_poolObjectId

{

"pool_id": "",

"name": ""

}

account_poolObjectId

{

"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 数据去向与映射

28.png

设置项
说明
数据连接只展示已配置过数据连接且当前用户有数据连接使用权限的选项
简道云应用下拉展示数据连接中包含的简道云应用
应用表单下拉展示对应应用下所有简道云表单
字段映射详情可参见:数据同步功能说明 文档的 3.2 节内容

2.3 写入方式

29.png

设置项
说明
写入方式有两种写入方式:
  • 直接将数据写入目标表:直接插入数据

  • 基于标识字段,追加/更新/删除数据:提供复选框,用户可自定义设置

注:写入方式清空目标表,再写入数据」灰化,不可选择

插入/更新/删除数据详细说明:

  • 插入:将数据插入到简道云表单,直接调用新增数据接口、无需_id,支持勾选「触发智能助手」和「发起流程」,默认不勾选

  • 更新:按照后面选择的_id,对数据进行更新,支持勾选「触发智能助手」,默认不勾选

  • 删除:按照后面选择的_id,对数据进行删除,支持勾选「触发智能助手」,默认不勾选

标识字段&标识值仅写入方式为「基于标识字段,追加/更新/删除数据」可见
  • 选择标识字段和标识值,用于判断插入、更新和删除

  • 前置节点为 「数据比对」时,标识字段默认选择 fdl_comparison_type,标识值需要与「数据比对」算子中的「标识关系」值一一对应

具体可参见:数据比对

主键映射仅勾选更新或删除时出现此选项,不允许为空,用户可从数据流内自行选择字段,默认选择数据流内字段名为 _id 的字段
更多配置提供「触发智能助手」、「发起流程」(仅流程表单插入数据时支持)选项,复选框,默认不选

3. 简道云不同控件类型使用说明编辑

3.1 输出至成员单选、部门单选控件

数据要同步到的简道云表单中包含「成员单选」、「部门单选」控件时,要同步的数据与目标表单字段映射关系如下表所示:

注:username、dept_no 具体介绍请参见:通讯录接口

待同步的数据应包含字段
简道云表单对应字段
username(成员编号)成员单选
dept_no(部门编号)部门单选

因此,待同步的数据中需要包含username(成员编号)dept_no(部门编号)信息,才能成功同步到包含「成员单选」、「部门单选」控件的简道云表单中。

一般需要待同步的数据与包含简道云部门编号、成员编号的表信息关联后,再同步到简道云表单中。

如下表所示,username 字段对应简道云表单中的成员单选字段,dept_no 字段对应简道云表单中的部门单选字段。

示例详情可参见 示例二:简道云表单中包含部门成员字段

待同步的数据应包含字段示例简道云表单对应字段示例
87.png89.png

3.2 输出至简道云复选框组

  • 源表数据中本身就是数组形式,需要输出到简道云的「复选框组」字段,则直接使用简道云输出配置字段映射即可。

  • 源表数据不符合简道云字段形式,需要输出到简道云的「复选框组」字段,则需要使用 SparkSQL 中的 collect_list、concat_ws 函数拼接复选框组文本,如下图所示:

输入语句:

select $[DB表输入].`合同类型`,CONCAT('["',CONCAT_WS('","',COLLECT_LIST($[DB表输入].`客户ID`)),'"]') AS data
from $[DB表输入]
group by $[DB表输入].`合同类型`

拼接出的要输出至简道云复选框组的数组如下图所示:

然后即可将数据使用简道云输出。