历史版本27 :简道云输出算子 返回文檔
編輯時間: 內容長度:图片数:目录数: 修改原因:

目錄:

1. 概述编辑

1.1 版本

FineDataLink 版本功能变动
4.0.20新增简道云输出算子,可将数据输出到简道云中,供简道云使用
4.0.28
  • 调整「写入方式」和「字段映射」的顺序

  • 调整写入方式名称

4.0.29主键冲突策略中主键相同,停止写入并报错修改为主键相同,记录为脏数据

1.2 功能简介

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

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

83.png

效果如下图所示:

86.png

2. 功能说明编辑

2.1 支持的控件类型

简道云表单中包含以下控件类型时,「简道云输出」算子支持将数据输入到指定表单中:

分类
控件类型
基础字段
单行文本
多行文本
数字

日期时间

注:写入日期时间控件中的字段需要时yyyy-MM-dd格式。

单选按钮组
下拉框
增强字段子表单
手机
部门成员字段成员单选
部门单选

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

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

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

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

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

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

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

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

2.2 数据去向与映射

28.png

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

2.3 写入方式

29.png

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

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

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

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

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

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

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

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

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

具体可参见:数据比对

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