字段类型参考

本参考文档详细介绍了 PaaS 平台所支持的字段类型、底层数据规格、高级配置要求以及排查思路，用于辅助管理员在建模和日常维护中进行方案设计。

字段类型列表与基础规格

系统目前共支持 32 种字段类型 与 3 个业务组件。每个对象最多可配置 500 个 字段。

字段类型	字段说明与默认限制	典型示例	关键配额与字数限制
单行文本	用于录入简短文本，支持扫码和手动输入。	姓名、手机号	最多 100 个字符。
多行文本	用于录入长段的文字备注。	处理意见、备注	最多 2000 个字符。
富文本	支持在网页端进行图文混排。	产品描述、通知	最多 131,072 个字符。
协同富文本	相比富文本支持网盘、投票和 CRM 对象引用。	产品设计、协同方案	最多 131,072 个字符。
单选	从预设选项中选择一项。	客户级别（A/B/C）	选项值最多 3000 个。
多选	从预设选项中选择多项。	客户兴趣偏好	选项值最多 3000 个。
数字	存储普通数值，支持最大位数限制。	年龄、订购数量	允许最大位数 = 整数位 + 小数位。
金额	带千分位显示的货币数值。	销售订单金额	支持千分位及掩码显示。
日期	记录具体的年月日日期。	2026-07-02	支持年/年月/季度等格式变形展示。
时间	记录具体的时刻。	14:30	格式为 hh:mm。
日期时间	记录唯一精确的时间点。	2026-07-02 14:30	包含日期与时间。
日期范围	记录一个具体的时间段。	2026-07-02 ~ 2026-07-09	可精确到秒。
手机	用于输入电话号码。	18888889999	支持在客户对象下发送短信验证码。
邮箱	校验电子邮件地址格式。	user@example.com	支持默认值与掩码。
网址	存储网址并自动转化为超链接。	www.example.com	限制标准 URL 格式。
布尔值	二元状态选择器（是 / 否）。	是否已收款（是/否）	支持在公式中进行逻辑判定。
百分数	存储并以百分比格式展示数值。	利润率 90%	自动带百分号。
部门 / 部门多选	选择系统内架构部门。	销售一部	可限制部门选择范围。
人员 / 人员多选	选择系统内激活的用户。	张三	可限制人员选择范围。
定位	用于记录经纬度及具体地址。	卫星大厦	支持在地图中展示。
地区定位组件	记录地理位置的快捷组件。	地图定位	可触发 UI 事件。
签名	允许前台录入人员电子签名信息。	签字确认	存储为图片格式。
图片	存储上传的图片资产。	产品外观图	每个对象最多 20 个。支持水印和 OCR。
附件	存储上传的文件资产。	合同 PDF 扫描件	每个对象最多 50 个。支持预览和 OCR。
大附件	适用于上传超过 100 MB 的超大文件。	产品培训视频	每个对象最多 1 个。不支持购买扩展包。
查找关联	在两个独立对象间建立关联关系。	订单关联客户	每个对象最多 10 个（可购买资源包扩展）。
查找关联（多选）	可同时选择多个关联对象记录。	项目关联多个干系人	多对多松散关系。
主从关系	表示主明细对象强绑定关系。	订单关联订单产品	每个对象最多 1 个。主对象最多 5 个从对象。
引用字段	用于跨关联对象读取字段数据。	订单明细上显示产品价格	每个对象最多 20 个（可购买扩展包）。
自增编号	系统根据编号规则自动生成代码。	PSD-20260702-0001	每个对象最多 10 个（可购买扩展包）。
计算字段	根据设定的数学公式和逻辑得出结果。	订单利润 = 金额 - 成本	每个对象最多 20 个（可购买扩展包）。
统计字段	跨明细对象汇总数据（SUM/COUNT）。	订单总金额 = 明细金额汇总	每个对象最多 20 个（可购买扩展包）。
签到组件	记录业务执行的外勤打卡数据。	外勤拜访签到	每个对象最多 1 个。
支付（收款）组件	支持在对象详情中直接调用收款功能。	订单线上付款	每个对象最多 1 个。

---

引用字段 (Reference field)

引用字段支持跨对象获取一对多关系中“1 方”的字段值并呈现在“多方”页面上。

1. 引用字段与默认值的区别

引用字段是 动态链接 的，其数据会始终跟随源头对象中字段的改变而 实时同步发生变化。而默认值只在创建记录时加载一次，之后源对象值修改，默认值不会发生变化。

2. 引用字段的计算时效性

• 不支持筛选的引用字段：在用户打开页面或查询数据时，在内存中 实时关联计算并展示，数据库不持久化该值。
• 支持筛选的引用字段：由于需要在数据库底层建立索引以供查询，其值在保存数据后由后台程序在 计算队列中异步计算并写入数据库。因此存在一定的同步延迟。

WARNING

引用字段筛选“有值但筛选不出”问题： 在列表页数据中能看到引用字段的值，但在列表筛选时却无法搜出来。这是因为页面显示的值是进入页面时实时关联计算渲染的，而筛选是在数据库物理列中检索。如果后台计算队列尚未将新计算的值写入该引用字段对应的物理列，筛选就会失效。请批量操作后耐心等待计算队列执行完毕。

