ICS 35.020 CCS L 70 2201 长 春 市 地 方 标 准 DB 2201/T 19—2022 城市智能体数据指标卡片管理规范 Management specification of urban agent data index card 2022 - 01 - 14 发布 2022 - 01 - 30 实施 长春市市场监督管理局 发 布 DB 2201/T 19—2022 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件的某些内容可能涉及专利，本文件的发布机构不承担识别专利的责任。 本文件由长春市政务服务和数字化建设管理局提出并归口。 本文件起草单位：长春市政务服务和数字化建设管理局、成都四方伟业软件股份有限公司。 本文件主要起草人：蒋杰、王军、杨仕峰、丁慧东、柳羽辉、孟红月、杨烁、冷皓。 I DB 2201/T 19—2022 引 言 为了提高长春市各级政府及各单位对共享数据的利用率，提升各部门对共享数据指标的开发应用 水平，将数据指标按照规范封装成可视化卡片，并以卡片形式提供数据共享服务，降低对业务人员IT技 术水平的要求，使业务人员能够快速搭建可视化数据看板、管理者驾驶舱等应用场景，为了使不同部门 开发的指标卡片实现共享，特制定本文件。 II DB 2201/T 19—2022 城市智能体数据指标卡片管理规范 1 范围 本文件规定了指标卡片的缩略语、卡片化相关方、数据指标卡片设计、数据指标卡片管理、数据指 标卡片使用的内容。 本文件适用于长春市政务数字化建设中所使用指标卡片的设计、管理和使用。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 数据指标 一个可以量化目标事物多少的数值。 数据指标卡片 将业务数据指标实现可视化效果的数据图表单元。 注：数据指标卡片的数据图表单元，自带样式、数据及权限内容，且可实现交互。 数据指标卡片化 数据指标卡片封装成可视化系统能够调用的过程。 卡化编辑器 实现数据指标卡片的样式设计、事件、交互传参、封装的工具。 数据共享交换平台 长春市政务服务和数字化建设管理局建设的数据共享交换平台。 4 缩略语 1 DB 2201/T 19—2022 下列缩略语适用于本文件。 API：应用程序接口（Application Programming Interface） SDK：软件开发工具包（Software Development Kit） 5 卡片化相关方 可视化卡片平台 提供卡片设计、封装、存储和管理的平台。 卡片提供方 数据拥有者，负责提供数据及使用权限，设计卡片的样式、事件、交互，并发布到卡片平台，提供 服务。 卡片管理方 拥有数据指标卡片的管理权限，并可以定义数据卡片的使用范围。 卡片使用方 使用卡片进行数据看板设计。 第三方系统 调用和使用卡片的非 5.1 可视化卡片平台 规定的平台/系统。 6 数据指标卡片设计 数据指标设计 6.1.1 指标的构成 数据指标由维度、汇总方式和量度构成。 6.1.2 指标的类型 数据指标的主要类型有基础指标、复合指标和派生指标。 a) 基础指标指不能再拆解的指标。 b) 复合指标是建立在基础指标之上，通过一定运算规则形成的计算指标集合。 c) 派生指标是指基础指标或复合指标与维度、统计项、管理属性等相结合产生的指标。 6.1.3 指标的属性 6.1.3.1 基础属性 基础属性包括： a) 数据指标编码：根据数据指标编码命名规则进行编写； b) 中文名称：数据指标中文名称； 2 DB 2201/T 19—2022 c) d) e) f) g) 英文名称：数据指标英文名称； 应用场景：数据指标适用的场景； 数据版本：数据指标的版本信息； 数据指标分类：根据数据指标分类规则进行分类，以保证易用性，以及符合用户查找习惯； 数据指标级别：按开放程度定义，如市本级、区县等。 6.1.3.2 管理属性 管理属性包括： a) 数据提供部门：该数据标准定义数据的提供部门； b) 数据提供部门负责人：该数据标准定义数据提供负责人； c) 数据维护部门：该数据标准定义数据维护部门； d) 数据维护部门负责人：该数据标准定义数据维护负责人； e) 业务主管部门：该数据标准定义数据业务主管部门，该部门对数据口径、编码取值和相关专业 术语有决定权； f) 业务主管部门负责人：该数据标准定义数据业务负责人； g) 指标生成系统：最终对指标进行计算和发布的系统，也是各部门唯一获取指标的来源系统； h) 数据生成系统：指标生成所需的数据的来源系统。 6.1.3.3 业务属性 业务属性包括： a) 主要依据：关于指标的解释或依据的文件； b) 业务定义：指标的业务描述口径，一般由业务部门使用业务语言制定； c) 计算流程/算法：用来描述指标的计算过程。 6.1.3.4 技术属性 技术属性包括： a) 计量单位：数据使用单位。如：“万元”、“分钟”、“万人”、“月”、“次”、“%”等； b) 精度：指标值精确到保留几位小数； c) 数据值域：数据指标的合理取值范围； d) 统计周期：数据统计周期。如“日”、“周”、“月”、“季度”、“半年”、“年”等； e) 统计粒度：数据统计粒度。如：“街道级”、“区县级”、“市级”等； f) 统计维度：数据统计维度。如：“地域”、“分类级别”、“主题专题”、“业务职能”等。 卡片设计发布 采用卡片编辑器设计发布卡片，设计发布流程如下： a) 打开卡片编辑器，在右侧面板中设置卡片的大小； b) 将单个或多个合适的组件拖入到画布区进行设计； c) 绑定组件数据； d) 自定义设置组件的样式、颜色，如坐标轴、图例、提示框等； e) 根据具体的业务，配置组件的事件、动作； f) 填写卡片相关属性信息； 3 DB 2201/T 19—2022 g) 将设计完成的卡片在可视化卡片平台发布。 卡片主要属性及 API 6.3.1 卡片 API 属性见表 1。 表1 卡片 API 属性表 属性名称 类型 描述 示例 id String 卡片 id ’bar_xxx’ type String 卡片类型 ’bar’ version String 卡片版本 ’1.0.0’ config any 卡片配置 {} $element JQuery 卡片 DOM 元素 $(’<div></div>’) $parent JQuery 外部框架创建的卡片根节点 children Array<Component> 子卡片 [] 6.3.2 卡片 API 见表 2。 表2 卡片 API 表 函数名称 constructor() 参数 描述 构造卡片实例、生成配置 init() 卡片开始初始化 destroy() 卡片销毁 getConfig() 获取配置 updateConfig(key,value) key: string value: string 更新配置 render() 渲染卡片 buildDefaultConfig() 构造卡片的默认配置 resize() width:number height:number 修改大小 reposition() x:number y:number 调整位置 getConfigSnapshot() 获取配置的快照 getParent() 获取$parent registEvent() 注册事件 dispatchEvent() eventType: string event: any Dispatch 事件给 EventManager receiveEvent() 接收来自 EventManager 的事件 getModelConfig() 获取卡片实例上的模型配置 updateModelConfig(key,value) 更新卡片模型数据，支持全局修 改和局部按照命名空间修改值 4 DB 2201/T 19—2022 6.3.3 卡片文件结构规范见表 3。 表3 卡片文件结构规范表 目录/文件 common/ design/ 说明 Component.ts 基类组件 style.less 基类样式 DesignComponent.ts settings/ 设计器组件（派生 自基类） basic.ts 基础设置的配置 event.ts 事件设置的配置 model.ts 模型设置的配置 设计器组件样式 runtime/ RuntimeComponent.ts 运行器组件（派生 自基类） Style.less 运行器组件样式 public/ 静态资源目录 manifest.json 配置文件 注1：basic.ts为卡片抽象的基础及样式配置项，卡片可以把基础属性宽高，边框等属性抽象为 配置项； 注2：events.ts:为卡片抽象出来的事件动作、事件配置类型的配置文件，系统通过读取配置文 件给卡片生成配置项 注3：model.ts:为卡片抽象出来的数据模型配置项，通过该配置项，系统能读取到该卡片的绑定 列、渲染告警等信息。 6.3.4 卡片实例对象结构见表 4。 表4 卡片实例对象结构表 名称 含义 "id" "卡片 Id" "name" "卡片名称" "config" "卡片配置" "cardFromSys" "创建卡片的业务系统" "cardDesc" "卡片备注" "groupId" "卡片分组 Id" "iconUrl" "卡片图标 url" "createUserId" "创建卡片的用户 Id" "createTime" "创建卡片的时间" "updateUserId" "更新卡片的用户 Id" "updateTime" "更新卡片的时间" "releaseUserId" "发布人" 5 DB 2201/T 19—2022 表 4 卡片实例对象结构表（续） 名称 含义 "releaseTime" "发布时间" "version" "卡片发布的版本信息" "codeJsOrder" "代码注入 js 顺序" "codeCssOrder" "代码注入 css 顺序" "filesJson" "页面引用图片信息 JSON" "svgJson" "svg 信息" 7 数据指标卡片管理 存储 7.1.1 卡片存储，依据“谁的卡片，谁负责”原则，