简道云输入功能说明

  • Last update: November 13, 2023
  • 1. 概述

    1.1 版本

    FineDataLink 版本功能变更
    4.0.2.1
    • 数据连接新增「简道云」类型

    • 「数据转换」节点新增算子「简道云输入」

    1.2 应用场景

    用户处于以下场景时:

    • 简道云数据量比较大,约五十万数据级别,需要做一些复杂计算分析,简道云数据工厂无法处理。

    • 出于数据安全考虑,需要将简道云数据备份到本地数据库。

    「简道云输入」算子可满足用户需求。

    1.3 功能简介

    「简道云输入」算子可读取指定简道云表单数据,数据读取后可根据实际需要进行处理并输出。

    80.png

    2. 操作步骤

    2.1 简道云数据连接准备

    用户需要有一个 简道云数据连接 的使用权限,以便简道云输入算子读取指定简道云表单数据。

    2.2 设置字段别名(建议做)

    在简道云表单接入前,建议提前设置字段别名,否则接入到 FineDataLink 中时会使用字段原始名,不便于在 FineDataLink 中进行业务处理。

    进入简道云应用,进入需要使用表单的编辑界面,选择「扩展功能>数据推送>设置字段别名」。如下图所示:

    79.png

    2.3 读取简道云数据

    「简道云输入」算子设置界面如下图所示:

    1689927380758832.png

    各设置项介绍如下表所示:

    设置项
    说明
    数据连接下拉展示有权限的,且已配置的简道云数据连接
    简道云应用
    下拉展示数据连接中包含的简道云应用
    应用表单下拉展示对应应用下所有简道云表单
    筛选条件

    可点击「添加筛选条件」按钮,添加筛选条件(支持引入参数)。如下图所示:

    注1:输入框支持引用参数

    注2:不同类型的字段支持的过滤条件不同,详情请参见:简道云输入-过滤条件说明

    45.png

    时间字段使用参数筛选时,自定义参数 中目前不支持的时间参数类型:

    • yyyymmdd hh:mi:ss

    • yyyymm

    点击「数据预览」,可查看简道云数据。其中,一些简道云字段为 JSON 格式数据,需要进行解析。如下图所示:

    1689928408968946.png

    2.4 解析数据(选做)

    本节介绍怎么使用「JSON 解析」算子解析简道云表单的一些特殊字段,例如:成员单选、部门单选、附件、手写签名、图片。

    本节示例以一张包含成员单选、部门单选、附件、手写签名、图片字段的简道云表单为例,介绍这些字段解析后的情况。

    1690199343515777.png

    2.4.1 成员单选

    使用「JSON 解析」算子解析成员单选字段 member 。

    1)「JSON 解析」算子中,选择源字段为 member。点击选择 JSON 节点,可看到 member 节点可解析为 5 个字段,5 个字段全选。

    注:用户可根据实际需要选择字段,字段具体含义可参见下方步骤内容。

    1689930205893245.png

    2)点击数据预览。如下图所示:

    1689930462221870.png

    解析后的字段说明如下表所示:

    注:字段具体介绍请参见 部门接口

    解析后的字段
    含义备注
    name昵称

    name 可以重复,重名成员的 name 相同

    username用户名

    username 在企业内是唯一的,不同企业之间可能存在重复

    status部门状态

    1: 使用中的部门

    -1: 集成模式下同步后删除的部门

    type部门类型

    0: 常规部门

    2: 企业互联外部部门

    departments

    用户所属的部门编号列表

    -

    2.4.2 部门单选

    使用「JSON 解析」算子解析成员单选字段 department 。

    1)「JSON 解析」算子中,选择源字段为 department。点击「选择 JSON 节点」,可看到 department 节点可解析为 5 个字段,5 个字段全选。

    注:用户可根据实际需要选择字段,字段具体含义可参见下方步骤内容。

    1689931064845337.png

    2)点击数据预览。如下图所示:

    53.png

    解析后的字段说明如下表所示:

    注:字段具体介绍请参见 部门接口

    解析后的字段说明
    name部门名称
    dept_no部门编号
    type部门类型
    parent_no父部门编号
    status
    部门状态

    2.4.3 附件

    使用「JSON 解析」算子解析附件字段 annex 。

    1)「JSON 解析」算子中,选择源字段为 annex。点击「选择 JSON 节点」,可看到 annex 节点可解析为 4 个字段,4 个字段全选。

    注:用户可根据实际需要选择字段,字段具体含义可参见下方步骤内容。

    1690199516707608.png

    2)点击数据预览。如下图所示:

    1690199573506987.png

    解析后的字段说明如下表所示:

    解析后的字段说明
    name附件本来的名称
    size附件的大小,单位为字节
    mime附件的类型
    url附件存放地址

    2.4.3 手写签名

    使用「JSON 解析」算子解析手写签名字段 signature 。

    1)「JSON 解析」算子中,选择源字段为 signature。点击「选择 JSON 节点」,可看到 signature 节点可解析为 4 个字段,4 个字段全选。

    注:用户可根据实际需要选择字段,字段具体含义可参见下方步骤内容。

    1690200720981508.png

    2)点击数据预览。如下图所示:

    1690200763215992.png

    解析后的字段说明如下表所示:

    解析后的字段说明
    name

    在简道云中,手写签名的数据会自动保存为图片格式

    该字段代表自动生成的图片名称

    size图片大小,单位为字节
    mime图片类型
    url图片存放地址

    2.4.5 图片

    使用「JSON 解析」算子解析成员单选字段 picture 。

    1)「JSON 解析」算子中,选择源字段为 picture。点击「选择 JSON 节点」,可看到 member 节点可解析为 4 个字段,4 个字段全选。

    注:用户可根据实际需要选择字段,字段具体含义可参见下方步骤内容。

    1690199800603515.png

    2)点击数据预览。如下图所示:

    1690199868948282.png

    解析后的字段说明如下表所示:

    解析后的字段
    说明
    name图片本来的名称
    size图片的大小,单位为字节
    mime图片的类型
    url图片存放地址

    2.5 继续处理数据或输出

    根据实际业务场景,继续对数据进行处理或将上述步骤读取后的数据输出。



    附件列表


    主题: 数据开发
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    9s后關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy