了解字段的定义、类型、基础属性和常见配置规则。
概述
字段是对象中存储数据的基本单元，是构建业务模型的核心要素。系统支持 32 种字段类型和 3 种业务组件，涵盖文本、选择、数值、日期时间、关系与计算等多种类别。本文介绍字段定义、字段类型详情、基础属性配置和常见配置规则。
字段定义
每个对象的具体信息都是由字段承载的，企业可根据业务需要添加相应的字段进行数据维护。一个对象最多支持 500 个 字段。
新增字段入口：管理后台 > 对象管理 > 预设对象管理 / 自定义对象管理，选择一个需要配置的对象，点击 新增字段。
系统标准字段
系统标准字段（也叫预制字段）指每个对象创建后自动包含的字段，共 15 个：
| 字段名称 | 字段类型 | 字段意义 | 是否可编辑 |
|---|---|---|---|
| 主属性 | 单行文本 | 用于唯一标识一条数据 | 支持部分编辑 |
| 负责人 | 人员 | 本条数据的负责人 | 支持部分编辑 |
| 外部负责人 | 人员 | 本条数据的外部负责人，用户互联场景 | 不可编辑 |
| 归属组织 | 部门 | 本条数据属于哪个组织 | 不可编辑 |
| 归属部门 | 部门 | 本条数据属于哪个部门，负责人字段修改后此字段不变 | 支持部分编辑 |
| 负责人主属部门 | 单行文本 | 本条数据负责人的主属部门，负责人字段修改后此字段随之改变 | 不可编辑 |
| 锁定状态 | 单选 | 用于确定该数据是否锁定 | 不可编辑 |
| 业务类型 | 业务类型 | 每条数据都必须有一个业务类型 | 不可编辑 |
| 生命状态 | 单选 | 一般结合审批流使用，表示当前数据生命状态 | 不可编辑 |
| 最后修改时间 | 日期时间 | 本条数据最后修改时间 | 不可编辑 |
| 创建时间 | 日期时间 | 本条数据创建时间 | 不可编辑 |
| 最后修改人 | 人员 | 本条数据最后修改人 | 不可编辑 |
| 创建人 | 人员 | 本条数据创建人 | 不可编辑 |
| 汇率 | 数字 | 针对交易业务，企业开启多币种后，对象会预制汇率字段 | 不可编辑 |
| 币种 | 单选 | 针对交易业务，企业开启多币种后，对象会预制币种 | 不可编辑 |
由于这些标准字段为存储数据的共性，因此无法删除，部分字段支持编辑。
[!NOTE]
- 负责人、负责人主属部门和归属部门涉及数据权限，仅新建页面可以设置字段值。编辑时无法修改这些字段，只能通过按钮和函数进行变更。如需在数据创建后变更，建议配置业务按钮的字段变更事件。
- 当出现标准字段数据冗余时，建议在角色权限设置中让角色无法查看该字段，或在场景中直接隐藏该字段。
标准字段与自定义字段的区别
相同点：
- 无论是预制字段还是自定义字段，每个字段包含以下属性：字段名称、API Name、备注信息、创建时间、字段类型、状态、操作。
- 字段都没有最后修改时间。
不同点：
- 预制字段：字段名称、API Name、备注信息、字段类型一般都是固定的，不允许修改。
- 自定义字段：字段保存后，除了 API Name、字段类型，其他属性基本可以修改。
预设字段中，锁定状态、业务类型、生命状态、外部负责人、负责人主属部门、最后修改时间、创建时间、最后修改人、创建人不支持编辑、禁用、删除。主属性、负责人、归属部门支持部分编辑。
字段类型汇总
目前支持 32 种字段类型和 3 种业务组件。各类型的适用情况和限制如下：
文本类字段
| 字段类型 | 说明 | 示例 | 备注 |
|---|---|---|---|
| 单行文本 | 适用于填写简短文字，如"姓名" | 文本 | 字段值最多 100 个字符 |
| 多行文本 | 适用于填写大段文字，如"备注""建议" | 这是长文本通常长于 10 个字 | 字段值最多 2,000 个字符 |
| 富文本 | 适用于图文混排内容，如"产品描述" | 文字 + 图片 | 字段值最多 131,072 个字符 |
| 协同富文本 | 适用于图文混排内容，比富文本具有更多协同功能 | 文字 + 图片 | 字段值最多 131,072 个字符 |
选择类字段
| 字段类型 | 说明 | 示例 | 备注 |
|---|---|---|---|
| 单选 | 适用于在几个选项中选一个，如投票、"男/女" | A 级 | 选项值最多 3,000 个 |
| 多选 | 适用于在几个选项中选多个，如投票 | A，B | 选项值最多 3,000 个 |
| 布尔值 | 用于选择"是"或"否" | 是 | — |
数值类字段
| 字段类型 | 说明 | 示例 | 备注 |
|---|---|---|---|
| 数字 | 适用于填写数字，如年龄、订购数量 | 10.01 | — |
| 金额 | 适用于填写数字，带千分位，如订单金额 | 66.66 | — |
| 百分数 | 用于输入和展示百分数 | 90% | — |
日期时间类字段
| 字段类型 | 说明 | 示例 | 备注 |
|---|---|---|---|
| 日期 | 选择特定日期 | 2099-12-31 | 支持"年-月-日""年-月""年-季度""年"格式变形 |
| 时间 | 选择特定时间 | 16:31 | — |
| 日期时间 | 选择特定唯一的时间点 | 2099-12-31 16:31 | — |
| 日期范围 | 设置一个具体的时间段 | 07/03/2023, 00:00 - 05/04/2023, 10:00 | 可以设置精度到秒 |
联系与媒体类字段
| 字段类型 | 说明 | 示例 | 备注 |
|---|---|---|---|
| 手机 | 用于输入手机号码 | 18888889999 | — |
| 邮箱 | 用于输入邮件地址 | user@example.com | — |
| 网址 | 用于输入网址 | www.example.com | — |
| 图片 | 适用于上传图片，支持水印拍照、OCR 文字识别 | — | 每个对象最多添加 20 个（可购买资源包扩展） |
| 附件 | 适用于上传文件，可设定最多上传附件的数量 | — | 每个对象最多添加 50 个（可购买资源包扩展） |
| 大附件 | 适用于上传超过 100M 的文件 | — | 每个对象最多添加 1 个（暂不支持资源包） |
关系与计算类字段
| 字段类型 | 说明 | 示例 | 备注 |
|---|---|---|---|
| 查找关联 | 将当前对象与其他对象（或自身）建立关联关系 | [订单] 关联 [客户] | 每个对象最多添加 10 个（可购买资源包扩展） |
| 主从关系 | 定义主从对象关联关系，从属对象数据权限受主对象控制 | 订单 - 订单产品 | 每个对象最多添加 1 个 |
| 引用字段 | 支持跨对象的数据取值 | — | 每个对象最多添加 20 个（可购买资源包扩展） |
| 自增编号 | 系统按照规则自动生成编码，不可手动修改 | 20191219-00001 | 每个对象最多添加 10 个（可购买资源包扩展） |
| 计算字段 | 利用公式计算字段值，结果类型包括数值、百分数、日期、布尔值等 | 66.66 | 每个对象最多添加 20 个（可购买资源包扩展） |
| 统计字段 | 支持跨对象的数据汇总 | — | 每个对象最多添加 20 个（可购买资源包扩展） |
人员与定位类字段
| 字段类型 | 说明 | 示例 | 备注 |
|---|---|---|---|
| 部门 | 用于选择公司内指定部门 | 销售一部 | — |
| 人员 | 用于选择公司内指定人员 | 张三 | — |
| 定位 | 用于创建定位信息，可以在地图中展示位置信息 | 北京市海淀区知春路甲 63 号 | — |
| 签名 | 支持录入人员的签名信息 | — | — |
业务组件
| 字段类型 | 说明 | 备注 |
|---|---|---|
| 地区定位组件 | 用于记录业务数据的具体地理位置信息 | — |
| 签到组件 | 记录业务执行的时间、地点及时长 | 每个对象最多添加 1 个 |
| 支付（收款）组件 | 通过定义该字段完成业务收款，收款到指定账户 | 每个对象最多添加 1 个 |
字段基础属性
字段名称与 API Name
- 字段名称：在本对象内不可重复，管理员可按业务需要自定义。
- API Name：系统自动生成，主要供开发人员和公式引用使用。如无特殊需求，建议不要修改。
帮助信息
帮助信息用于为前台用户提供字段的填写说明，支持两种展示方式：
| 展示方式 | 展示位置 | 适用场景 |
|---|---|---|
| 悬停问号展示 | 新建页、编辑页、详情页 | 说明较长，或只需用户按需查看 |
| 外露展示 | 仅新建页、编辑页 | 需要直接提示录入格式或填写口径 |
默认值
- 默认值：在前台用户新建记录时自动填充预设值。默认值可以是固定值，也可以是通过计算公式算出的动态值。默认值填充后，允许用户进行手动二次修改。
不同字段类型支持的默认值配置方式不同：
| 字段类型 | 默认值方式 |
|---|---|
| 单行文本、多行文本、百分数 | 可输入文字或公式计算 |
| 富文本、邮箱、网址 | 仅可输入文字 |
| 数字、金额 | 可选择数字或输入计算公式（整数少于 12 位，小数少于 2 位） |
| 布尔值 | 可设置"是/否"作为默认值（选项值支持修改名称） |
| 手机 | 仅支持查找关联关系中其他对象的手机/电话类型字段 |
| 单选、多选 | 可将某个选项值作为默认值 |
| 日期、日期时间、时间 | 可输入计算公式 |
默认值与计算字段的区别
在设计字段默认值公式时，容易将其与"计算字段"混淆。下表对比了两者的本质区别与适用场景：
| 维度 | 字段默认值（使用计算公式） | 计算字段 |
|---|---|---|
| 设计目的 | 提供录入辅助。生成初始推荐值，但允许前台用户根据实际业务二次调整 | 保证结果严格正确。自动计算且不允许用户手动修改，只读显示 |
| 典型场景 | 产品默认售价（成本 + 利润率），销售代表可根据客户折扣手动改价 | 本位币金额（原币金额 × 汇率），作为财务凭证必须严格计算且只读 |
| 历史数据重算 | 新建或修改默认值公式后，系统不会重新计算已存在的历史数据 | 修改公式后，系统会自动重新计算历史所有数据（会有一定延迟） |
| 触发场景 | 仅在新建页、编辑页或列表页编辑中，当公式中的依赖字段发生物理变化时触发。通过后台 API、导入、自定义函数或按钮操作修改数据时，默认值公式不会重新触发计算 | 无论任何场景（包括前台手动录入、接口导入、自动化按钮、UI 函数、自定义工作流等），只要依赖字段改变，系统百分之百自动触发重算 |
其他基础属性
| 属性 | 说明 |
|---|---|
| 新建页字段值为空时提示 | 在前端新建编辑页，字段未输入值时显示占位提示。目前仅单行文本、多行文本、数字、金额、手机、网址字段支持此配置 |
| 是否允许重复 | 选择"不允许重复"时，系统校验数据唯一性，与该字段值完全一致的数据不可新建、编辑、保存、导入 |
| 是否必填 | 选择"是"时，该字段在新建、编辑、导入等场景必填，否则无法保存 |
| 是否可复制 | 选择"是"时，前端详情页复制记录会带入该字段值 |
| 是否使用 AI 内容生成 | 选择"是"时，可选择已有提示模板或新建模板。前台用户在新建数据时可点击 AI 按钮生成内容 |
必填配置的三种方式
- 字段级必填：在字段配置页中，将"是否必填"设为"是"。此配置在全场景生效，包括前台录入和后台数据导入，未填将阻止保存。
- 布局级必填：如果字段仅在特定业务场景下必填，建议将其在字段属性中设为不必填，转而在特定的页面布局编辑器中，选中该字段并勾选"必填"。
- 条件必填：如果必填条件依赖于其他字段的值（例如：只有当"客户流失原因"不为空时，"流失描述"才必填），需配置验证规则，详见 如何配置验证规则。
AI 内容生成配置
当启用 AI 内容生成后，需要配置提示模板：
| 配置项 | 说明 |
|---|---|
| 场景分类 | 对提示模板进行分类 |
| 主对象 | 该字段所属对象，不可修改 |
| API Name | 系统自动生成，可以修改，如无特殊需求建议不要修改 |
| 模板名称 | 作为选择提示模板的唯一标识，必填。建议不与已有模板名称重复 |
| 描述 | 必填，在选择提示模板时不显示描述 |
| 提示内容 | 可输入文本和变量（支持所属对象及字段、其他对象及字段、场景相关变量、自定义函数） |
所选模型按照"生成语言""语言风格""内容长度"根据"提示内容"生成模板，点击"生成预览"可查看模板效果。配置完成后，前台新建数据时点击字段的 AI 按钮，AI 模型按照模板生成含历史数据的关键业务信息摘要。
批量导入字段
当一个对象需要一次性新增多个字段时，可以使用字段批量导入。批量导入适合对象初始化阶段，例如从旧系统迁移字段清单，或根据业务设计表快速创建字段。
详细的操作步骤和支持的字段类型列表，请参阅 字段的批量导入。
设置字段显示名称
如果同一个对象存在多个业务类型，管理员可以为同一个字段设置不同的前台显示名称，适合不同业务线共用同一字段但使用不同业务称呼的场景。
[!NOTE]
字段显示名称设置只影响前台展示名称。后台字段配置中的物理字段名称保持不变。
详细的配置步骤和效果说明，请参阅 字段显示名称设置。
字段依赖关系
字段依赖关系用于在同一业务对象内，控制单选/多选子字段的可选值随父单选字段值的变化而动态联动。
业务场景示例
在"客户"对象中，有 客户等级 单选字段（选项包括：1 级、2 级、3 级）与 客户资产 单选字段（选项包括：小于 10w、10-100w、大于 100w）。如果业务规定：当用户选择 1 级客户时，不允许选择（隐藏）"小于 10w"这一资产选项，此时就需要配置字段依赖关系。
配置步骤
- 前提条件：在目标对象中，建好父字段和子字段，并录入它们的所有选项值。
- 前往 企业管理 > 对象管理 > 预设/自定义对象管理，打开目标对象。
- 进入 字段依赖关系 配置页面，点击新建关联关系。
- 选择 父字段 与 子字段，并在依赖矩阵中勾选父字段各选项值所对应的子字段可选范围。
- 保存配置。
核心限制与逻辑规则
- 父子字段类型限制：父字段只能是单选字段；子字段可以是单选字段或多选字段。
- 级联层级上限：系统支持通过多级依赖组成多级级联（即第二级的子字段作为第三级依赖的父字段，以此类推），最多可设置 10 级依赖关系。
- 自动回填逻辑：在前台录入界面，当子字段被设置为"必填"，且在父字段选中某值后，子字段仅剩一个唯一可选值时，系统会触发自动回填，默认直接勾选并填充该唯一值。
跨对象筛选
跨对象筛选允许用户通过主从字段、查找关联字段或引用字段，跨越不同对象设定级联过滤条件。例如：在"客户"列表中，直接筛选出"最近 30 天内有联系记录"的客户。
后台启用跨对象筛选
- 前往 企业管理 > 对象管理 > 预设/自定义对象管理，进入目标对象。
- 在 基本信息 > 可选功能 区域中，勾选并开启 跨对象筛选 功能。
前台操作步骤
当后台开启该功能后，用户可在前台列表页执行多维高级筛选：
- 进入前台目标对象列表页，点击右上角的 筛选 按钮展开侧边筛选面板。
- 在筛选面板中，点击 高级筛选 按钮。
- 点击 选择对象，指定需要作为过滤条件所属的关联对象（例如选择关联的"联系记录"对象）。
- 在弹出的选框内依次配置：关联对象名称、字段名称、操作符（如"大于""等于"）以及对应的筛选值。
- 配置完成后，点击下方的 筛选 按钮，系统即会过滤出符合跨对象条件的记录。
常见问题
预设字段想要修改名称如何操作
在字段列表页中无法直接修改预设字段名称。可通过 对象名称设置 菜单修改字段名称对应的语种值实现。
示例：希望将"负责人"修改为"数据负责人"，可将中文下的"负责人"值改为"数据负责人"，此时在中文环境下就会显示"数据负责人"。
负责人和负责人主属部门以及归属部门无法编辑
此类字段涉及数据权限，只有新建页面可以修改字段值。编辑时无法修改负责人、负责人主属部门和归属部门字段，只能通过按钮和函数进行变更。
如果在数据创建完成后需要变更这些字段，建议配置业务按钮的字段变更事件。
单选字段在页面显示"选项已删除"应该怎么排查
可能原因 1：获取到的选项名称不是最新的
- 尝试清空浏览器缓存后再查看。
- 确认选项名称是否发生变化，刷新后再查看。
可能原因 2：回填了不存在的选项值
- 确认字段是否设置了默认值，回填的选项是否存在。
- 确认选项是否由函数赋值，回填的选项是否存在。