新建和管理标准代码(码表)

码表也称lookup表、数据字典表,一般由中英文名称编码组成,由可枚举数据构成,存储枚举数据名称与编码的映射关系。码表可用于标准属性值取值范围的约束。本文为您介绍如何新建和管理标准代码(码表)。

权限说明

  • 超级管理员、数据标准管理员支持新建及管理所有码表和码表目录。

  • 标准集维护人员可以在已加入的码表下编辑或删除码表。

  • 超级管理员、数据标准管理员和导入导出记录的操作人可查看导入详情或下载导出文件。

使用限制

  • 创建码表目录层级不超过10级。

  • 所有层级的码表目录总数不超过1000层。

  • 每个码表最多添加10000个码值,并且单个码表下的码值不可重复。

码表列表

码表列表为您提供编辑查看两种展示模式,在码表页面,单击右上角image图标进行切换查看。

查看模式下,可以查看已配置的码表目录和码表信息,但不支持操作,适用于浏览的场景。

编辑模式下,除了查看已配置的码表目录和码表外,支持对码表执行查看引用、编辑、导出码表、删除操作,可对码表目录执行编辑、删除等操作。仅有码表管理权限的账号可以进入编辑模式,下图以编辑态为例。

image

区域

描述

筛选及搜索区

您可根据码表的名称、编码进行搜索,也可根据码表所属目录、负责人等对码表范围进行筛选。

码表目录

码表目录从业务或组织架构视角出发,对码表进行分类、分层管理。

  • 您可单击展开全部分类image..png或收起全部分类image..png图标,展开或收起码表目录。

  • 支持根据码表的目录名称进行搜索。

  • 全部码表:为您展示已创建的所有码表。

  • 码表目录:选中后为您展示直接归属该层级目录及其子目录下的所有码表 。特殊的,若某个码表直接归属码表根目录,可通过单击全部码表进行查询。如需创建目录,请参见管理码表目录

  • 鼠标悬停至码表目录,您可查看该码表目录信息,包括该目录下包含的码表数、目录的最近更新人和最近更新时间。

    image.png

码表列表

为您展示码表的名称、所属目录、状态、码值数、负责人、最近更新人/时间、描述信息。同时,您可对码表执行查看详情、查看引用、编辑、导出、删除操作。

  • 查看详情:单击操作列下的image图标,查看码表详情、引用信息。

  • 查看引用:单击操作列下的image图标,查看码表被标准模板引用的详情,单击标准模板的名称,可快捷查看标准模板信息,包括模板的属性信息、引用信息、历史版本。

  • 编辑:单击操作列下的image图标,支持修改码表的配置信息。

  • 导出:单击操作列下的image图标,选择导出,可将码表及码值信息导出为Excel文件,方便信息维护和发送给相关业务人员查询。支持单击操作列下的导出,导出单个码表或单击底部的批量导出按钮,批量导出码表。导出配置详情请参见批量导出码表

  • 删除:单击操作列下的image图标,选择删除,码表删除后不可撤销,请谨慎操作。

管理码表目录

  1. 在Dataphin首页,单击顶部菜单栏治理 > 数据标准

  2. 单击左侧导航栏的标准代码(码表),在码表目录页签,单击编辑图标。

  3. 您可以对码表目录进行新建、移动、编辑、删除操作。

    image.png

    区域

    描述

    搜索区

    您可根据码表目录的名称关键字进行搜索。

    操作区

    您可对目录执行新建、编辑、移动、删除操作。

    • 新建:请填写目录的名称。同一目录下的同级目录不支持重名。不支持输入字符正斜杠(/),128个字符以内。

      支持添加目录至指定层级的下一级。若未选择归属目录,将直接归属码表根目录。

    • 编辑:可修改目录的名称。

    • 移动:支持移动码表的所属上级目录。

    • 删除:若当前目录下有子目录或码表,则不支持删除。

