数字政府应用服务规范 第4部分：电子表单服务接口规范（征求意见稿）

T/ZGCSA1.4—2024数字政府应用服务规范第4部分：电子表单服务接口规范本文件适用于全国各级党政机关、企事业单位、国土、财政、水利、统计等行业以及NGO的信息系统规划、建设，以及系统集成商、软件开发商和监理单位进行数字政府信息系统的开发与整合。在涉及国家秘密的信息系统规划、建设中，需参照《涉及国家秘密的信息系统分级保护管理办法》和相关标准、规定。2规范性引用文件下列文件中的条款通过本部分的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本部分，然而，鼓励根据本部分达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。GB/T13016—1991标准体系表编制原则和要求GB/T19488.1—2004电子政务数据元第1部分:设计和管理规范GB/T20000.1—2002标准化工作指南第1部分：标准化和相关活动的通用术语GB/T21062.1—2007政务信息资源交换体系第1部分：总体框架GB/T21063.1—2007政务信息资源目录体系第1部分:总体框架GB/T21064—2007电子政务系统总体设计要求3术语和定义表单模板（FormTemplate）：定义了表单的基本结构和属性，包括样式、数据项、校验、计算等内容，用来载入表单数据并在权限控制下动态生成表单文档。表单模板可采用JSON格式、XML格式或者其他格式进行描述，通过标签或控件及相应的属性值进行定义，如一般发文签批单。表单文档（FormDoc是表单模板的应用实例。表单文档是由表单模板和表单业务数据在权限控制下动态生成的文档，包括含有表单业务数据静态存储的电子文档，用于为最终用户提供显示、录入、修改的人机界面，如一份发文。表单业务数据（FormBusinessData表单文档中的业务数据部分，一份表单文档对应于一份表单业务数据，采用JSON格式进行表示。T/ZGCSA1.4—2024JSON（JavaScriptObjectNotation是一种轻量级的数据交换格式。易于人阅读和编写，可以在多种语言之间进行数据交换，同时也易于机器解析和生成。4电子表单服务的组成部分图1电子表单服务的各组成部分示意图参照图1，电子表单服务由三部分组成：表单设计器、表单填写器、表单服务器。表单设计者通过表单设计器在线或者离线设计表单模板（FormTemplate通过表单服务器上传到服务器端，放入到文档库中的表单模板库。文档库可以使用数据库、文件系统或其他的存储方式，如果需要采用数据库分离存储表单中的数据，表单设计器则需提供数据映射功能。表单使用者通过表单填写器调用表单模板进行填写操作，通过表单服务器提交表单数据并保存到表单实例库；使用者可以通过表单填写器浏览、查找、修改已经填写的表单文档。5电子表单服务接口5.1表单模板管理服务5.1.1获取表单模板对象接口地址：https://ip:port/itemAdmin/services/rest/formDefine/getById请求方法：GETContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：获取表单模板对象参数说明T/ZGCSA1.4—2024参数名称类型描述string表单模板id返回值说明字段类型描述successboolean操作是否成功codeint32错误代码msgstring操作描述datastirng表单模板json字符串5.1.2获取所有表单模板接口地址：https://ip:port/itemAdmin/services/rest/formDefine/findAll请求方法：GETContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：根据事项唯一标识（事项id）和流程序列号获取数据参数说明参数名称类型描述无参数返回值说明字段类型描述successcodemsgdatabooleanint32stringList<strin操作是否成功错误代码操作描述表单模板json集合5.1.3查询表单模板接口地址：https://ip:port/itemAdmin/services/rest/formDefine/search请求方法：GETContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：根据唯一标识（表单id）获取绑定字段信息参数说明参数名称类型描述namestring表单模板名称systemNamestring系统名称T/ZGCSA1.4—2024返回值说明字段类型描述booleanint32stringList<strinbooleanint32stringList<strin操作是否成功错误代码操作描述表单模板json集合msgdata5.2表单业务数据管理服务5.2.1保存表单业务数据接口地址：https://ip:port/itemAdmin/services/rest/formData/save请求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：获取子表数据参数说明参数名称类型描述formIdstring表单模板idformDataJson返回值说明string表单业务数据json字符串字段类型描述booleanint32stringbooleanint32stringstringsuccesscodemsgdata操作描述操作成功返回的数据5.2.2获取表单业务数据接口地址：https://ip:port/itemAdmin/services/rest/formDate/getData请求方法：GETContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：获取表单业务数据参数说明参数名称类型描述formIdstring表单模板idguidstring业务数据idT/ZGCSA1.4—2024返回值说明字段类型描述booleanint32stringbooleanint32stringobjectobjectobjectsuccesscodemsgdata操作描述操作成功返回的数据Amapanyobject.5.2.3删除表单业务数据接口地址：https://ip:port/itemAdmin/services/rest/formData/delete请求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：删除表单业务数据参数说明参数名称类型描述formIdstring表单模板idguidstring业务数据id返回值说明字段类型描述successboolean操作是否成功codeint32错误代码msgstring操作描述datastring操作成功返回的数据T/ZGCSA1.4—2024参考文献[1].电子政务主题词表编制规则(GB/T19486-2004)[2].信息技术程序设计语言、环境与系统软件接口独立于语言的数据类型(GB/T18221-2000)[3].现代设计工程集成技术的软件接口规范(GB/T18