DB37T 6090-2026“山东通”协同办公平台 公共组件服务要求

ICS35.240.9937CCSL67山东省地方标准DB37/T60902026"山东通协同办公平台公共组件服务要求“Shandongtong"collaborativeofficeplatform——Publiccomponentservicerequirements2026-10-12发布2026-11-12实施山东省市场监督管理局发布DB37/T6090—2026目次HYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINKHYPERLINK\l"br16".............................................................................HYPERLINK\l"br16"HYPERLINK\l"br16"13IDB37/T6090—2026前言本文件按照GB/T1.1—《标准化工作导则第部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由山东省大数据局提出并组织实施。本文件由山东省大数据标准化技术委员会归口。浪潮数字（山东）建设运营有限公司、山东省计算中心（国家超级计算济南中心）。本文件主要起草人：郑慧杰、张东、刘云、陈琦、谢厚娟、赵硕、张艺馨、扈玮、迟钰沛、潘震、高枫。IIDB37/T6090—2026""协同办公平台公共组件服务要求1范围型、组件发布、组件使用和组件运维等要求。本文件适用于各级各部门（单位）公共组件的发布、使用和维护。2规范性引用文件文件。GB/T19488.22008电子政务数据元第部分：公共数据元目录DB37/T4220—2020政务信息资源数据标准基本要求3术语和定义下列术语和定义适用于本文件。3.13.2组件component系统中实现其部分功能的能识别区分的部分。公共组件publiccomponent应用系统开发过程中能供不同系统应用的标准化组件。4缩略语下列缩略语适用于本文件。API：应用程序接口（ApplicationProgrammingInterface）JSON：轻量级的数据交换格式（JavaScriptObjectNotation）SDK：软件开发工具包（SoftwareDevelopmentKit）XML：可扩展标记语言（ExtensibleMarkupLanguage）5组件服务框架用系统。公共组件服务框架见图1。1DB37/T6090—2026各级各部门（单位）应用系统组件使用系统接入山东通平台统一认证即时通讯手写签批组件发布...组件1组件2...组件1组件2...组件1组件2......组件n组件n组件n部门1部门2部门n图1组件服务框架6组件服务类型6.1概述组件服务类型包括API组件和SDK组件等。6.2API6.2.1API接口设计应符合安全性、开放性和灵活性的原则。6.2.2API接口信息包括接口描述（描述接口的概要信息）、请求方法（给出接口的方式GET/POST/PUT/DELETE）、接口地址（接口的访问路径）、输入参数（给出参数名称/参数说明数据类型/JSON/XMLAPI组件示例见附录A。2DB37/T6090—20266.2.3接口输入参数、输出参数中允许的数据类型包括字符型、数字型、日期型、日期时间型等，具体要求应符合DB37/T4220—2020中5.2.5的要求，参数数据类型见表1。表1参数数据类型数据类型字符型说明通过字符形式表达的值的类型数字型通过从“0”到“9”数字形式表达的值的类型通过YYYYMMDD或YYYY—MM—的形式表达的值的类型，应符合GB/T19488.2—2008中5.4的要求日期型通过YYYYMMDDhhmmssYYYYMM—hh:mm:ssGB/T19488.2—2008中5.4的要求日期时间型布尔型二进制两个且只有两个表明条件的值，如True/False上述无法表示的其他数据类型，如图像、音频、视频等6.3SDKSDK包括开发工具、核心代码和示例，其中开发工具包括编程语言、集成开发环境、成本控制、依结构示例见附录B。SDK应满足以下要求：——开发工具支持主流操作系统和开发环境，且安装简单；——核心代码库提供主流语言版本、覆盖SDK承诺的所有服务功能。7组件发布7.1公共组件发布应按照组件申请、组件开发、组件测试、组件发布的流程接入“山东通”平台，公共组件发布流程符合附录CD的要求将公共组件发布申请表提交“山东通”主管部门审核，明确申请部门、组件名称、组件描述信息等。7.2各级各部门（单位）应与“山东通”平台进行公共组件适配对接，明确适配信息，由“山东通”平台统一配置。——API务公开路径、鉴权方式等信息。——SDK组件适配时，各级各部门（单位）明确公开路径、鉴权方式等信息。7.3各级各部门（单位）组件发布前应对公共组件及其承载系统的功能、性能和安全性进行测试，并将测试报告、等保报告、密评报告等提交至“山东通”主管部门审核。7.4各级各部门（单位）公共组件应以服务目录的形式发布。公共组件服务目录包括组件编码、组件检索，服务目录编码由“SDT”＋“—”＋“组件类型”＋“—”＋“序列码”组成。公共组件服务目录见附录。注1：“组件类型”分为APISDK组件。注2：“序列码”由4位数字码组成。8组件使用3DB37/T6090—20268.1各级各部门（单位）可按照组件名称、功能描述等关键字段或按照主题、部门分类，通过“山东通”平台对公共组件进行查询。8.2各级各部门（单位）应按照组件申请、联调测试的流程使用公共组件，公共组件使用流程符合附录FG的要求将公共组件使用申请表提交“山东通”主管部门审核，明确申请部门、应用全称、申请说明等。8.3采用API平台配置调用权限、IP白名单等信息后，方可调用API接口。采用方式使用公共组件时，各级各SDK台对公共组件的功能和安全性进行对接联调。8.4各级各部门（单位）应对本部门（单位）发布的公共组件的运行状态和性能指标进行实时监测。8.5可根据分析报告对已发布的公共组件进行优化升级。9组件运维9.1目录维护录相关内容。9.2组件维护9.2.1“山东通”平台应对公共组件进行日常巡检、运行监测，确保公共组件安全稳定运行。公共组级各部门（单位）整改，整改通过后应重新提交上架申请。9.2.2各级各部门（单位）应对公共组件进行监控管理，出现问题时，应执行对应的应急处置方案。9.2.3“山东通”平台应支持公共组件的版本追溯、回滚以及多版本并存。9.2.4“山东通”平台应对公共组件相关的技术文档、使用说明和接口规范进行维护管理，确保信息完整可查。9.3组件变更9.3.1涉及公共组件名称调整等一般变更情况，各级各部门（单位）应通知“山东通”平台进行变更处理。9.3.2公共组件地址变更、功能调整等较大变更情况时，经“山东通”平台审核后，重新上架发布。4DB37/T6090—2026附录A（资料性）API组件示例A.1文档转换文档转换接口信息见表。表A.1文档转换接口接口描述接口方式接口地址文档转换POST/cps/v2/office/convert输入参数参数名称文件平台数据类型字符型字符型字符型字符型字符型约束必选必选必选必选必选说明——任务ID最长255个字符，不能重复文档地址——文件名带后缀转换后文件格式——由应用自定义，64字、下划线业务唯一标识字符型必选返回参数说明{"result":"0","msg":"Success"}A.2上传文件请求上传文件请求接口信息见表A.2。表A.2上传文件请求接口接口描述接口方式接口地址上传文件请求POST配置域名+/open+/drive/v2/corpgroups/:group_id/files/upload/request输入参数参数名称数据类型约束说明5DB37/T6090—2026表A.2上传文件请求接口（续）参数名称团队id数据类型字符型字符型字符型字符型字符型约束必选必选必选可选必选说明——企业授权凭证访问令牌父目录id文件名称————默认为根目录——文件大小不能超过文件上传大小上限文件大小整数型字符型必选必选文件sha1——返回参数说明{"uploadinfo":{"url":"string","params":"{}","headers":"{}","store":"string"},"result":"0"}6DB37/T6090—2026附录B（资料性）SDK开发包核心代码结构示例SDK开发包核心代码结构示例如下。|--src/main/java/||--com.inspur.dgov.sdk/|||--builder/||||--DgovCredibleHttpClientBuilder.java//http请求客户端构建||||--DgovCredibleUploadHttpPost.java|||--enums///文件上传请求客户端||||--AicMode.java||||--Algorithm.java|||--util///鉴权方式枚举//签名方式枚举||||--ByteUtil.java||||--DgovCredibleConstant.java||||--RandomUtil.java||||--SMUtils.java||||--StringUtils.java|||--SignatureExec.java//字节工具类//系统常量//随机字符串工具类//加密工具类//字符串工具类//请求构建签名逻辑7DB37/T6090—2026附录C（规范性）公共组件发布流程公共组件发布流程见图。各级各部门（单位）山东通主管部门山东通平台开始组件申请提交通过审核组件上架申请未通过组件注册组件适配组件开发对接测试对接测试组件运营维护组件发布测试通过组件发布组件日常监测组件整改发现问题结束图C.1公共组件发布流程8DB37/T6090—2026附录D（规范性）公共组件发布申请公共组件发布申请见表。表D.1公共组件发布申请表申请部门组件名称ab组件描述信息组件开发单位cd技术联系人及联系方式提交资料e□测试报告□等保报告申请部门意见（签字、盖章）（签字、盖章）本级大数据主管部门意见备注：abcde应为组件提供部门全称，按照“XX市区（县）部门”的格式。应为中文名称，简明规范。应概要描述组件功能。应明确组件开发单位全称。包括组件发布包信息、组件运行环境信息、组件文档信息等。9DB37/T6090—2026附录E（资料性）公共组件服务目录E.1公共组件服务目录模板公共组件服务目录模板见表E.1。表E.1公共组件服务目录模板序号组件编码组件类型组件名称组件描述E.2公共组件服务目录示例公共组件服务目录示例见表E.2。表E.2公共组件服务目录示例序号组件编码组件类型组件名称即时通讯组件描述可提供token服务1SDT-API-0001APISDK可提供唤起签批组件、签批文件发送提交、获取文件在线预览URL和获取常用意见等服务2SDT-SDK-0001手写签批10DB37/T6090—2026附录F（规范性）公共组件使用流程公共组件使用流程见图。各级各部门（单位）山东通主管部门山东通平台开始组件详情查看未通过通过组组件调用申请审核件申请对接组件信息联调测试通过正式环境使用联调测试结束图F.1组件使用流程11DB37/T6090—2026附录G（规范性）公共组件使用申请公共组件使用申请见表。表G.1公共组件使用申