數(shù)字政府應(yīng)用服務(wù)規(guī)范 第4部分：電子表單服務(wù)接口規(guī)范（征求意見稿）

T/ZGCSA1.4—2024數(shù)字政府應(yīng)用服務(wù)規(guī)范第4部分：電子表單服務(wù)接口規(guī)范本文件適用于全國各級黨政機關(guān)、企事業(yè)單位、國土、財政、水利、統(tǒng)計等行業(yè)以及NGO的信息系統(tǒng)規(guī)劃、建設(shè)，以及系統(tǒng)集成商、軟件開發(fā)商和監(jiān)理單位進行數(shù)字政府信息系統(tǒng)的開發(fā)與整合。在涉及國家秘密的信息系統(tǒng)規(guī)劃、建設(shè)中，需參照《涉及國家秘密的信息系統(tǒng)分級保護管理辦法》和相關(guān)標準、規(guī)定。2規(guī)范性引用文件下列文件中的條款通過本部分的引用而成為本部分的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本部分，然而，鼓勵根據(jù)本部分達成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本部分。GB/T13016—1991標準體系表編制原則和要求GB/T19488.1—2004電子政務(wù)數(shù)據(jù)元第1部分:設(shè)計和管理規(guī)范GB/T20000.1—2002標準化工作指南第1部分：標準化和相關(guān)活動的通用術(shù)語GB/T21062.1—2007政務(wù)信息資源交換體系第1部分：總體框架GB/T21063.1—2007政務(wù)信息資源目錄體系第1部分:總體框架GB/T21064—2007電子政務(wù)系統(tǒng)總體設(shè)計要求3術(shù)語和定義表單模板（FormTemplate）：定義了表單的基本結(jié)構(gòu)和屬性，包括樣式、數(shù)據(jù)項、校驗、計算等內(nèi)容，用來載入表單數(shù)據(jù)并在權(quán)限控制下動態(tài)生成表單文檔。表單模板可采用JSON格式、XML格式或者其他格式進行描述，通過標簽或控件及相應(yīng)的屬性值進行定義，如一般發(fā)文簽批單。表單文檔（FormDoc是表單模板的應(yīng)用實例。表單文檔是由表單模板和表單業(yè)務(wù)數(shù)據(jù)在權(quán)限控制下動態(tài)生成的文檔，包括含有表單業(yè)務(wù)數(shù)據(jù)靜態(tài)存儲的電子文檔，用于為最終用戶提供顯示、錄入、修改的人機界面，如一份發(fā)文。表單業(yè)務(wù)數(shù)據(jù)（FormBusinessData表單文檔中的業(yè)務(wù)數(shù)據(jù)部分，一份表單文檔對應(yīng)于一份表單業(yè)務(wù)數(shù)據(jù)，采用JSON格式進行表示。T/ZGCSA1.4—2024JSON（JavaScriptObjectNotation是一種輕量級的數(shù)據(jù)交換格式。易于人閱讀和編寫，可以在多種語言之間進行數(shù)據(jù)交換，同時也易于機器解析和生成。4電子表單服務(wù)的組成部分圖1電子表單服務(wù)的各組成部分示意圖參照圖1，電子表單服務(wù)由三部分組成：表單設(shè)計器、表單填寫器、表單服務(wù)器。表單設(shè)計者通過表單設(shè)計器在線或者離線設(shè)計表單模板（FormTemplate通過表單服務(wù)器上傳到服務(wù)器端，放入到文檔庫中的表單模板庫。文檔庫可以使用數(shù)據(jù)庫、文件系統(tǒng)或其他的存儲方式，如果需要采用數(shù)據(jù)庫分離存儲表單中的數(shù)據(jù)，表單設(shè)計器則需提供數(shù)據(jù)映射功能。表單使用者通過表單填寫器調(diào)用表單模板進行填寫操作，通過表單服務(wù)器提交表單數(shù)據(jù)并保存到表單實例庫；使用者可以通過表單填寫器瀏覽、查找、修改已經(jīng)填寫的表單文檔。5電子表單服務(wù)接口5.1表單模板管理服務(wù)5.1.1獲取表單模板對象接口地址：https://ip:port/itemAdmin/services/rest/formDefine/getById請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：獲取表單模板對象參數(shù)說明T/ZGCSA1.4—2024參數(shù)名稱類型描述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接口描述：根據(jù)事項唯一標識（事項id）和流程序列號獲取數(shù)據(jù)參數(shù)說明參數(shù)名稱類型描述無參數(shù)返回值說明字段類型描述successcodemsgdatabooleanint32stringList<strin操作是否成功錯誤代碼操作描述表單模板json集合5.1.3查詢表單模板接口地址：https://ip:port/itemAdmin/services/rest/formDefine/search請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：根據(jù)唯一標識（表單id）獲取綁定字段信息參數(shù)說明參數(shù)名稱類型描述namestring表單模板名稱systemNamestring系統(tǒng)名稱T/ZGCSA1.4—2024返回值說明字段類型描述booleanint32stringList<strinbooleanint32stringList<strin操作是否成功錯誤代碼操作描述表單模板json集合msgdata5.2表單業(yè)務(wù)數(shù)據(jù)管理服務(wù)5.2.1保存表單業(yè)務(wù)數(shù)據(jù)接口地址：https://ip:port/itemAdmin/services/rest/formData/save請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：獲取子表數(shù)據(jù)參數(shù)說明參數(shù)名稱類型描述formIdstring表單模板idformDataJson返回值說明string表單業(yè)務(wù)數(shù)據(jù)json字符串字段類型描述booleanint32stringbooleanint32stringstringsuccesscodemsgdata操作描述操作成功返回的數(shù)據(jù)5.2.2獲取表單業(yè)務(wù)數(shù)據(jù)接口地址：https://ip:port/itemAdmin/services/rest/formDate/getData請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：獲取表單業(yè)務(wù)數(shù)據(jù)參數(shù)說明參數(shù)名稱類型描述formIdstring表單模板idguidstring業(yè)務(wù)數(shù)據(jù)idT/ZGCSA1.4—2024返回值說明字段類型描述booleanint32stringbooleanint32stringobjectobjectobjectsuccesscodemsgdata操作描述操作成功返回的數(shù)據(jù)Amapanyobject.5.2.3刪除表單業(yè)務(wù)數(shù)據(jù)接口地址：https://ip:port/itemAdmin/services/rest/formData/delete請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=UTF-8接口描述：刪除表單業(yè)務(wù)數(shù)據(jù)參數(shù)說明參數(shù)名稱類型描述formIdstring表單模板idguidstring業(yè)務(wù)數(shù)據(jù)id返回值說明字段類型描述successboolean操作是否成功codeint32錯誤代碼msgstring操作描述datastring操作成功返回的數(shù)據(jù)T/ZGCSA1.4—2024參考文獻[1].電子政務(wù)主題詞表編制規(guī)則(GB/T19486-2004)[2].信息技術(shù)程序設(shè)計語言、環(huán)境與系統(tǒng)軟件接口獨立于語言的數(shù)據(jù)類型(GB/T18221-2000)[3].現(xiàn)代設(shè)計工程集成技術(shù)的軟件接口規(guī)范(GB/T18