3. 使用限制与置灰规则

• 引用字段不支持引用计算字段、统计字段和另一个引用字段。若需要关联引用，请使用计算字段的“高级模式”进行嵌套。
• 引用字段不支持作为计算字段、统计字段或默认值公式中的运算变量。
• 引用字段不支持触发前端 UI 事件。
• 如果引用字段引用了 查找关联、部门、人员、图片 字段，则后台的 是否支持筛选 选项将强制置灰为“否”，不支持作为前台列表的筛选条件。

---

计算字段 (Calculation field)

计算字段能够利用预设公式自动生成数据结果，其计算涵盖前台新建、编辑保存、API 写入以及数据批量导入全场景。

1. 核心注意事项与规则

• 公式空值参与计算报错：如果计算字段返回日期、时间、文本、布尔等类型，当参与公式的字段为空时，系统无法进行隐式转换，会直接报错导致计算结果为空。在设计公式时，必须使用 ISNULL() 嵌套进行判空处理。
• 全局变量导致筛选失效：如果计算公式中引用了全局变量（如当前日期 $currentTime__g、$now）、人员对象的特定字段或使用了 NOW()、TODAY() 函数，该计算字段在前台列表页中将 不支持作为筛选条件，且不支持被其他统计字段、计算字段或验证规则引用。
• 小数位数截断：例如在后台设置计算字段小数位数为 2 位。若公式计算出的精确值为 6.167，系统会自动四舍五入并以 6.17 的数值写入数据库物理存储中。

2. 超过 10,000 条历史数据时的保存策略

当编辑或新建计算字段保存时，如果当前对象下的存量数据已超过 10,000 条，系统会弹出提示，管理员需选择计算范围：

• 现有数据不计算：公式仅对保存后新建或被编辑过的记录生效，不刷新历史记录。
• 全部计算：系统会在后台计算队列中启动异步任务重算历史数据（数据量巨大时，该计算字段在前台列表中可能会有一段时间显示为空，需要等待后台队列执行完毕）。
• 符合以下数据范围计算：管理员配置特定条件，系统只对符合条件的子集进行历史数据刷值。

3. AI 公式助手

在计算设置中，支持通过输入“/”或点击“AI 公式助手”来调出 AI 引擎，管理员输入中文描述（如“如果创建时间大于 2026 年且金额大于 100 算 1，否则算 0”），AI 会自动生成并填入标准系统公式。

4. 常用函数汇总参考

函数分类	函数名称与语法	功能说明与返回值	示例说明
逻辑	IF(logical_test, val_true, val_false)	嵌套条件分支。注意：IF 在计算时所有分支均会编译，任何分支报错（如除零）都会导致公式报错。	IF(1 > 2, 10, 20) 返回 20
逻辑	CASE(expr, val1, res1, val2, res2..., else)	多条件分支（最多支持 50 个分支，所有 res 类型必须完全一致）。	CASE(3, 2, "A", 3, "B", "C") 返回 "B"
数学	ROUND(number, num_digits)	四舍五入到指定小数位数。	ROUND(1.45, 1) 返回 1.5
数学	ROUNDDOWN(number, num_digits)	向下舍入。	ROUNDDOWN(1.47, 1) 返回 1.4
时间	DATETIMETODATE(datetime)	将日期时间格式安全转化为纯日期格式。	返回 2026-07-02
文本	TEXT(value)	将其他类型的数据转化为文本格式。	日期字段返回 "2026-07-02"

---

统计字段 (Roll-up summary field)

统计字段用于在主从关系的主对象（或查找关联对象的 1 方）中，对其属下的从对象/关联对象的子记录进行数学运算。

1. 核心统计类型

• COUNT：统计关联的子数据总记录数（例如：客户下的联系人数量）。
• SUM：对子记录的特定数值/金额字段进行求和（例如：订单下的产品金额合计）。
• MAX / MIN：获取子记录中特定字段的最大值或最小值。
• AVG：计算子记录的平均值（例如：订单产品的平均折扣）。

2. 统计字段过滤条件的“白名单”与“黑名单”

管理员可以为统计范围设置过滤条件，但仅有部分字段类型支持做过滤条件：

• 支持的类型：文本类、数值类、单选/多选/布尔值、人员（及其多选）、部门（及其多选）、查找关联、国家省市区、定位字段。
• 不支持的类型：计算字段（无论是否可筛选均不可）、统计字段、引用字段、复合组件（如支付组件、签到组件的父容器，但可以引用组件内部的子字段）、业务字段（评星、视频、预约时间段等）。

CAUTION

多层级“多级计算/统计互算”拦截限制： 系统限制跨对象的多级级联计算/统计互算，以防范数据库死锁。若存在多级引用（如 发货单.优惠额度 -> 发货单.门店信用 -> 门店.信用值），保存时系统会报错拦截并提示不支持该多级链路。