新建码表

  1. 在Dataphin首页,单击顶部菜单栏的治理 > 数据标准

  2. 单击左侧导航栏的标准代码(码表),再单击+新建码表按钮。

  3. 新建自定义码表对话框中,填写参数。

    参数

    描述

    码表名称

    码表的名称,不超过128个字符,所属上级目录下名称唯一。例如:全国地区代码表。

    码表编码

    用于唯一识别码表,输入不超过128个字符,支持输入英文字母、数字和任意半角符号。例如:DQ001。

    所属目录

    选择码表归属的目录,若当前定位在某个码表目录下,创建码表时默认填充该码表目录;若未选择归属目录,将直接归属根目录。如需新建目录,请参见管理码表目录

    负责人

    选择码表的负责人。

    描述

    可添加码表含义的描述,输入不超过1000个字符。

    代码信息

    • 填写序号代码值代码名称代码英文名称代码描述信息。同时可对代码信息进行编辑和删除操作。

      • 代码值:必填,最多输入64个字符,支持输入中文、英文字母、数字、特殊字符:-、_、()、空格’,码表内唯一。

      • 代码名称:必填,最多输入64个字符,支持输入中文、英文字母、数字、特殊字符-、_、()、空格’

      • 代码英文名:非必填,最多输入64个字符,支持输入英文字母、数字、任意半角符号。

      • 代码描述:非必填,最多可输入256个字符。

    • 单击image图标,增加码值数量。

      例如:代码值:2900,代码名称:上海市,代码英文名称:Shanghai City,代码描述:用2900标识上海市。

  4. 单击保存并发布,完成码表的创建。

批量导入码表

  1. 码表列表页面,单击批量导入导出,选择批量导入码表

  2. 批量导入码表对话框,配置相关参数。

    参数

    描述

    导入场景

    不同导入场景对应的配置模板不同,其中下载的更新模板文件将包含所有已选中的码表信息,您只需要修改需要修订的信息,再重新导入即可。支持新增更新两种导入场景。

    导入场景仅影响配置模板的生成,实际导入过程中,将根据码表编码是否存在决定是新增还是更新。

    STEP 1 下载配置模板--新增

    配置模板

    若没有模板,可点击文件名称或下载image.png图标下载.xlsx文件;若已有模板,可直接执行上传配置文件并导入。

    说明

    导入码表需要有创建或编辑码表的权限,否则会使权限校验失败,无法导入。

    STEP 1 下载配置模板--更新

    更新范围

    选择需要更新的码表,单次选择码表个数不超过20个。

    配置模板

    根据所选的码表范围生成,点击生成模板,生成.xlsx格式的模板文件后下载。

    说明
    • 若没有模板,可点击文件名称或下载image.png图标下载.xlsx文件;若已有模板,可直接执行上传配置文件并导入。

    • 导入码表需要有创建或编辑码表的权限,否则会使权限校验失败,无法导入。

    STEP 2 上传配置文件

    上传文件

    • 每个码表对应一个单独的.xlsx文件,如果文件类型不一致则无法导入。

    • 单次上传不超过20个文件,单个文件不超过20M。

    • 每个码表支持填写10000个码值。

    • 填写模板时,请遵循每个字段的填写规范,如果移动了行列位置、修改了列名称、或增删行列,会导致解析失败无法导入。

    • 码表基本信息:导入过程中,会首先针对码表的基本信息进行校验,只有校验通过的文件才可以执行码值的导入。

      • 码表名称:必填,需要和码表编码一一匹配,最多输入128字符,在所属目录下唯一;仅支持导入有操作权限的码表。

      • 码表编码:必填,全局唯一,根据码表编码识别码表对象,最多输入128个字符,区分大小写。导入时将根据码表编码识别码表对象,如果码表编码已经存在,则视为更新码表操作,结合冲突策略配置执行导入;如果码表编码不存在,则视为新增码表操作。

      • 码表目录:非必填,请按照/一级目录名称/二级目录名称.../的样式填写,如未填写或填写/,将直接归属根目录。

      • 码表负责人:非必填,请填写用户名称(可在成员管理页面获取ID);新增场景下如未填写,默认以批量导入操作人作为负责人进行校验;更新场景下如未填写,则保留线上已有的负责人信息。

      • 码表描述:非必填,最多输入1000个字符。

      • 码值信息:每个码值1行。码表基本信息校验通过后,会针对码值的基本信息进行校验,只有校验通过的文件才会最终导入。

        • 代码值:必填,最多输入64个字符,支持输入中文、英文字母、数字和特殊字符:-、_、()、空格’,码表内唯一。

        • 代码名称:必填,最多输入64个字符,支持输入中文、英文字母、数字和特殊字符-、_、()、空格’

        • 代码英文名:非必填,最多输入64个字符,支持输入英文字母、数字和任意半角符号。

        • 代码描述:非必填,最多输入256个字符。

    STEP 3 冲突解决策略

    校验字段

    代码值(码表内唯一,不区分大小写)。

    处理策略

    针对本次导入的代码值若和码表内已有的代码值相同时的处理策略,支持选择冲突则跳过冲突则覆盖更新

    • 冲突则跳过:如果导入的代码值和码表下已有的代码值重复,则跳过记录不处理。

    • 冲突则覆盖更新:如果导入的代码值和码表下已有的代码值重复,以本次导入的内容为准更新线上已有的代码值的其他信息,如代码名称、描述等。

  3. 单击开始解析,对本次导入的文件格式、码表信息进行校验。

    文件格式:校验本次导入的文件是否为空、文件是否包含多张码值或码表的sheet、文件格式和模板是否一致。

    码表信息:校验当前操作人是否具有管理码表的权限、是否超过码表可创建的个数及码表配置信息的合法性(包括码表编码、码表名称、码表目录、指定码表目录下是否存在同名码表、码表负责人、码表描述)。

  4. 解析通过后,对码值信息进行校验,校验通过后呼出导入结果页面。

    码值:校验代码值/代码名称是否完整、代码值/代码名称/代码英文名/代码描述是否符合输入规范、代码值是否重复、代码值个数是否超过系统限制。

    参数

    描述

    导入结果

    可查看导入进度、导入结果、执行时间。

    异常记录

    • 为您展示校验不通过而无法导入的代码值记录,包括记录在原始文件中对应的代码值、代码名称、代码英文名称、代码描述和异常提示。

    • 异常记录页签下,可单击下载异常记录,将对应的原始记录下载成文件,根据异常提示修改后重新导入。

    跳过记录

    • 如果冲突策略配置为冲突则跳过,则针对在指定码表中已经存在的代码值记录会被跳过,展示在跳过记录列表中,包括记录在原始文件中对应的代码值、代码名称、代码英文名称、代码描述和异常提示。

    • 跳过记录页签下,可单击下载跳过记录,将对应的原始记录下载成Excel文件。

    执行日志

    可查看导入过程的执行日志并复制。

    导入完成后,若您想快速查看导入结果,可关闭导入配置对话框,关闭对话框不会终止导入任务的执行。您可以在码表列表,单击批量操作记录,并选择需要查看的历史导入记录。

