# 标签开发 ## 实体管理 1. 实体管理模块包含实体体系、新建实体、修改实体、实体调度、实体详情等功能 2. 普通用户只能查看和使用其被授权的实体及体系结构 ![entity_list](../images_v2.0/tag/entity_list.png) ### 实体体系 ​ 支持新建、编辑、删除实体目录，便于管理不同层次及结构的实体 ### 新建实体 ​ 在实体体系非顶级目录上点击+号或列表右上角新建实体按钮即可进入新建实体流程,流程一共分为4步:基本信息、属性配置、调度配置和信息总览 #### 基本信息 ​ 填写实体中英文名称及描述,其中名称不得超过50个字符,描述信息不得超过500个字符 #### 属性配置 - 首先选择实体数据的来源，可以选择三种数据来源：从数据集、数据库中选择一张表 或 从数据工厂流程中选择一张目标表。 - 选择实体所需的字段，填写字段的别名及备注，并标注主键列，主键要求无重复数据。 - 点击下一步时，系统会自动进行主键的数据查重，如果查重结果为没有重复数据，即可进入下一步； - 否则，系统会提示主键数据有重复，此时用户需要核查是否选择了正确的主键列； - 如果选择正确，则说明基础数据有误，需要找对应的数据治理部门进行核查和数据清洗。 从数据工厂选择数据来源 ![entity_attribute](../images_v4.0/tag/add_entity_step2.png) #### 调度配置 ​ 如果上一步中选择的数据了来源为普通表，则无须配置调度。 ​ 如果数据来源为 数据工厂，则可以进行定时调度配置。 ​ 配置调度后，可以定时运行数据工厂的流程，从而保证实体数据的实时更新。 #### 信息总览 该步骤会将前述所有步骤的配置信息进行汇总展示，以供用户核查，同时可以修改之前填写的中英文名及调度信息。 如核查无误，即可点击”保存“按钮创建实体，成功创建后会跳转到相应的实体列表。 ![entity_info_overview](../images_v2.0/tag/entity_info_overview.png) ### 实体列表 点击实体体系中的任何一个目录，即可将此目录下包含的所有实体展示到右侧列表中。 实体列表可以展示实体名称、来源类型、创建人、更新时间、标准标签、标准分群、运行状态等信息，同时支持对某些列进行排序和搜索功能。 标准标签和标准分群列对应的数字表示该实体下所拥有的标准标签或分群的数量，点击对应的数字会跳转到相应实体的标签管理模块或分群管理模块。 当鼠标放置在某行实体上时，会显示可以在该实体上可进行的不同操作按钮，包括: - 运行实体：只有数据工厂类型的实体可点击运行 - 权限设置：审核人可对普通用户配置相应实体的不同权限 - 实体细查：点击该按钮可以跳转到实体细查模块 - 编辑调度：只有数据工厂类型的实体可编辑调度信息 - 删除实体：如果该实体已经创建有标签或者分群，删除时会提示有关联关系限制，并展示对此实体有依赖的标签或分群位置 点击列表中的实体名称，可展示相应实体的实体详情。 ### 实体详情 在左侧实体树或者右侧实体列表中，点击任意实体，即可查看相应的实体详情。其中包含实体的基本信息,实体属性列表和调度历史 ![entity_details](../images_v2.0/tag/entity_details.png) #### 基本信息 ​ 基本信息包含: - 实体名称 - 存放位置 - 描述信息 - 创建人 - 创建时间 - 来源类型 - 标准标签以及标准分群的数量 ​ 其中： 1. 实体名称和描述支持修改 2. 点击标准标签以及标准分群的数量也可以跳转到对应的标签或分群管理模块 #### 实体属性 ​ 以表格的形式展示实体所包含的数据列信息: - 列名 - 别名 - 备注 - 主键 ​ 点击修改图标可以修改对应的别名和备注，并可新增之前未选择的底层数据表的对应列 #### 调度历史 ​ 当来源类型为数据工厂时，会展示该实体的调度历史。 ​ 点击编辑按钮可以修改实体的调度配置。 ## 标签体系 不同的实体有各自的标签体系，进入标签体系模块后，可以点击切换实体按钮，来对相应的实体进行标签体系规划。 超级管理员和审核人对实体管理拥有所有权限，在体系规划中，可以新建、删除、修改节点，并管理节点权限 普通用户只能查看和使用其被授权的标准标签和标准分群体系 ![tag_ref](../images_v2.0/tag/tag_ref.png) ## 标签管理 不同实体有各自的标签管理页面，可通过切换实体按钮管理相应实体下的标签。 标签管理模块包含新建标签、标签列表、标签详情等页面，以及收藏、审批、调度、删除、权限管理等功能。 标准标签和个人标签有各自不同的体系，个人标签可通过审批进入到公共的标准标签体系中。 标准标签可通过审核人进行权限管理授予普通用户相应的权限。 ### 新建标签类别 ​ 点击标签体系+号或列表右上角新建标签按钮可进入创建标签流程 ​ 本系统支持4种建标签的方式，分别为： 1. 规则创建 2. SQL创建 3. 导入创建 4. 智能创建 #### 规则创建标签 规则创建标签是最常见的创建标签类别的方式，用户可利用实体属性或已有的标准标签、分群配置相应的规则生成所需的个人标签。 ![tag_config](../images_v2.0/tag/tag_config.png) ##### 基本信息 填写标签类别的中英文名、责任部门、描述等信息 ##### 配置规则 左侧默认已有“标签1”，可以通过右侧详细页面进行标签名、描述、规则等配置； 也可以点击左下角的“添加”或“复制”按钮，可以新建新的标签。 多个标签之间可以上下拖动改变顺序，系统会按照标签的顺序进行匹配，同一实体会被优先匹配在顺序靠前的标签中。 ##### 调度配置 此处可以配置调度规则 ##### 信息总览 此页面总结并展示了前述所有步骤的配置信息，同时支持修改部分配置。 同时，在本页面可以抽样部分或选中全部数据进行标签试算，试算结果会以弹出页面的形式进行展示打标情况和结果预览信息,以查验结果是否符合预期。 如果发现与预期不一致，可返回前述步骤重新修改规则。 当然，用户也可不经试算，直接点击“保存”按钮创建标签类别。 ![tag_trial](../images_v2.0/tag/tag_trial.png) #### SQL创建标签 ​ 平台同时支持通过编写普通SQL或者存储过程的方式创建规则。 ​ 可以通过编写SQL语句，实现一些比较复杂或者特殊的标签。这种情况适用于某些用户在部署本系统之前，已经有一些SQL来生成标签。 ![tag_SQL](../images_v2.0/tag/tag_SQL.png) ##### 填写SQL 右上角选择数据源，将普通SQL查询或者存储过程填入编辑框，点击右上角按钮可试运行，运行结果展示在下方结果预览区域。 结果中必须有一列数据类型与实体主键相同，用于和实体数据进行连接生成最终标签数据。如果没有的话，则不允许进入下一步。 左侧展示了数据库树结构，对SQL编写起辅助作用。 ##### 配置标签 填写标签类别的中英文名、责任部门以及描述信息。 另外需要根据上一步的运行结果选择主键列和标签列。 ##### 调度配置 略 ##### 信息总览 同规则标签，但是SQL标签的试算不支持抽样，默认进行全部试算。 #### 导入文件创建标签 导入标签允许用户使用CSV/TXT文件将已有的标签数据导入到本系统中。导入的文件大小限制在200MB以内,超过200MB的文件将无法上传. ![tag_import_file](../images_v2.0/tag/tag_import_file.png) ##### 选择文件 ​ 选择或拖入CSV文件到页面中，页面会自动根据默认参数对文件进行解析，系统会自动判断列类型，并将解析结果展示在页面下方区域。同时支持用户修改列的数据类型，但是需要至少有一列数据与实体主键数据相匹配，否则不允许进入下一步。 ​ 如果结果数据解析有误，可修改解析参数并点击解析按钮重新解析 ##### 配置标签 首先通过下拉框选择主键列，然后通过左侧复选框选择想要创建的标签类别，并填写标签中英文名、责任部门和标签描述。 ##### 信息总览 ​ 汇总前述步骤的配置信息，并展示在本页面以供核查和修改。 ​ 注意在此处，由于是导入类型的标签，所以没有试算功能，点击“开始导入”按钮即可创建一个或多个标签类别。 #### 智能创建标签 可在Littleboy建模平台中进行标签建模及预测,然后通过规则、SQL或导入的方式创建智能标签。 ### 标签列表 点击标签管理左侧体系结构的任何一个目录，即可将此目录下包含的所有标签(有权限的)展示到右侧列表中。 标签列表可以展示标签名称、标签类型、更新次数、更新时间、责任部门、运行状态、审批状态(个人标签)、创建人(标准标签)等信息，同时支持对某些列进行排序和搜索功能。 当鼠标放置在某行标签上时，会显示可以在该标签上可进行的不同操作按钮，包括: - 运行标签：导入类型的标签无须运行 - 编辑调度：导入类型的标签无须调度 - 删除标签: 如果是标准标签，可能存在关联关系限制而无法删除；个人标签列表同时还支持批量删除 标准标签特有操作： - 权限设置：可对用户配置相应标签的权限 - 收藏功能：用户可点收藏该标签，同时该标签会被收录到左侧标准标签下我的收藏目录中 - 启用停用：标准标签支持启用和停用，普通用户只能看到已启用的标准标签, 个人标签特有操作： - 审批或查看审批：用户可通过该功能将个人标签提交审批，如果通过则成为标准标签；如果已提交审批，点击该按钮可查看审批进度；请注意，没有成功运行历史的个人标签不允许提交审批。 点击列表中的标签名称，将相应的标签详情。 ![tag_list](../images_v2.0/tag/tag_list.png) ### 标签详情 在左侧标签体系结构或者右侧标签列表中，点击任意标签名称，即可查看相应的标签详情。 ![tag_detail](../images_v2.0/tag/tag_detail.png) #### 基本信息 - 标签名称 - 存放位置 - 描述信息 - 创建人 - 创建时间 - 标签类型 - 更新时间 - 调度信息 - 责任部门 其中： 1. 标签名称、描述、调度信息、责任部门支持更新和修改 2. 标签名称可查看对应的标签规则或者SQL，但导入类型标签名称无法点击 3. 如果是标准标签，其名称右侧有收藏状态按钮，可点击收藏或取消收藏 #### 调度历史 以表格形式展示标签的运行历史记录及统计信息，包括: - 调度时间 - 某标签的当前实体数 - 某标签的新增实体数 - 某标签的减少实体数 - 总数 点击其中某个数量即可查看其中的实体，并可根据条件进行高级搜索出想要的实体，结果可全部或者部分导出。 导入标签没有调度历史，因此不会展示 #### 历史详情 以柱状图的形式将调度历史中的数据可视化显示出来，点击某个柱状图时可将该次运行的统计信息已以饼状图形式展示在右侧 #### 标签分布 以饼状图的形式默认展示最新一次的运行结果，可与左侧历史详情进行联动。 如果是导入标签，则展示其固定的统计信息。 ## 分群管理 不同实体有各自的分群管理页面，可通过切换实体按钮管理相应实体下的分群。 分群管理模块包含新建分群、分群列表、分群详情等页面，以及收藏、审批、调度、删除、权限管理等功能。 标准分群和个人分群有各自不同的体系，个人分群可通过审批进入到公共的标准分群体系中。 标准分群可通过审核人进行权限管理授予普通用户相应的权限。 ### 新建分群 ​ 点击分群体系+号或列表右上角新建标签按钮可进入创建分群流程 ​ 本系统支持2种新建分群的方式，分别为： 1. 规则创建 2. 导入创建 #### 规则创建分群 ​ 通过配置规则的方式创建相应的分群 ![segment_rule_config](../images_v2.0/tag/segment_rule_config.png) ##### 基本信息 填写分群类别的中英文名、责任部门、描述等信息 ##### 配置分群 利用实体属性或已有的标准标签、标准分群来配置相应的规则 ##### 信息总览 此页面总结并展示了前述所有步骤的配置信息用于核查，同时支持修改部分配置。 在本页面可以抽样部分或选中全部数据进行分群试算，试算结果会以弹出页面的形式进行展示，以查验结果是否符合预期。 如果发现与预期不一致，可返回前述步骤重新修改规则。 当然，用户也可不经试算，直接点击“保存”按钮创建分群。 #### 导入创建分群 导入创建分群允许用户使用CSV/TXT文件将已有的分群数据导入到本系统中。导入的文件大小限制在200MB以内,超过200MB的文件将无法上传. ![segment_import_file](../images_v2.0/tag/segment_import_file.png) ##### 选择文件 ​ 选择或拖入CSV/TXT文件到页面中，页面会自动根据默认参数对文件进行解析，系统会自动判断列类型，并将解析结果展示在页面下方区域。同时支持用户修改列的数据类型，但是需要至少有一列数据与实体主键数据相匹配，否则不允许进入下一步。 ​ 如果结果数据解析有误，可修改解析参数并点击解析按钮重新解析 ##### 配置分群 ​ 分群的中文名由文件名生成,若出现文件名不合法,需要主动修改后进入下一步 ​ 选择数据中的一列作为主键列,未选择主键列无法进入下一步 ##### 信息总览 ​ 汇总前述步骤的配置信息，并展示在本页面以供核查和修改。 ​ 注意在此处，由于是导入类型的分群，所以没有试算功能，点击“开始导入”按钮即可创建一个分群类别。 ### 分群列表 点击分群管理左侧体系结构的任何一个目录，即可将此目录下包含的所有分群(有权限的)展示到右侧列表中。 分群列表可以展示分群名称、更新次数、更新时间、责任部门、运行状态、审批状态(个人分群)、创建人(标准分群)等信息，同时支持对某些列进行排序和搜索功能。 当鼠标放置在某行分群上时，会显示可以在该分群上可进行的不同操作按钮，包括: - 运行分群 - 编辑调度 - 删除分群: 如果是标准分群，可能存在关联关系限制而无法删除；个人分群列表同时还支持批量删除 标准分群特有操作： - 权限设置：可对用户和角色配置相应分群的权限 - 收藏功能：用户可点收藏该分群，同时该分群会被收录到左侧分群分群下我的收藏目录中 - 启用停用：标准分群支持启用和停用，普通用户只能看到已启用的标准分群 个人分群特有操作： - 审批或查看审批：用户可通过该功能将个人分群提交审批，如果通过则成为标准分群；如果已提交审批，点击该按钮可查看审批进度；请注意，没有成功运行历史的个人分群不允许提交审批。 点击列表中的分群名称，将相应的分群详情。 ![segment_list](../images_v2.0/tag/segment_list.png) ### 分群详情 在左侧分群体系结构或者右侧分群列表中，点击任意分群名称，即可查看相应的分群详情。 ![segment_detail](../images_v2.0/tag/segment_detail.png) #### 基本信息 - 分群名称 - 存放位置 - 描述信息 - 创建人 - 创建时间 - 更新时间 - 调度信息 - 责任部门 其中： 1. 分群名称、描述、调度信息、责任部门支持更新和修改 2. 点击分群名称可查看对应的分群规则 3. 如果是标准分群，其名称右侧有收藏状态按钮，可点击收藏或取消收藏 #### 调度历史 以表格形式展示分群的运行历史记录及统计信息，包括: - 调度时间 - 分群当前实体数 - 分群新增实体数 - 分群减少实体数 - 总数 点击其中某个数量即可查看其中的实体，并可根据条件进行高级搜索出想要的实体，结果可全部或者部分导出。 #### 历史详情 以柱状图的形式将调度历史中的数据可视化，点击某个柱状图时可将该次运行的统计信息已以饼状图形式展示在分群分布中 #### 分群分布 以饼状图的形式默认展示最新一次的运行结果，可与历史详情进行联动。 ## 实体细查 在本页面可以针对不同实体的数据进行检索查询，可点击切换实体按钮来选择需要的实体 ### 快速搜索 可以通过实体中字符串类型的属性进行搜索，首先选择属性，填入相应的搜索内容，点击搜索即可查询到匹配的实体 ![entity_search_quick](../images_v2.0/tag/entity_search_quick.png) ### 高级搜索 可以通过复杂的规则组合来对实体进行筛选 ![entity_search_query](../images_v2.0/tag/entity_search_query.png) ### 单实体画像 在快速或者高级搜索的结果数据中，点击任一实体数据，即可查看该实体实例的画像 ![entity_user_info](../images_v2.0/tag/entity_user_info.png) #### 属性集 展示该实体实例的所有属性及属性值，并使用特殊图标标识出主键属性 #### 时间线 由于标签和分群可以多次运行，每次运行的结果有可能随时间变化 因此系统此处引入了时间线的概念，每次标签或分群的运行以时间点的形式在线上标识 当用户选择不同的时间点是，可查看该时间点该实体实例的标签集以及所属分群 #### 所属标签 展示某个时间点该实体实例上的打标的所有标签 #### 所属分群 展示某个时间点该实体实例上的打标的所有分群 ## 标签分析 ### 组合分析 组合分析的功能为通过一个或多个已有的不同标签或者分群作为条件组合，筛选出符合条件的实体集合。 ![tag_combine_analysis](../images_v2.0/tag/tag_combine_analysis.png) #### 选择组合条件 - 左侧树结构中支持通过单击选择分群或者标签作为组合条件 - 左侧树中支持针对体系结构目录名称、标签类别名称、分群名称进行搜索，但无法搜索到标签名称级别 - 为运行过的标签类别或者分群无法作为组合条件 - 同一个标签类别下只能选择一个标签作为组合条件 - 已选的标签或者分群组合会展示在右上侧的已选组合条件区域 - 已选的标签或者分群可以点击叉号进行取消选中，同时可以一键情况所有已选条件 #### 开始分析 - 点击开始分析按钮开始组合分析，分析完成后会将筛选出的实体列表展示到下方分析结果列表中 #### 分析结果展示 - 组合分析结果以列表的形式展示符合条件的实体集合，支持翻页查看所有符合条件的实体 - 同时会展示当前筛选结果中的实体数量以及占实体总数的比例 - 同时支持将符合条件的实体列表下载导出或者以当前的组合条件创建为新的分群 #### 创建为新分群 - 当组合条件中包含个人标签或者个人分群时，无法以该条件组合创建为新的分群 ### 分群对比 - 对比分析可以选中两个标签或者分群进行对比，得出Simpson相似度以及各自的画像对比结果 ![segment_contrast](../images_v2.0/tag/segment_contrast.png) #### 选择分群 - 点击左右两侧的按钮选择需要进行对的标签或者分群 - 选中标签或者分群后会以卡片的形式展示其基本信息 - 已选中的标签或者分群可以通过其左上角的叉号删除并重新选择 - 同时可通过右上角的清空按钮清空目前的所有选项及分析结果 - 没有成功运行历史的标签或者分群无法选择 #### 开始分析 - 点击右上角的开始分析按钮进行对比分析 #### 结果展示 - Simpson相似度以及画像对比会展示在页面下方 - 画像对比支持左右单独排序对照或者左右双排序对比(默认)，可通过对比结果右上角三个按钮进行切换查看 ### 相似发现 ![tag_similiar_search](../images_v2.0/tag/tag_similiar_search.png) #### 选择标签或者分群 - 点击按钮选择需要进行分析的标签或者分群 - 选中之后会展示标签或分群的基本信息 - 没有成功运行历史的标签或者分群无法选择 - 右上角清空按钮可清空当前的选项及分析结果 #### 开始分析及结果展示 - 点击开始分析后下方会展示当前标签或分群的画像，以及当前标签或分群下的实体列表 #### 画像探索及新建分群 - 画像的内容为与当前标签或分群重合度较高的标签或分群的排序 - 选中画像中不同的标签或分群可以进行组合分析 - 组合分析的结果为当前标签或分群的相似实体列表，支持预览及下载 - 当前的组合条件可以直接创建为新的分群 - 当组合条件中包含个人标签或者个人分群时，无法以该条件组合创建为新的分群