业务实体
实体是构建 RB 系统的基石。
实体
作为业务数据的载体，业务实体（Business Entity）约定了数据的格式、约束以及与其他实体（数据）间的关联。通过各个实体之间的关系，可以达成具体业务的实现，例如订单与客户、仓库与库存、订单与订单明细等。
添加实体
进入管理员后台 - 实体管理，点击 [添加实体] 进行添加。可以手动添加，也可以从 RB 线上仓库导入。
输入实体名称，点击 [确定] 即可，添加后会进入实体管理页。其中
- 添加名称字段，在添加实体的同时会自动添加一个 名称字段（详见下文）
- 这是一个明细实体，建立的实体需要依附在一个主实体之上（例如订单明细通常依附于订单），需要注意的是目前 RB 仅支持一个主实体对应一个明细实体
管理实体
添加实体后可以对实体进行进一步的配置，实体管理页有非常丰富的选项供使用。
上图中，名称字段 将作为主显字段、列表点击字段，以及快速查询字段。快速查询字段 是作为可供快速搜索的字段。
主显字段（名称字段）
顾名思义，主显即主要显示字段，例如在下图中，相关客户 所显示的就是来自主显字段值（列表亦是如此）
同时，主显字段在列表中会显示为一个 带下划线的链接，点击即可打开记录视图（也可以选中某条记录，然后点击右上角的 [打开] 按钮打开）。
快速查询字段 ~~v2.1
快速查询会应用在多个地方，包括列表中的快速查询，表单页引用字段的快速搜索等。
?注意：默认情况下系统会将名称字段、自动编号字段作为快速查询字段，如果配置了快速查询字段，则以配置的为准
字段
在实体中，最小单位是字段，即可以把实体看作是一组字段的集合。例如在“客户”实体中，包括了“客户名称”、“联系电话”、“所在行业”等字段。这些字段构成了对一个客户的完整表述。
添加字段
进入管理员后台 - 实体管理，点击某个实体后进入实体管理页 - 字段管理，点击右上角 [添加] 按钮进行添加。
输入字段名称，选择字段类型（详见下文），最后点击 [确定] 即可，添加后会进入字段管理页。
管理字段
根据不同的字段类型，会有不同的配置选项，如下图是一个引用型字段的配置选项。
其中，多数选项都是显而易懂的，根据字面意思理解即可，此处不再赘述。下面只针对一些可能产生误解的选项进行说明。
- 允许新建 即只能在新建记录的时候填写
- 允许更新 即新建后是否还允许修改
- 允许重复 无论是新建还是更新，如果检测到重复值将会弹出窗口提示哪些重复，并且 不允许保存
引用字段
- 附加过滤条件 ，在搜索引用记录时会自动过滤出符合条件的数据
引用字段还可以配置 表单回填，详见下文
自动编号字段
- 编号规则 由常量和变量组成，变量使用
{}包裹，变量支持YYYY4 位年份，如 2020YY2 位年份，如 20MM2 位月份，如 09DD2 位日，如 21HH2 位时，如 23II2 位分，如 59SS2 位秒，如 570000自增数字，如 0001（长度可以自定，如00000000）- 以上变量可组合使用，例如
ABC-{YYYYMMDD}{00000}
- 自增数字归零 即变量中的自增变量是否需要清零（重新从 1 开始计数）以及清零时间
字段类型
为了保证数据的有效性，应该为字段选择合适的字段类型，RB 会在用户填写时做相应效验，不符合的数据将会提示用户错误无法录入。例如电话号码应该选择“电话”而非“文本”类型。以下是 RB 目前所支持的数据类型。
| 字段类型 | 备注 |
|---|---|
| 文本 | 一般文本，如客户名称。默认长度 200 |
| 多行文本 | 长文本，如客户跟进情况。默认长度 32767 |
| 电话 | 电话号码或手机号码 |
| 邮箱 | 邮箱地址 |
| 链接 | 支持 http https ftp |
| 自动编号 | 可设置编号规则，支持 年月日 及 自增序号 变量。如订单号 |
| 整数 | 无小数位 |
| 货币 | 含小数位 |
| 日期 | 仅日期。如 YYYY-MM-DD |
| 日期时间 | 包括时间部分。如 YYYY-MM-DD HH:II:SS |
| 列表 | 下拉列表。如客户来源、订单类型等拥有固定值的字段 |
| 多选 | 多项选择，最多支持 64 个选项 |
| 分类 | 可以看作是超大“列表”，同时带有级联。如地区（省市区） |
| 引用 | 与其他实体进行关联，单一引用。如订单实体中的客户字段 |
| 多引用 ~~v2.1 | 与其他实体进行关联，多个引用 |
| 文件 | 无 |
| 图片 | 无 |
| 头像 | 无 |
| 二维码 | 支持二维码与条形码 |
| 布尔 | 单选（是/否） |
如默认字段长度不能满足需求可自行至 MySQL 表中修改，但请注意符合 MySQL 索引对于字段长度的要求（根据 MySQL 版本不同而不同）
字段默认值
绝大部分字段支持默认值配置。关于默认值的生效时机，分为两种情况。
- 字段已布局在表单中：新建时会自动填写，用户可根据需要重新填写
- 字段未布局在表单中：会在后端进行自动填写（因此默认值在 OpenAPI 中调用也会生效）
? 如字段未布局在表单中，请将字段设置为“允许为空”。因为虽然默认值会在后端自动填写，但无法通过自动填写前的基础效验逻辑
系统字段
当新建一个实体，系统将自动添加以下系统级字段，这些字段值通常由系统自动填写，用户无需关心。
| 字段 | 说明 |
|---|---|
| 所属用户 | 记录的所属用户（可通过分派修改） |
| 所属部门 | 记录的所属部门（与所属用户联动） |
| 创建时间 | 记录何时创建 |
| 创建用户 | 记录由谁创建 |
| 修改时间 | 记录最近更新时间 |
| 修改用户 | 记录最近更新用户 |
| 审批流程 | 选择的审批流程（实体开启审批流程后可用） |
| 审批状态 | 当前流程状态（实体开启审批流程后可用） |
引用字段的更多说明
表单回填
当在表单页选择引用字段（值）时，系统将按照设置好的规则自动回填页面上其他字段的值，以此减少重复录入，还能避免错误录入的情况发生。
?系统无法对未布局/未显示在表单上的字段进行回填，回填仅仅是页面上发生的行为。如需后端回填或跨实体回填，请考虑使用 触发器-数据转写
实体关系
在一套业务系统中通常会存在许多实体，这些实体各司其职的同时也能进行有机的结合。例如在一条“订单”记录中，通常包括订单所属的“客户”，这其中订单与客户即存在着引用关系。
在系统实施前期，应当充分考虑与梳理业务实体模型。良好的实体关系设计有利于系统的易用性，也能够避免冗余或无效数据的存在。
布局
当实体和字段添加完毕后，我们需要将其布局到相应的页面才能使用，包括表单页与列表页。
表单布局
表单常用于数据录入。得益于 RB 的可配置特性，你可以通过配置决定录入哪些数据，并且可以指定哪些数据是必填、哪些数据是选填。
进入管理员后台 - 实体管理，点击某实体进入配置页后，点击 表单布局 即可进行配置。
- 点击 区域 1 处的 字段列表，可以添加到布局
- 区域 2 处显示已布局字段，通过长按可以拖动位置
- 区域 3 可以对字段进行高级控制（详见下文）
布局将同时应用于表单页和视图页。目前仅支持一个布局，且仅有管理员可配置，后续会增加多布局支持
高级控制 ~~v2.2
布局高级控制可控制在数据录入时（新建或修改）的字段状态，包括是否显示、是否必填。请注意 [必填] 选项，如果字段本身不允许为空，则不能在表单中对其进行非必填控制。
列表布局
当数据录入完毕后，我们需要方便的进行查阅和管理，这便是列表所承担的职责。
列表布局即列显示，通过列显示控制要显示的字段。进入列表页后点击右侧 [更多] - [列显示] 即可进行配置。
列显示可以由用户自行配置（可以通过角色控制是否允许），也可以由管理员配置好以后分享给他人使用（只读），一般我们建议此项由管理员配置。