1、 ICS 35.020 CCS L 70 37 山东省 地方标准 DB 37/T 4410 2021 自然资源应用系统接入规范 2021 - 10 - 18 发布 2021 - 11 - 18 实施 山东省 市场监督管理局 发 布 DB 37/T 4410 2021 I 目 次 前言 . II 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 缩略语 . 1 5 平台架构 . 2 6 已有业务应用接入流程 . 2 7 新建业务应用接入流程 . 4 8 接入要求 . 5 附录 A（资料性） 资源说明 . 7 附录 B（资料性） 服务调用规范 . 8 附录 C（资料性） U
2、I要求 . 10 DB 37/T 4410 2021 II 前 言 本文件按照 GB/T 1.1 2020标准化工作导则 第 1部分：标准化文件的结构和起草规则的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由山东省自然资源厅提出并组织实施。 本文件由山东省自然资源标准化技术委员会归口。 本文件起草单位：山东省国土空间数据和遥感技术研究院、浪潮软件科技有限公司。 本文件主要起草人：史辉、吴建廷、孙振喜、薛秀荣、杨仕勇、王蒙、张妍、张华、甄明扬、刘晓 宇。 DB 37/T 4410 2021 1 自然资源应用系统接入规范 1 范围 本文件规定了山
3、东省国土空间基 础信息平台应用接入的架构、流程和要求。 本文件适用于需要接入山东省国土空间基础信息平台的自然资源业务应用系统。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 22239 信息安全技术 网络安全等级保护基本要求 GB/T 28452 信息安全技术 应用软件系统通用安全技术要求 3 术语和定义 下列术语和定义适用于本文件。 3.1 应用接入 application access 满足山东省国土空间基础信息平台接
4、入要求的自然资源业务应用接入平台并实现统一管理和运维 的过程。 3.2 单点登录 single sign on 一种统一认证和授权机制。访问不同应用的同一用户，只需登录一次即可访问所有相互信任的应用 系统，无需重复登录。 3.3 国土空间基础信息平台 basic information platform for territorial space 利用云计算、大数据等技术，实现公共服务和数据资源统一配置、调度、管理和监控的开放、共享， 形成 “全 域管控、全要素治理、全过程服务”的数字化国土空间治理体系服务平台。（简称“平台”） 3.4 自然资源业务应用 application of natu
5、ral resources business 为山东省自然资源厅提供政务办公、业务管理、资源监管和公共服务的信息化系统。 3.5 应用部署 application deployment 自然资源业务应用使用平台提供资源，将其软件项目本身，进行收集、打包、安装、配置的过程。 3.6 应用上线 application on-line 测试通过后的自然资源业务应用交付给用户正式上线使用的过程。 4 缩略语 DB 37/T 4410 2021 2 下列缩略语适用于本文件。 HTML：超文本标记语言 (HyperText Markup Language) HTTP：超文本传输协议（ HTTP， Hype
6、rText Transfer Protocol） JSON：轻量级的数据交换格式（ JavaScript Object Notation） REST：一种针对网络应用的设计和开发方式（ Representational State Transfer） UI：用户界面（ User Interface） 5 平台架构 按照自然资源部国土空间基础信息平台建设总体方案和省级国土空间基础信息平台建设要求 的建设要求，利用“云计算”设计理念，采用“平台 +数据 +应用”的模式建成国土空间基础信息平台， 其总体架构整体分为基础服务层、数据服务层、平台支撑层、应用体系和统一门户层。基础服务层和数 据服务层向微
7、服务和通用服务提供硬件和数据的支撑。应用服务层通过业务微服务、软件通用服务和数 据服务支撑调查、规划、管理、决策和服务应用体系的系统建设。统一门户是国土空间基础信息平台的 展示层，通过门户进入各应用系统。（平台总体架构见图 1） 图 1 平台总体架构图 服务超市中的资源应用为应用开发者提供应用注册、应用配置、应用管理、平台资源申请等功能。 资源管理提供对各种资源及应用的全生命周期管理监控。云环境监控对所有基础设施资源进行统一管理 和统一运维。平台为业务人员提供统一的终端显示。通过平台整合信息资源、实现资源共享，为用户提 供个性化的信息服务，为业务管理提供信息支持，提高业务协同和数据整合的效率。
8、 6 已有业务应用接入流程 流程总述 6.1 DB 37/T 4410 2021 3 已上线运行的自然资源业务应用接入平台需按照申请部署资源、迁移应用程序包和数据库的流程， 最终迁移至平台运行。（见图 2） 图 2 已有业务应用接入流程图 开发者注册 6.2 开发者注册流程主要包括： a) 填报注册信息，包括“应用名称”“应用类别”“联系人”“联系电话”“系统状态”“开 发语言”“系统描述”等信息，详见表 1； b) 提交平台管理者审核； c) 赋予该账号开发者权限。 表 1 开发者注册信息表 注册信息 说明 应用 名称 接入平台的应用名称 应用类别 应用类别包括但不限于：政务办公、综合管理、
9、调查监测、确权登记、开发利用、空间规划、用途管制、耕地保护、地质管理、矿产保护、测绘管理、执法检查 联系人 开发者姓名 联系电话 开发者联系电话 系统状态 系统状态包括：新建、已有 开发语言 应用系统开发使用的编程语言 系统描述 系统功能等情况的综合说明 资源申请 6.3 6.3.1 概述 开发者可申请使用平台提供的资源进行应用开发，平台提供资源主要包括：基础资源、功能资源、 数据库资源、开发环境资源、业务资源和数据资源（详见附录 A），开发者根据实际需要进行申请。 6.3.2 基础资源 基础资源为平台提供的应用系统运行环境类资源。基础资源包括计算资源和存储资源，计算资源提 供云主机和云应用引
10、擎两类服务。存储资源提供 Oracle数据库和云存储两类存储服务。 6.3.3 功能资源 功能资源主要包括平台的工作流引擎服务、统一用户认证、组织机构服务、数字签名服务、短信服 务等通用服务。 功能资源对外提供 REST服务接口，采用 HTTP通讯协议进行同步通讯，实现数据交换。服务调用规范 详见附录 B。 6.3.4 开发环境 开发环境资源提供统一标准的 Java开发工具和集成开发环境。 6.3.5 业务资源 DB 37/T 4410 2021 4 业务资源为各应用系统注册的用于应用系统之间共享的各类服务资源。 6.3.6 数据资源 数据资源为平台提供的数据类服务资源，主要包括属性数据、空间
11、数据、档案数据、多媒体数据、 接口服务等资源。 应用配置 6.4 业务系统应与平台完成单点登录对接，并将功能菜单和业务办理角色配置到平台中，由平台管理员 统一管理。 应用上线 6.5 应用测试完成后，向平台提交上线申请。审核通过后将业务应用自动发布至平台门户，完成业务应 用上线。提交申请上线需填写以下内容： a) 应用名称：在门户显示的应用名称； b) 应用分类：在门户显示的应用分类； c) 应用图标：在门户显示的应 用图标。 7 新建业务应用接入流程 流程总述 7.1 未上线运行的自然资源业务应用（包括在建、待建业务应用）接入需遵循平台提供的统一开发标准， 按照集约使用、按需申请的要求，使用
12、平台提供的各类资源，基于平台部署和运行。（接入流程见图 3） 图 3 新建业务应用接入流程图 DB 37/T 4410 2021 5 开发者注册 7.2 未上线运行的自然资源业务应用接入时开发者注册过程按 6.2的规定。 应用开发 7.3 注册审核通过之后，使用用户名和密码登录国土空间基础信息平台，按需申请开发环境等资源，进 行应用开发。包括资源申请、代码检查、应用生成和应用配置四个流程。 7.3.1 资源申请 未上线运行 的自然资源业务应用接入时，其资源申请过程按 6.3章节的规定。 7.3.2 代码检查 应用开发完成后，将应用系统的代码上传到平台分配的代码仓库中，即可使用平台提供的代码检查
13、 功能，检查编写的代码，并根据代码检查的结果对代码作相应调整。 7.3.3 应用生成 代码检查通过后，可通过平台提供的应用构建功能，将应用构建、打包，生成以应用系统名称为前 缀、日期为时间戳的可基于平台部署的程序包。 7.3.4 应用配置 未上线运行自然资源业务应用接入时应用配置过程按 6.4的规定。 应用部署 7.4 应用开发完成后即可申请应用部署。平台根据应用申请部署时填写的资源要求，按需分配资源。应 用部署申请时填写的资源要求说明。 a) 镜像说明：部署的应用镜像，平台自动生成，无需填写。 b) 镜像版本：部署的应用镜像版本，平台自动生成，无需填写。 c) 应用名称：由中文、英文、数字和
14、“ _”组成 ， 2-20 个字符不含空格。 d) 域名：由数字、字母、“ -”、“ _”组成， 2-20 位不含空格，唯一标识，创建后不可修改。 e) 配置规格：选择需要的 cpu 和内存规格， cpu规格为核数，内存的规格为 GB。 f) 实例模式：选择部署模式，单例和手动，单例为平台自动部 署。手动为自己部署。 g) 申请理由：申请部署的说明。 应用上线 7.5 未上线运行的自然资源业务应用接入时，其应用上线过程按 6.5的规定。 8 接入要求 UI 要求 8.1 接入平台的业务应用应统一界面风格。新开发的业务应用在整体视觉风格上应保持一致，在色系、 页面结构、页面导航、图像、图标、标志
15、性元素和特别元素方面保持统一风格；已有业务应用根据实际 情况进行调整。（详见附录 C） 安全要求 8.2 DB 37/T 4410 2021 6 应符合 GB/T 28452、 GB/T 22239的要求。 DB 37/T 4410 2021 7 A A 附录 A （资料性） 资源说明 平台提供基础资源、功能资源、数据库资源、开发环境资源、业务资源和数据资源。业务应用在开 发时向平台按需申请资源。平台提供资源列表见表 A.1。 表 A.1 平台提供资源列表 大类 小类 资源说明 基础资源 云主机 提供云主机资源 云应用引擎 提供云应用引擎资源。应用引擎服务建立在平台弹性运行环境提供的应用容器基
16、础之上，提供多种语言的程序运行环境 功能资源 工作流引擎服务 根据流程编号获取所有待办及已办任务 、 根据组织机构编码获取已办任务 、校验流程定义是否已委托办理等 统一用户认证 验证证书签名有效期 CRL、 身份证登录验证接口 、 通过用户编码获取用户信息等 组织机构服务 获取行政区划数据 、 根据 用户 编码获取该用户所属组织机构 、 组织变更同步服务等 数字签名服务 根据印章标识获取印章信息 、 根据用户客服号以及印章类型获取印章列表 短信服务 短信发送服务 数据库资源 云存储 云应用文件存储服务，其核心是为开发者提供安全、稳定、高效的存储服务，并提供一系列丰富的对象操作和权限控制管理功能
17、 数据库 数据库服务提供多租户模式的关系数据库服务，用户可以快速申请一个关系 数据库实例，交付数据库地址、用户名密码等信息线数据库服务，采用即开即 用方式 开发环境 代码仓库申请 提供开放源代码的版本控制服务 编译环境 提供各类编译环境的下载 开发工具 提供 各类开发工具的下载 插件 提供构建工具 、 版本控制工具 、 应用服务器等插件的下载 集成开发环境 提供 集成多种插件的集成开发环境的下载 业务资源 规则资源 、 组件资源 政务办公 、 综合监管 、 执法监察 、 数据应用 、 土地管理 、 矿产管理 、 测绘管理 、 地质环境等业务相关资源 数据资源 数据资源 属性数据、空间数据、档案
18、数据、 多媒体数据 、 接口服务等资源 DB 37/T 4410 2021 8 B B 附录 B （资料性） 服务调用规范 服务调用规范见表 B.1。 表 B.1 服务调用规范表 接口名称 http:/10.10.28.134/dev/service/api/create/1.0?client_id=* 接口类型 POST/GET 接口描述 应能描述出接口的作用和功能。如 创建流程接口，用于发起流程 实例 入参 应包含参数名、中文描述、类型、约束等信息 Map params， key 分别为 ： procDefUniqueId 流程定义唯一 ID reqOrganId 流程创建人组织内码 re
19、qOrganName 流程创建人组织名称 context 上下文数据 ， Map 类型，内容为需要往流程中交互的数据 返回值 明确输出返回值，一般应为 XML、 Json 等格式文件。 Map 1) key 分别为 processId 流程实例 Id procDefUniqueId 流程定义唯一 Id procDefId 流程定义 Id procDefName 流程定义名称 procCreateTime 流程创建时间 procType 流程类型 context 上下文数据 (类型为 Map) assignmentId 委派实例 Id actList 当前环节实例列表 (发起流程时 ,只有一个环
20、节实例 ) 2) actList 为 List,内容为 Map,key 分别为 activityId 环节实例 id actDefUniqueId 环节定义唯一 Id actDefId 环节定义 Id actDefName 环节定义名称 actCreateTime 环节创建时间 actType 环节类型 assignRuleType 环节任务分配规则 assList 该环节委派实例列表 DB 37/T 4410 2021 9 表 B.1 服务调用规范表 （续） 返回值 3) assList 为 List,内容为 Map ,key 分别为 assignmentId 委派实例 Id organId
21、 组织内码 organName 组织名称 assCreateTime 委派创建时间 DB 37/T 4410 2021 10 C C 附录 C （资料性） UI 要求 UI要求包括但不限于。 a) 浏览器及版本信息应支持 IE9 及以上版本。 b) 前端 html、 CSS 样式页面应自适应浏览器，可采用响应式布局，网页应能自动识别屏幕宽度 （包括 PC和移动端），并做出相应调整的网页设计。 c) 页面的结构布局应遵循人的视觉习惯。页面排版应保持间距统一。 d) 色彩要求包括但不限于。 1) 主色。应以蓝色、浅灰和白色为主色调，蓝色参考值为 #3c9afd，灰色参考值为 #f5f5f5， 白色
22、参考值为 #ffffff；蓝色建议值为深蓝色（ H值 235）至浅蓝色（ H值 190）。 2) 辅助色。应使用橙色、绿色进行整体页面点缀，橙色参考值为 #ffb400；绿色参考值为 #14863b；内容填充色应使用浅灰色或白色，参考值范围可以从 #ffffff至 #CCCCCC，浅灰 色参考值为 #f9f9f9。 3) 黑灰色值。黑灰色参考值应在以下范围内（见图 C.1），数值应使用整数。 图 C.1 黑灰色参考值范围 e) 文字要求包括但不限于。 1) 字体。常用的字体为微软雅黑和宋体，其中宋体为默认字体。正文中所有小于 14号（包 括 14号）的文字应使用宋体，所有超过 16号字体（包括 16 号）的文字应使用微软雅黑 （特殊情况除外）。 2) 字号。所有文字不应小于 12号，尺寸统一使用复数。 3) 字色。文字颜色主要分为以下几种（见图 C.2）。 图 C.2 文字颜色范围
