1 概述

实体管理模块用于管理企业下各类业务实体的元数据，比如客户、订单、商品、优惠券、门店等。完成实体元数据定义后，可以通过OpenAPI导入实体数据。实体表主要分为两类应用：

应用一：作为应用主体，应用主体可以进行打标/分群等数据应用操作。以客户实体为例，默认作为应用主体，在标签/分群模块可以选定该实体作为应用主体。

应用二：作为关联维表，比如将实体数据作为行为日志表的关联维度表，即可进行关联维表分析。以商品实体为例，订单行为表里上报了商品ID，可以关联商品维表进行数据应用（比如标签/分析）。

2 管理客户实体

2.1 客户实体-参数管理

2.1.1 客户实体 - 参数管理 - 登记字段

登记字段支持单个登记与批量登记两种方式。

【单个登记】以“会员等级”为例，需填写字段显示名（必填）、字段Key（必填）、字段类型（必填，支持字符串/整型/小数型/日期/日期时间等类型）、字段说明（选填）、显示状态、字段索引。

【批量登记】按照“字段Key 字段类型字段显示名”的格式进行批量登记，可以将表格内容复制后粘贴在此处。字段类型支持：字符串、数值-整型、数值-小数型、日期、日期时间。

2.1.2 客户实体 - 参数管理 - 编辑字段

参数列表页支持对已创建的实体字段进行编辑操作。

2.1.3 客户实体 - 参数管理 - 删除字段

参数列表页支持对已创建的实体字段进行删除操作。

2.1.4 客户实体 - 参数管理 - 导出字段

在参数列表页支持导出实体字段，便于了解实体表的元数据情况，以及调整后进行变更字段重新登记。

2.1.5 客户实体 - 参数管理 - 查看参数列表

在参数列表页可以通过搜索快速查找客户实体字段：在搜索框中输入字段显示名或字段Key，可以快速定位符合条件的客户实体字段。

2.1.6 客户实体 - 参数管理 - 关联数据字典

实体字段可以关联字典表进行值翻译，比如会员等级实际存储值为1、2、3……通过“1-金卡会员；2-银卡会员；3-普卡会员”的字典表，可以在应用层展示翻译值“金卡会员”/“银卡会员”/“普卡会员“等

添加字典表关联后可以对字典表进行编辑（替换字典表）和删除。

2.2 客户实体-数据同步

实体数据默认会同步至“数据集管理”模块，作为维度表，以便服务分析/标签等各类查询应用，如下所示：

2.3 客户实体-关联设置

客户实体支持关联其他实体表，即构建实体关联关系。可以将“客户”实体下的用户ID关联“订单”实体的用户ID，以分群应用为例则可以圈选满足条件的订单对应的客户列表，比如订单中购买过商品A的客户列表。

除了单次关联，关联设置还可以设置多对多关联，支持N:N存储的2个实体、无直接关联的2个实体，统一通过关系表（可视为第3个实体）建立关联。更好地扩展支持“货找人、场找人”。

2.4 客户实体-行级权限

2.4.1 基础概念

行级权限是指针对同一份数据内容，不同的人能够看到的数据行范围不同的权限。例如对于同一张订单数据看板，成都的人只能看到成都分公司的订单数据，北京的人都只能看到北京分公司的数据，而管理的总部人员可以看到全部数据。就像是下面这张完整的数据：

当我们按照前文所说的方式设置了行级权限后，成都的人查看数据表格及其可配置出的图形时就会变为：

因为是以数据行的粒度切分了数据查看的范围，因此被称作行级权限。

2.4.2 功能入口

客户实体支持进行全局行级权限的设置，因为设置后会被下游的数据资产继承，影响范围较大，因此仅支持当前空间的管理员进行行级权限设置。

此外，需注意行级权限和列级权限是最细粒度的权限规则设置，它在权限校验中处于最后顺序。也就是说，在校验某个用户对某个日志表的权限时，我们首先会校验这个用户有无本版块的功能权限，其次再校验是否拥有当前日志表的权限，最后才是根据行列权限确认其需不需要进行细粒度的可见范围控制。

2.4.3 设置说明

