选择应用类型
企业内部应用开发
学习地图
动态与公告
应用开发平台简介(新版)
应用开发平台简介
开发应用(新版)
开发应用
服务端API
开发指南
API总览
身份验证(免登)
获取访问凭证
通讯录管理
上下游组织(原合作空间)
上下级组织(原关联组织)
考勤
日志
日程
签到
公告
音视频
钉工牌
工作台
服务窗
OA审批
即时通信IM
智能人事
智能填表
智能交互
组织大脑
待办任务
文档/文件
钉钉客联
互动卡片
应用管理
企业文化
专属开放
生态开放
智能硬件
行业开放
HCM 主数据
宜搭应用开发
客户管理(官方CRM)
概述
使用教程
权限申请
客户
联系人
跟进记录
自定义对象
客户群
控件格式
自定义控件字段格式说明V1
自定义控件字段格式说明V2
新增和更新客户字段格式说明V1
新增和更新客户字段格式说明V2
新增和更新联系人字段格式说明V1
新增和更新联系人字段格式说明V2
查询DSL说明
客户群查询DSL语法说明
Teambition 项目管理
钉钉快办
Agoal
炼丹炉(模型服务)
AI 助理
365会员
附录
客户端API
事件订阅
参考
常见问题
历史文档

自定义控件字段格式说明V2

更新于 2023-01-18本文档介绍客户管理支持操作的自定义控件字段信息,在使用新增或更新客户、联系人、跟进记录、自定义对象相关接口时需了解自定义控件字段信息。

电话

字段类型

Key

Value

Value

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值格式为字符串:

  • 国际手机号需加国际区号,否则导致无法解析。

  • 国内手机号是否添加+86都符合value格式。

  • 固定电话是否添加区号都符合value格式。

Loading...

数字输入框

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值格式为字符串。

Loading...

单选框

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值需符合以下条件:

  • 格式为字符串

  • 填写预设的选项值之一。

Loading...

多选框

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值填写预设的选项值组成的数组转义为字符串,即使只有一个,value也需要是数组格式。

Loading...

日期

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值的格式:

  • 如果控件的日期类型选择【年-月-日】,value格式为yyyy-MM-dd。

  • 如果控件的日期类型选择【年-月-日 时:分】,value格式为yyyy-MM-dd HH:mm。

Loading...

日期区间

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值的格式:

  • 如果控件的日期类型选择【年-月-日】,value格式为yyyy-MM-dd。

  • 如果控件的日期类型选择【年-月-日 时:分】,value格式为yyyy-MM-dd HH:mm。

Loading...

身份证

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值格式为字符串。

Loading...

金额

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值格式为字符串。

Loading...

附件

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value是一个json数组转义为字符串形式。

说明

数组中的每个 json 对象都是一个附件文件,每个文件都必须包含 spaceId、fileName、fileSize、fileType 和 fileId 字段,这些字段都可以通过调用保存文件到自定义或审批钉盘空间接口获取。

Loading...

联系人

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值是userId为元素的json数组格式。

Loading...

省市区

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value需同时符合以下条件:

  • 必须和地址控件的格式一致且正确。

  • 使用英文格式逗号进行分隔。

Loading...

评分

字段类型

Key

Value

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值格式为number。

Loading...

部门

字段类型

Key

Value

extValue

示例

自定义控件

通过调用获取个人或企业客户的元数据接口,获取字段列表fields下的字段名称name。

value值格式为字符串。

value需同时符合以下条件:

  • extValue格式必须是数组结构。

  • extValue必须是相同的部门名称。

Loading...

点击纠错