HTML5表單的概念是描述檔,這些描述檔公開為REST端點,以啟用表單範本的行動轉譯。 這些配置檔案具有關聯的配置檔案渲染器。 它們是JSP頁面,負責呼叫Forms OSGi服務來產生表單的HTML表示法。 「描述檔」節點的JCR路徑會決定演算端點的URL。 指向「預設」描述檔的表單的預設演算端點看起來如下:
https://<host>:<port>/content/xfaforms/profiles/default.html?contentRoot=<包含xdp>的資料夾路徑&template=xdp名稱
例如, http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=c:/xdps&template=sampleForm.xdp
對於自訂描述檔,端點會隨之變更。 例如,名稱為hrforms的自訂描述檔的端點為:
http://localhost:4502/content/xfaforms/profiles/hrforms.html?contentRoot=c:/xdps&template=sampleForm.xdp
如果您的範本位於名為FormSubmission的應用程式中的AEM儲存庫中,URI為:
http://localhost:4502/content/xfaforms/profiles/default.html?
contentRoot=crx:///content/dam/formsanddocuments/FormSubmission/1.0
&template=sampleForm.xdp
將表單轉譯為HTML時支援的請求參數包括:
參數 | 說明 |
---|---|
範本 |
此參數指定模板檔案的名稱。 |
contentRoot |
此參數指定模板和相關資源所在的路徑。 此路徑可以是伺服器檔案系統路徑或儲存庫路徑或http或ftp路徑。 |
submitUrl |
此參數指定張貼表單資料xml的URL。 |
參數 | 說明 |
---|---|
dataRef | 此參數指定與模板合併的資料檔案的絕對路徑。 此參數可以是剩餘服務傳回xml格式資料的URL。 |
資料 | 此參數指定與範本合併的UTF-8編碼資料位元組。 如果指定此參數,HTML5表單會忽略dataRef參數。 |
HTML5表格支援三種傳遞演算參數的方法。 您可以透過URL、鍵值配對和描述檔節點傳遞參數。 在render參數中,鍵值對的優先順序最高,後跟配置檔案節點。 「URL請求」參數的優先順序最低。
URL請求參數:您可以在URL中指定演算參數。在URL請求參數中,參數對一般使用者可見。 例如,下列提交URL在URL中包含範本參數:http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=/Applications/FormSubmission/1.0&template=sampleForm.xdp
SetAttribute請求參數:可以將渲染參數指定為鍵值對。在SetAttribute請求參數中,參數對最終用戶不可見。 您可以從任何其他JSP將請求轉發到HTML5表單描述檔轉譯器JSP,並在請求物件上使用setAttribute來傳遞所有演算參數。 此方法的優先順序最高。
配置檔案節點請求參 數:可以將渲染參數指定為配置檔案節點的節點屬性。在描述檔節點請求參數中,一般使用者看不到這些參數。 描述檔節點是傳送請求的節點。 要將參數指定為節點屬性,請使用CRXDE lite。
HTML5表單提交資料;在AEM伺服器上執行伺服器端指令碼和web-services。 如需在AEM伺服器上執行伺服器端指令碼和web-services的參數詳細資訊,請參閱HTML5 forms Service Proxy。