EspoCRM实体与字段

本文目录导读：

1. 什么是实体？
2. 什么是字段？
3. 主要字段类型详解
4. 如何查看和管理实体与字段？
5. 实战例子：为“客户”实体添加一个新字段

EspoCRM 的实体（Entities）和字段（Fields）是其数据模型的核心,理解它们之间的关系是进行定制化开发和管理的基础。

什么是实体？

实体（Entity）可以理解为数据库中的“表”或“对象”，它代表了一类具体的数据或业务对象，客户、联系人、销售线索、潜在客户、任务等都是一个实体。

常见的预定义实体包括：

• Account（客户/公司）： 存储公司信息。
• Contact（联系人）： 存储个人联系人信息,通常关联到某个客户。
• Lead（潜在客户）： 未转化的潜在客户。
• Opportunity（商机）： 潜在的销售机会。
• Case（工单/案例）： 客户服务请求或问题。
• Task（任务）： 需要完成的待办事项。
• Email（邮件）： 存储电子邮件。
• Calendar（日历事件）： 会议、通话、任务等。
• User（用户）： 系统用户。
• Custom Entity（自定义实体）： 你可以通过管理界面创建全新的实体来满足特定业务需求（项目、合同、资产等）。

什么是字段？

字段（Field）是实体的“列”或“属性”，它定义了实体可以存储的特定类型的信息。“客户”这个实体有“名称”、“电话”、“地址”、“行业”等字段。

字段的通用属性

每个字段通常都有以下属性：

• 名称： 内部使用的系统名称（name，emailAddress）,通常不能更改。
• 在用户界面中显示的名称（“名称”，“电子邮件”）。
• 类型： 字段存储的数据类型（如文本、整数、日期、下拉、关联等）。
• 必填： 该字段是否必须填写。
• 默认值： 创建新记录时自动填入的值。
• 审计： 是否记录该字段的变更历史。
• 只读： 用户是否可以修改该字段。
• 布局： 该字段在详情页、列表、编辑表单等位置如何显示（位置、顺序、是否可见等）。

主要字段类型详解

EspoCRM 提供了非常丰富的字段类型，可以满足复杂的数据结构需求,以下是对常用类型的分类和解释：

基础文本类

• Varchar： 短文本（如姓名、标题、手机号）。
• Text： 长文本（如备注、描述）。
• Multi-Enum： 多选下拉框（如：标签 ["技术", "销售", "支持"]）。
• Array： 与 Multi-Enum 类似，但存储方式不同,通常用于简单列表。
• Checklist： 复选框列表（技能 [PHP, Python, Java]）。

数值类

• Integer： 整型数字（如：数量、员工数）。
• Float： 浮点数（如：金额、比率）。
• Currency： 带货币单位的金额（如：销售金额、预算）,可以设置多种货币。

时间日期类

• Date： 仅日期（如：生日、截止日期）。
• DateTime： 日期和时间（如：创建时间、会议时间）。
• Date Interval： 日期范围（如：项目开始日期到结束日期）。

关联类

这是 EspoCRM 功能强大之处,用于建立实体间的关联。

• Link： 一对一或一对多关联，字段会显示为选择按钮，可以指向另一个实体的单条记录。
  • 联系人 实体中的 客户 字段（Link to Account）,表示一个联系人属于一个客户。
• Link-Multiple： 多对多关联，字段会显示为多选列表。
  • 任务 实体中的 关联到 字段（可以对接到多个联系人、客户或商机）。
  • 用户 实体中的 团队 字段（一个用户可以属于多个团队）。
• Link-Parent： 多态关联，一个字段可以指向不同类型的实体。
  • 备注 或 活动 实体中的 父级 字段，一条备注可以关联到一个联系人、一个客户或一个商机。
• Attachment（附件）： 存储文件。
• Image（图片）： 存储图片文件。
• File（文件）： 存储任何类型的文件。

地址类

• Address： 包含街道、城市、州、邮政编码、国家等多个子字段的复合字段，通常用于客户、联系人的地址。
• Map： 在地图上显示位置。

其他特殊类型

• Boolean（布尔）： 是/否,复选框。
• Enum（下拉框）： 单选下拉菜单。
• Phone（电话）： 存储电话号码（支持多个号码并分类：工作、手机、家庭等）。
• Email（电子邮件）： 存储电子邮件地址（支持多个邮箱并设置首选）。
• Url（网址）： 存储超链接。
• JSON Object（JSON 对象）： 存储结构化的 JSON 数据,用于高级扩展。
• Wysiwyg（富文本）： 存储带有格式的文本（如 HTML）。
• Formula（公式）： 根据其他字段的值自动计算（如：总额 = 单价 * 数量）。
• Foreign（外键）： 通过关联在目标实体上显示一个字段（在联系人列表中显示其关联客户的“行业”字段）。
• Auto-Increment（自动编号）： 自动生成唯一的数字序列（如：INV-00001）。

如何查看和管理实体与字段？

所有管理操作都在 管理面板 中进行。

1. 访问路径： 点击右上角的用户头像 -> 管理 -> 实体管理器。

2. 实体管理器：

   • 查看所有实体： 你会看到所有标准实体和已创建的自定义实体列表。
   • 编辑实体： 点击某个实体名称进入其详情页。
     • 字段 选项卡： 这里列出了该实体的所有字段，你可以：
       • 添加新字段（点击 添加字段 按钮）。
       • 编辑现有字段（点击字段名）。
       • 删除自定义字段（不能删除系统核心字段）。
     • 关系 选项卡： 这里定义了实体之间的关系,你可以添加新的关联关系。
     • 布局 选项卡： 在这里可以改变字段的显示方式（左右列、顺序、隐藏等）。

3. 创建自定义实体：

   • 在实体管理器中点击 创建实体。
   • 输入实体名称（建议使用英文名称，如 Project）。
   • 设置标签（中文名称，如 项目）。
   • 选择是否包含默认字段（如：名称、描述、负责人、团队等）。
   • 点击 保存，之后你就可以像操作标准实体一样，为其添加字段、关系并配置布局和权限。

实战例子：为“客户”实体添加一个新字段

假设你需要为“客户”记录其 公司规模（下拉选择：小型、中型、大型）。

1. 进入 管理 -> 实体管理器。
2. 点击 Account（客户）。
3. 点击 字段 选项卡。
4. 点击 添加字段。
5. 选择字段类型：Enum（下拉框）。
6. 设置属性：
   • 名称： companySize （系统内部用）。
   • 公司规模 （界面显示）。
   • 选项值：
     • Small -> 小型
     • Medium -> 中型
     • Large -> 大型
   • 必填： 否 （根据需要选择）。
7. 点击 保存。
8. （可选）点击 布局 选项卡,将新字段拖放到详情页或编辑页面的合适位置。
9. 操作完成！现在打开任意一个客户记录，就会看到新的“公司规模”下拉框。

• 实体 = 对象/表（如：客户、联系人、项目）。
• 字段 = 属性/列（如：名称、电话、创建日期、关联的客户）。
• 关系 = 实体间的连接（如：一个客户 -> 多个联系人）。
• 管理入口： 管理 -> 实体管理器。
• 核心能力： 你可以通过添加自定义字段和创建自定义实体，无需写代码即可高度定制 EspoCRM 来适配你的业务。

通过熟练掌握实体和字段的操作，你可以将 EspoCRM 从一个通用 CRM 变成一个专属于你公司的业务管理系统。