3. 四舍五入精度偏差问题（数据库统计 vs 列表汇总）

管理员经常会发现，在前台列表页对某列金额进行 excel 或界面求和，与该对象上的 统计字段 计算值相差一分钱。

• 原因分析：
  • 列表界面求和：采用的是 先四舍五入，再求和。系统先把数据库里的高精度值保留 2 位小数显示出来，然后对显示值进行累加（例如：7580.946 -> 7580.95；3925.088 -> 3925.09；合计为 11506.04）。
  • 统计字段计算：采用的是 先求和，再四舍五入。系统在数据库底层对高精度物理值进行累加，然后对求和后的总值保留 2 位小数（例如：7580.946 + 3925.088 = 11506.034，四舍五入为 11506.03）。
  • 这种算法逻辑差异导致了精度的一分钱偏差，属于系统设计的正常逻辑。

---

图片与附件字段

图片和附件字段主要用于上传和存储多媒体与非结构化文件。

1. 图片字段的水印拍照配置

图片字段支持前台强制水印拍照上传，防止作假。

• 内置变量：当前用户、当前时间、当前地址。
• 配置规则：水印文本中最多可选 5 个 变量，且已选变量不支持重复添加。

2. 附件字段支持预览的格式列表

以下格式的附件在前台详情页中支持在线预览： doc, docx, ppt, pptx, xls, xlsx, pdf, jpg, png, bmp, gif, jpeg, svg, txt, html, js, xml, aspx, csv, sql, css, json, htm, msg, mp4, mkv, mov, m4v, webm, ogg, mp3, wav, aac。 其余未列出格式在前台仅支持下载，无法直接预览。

---

OCR 文字识别配置

图片与附件字段均可以开启 OCR（光学字符识别）能力，实现图片或文档中的信息自动提取并回填到当前对象的存储字段中。

1. 配置步骤

1. 购买租户级 OCR 识别调用次数资源包。

2. 在目标对象中，建好用来承载和存储识别结果的物理字段（如：姓名、身份证号等）。

3. 前往对象字段设置，编辑图片或附件字段，开启 是否启用 OCR 开关，选择对应的识别卡证类型（如：身份证、银行卡、营业执照等），并配置映射回填字段。

   

4. 前台用户在新建或编辑页面，上传该身份证图片，系统便会自动识别并结构化回填字段。

   

2. 图片/文档限制规范

• 文件类型限制：OCR 图片模式支持 PNG、JPG、JPEG、BMP、TIFF、PNM、WebP。发票识别可额外支持 PDF 与 OFD 格式。
• 文件大小限制：上传图片 Base64 编码后文件大小需小于 4 MB，分辨率不能高于 4096 x 4096，单边尺寸不低于 15 像素。
• 排错注意：同一张图片中只能包含一个需要识别的主体。如果有复杂水印、印章遮挡或画质太暗，可能会导致识别失败或返回低精度数据。

3. 常见 OCR 报错码快速对照

错误码	错误信息	解决方案
6	No permission to access data	无接口权限，请联系产研检查应用中是否勾选了该文字识别接口。
17	Daily request limit reached	免费测试额度已用完，需在后台购买次数包。
18	QPS request limit reached	QPS 超并发限制（免费 QPS 为 2，次数包 QPS 上限为 10）。
110 / 111	Access token invalid / expired	access_token 无效或过期（有效期为 30 天），需要系统定期重新拉取。
216201	Image format error	上传图片格式不符，必须为系统指定的 PNG/JPG/WebP 等。
282112	Url download timeout	传递的是 URL 图床链接，系统下载超时。请确认链接未防盗链且大小小于 3 MB。

---

动态地址与地图定位字段

1. 动态地址字段

动态地址字段专门用于企业跨境业务及全球化地址管理。

• 国家地区联动：首行固定显示国家/地区。当用户选择不同的国家时，下方的行政区划字段顺序、名称及必填校验会自动切换。例如，选择中国展示“省 / 市 / 区”，选择美国展示“State / City / Zip”。
• 升级逻辑：历史的“地区定位”字段在编辑页中可以一键勾选“升级为动态地址”。升级后不可撤回，系统将平滑保留并转换历史数据。

2. 定位字段的地图平台与导入规范

• 地图平台：定位字段目前支持 高德地图 与 华为地图。
• Excel 批量导入格式：通过后台或数据工具导入定位数据时，必须遵循以下字符格式：经度|纬度|具体地址。
  • 示例：116.427354|39.90283|北京市东城区毛家湾胡同甲13号北京站
  • 注意：若仅导入地址文本而没有经纬度分隔数据，导入后系统在前台地图上将无法进行精准定位。

---

日期与日期时间字段

日期字段底层始终保存为标准日期类型，录入时需要包含具体日期。展示格式只影响列表页展示、前台筛选条件和导出时的文本格式。

例如，管理员将日期字段展示格式设为 年-月 后，前台新建记录时仍需要选择具体日期。系统保存完整日期后，再按配置格式展示。

---

相关主题

• 如何配置字段
• 如何配置字段默认值与必填
• 对象关系概述