启用开关：只有当开关打开时，设置才会生效。该功能可用于初次配置过程中不希望影响下游使用，或是需要快速关闭已经生效的行级权限场景。

受控数据对象：可以从鼠标移入的浮窗中了解当前设置后会对下游生效的范围。

规则设置：新建行级权限规则或是查看已有规则。当有多条规则，多个用户或是多个字段的复杂场景时，权限的校验遵循

1) 如一个用户出现在多条规则中，例如张三实际也是北部运营组角色的成员，则系统取权限并集，即张三可以查看重庆+黑龙江、河北、吉林、辽宁、北京、内蒙古范围内的权限。

2) 如果有多个字段要进行控制，例如希望即控制用户查看的省份范围，又希望控制品牌的范围，则应该为所有用户指定在两个字段上的权限范围。最终系统在校验时会在『多个字段间』取交集。

注意新增受控字段时需要考虑对所有人的影响。例如已设置了张三、李四可见重庆省份的数据，又新设置了张三可见 A 品牌的数据，则最终效果为张三可以看到城市等于重庆且品牌等于 A品牌的范围。而李四没有任何可见范围，因为对李四没有在品牌字段上设置任何可见范围，会走默认“无任何权限“，交集后使得李四没有得到任何可见数据范围。

3) 未在规则中出现的字段，对所有人默认都是可见的。

规则外其他用户：默认为无任何权限，即如果某个用户没有出现在上方设置的任何规则中，就不允许该用户在数据资产内查看到任何数据。这种设置更加安全，避免新出现的人员查看到超出范围的数据内容。

白名单：实际场景中，总部职能人员或是管理员通常不需要受到任何细粒度的权限控制，但逐个为他们设置规则效率太低。因此可以直接将这类人员或角色加入白名单，系统将自动为白名单人员跳过行级权限的校验。

2.5 客户实体-列级权限

2.5.1 基础概念

列级权限包含了禁止性的列级权限和脱敏性的列级权限，指对同一份数据，不同的人的人能够查看的字段不同。例如对于订单表，客诉人员可以查看客户手机号，而运营人员则只能查看到脱敏后的****或者直接对此字段不可见。

因为是以列的粒度切分了数据查看的范围，因此被称作列级权限。

2.5.2 功能入口

客户实体支持进行全局列级权限的设置，因为设置后会被下游的数据资产继承，影响范围较大，因此仅支持当前空间的管理员进行列级权限设置。

2.5.3 设置说明

启用开关：只有当开关打开时，设置才会生效。该功能可用于初次配置过程中不希望影响下游使用，或是需要快速关闭已经生效的列级权限场景。

受控数据对象：可以从鼠标移入的浮窗中了解当前设置后会对下游生效的范围。

规则解释：例如对于手机号字段，如设置完整查看，则受控用户看到的就是13901836666这样的完整手机号。而设置脱敏查看，则受控用户看到的是********，或*******6666这样的形式，无法查看明细全文，但进行统计计数则不受影响。但如果设置禁止查看，则受控用户无法到手机号字段，同时也无法利用此字段进行统计计数。

规则设置：新建列级权限规则或是查看已有规则。当有多条规则，多个用户或是多个字段的复杂场景时，权限的校验遵循

1) 当一个用户在多条规则中都被指定了同一个字段的权限，例如张三同时处于运营人员与开发人员中，两个角色对安卓设备 ID的权限完全相反。这事系统将采用更加安全的策略，即禁止类设置有更高优先级，最终张三对安卓设备 ID 的权限为禁止查看。

2) 如果有多个字段要进行控制，例如希望即控制用户查看的身份证号，又希望控制收货地址字段，则应该为所有用户指定在两个字段上的权限范围。否则未指定的字段权限视同规则外用户处理（默认为不允许查看）。例如设置张三可完整查看身份证号和收货地址字段，又设置李四可完整查看身份证号字段，最终效果为张三可以看到身份证号和收货地址字段，而李四默认情况下只能看到身份证号字段。

白名单：实际场景中，总部职能人员或是管理员通常不需要受到任何细粒度的权限控制，但逐个为他们设置规则效率太低。因此可以直接将这类人员或角色加入白名单，系统将自动为白名单人员跳过列级权限的校验。