SZDBZ 17.9-2008 深圳市電子政務(wù)應(yīng)用服務(wù)規(guī)范 第9部分：電子表單服務(wù)接口規(guī)范

深圳市電子政務(wù)應(yīng)用服務(wù)規(guī)范第9部分：電子表單服務(wù)接口規(guī)范深圳市質(zhì)量技術(shù)監(jiān)督局發(fā)布I Ⅱ 12規(guī)范性引用文件 3術(shù)語和定義 25電子表單服務(wù)接口 5.1表單模板管理接口 25.2表單文檔服務(wù)接口 45.3異常約定 6 8ⅡSZDB/Z17-2008《電子政務(wù)應(yīng)用服務(wù)規(guī)范》目前分為10個部分：——第1部分《總則》——第2部分《應(yīng)用系統(tǒng)分類及代碼規(guī)范》——第3部分《應(yīng)用系統(tǒng)描述規(guī)范》——第4部分《組織身份模型數(shù)據(jù)規(guī)范》——第5部分《應(yīng)用服務(wù)運行管理框架規(guī)范》——第6部分《組織身份服務(wù)接口規(guī)范》——第7部分《訪問控制服務(wù)接口規(guī)范》——第8部分《單點登錄服務(wù)接口規(guī)范》——第9部分《電子表單服務(wù)接口規(guī)范》——第10部分《業(yè)務(wù)流程服務(wù)接口規(guī)范》本部分為SZDB/Z17-2008的第9部分。術(shù)規(guī)范的編寫原則對本部分內(nèi)容進行擴充。本技術(shù)規(guī)范文件由深圳市信息化領(lǐng)導(dǎo)小組辦公室、深圳市福田區(qū)信息中心提出。本技術(shù)規(guī)范文件由深圳市信息化領(lǐng)導(dǎo)小組辦公室歸口。有限公司共同起草。本技術(shù)規(guī)范文件主要起草人：賈興東、陳朝祥、張雁、高新輝、王克照、石禮洪、楊海波、王姝、張煥煥、劉用軍、梁文龍等。本技術(shù)規(guī)范文件為首次發(fā)布。1深圳市電子政務(wù)應(yīng)用服務(wù)規(guī)范第9部分：電子表單服務(wù)接口規(guī)范本部分定義了電子表單的基本概念，規(guī)范了電子表單服務(wù)的組成部分、功能電子表單使用和管理的服務(wù)接口，為使用電子表單的應(yīng)用系統(tǒng)提供統(tǒng)一的、標(biāo)準(zhǔn)的表單服務(wù)。本部分主要用于深圳市各級黨政機關(guān)的信息系統(tǒng)規(guī)劃與建設(shè)，以及電子政務(wù)成商、軟件開發(fā)商和監(jiān)理單位進行信息化規(guī)劃、建設(shè)。適用于設(shè)計與建設(shè)電子政務(wù)中的電子表單系統(tǒng)，以及使用電子表單服務(wù)接口的應(yīng)用系統(tǒng)。下列文件中的條款通過本部分的引用而成為本部分的條款。凡是修改單(不包括勘誤的內(nèi)容)或修訂版均不適用于本部分，然而，鼓勵根據(jù)本部分達成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本部分。GB/T19488.1-2004電子政務(wù)數(shù)據(jù)元第一部分：設(shè)計和管理規(guī)范SZDB/Z17.1-2008電子政務(wù)應(yīng)用服務(wù)規(guī)范第1部分：總則為方便查詢、顯示及對表單模板進行權(quán)限管理，對具有相同或相似業(yè)務(wù)理。所有的資源節(jié)點共同構(gòu)成樹形結(jié)構(gòu)，表單模板放在資源節(jié)點下。表單模板(FormTemplate):定義了表單的基本結(jié)構(gòu)和屬性，包括樣式、數(shù)據(jù)項、校驗、計算等控件及相應(yīng)的屬性值進行定義，如一般發(fā)文簽批單。表單文檔(FormDoc):是表單模板的應(yīng)用實例。表單文檔是由表單模板和表單數(shù)據(jù)在權(quán)限控制有表單數(shù)據(jù)靜態(tài)存儲的電子文檔，用于為最終用戶提供顯示、錄入、修改的人機界面，如一份發(fā)文。表單數(shù)據(jù)(FormData):表單文檔中的數(shù)據(jù)部分，一份表單文檔對應(yīng)于一份表單數(shù)據(jù)，采用XML格式進行表示。2表單填寫器—文檔庫—表單設(shè)計器一表單實例庫參照圖1,電子表單服務(wù)由三部分組成：表單設(shè)計器、表單填寫器、表單服務(wù)器。表單設(shè)計者通過表單設(shè)計器在線或者離線設(shè)計表單模板(FormTemplate),通過表單服務(wù)器上傳到需要采用數(shù)據(jù)庫分離存儲表單中的數(shù)據(jù)，表單設(shè)計器則需提供數(shù)據(jù)映射功能。單實例庫；使用者可以通過表單填寫器瀏覽、查找、修改已經(jīng)填寫的表單文檔。本接口所處的命名空間為：egov.appserFormTemplateService.de服務(wù)說明參數(shù)名稱參數(shù)說明表單模板對象。果為Null則表示根節(jié)點。NoSuchElementExcept如果指定的資源節(jié)點不存在，則拋出此異常。如果無法正常返回結(jié)果，則拋出此異常返回經(jīng)過表單服務(wù)器處理的FormTemplate對象。顯示和修改。3FormTemplateService.de服務(wù)說明表單模板相應(yīng)的版本有對應(yīng)的表單實例，此表單模板不會被參數(shù)名稱參數(shù)說明String類型，指定表單模板唯一標(biāo)識。Int類型，表單模板的版本號，從0開始。如果為-1則表示刪除此表單模板的所有版本。NoSuchElementExcept如果指定的表單模板不存在，則拋出此異常。如果無法正常返回結(jié)果，則拋出此異常無FormTemplateService.服務(wù)說明更新指定版本的表單模板。參數(shù)名稱參數(shù)說明用于更新的表單模板對象。int類型，表單模板的版本號，從0開始。NoSuchElementExcept如果流程定義或相應(yīng)版本不存在，則拋出此異常。如果無法正常返回結(jié)果，則拋出此異常返回已更新的FormTemplate對象。備注FormTemplateService.g服務(wù)說明獲取指定表單模板對象。參數(shù)名稱參數(shù)說明String類型，指定表單模板唯一標(biāo)識。NoSuchElementExcept如果無法正常返回結(jié)果，則拋出此異常返回FormTemplate對象。FormTemplateService.getAl1V服務(wù)說明參數(shù)名稱參數(shù)說明String類型，指定表單模板唯一標(biāo)識。NoSuchElementExcept如果表單模板不存在，則拋出此異常。備注4FormTemplateService.sea服務(wù)說明參數(shù)名稱參數(shù)說明NoSuchElementExcept如果無法正常返回結(jié)果，則拋出此異常備注FormTemplateService.imp服務(wù)說明導(dǎo)入表單模板的XML,獲得表單模板對象參數(shù)名稱參數(shù)說明String類型，要導(dǎo)入的表單模板XML。NoSuchElementExcept如果無法正常返回結(jié)果，則拋出此異常備注FormTemplateService.exp服務(wù)說明參數(shù)名稱參數(shù)說明String類型，指定表單模板唯一標(biāo)識。int類型，表單模板的版本號，從0開始。如果版本號為-1,則導(dǎo)出最高版本。NoSuchElementExcept如果無法正常返回結(jié)果，則拋出此異常返回FormTemplate對象的XML格式。備注5.2表單文檔服務(wù)接口FormDocService.rend服務(wù)說明生成表單文檔。參數(shù)名稱參數(shù)說明String類型，表單模板唯一標(biāo)識。5int類型，表單模板的版本號，從0開始。如果版本號為-1,則使用最高版本。表單模型的數(shù)據(jù)對象。渲染選項，采用鍵值對的方式設(shè)置。例如：顯示痕跡：showvestige=1,缺省為0;如果無法正常返回結(jié)果，則拋出此異常返回FormDoc對象。備注FormDocService.rend服務(wù)說明輸出表單文檔。參數(shù)名稱參數(shù)說明String類型，指定表單文檔唯一標(biāo)識。顯示痕跡：showvestige=1,缺省為0;如果無法正常返回結(jié)果，則拋出此異常返回FormDoc對象。備注FormDocService.submitFo服務(wù)說明將填寫的表單實例數(shù)據(jù)以數(shù)據(jù)流方式，提交到表單服務(wù)器，生成FormData對象。參數(shù)名稱參數(shù)說明String類型，指定表單文檔唯一標(biāo)識。提交選項，采用鍵值對的方式設(shè)置。如果無法正常返回結(jié)果，則拋出此異常FormData對象，提交的表單數(shù)據(jù)經(jīng)服務(wù)器解碼、轉(zhuǎn)換后形成表單數(shù)據(jù)對象。備注FormDocService.subm服務(wù)說明將已填寫的表單實例數(shù)據(jù)提交到表單服務(wù)器。參數(shù)名稱參數(shù)說明String類型，指定表單文檔唯一標(biāo)識。表單數(shù)據(jù)對象。提交選項，采用鍵值對的方式設(shè)置。如果無法正常返回結(jié)果，則拋出此異常返回提交表單的處理結(jié)果。備注6服務(wù)說明刪除指定的表單文檔。參數(shù)名稱參數(shù)說明String類型，指定的表單文檔唯一標(biāo)識。如果無法正常返回結(jié)果，則拋出此異常無備注服務(wù)說明根據(jù)指定的查詢條件，查詢表單文檔。參數(shù)名稱參數(shù)說明詢條件的格式應(yīng)符合ANSISQL92中where子句對查如果無法正常返回結(jié)果，則拋出此異常返回formDocUID數(shù)組。備注FormDocService.getFo服務(wù)說明參數(shù)名稱參數(shù)說明String類型，指定表單文檔的唯一標(biāo)識。如果無法正常返回結(jié)果，則拋出此異常備注FormDocService.setFo服務(wù)說明設(shè)置表單數(shù)據(jù)。參數(shù)名稱參數(shù)說明String類型，指定表單文檔的唯一標(biāo)識。FormData對象，表示表單數(shù)據(jù)。如果無法正常返回結(jié)果，則拋出此異常無備注7異常名稱8[2].信息技術(shù)程序設(shè)計語言、環(huán)境與系統(tǒng)軟件