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