文件AEM as a Cloud Service使用手冊

HTML5表單的轉譯表單範本 rendering-form-template-for-html-forms

Last update: Thu Jul 17 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用對象：
  • Experience Manager as a Cloud Service
  • 主題：

建立對象：

  • 管理員
  • 使用者
  • 開發人員

HTML5 Forms功能屬於Early Access方案的一部分。 若要要求存取權，請將您的正式（工作）電子郵件ID傳送電子郵件至aem-forms-ea@adobe.com。

轉譯端點 render-endpoint

HTML5表單具有​ 設定檔 ​的概念，此設定檔會公開為REST端點，以啟用表單範本的行動轉譯。 這些設定檔已關聯​ 設定檔轉譯器。 這些是JSP頁面，負責呼叫HTML OSGi服務來產生Forms表單表示法。 「設定檔」節點的JCR路徑會決定轉譯器端點的URL。 指向「預設」設定檔之表單的預設轉譯端點看起來如下所示：

https://<主機>：<連線埠>/content/xfaforms/profiles/default.html？contentRoot=<包含表單xdp>&template=<xdp>的資料夾路徑

例如 http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=c:/xdps&template=sampleForm.xdp

對於自訂設定檔，端點會據此變更。 例如，名稱為表單的自訂設定檔的端點是：

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

演算引數 render-parameters

將表單轉譯為HTML時支援的請求引數包括：

參數
說明
範本
此引數指定範本檔案的名稱。
contentRoot
此引數會指定範本和相關資源所在的路徑。 此路徑可以是伺服器檔案系統路徑或存放庫路徑、http或ftp路徑。
submitUrl
此引數指定表單資料xml張貼到的URL。

將資料與表單範本合併 merge-data-with-form-template

參數
說明
dataRef
此引數指定與範本合併之資料檔案的​ 絕對路徑。 此引數可以是Rest服務的URL，會以xml格式傳回資料。
資料
此引數會指定與範本合併的UTF-8編碼資料位元組。 如果指定此引數，HTML5表單會忽略dataRef引數。

傳遞轉譯器引數 passing-the-render-parameter

HTML5 Forms支援三種傳遞轉譯器引數的方法。 您可以透過URL、索引鍵值配對和設定檔節點傳遞引數。 在轉譯器引數中，機碼值組擁有最高的優先順序，其後是設定檔節點。 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。

提交引數 submit-parameters

HTML5 forms會提交資料；在AEM伺服器上執行伺服器端指令碼和網頁服務。 如需在AEM伺服器上執行伺服器端指令碼和Web服務所使用的引數的詳細資訊，請參閱HTML5 Forms Service Proxy。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab