同步適用性Forms與XFA表單範本

簡介

您可以根據XFA表單範本（*.XDP檔案）建立最適化表單。 此重複使用可讓您保留對現有XFA表單的投資。 有關如何使用XFA表單範本建立最適化表單的資訊，請根據範本建立最適化表單。

您可以在最適化表單中重複使用XDP檔案中的欄位。 這些欄位稱為二進位欄位。 系統會從XDP檔案複製二進位欄位的屬性（例如指令碼、標籤和顯示格式）。 您也可以選擇覆寫其中某些屬性的值。

AEM Forms提供一種方式，可協助您讓適用性表單的欄位與後續對XDP檔案中對應欄位所做的任何變更同步。 本文說明如何啟用此同步。

您可以將欄位從XFA表單拖曳至最適化表單

在AEM Forms製作環境中，您可以將欄位從XFA表單（左）拖曳至最適化表單（右）

必備條件

若要使用本文中的資訊，建議您熟悉下列方面：

若要使用文章中提供的範例，請下載範例套件，如下一節範例套件所述。

示例包

文章透過範例來示範如何將最適化表單與更新的XFA表單範本同步。 範例中使用的資產可在套件中取得，可從本文的Downloads區段下載。

上傳套件後，您可以在AEM Forms UI中檢視這些資產。

使用套件管理器安裝套件：https://<server>:<port>/crx/packmgr/index.jsp

套件包含下列資產：

  1. sample-form.xdp:作為範例的XFA表單範本

  2. sample-xfa-af:以sample-form.xdp檔案為基礎的最適化表單。不過，此最適化表單不包含任何欄位。 在下一個步驟中，我們會將內容新增至此最適化表單。

將內容新增至最適化表單

  1. 導覽至https://<server>:<port>/aem/forms.html。 如有詢問，請輸入您的憑據。
  2. 開啟sample-af-xfa以在製作模式中編輯。
  3. 從側欄的「內容」瀏覽器中，選擇「資料模型對象」頁簽。 將NumericField1和TextField1拖曳至最適化表單。
  4. 將NumericField1的標題從​Numeric Field​更改為​AF Numeric Field。
注意

在上述步驟中，我們覆寫了XDP檔案中欄位的屬性。 因此，如果稍後修改XDP檔案中的對應屬性，則不會同步此屬性。

檢測XDP檔案中的更改

只要XDP檔案或片段有任何變更，AEM Forms UI就會根據XDP檔案或片段來標幟所有最適化表單。

更新XDP檔案後，您需要在AEM Forms UI中再次上傳該檔案，以便標籤變更。

例如，讓我們使用下列步驟更新sample-form.xdp檔案：

  1. 導覽至https://<server>:<port>/projects.html.如果出現提示，請輸入您的憑證。

  2. 按一下左側的Forms標籤。

  3. 在本機電腦上下載sample-form.xdp檔案。 XDP檔案下載為.zip檔案，可使用任何檔案解壓縮實用程式提取該檔案。

  4. 開啟sample-form.xdp檔案，並將欄位TextField1的標題從​Text Field​更改為​My Text Field。

  5. 將sample-form.xdp檔案上傳回AEM Forms UI。

如果XDP檔案更新，當您根據XDP檔案編輯最適化表單時，會在編輯器中看到圖示。 此圖示表示適用性表單與XDP檔案不同步。 在下圖中，查看側欄中旁邊的表徵圖。

圖示以顯示最適化表單與XDP檔案不同步

將最適化表單與最新的XDP檔案同步

當下次開啟與XDP檔案不同步的適用性表單以進行製作時，會顯示下列訊息：
適用性表單的「結構/表單範本」已更新。 Click Here 以新版本重新建立基礎。

按一下訊息會同步適用性表單中的欄位與XDP檔案中的對應欄位。

針對本文所用的範例，在製作模式中開啟sample-xfa-af。 訊息會顯示在最適化表單的底部。

訊息提示您將最適化表單與XDP檔案同步

更新屬性

除了由作者明確覆寫適用性表單（從元件對話方塊）中的屬性外，所有從XDP檔案複製到適用性表單的屬性都會更新。 已更新的屬性清單可在伺服器記錄中取得。

若要更新範例適用性表單中的屬性，請按一下訊息中的連結（標示為"Click Here"）。 TextField1的標題從「文本欄位」更改為「我的文本欄位」。

update-property

注意

標籤AF數值欄位未更改，因為您已從元件屬性對話框中覆蓋此屬性，如將內容添加到適用性表單中所述。

從XDP檔案新增欄位至最適化表單  

任何稍後新增至原始XDP檔案的欄位，都會顯示在「表單階層」標籤中，您可以將這些新欄位拖曳至最適化表單。

您不需要按一下錯誤訊息中的連結，即可更新「表單階層」索引標籤中的欄位。

XDP檔案中已刪除的欄位

如果先前複製到適用性表單的欄位從XDP檔案中刪除，製作模式中會顯示錯誤訊息，指出XDP檔案中不存在該欄位。 在這種情況下，請手動從適用性表單中刪除欄位，或清除元件對話方塊中的bindRef屬性。

下列步驟將說明本文所用範例中資產的使用流程：

  1. 更新sample-form.xdp檔案並刪除NumericField1。

  2. 在AEM Forms UI中上傳sample-form.xdp檔案

  3. 開啟sample-xfa-af最適化表單以進行製作。 將顯示以下錯誤消息：更新適用性表單的結構/表單範本。 Click Here 以新版本重新建立基礎。

  4. 按一下訊息中的連結（標示為「 Click Here」）。 系統會顯示錯誤訊息，指出XDP檔案中已不存在該欄位。

刪除XDP檔案中的元素時出現錯誤

已刪除的欄位也會以圖示標示，以指出欄位中的錯誤。

欄位中的錯誤圖示

注意

適用性表單中具有錯誤捆綁（編輯對話方塊中的無效bindRef值）的欄位也視為已刪除欄位。 如果作者未修正這些錯誤並發佈最適化表單，欄位會視為一般的未結束最適化表單欄位，並包含在輸出XML檔案的未結束區段中。

下載內容

本文範例的內容套件

取得檔案

本頁內容