批量导出码表

  1. 码表列表页面,单击批量导入导出,选择批量导出码表

  2. 批量导出码表对话框,根据导出范围导出码表。

    导出范围:选择需要导出的码表范围,支持选择导出全部码表或指定选择的码表。

    说明
    • 单次导出最多选择1000个码表。

    • 每个码表为1个单独的.xlsx格式的文件,单次导出多个码表将整体压缩为.zip格式。

  3. 单击确定,完成码表的导出。您可以在批量操作记录中查看本次导出操作信息,并下载导出文件。

码表批量操作记录

支持查看每个码表的导入、导出操作记录详情。

  1. 码表列表页面,单击批量导入导出,选择批量操作记录

  2. 码表批量操作记录弹框,查看码表的导入、导出操作记录。

    • 批量导入:为您展示码表导入的操作记录详情,包括序号、创建人、导入场景、码表名称、导入的状态、创建时间、结束时间信息。同时,您可单击操作列下的查看图标,查看导入详情。

    • 批量导出:为您展示码表导出的操作记录详情,包括序号、创建人、导出范围、导出的状态、创建时间、结束时间信息。同时,您可单击操作列下的下载图标,下载导出文件至本地。

      说明
      • 导出的码表文件系统存储7天,超过7天将无法下载。

      • 仅导出成功状态的记录支持下载导出文件。

后续步骤

码表创建完成后,您可以在配置标准模板属性的取值约束时,选择对应的码表,详情请参见创建及管理标准模板