使用XFA表單模板同步自適應Forms

簡介

您可以根據XFA表單範本(*.XDP檔案)建立最適化表單。 此重複使用可讓您保留現有XFA表單的投資。 有關如何使用XFA表單模板建立自適應表單的資訊,請基於模板建立自適應表單

您可以以最適化表單重複使用XDP檔案的欄位。 這些欄位稱為「已裝訂」欄位。 系統會從XDP檔案複製已裝訂欄位的屬性(例如指令碼、標籤和顯示格式)。 您也可以選擇覆寫部分屬性的值。

AEM Forms提供一種方法,幫助您使自適應表單的欄位與隨後對XDP檔案中相應欄位進行的任何更改保持同步。 本文將說明如何啟用此同步。

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

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

必備條件

若要使用本文中的資訊,建議您熟悉下列區域:

若要使用文章中的範例所提供的資產,請下載範例套件,如下一節Sample package所述。

示例軟體包

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

上傳套件後,您可以在AEM FormsUI中檢視這些資產。

使用軟體包管理器安裝軟體包: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. 開啟範例af-xfa,以在作者模式中進行編輯。
  3. 從側欄的「內容」瀏覽器中,選擇「資料模型物件」標籤。 將NumericField1和TextField1拖曳至最適化表單。
  4. 將NumericField1的標題從​Numeric Field​更改為​AF Numeric Field。
注意

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

檢測XDP檔案中的更改

每當XDP檔案或片段有任何變更時,AEM FormsUI會標示所有以XDP檔案或片段為基礎的最適化表單。

更新XDP檔案後,您必須在AEM FormsUI中重新上傳檔案,才能標幟變更。

例如,讓我們使用下列步驟更新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 FormsUI。

如果XDP檔案更新,當您根據XDP檔案編輯最適化表單時,會在編輯器中看到圖示。 此表徵圖表示最適化表單與XDP檔案不同步。 在下列影像中,請參閱側邊欄旁的圖示。

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

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

在下次開啟與XDP檔案不同步的自適應表單以進行創作時,將顯示以下消息:
最適化表單的架構/表單範本已更新。 Click Here 以新版本重新建立基礎。

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

對於本文中使用的範例,請在編寫模式中開啟sample-xfa-af。 該消息顯示在最適化表單的底部。

提示您將自適應表單與XDP檔案同步的消息

更新屬性

除了由作者在最適化表單(從「元件對話框」)中明確覆寫的屬性外,所有從XDP檔案複製到最適化表單的屬性都會更新。 已更新的屬性清單可在伺服器記錄檔中使用。

要更新示例自適應表單中的屬性,請按一下消息中的連結(標有"Click Here")。 TextField1的標題從​Text Field​變更為​My Text Field

update-property

注意

AF數值欄位標籤未變更,因為您已從元件屬性對話方塊中覆寫此屬性,如將內容新增至最適化表單中所述。

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

任何稍後添加到原始XDP檔案的欄位都會顯示在「表單層次」頁籤中,您可以將這些新欄位拖動到自適應表單中。

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

已刪除XDP檔案中的欄位

如果先前複製至最適化表單的欄位從XDP檔案中刪除,在編寫模式中會顯示錯誤訊息,指出該欄位不存在於XDP檔案中。 在這種情況下,請手動從最適化表單刪除該欄位,或清除元件對話框中的bindRef屬性。

下列步驟說明本文章範例中資產的使用流程:

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

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

  3. 開啟sample-xfa-af最適化表單以進行編寫。 將顯示以下錯誤消息:已更新最適化表單的架構/表單範本。 Click Here 以新版本重新建立基礎。

  4. 按一下訊息中的連結(標示為「 Click Here」)。 會顯示錯誤訊息,指出XDP檔案中不再存在欄位。

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

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

欄位中的錯誤圖示

注意

最適化表單中的欄位有不正確的系結(編輯對話方塊中的bindRef值無效),也會視為已刪除欄位。 如果作者未修正這些錯誤並發佈最適化表單,則該欄位會視為一般未加入的最適化表單欄位,並包含在輸出XML檔案的未加入區段中。

下載

本文中範例的內容封裝

取得檔案

本頁內容

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now