產生最適化表單或最適化表單片段的記錄檔案 generate-document-of-record-for-adaptive-forms

Adobe 建議使用新式且可擴充的資料擷取核心元件,用來建立新的最適化表單將最適化表單新增到 AEM Sites 頁面。這些元件代表最適化表單建立方面的重大進步,可確保令人印象深刻的使用者體驗。本文會介紹使用基礎元件編寫最適化表單的舊方法。

版本
文章連結
AEM as a Cloud Service
按一下這裡
AEM 6.5
本文章

概觀 overview

提交表單後,您的客戶通常希望以列印或檔案格式來記錄他們在表單中填寫的資訊,以供日後參考。 這稱為記錄檔案。

本文說明如何產生Adaptive Forms或Adaptive Form片段的記錄檔案。

NOTE
AEM 6.5 Forms Service Pack 19 (6.5.19.0)引進自訂最適化表單片段及其在最適化表單編輯器中欄位的支援。
NOTE
XFA型調適型表單不支援自動產生記錄檔案。 不過,您可以使用用來建立最適化表單作為記錄檔案的XDP。

最適化表單型別及其記錄檔案 adaptive-form-types-and-their-documents-of-record

建立最適化表單時,您可以選取表單模型。 您的選項有:

  • 表單範本
    可讓您為最適化表單選取XFA範本。 當您選取XFA範本時,您可以使用關聯的XDP檔案作為記錄檔案,如上所述。

  • XML結構描述
    讓您為最適化表單選取XML結構描述定義。 當您為最適化表單選取XML結構描述時,您可以:

    • 為記錄檔案建立XFA範本的關聯。 確保關聯的XFA範本使用與您的調適型表單相同的XML結構描述
    • 自動生成記錄檔案
  • 無讓您建立不含表單模型的最適化表單。 系統會自動為您的最適化表單產生記錄檔案。

當您選取表單模型時,請使用「記錄檔案範本組態」下可用的選項來設定記錄檔案。 另請參閱 記錄範本檔案設定.

自動產生的記錄檔案 automatically-generated-document-of-record

記錄檔案可讓您的客戶保留已提交表單的復本以供列印。 當您自動產生記錄檔案時,每次變更表單時,其記錄檔案都會立即更新。 例如,您會為選取美國作為其國家/地區的客戶移除年齡欄位。 當這類客戶產生記錄檔案時,他們無法在記錄檔案中看到年齡欄位。

自動產生的記錄檔案具有以下優點:

  • 它會處理資料繫結。
  • 它會自動隱藏在提交時標籤為從記錄檔案中排除的欄位。 不需要額外付出。
  • 這樣可節省設計記錄範本檔案的時間。
  • 它可讓您使用不同的基本範本嘗試不同的樣式和外觀,並為記錄檔案選擇最佳的樣式和外觀。 造型外觀是選用的,如果您未指定造型,系統樣式會設定為預設值。
  • 它可確保表單中的任何變更都立即反映在記錄檔案中。

自動產生記錄檔案的元件 components-to-automatically-generate-a-document-of-record

若要產生最適化表單的記錄檔案,您需要下列元件:

最適化表單 您要為其產生記錄檔案的最適化表單。

最適化表單片段 您要為其產生記錄檔案的自適應表單片段。

基礎範本(建議) 在AEM Designer中建立的XFA範本(XDP檔案)。 基礎範本用於指定記錄檔案範本的樣式和品牌資訊。

另請參閱 記錄檔案的基礎範本

NOTE
記錄檔案的基礎範本也稱為記錄檔案的中繼範本。

記錄範本檔案 從最適化表單產生的XFA範本(XDP檔案)。

另請參閱 記錄範本檔案設定.

表單資料 使用者在最適化表單中填入的資訊。 它與記錄檔案範本合併以產生記錄檔案。

最適化表單元素的對應 mapping-of-adaptive-form-elements

以下章節說明最適化表單元素在記錄檔案中的顯示方式。

欄位 fields

最適化表單元件
對應的XFA元件
預設包含在記錄檔案範本中?
附註
按鈕
按鈕
false
核取方塊
核取方塊
true
日期挑選器
日期/時間欄位
true
下拉式清單
下拉式清單
true
草寫簽名
手寫簽名
true
數值方塊
數值欄位
true
密碼方塊
密碼欄位
false
選項按鈕
選項按鈕
true
文字方塊
文字欄位
true
重設按鈕
重設按鈕
false
提交按鈕

電子郵件提交按鈕

HTTP提交按鈕

false
條款與條件
true
檔案附件
false
在記錄範本檔案中無法使用。 只能透過附件在記錄檔案中使用。

容器 containers

最適化表單元件
對應的XFA元件
附註
面板
子表單
可重複面板對應至可重複的子表單。

靜態元件 static-components

最適化表單元件
對應的XFA元件
附註
影像
影像
除非使用記錄檔案設定加以排除,否則TextDraw和Image元件(無論已繫結或未繫結)一律會出現在XSD型調適型表單的記錄檔案中。
文字
文字
NOTE
在傳統UI中,您會獲得不同的索引標籤來編輯欄位屬性。

表格 tables

最適化表單元件(例如頁首、頁尾和列)對應到對應的XFA元件。 您可以將可重複面板對應至記錄檔案中的表格。

記錄檔案的基礎範本 base-template-of-a-document-of-record

基礎範本為記錄檔案提供樣式和外觀資訊。 它可讓您自訂自動產生記錄檔案的預設外觀。 例如,您想要在檔案的頁首中新增公司標誌,並在頁尾中新增版權資訊。 基礎範本的主版頁面會作為記錄檔案範本的主版頁面。 主版頁面可以包含頁首、頁尾和頁碼等資訊,您可以將這些資訊套用至記錄檔案。 您可以使用基礎範本將此類資訊套用至記錄檔案,以自動產生記錄檔案。 使用基礎範本可讓您變更欄位的預設屬性。

請務必遵循 基礎範本慣例 當您設計基礎範本時。

基礎範本慣例 base-template-conventions

基礎範本用於定義記錄檔案的頁首、頁尾、樣式和外觀。 頁首和頁尾可包含公司標誌和版權文字等資訊。 基礎範本中的第一個主版頁面會被複製並用作記錄檔案的主版頁面,其中包含頁首、頁尾、頁碼或應出現在記錄檔案所有頁面上的任何其他資訊。 如果您使用的基底範本不符合基底範本慣例,則基底範本中的第一個主版頁面仍會用於記錄檔案範本中。 強烈建議您依照其慣例設計基礎範本,並用於自動產生記錄檔案。

主版頁面慣例

  • 在基礎範本中,您應將根子表單命名為 AF_METATEMPLATE 主版頁面為 AF_MASTERPAGE.

  • 具有名稱的主版頁面 AF_MASTERPAGE 位於 AF_METATEMPLATE 根子表單會獲得擷取頁首、頁尾和樣式資訊的偏好設定。

  • 如果 AF_MASTERPAGE 不存在,則會使用基本範本中出現的第一個主版頁面。

欄位的樣式慣例

  • 若要在記錄檔案中的欄位套用樣式,基礎範本會提供 AF_FIELDSSUBFORM subfrom在 AF_METATEMPLATE 根子表單。

  • 這些欄位的屬性會套用至記錄檔案中的欄位。 這些欄位應遵循 AF_<name of field in all caps>_XFO 命名慣例。 例如,核取方塊的欄位名稱應為 AF_CHECKBOX_XFO.

若要建立基礎範本,請在AEM Designer中執行下列動作。

  1. 按一下 檔案>新增.

  2. 選取 根據範本 選項。

  3. 選取 Forms — 記錄檔案 類別。

  4. 選取 DoR基本範本.

  5. 按一下 下一個 並提供必要資訊。

  6. (選擇性)修改您要在記錄檔案中欄位上套用的欄位樣式和外觀。

  7. 儲存表單。

您現在可以使用儲存的表單作為記錄檔案的基礎範本。
請勿修改或移除基礎範本中存在的任何指令碼。

修改基礎範本

  • 如果您未在基礎範本的欄位上套用任何樣式,建議您從基礎範本中移除這些欄位,以便自動擷取對基礎範本的任何升級。
  • 修改基底範本時,請勿移除、新增或修改指令碼。
NOTE
使用慣例並嚴格遵循上述步驟來設計基礎範本。

記錄範本文件配置 document-of-record-template-configuration

設定表單的記錄檔案範本,讓客戶下載已提交表單的易列印復本。 XDP檔案可作為記錄檔案範本。 客戶下載的記錄檔案會根據XDP檔案中指定的版面進行格式化。

執行以下步驟來設定最適化表單的記錄檔案:

  1. 在AEM編寫執行個體中,按一下 Forms > Forms和檔案。

  2. 選取表單,然後按一下 檢視屬性.

  3. 在「屬性」視窗中,選取 表單模型.
    您也可以在建立表單時選取表單模型。

    note note
    NOTE
    在「表單模型」標籤中,確定您選取 結構描述選取自 下拉式清單。 以表單範本作為表單模型的XFA式或調適型表單不支援記錄檔案。
  4. 在「表單模型」標籤的「記錄檔案範本組態」區段中,選取下列其中一個選項:

    如果您不想為表單設定記錄檔案,請選取此選項。

    建立表單範本為記錄檔案範本的關聯 如果您有要作為記錄檔案範本使用的XDP檔案,請選取此選項。 選取此選項時,會顯示AEM Forms存放庫中可用的所有XDP檔案。 選取適當的檔案。

    選取的XDP檔案會與最適化表單建立關聯。

    產生記錄檔案 選取此選項可使用XDP檔案作為定義記錄檔案樣式和外觀的基礎範本。 選取此選項時,會顯示AEM Forms存放庫中可用的所有XDP檔案。 選取適當的檔案。

    note note
    NOTE
    在下列情況下,請確定用來建立調適型表單的結構描述與XFA表單的結構描述(資料結構描述)相同:
    code language-none
    * 您的最適化表單是以結構描述為基礎
    * 您正在使用 **建立表單範本為記錄檔案範本的關聯** 記錄檔案的選項
    
  5. 按一下 完成。

自訂記錄檔案中的品牌資訊 customize-the-branding-information-in-document-of-record

產生記錄檔案時,您可以在記錄檔案索引標籤上變更記錄檔案的品牌資訊。 「記錄檔案」索引標籤包括如標誌、外觀、版面、頁首和頁尾、免責宣告等選項,以及您是否要包含未選取的核取方塊和選項按鈕選項。

若要將您在「記錄檔案」標籤中輸入的品牌資訊當地語系化,您必須確保已正確設定瀏覽器的地區設定。 若要自訂記錄檔案的品牌資訊,請完成下列步驟:

  1. 在記錄檔案中選取面板(根面板),然後選取 設定 .

  2. 選取 dortab . 記錄檔案索引標籤隨即顯示。

  3. 選取呈現記錄檔案的預設範本或自訂範本。 如果您選取預設範本,記錄檔案的縮圖預覽會顯示在「範本」下拉式清單下方。

    brandingtemplate

    如果您選擇選取自訂範本,請在AEM Forms伺服器上瀏覽並選取XDP。 如果您想使用AEM Forms伺服器上尚未存在的範本,您必須先將XDP上傳至AEM Forms伺服器。

  4. 根據您選取預設或自訂範本,以下部分或全部屬性會出現在「記錄檔案」標籤中。 適當地指定下列專案:

    • 標誌影像:您可以選取使用最適化表單中的標誌影像、從DAM中選擇影像,或從電腦上傳影像。
    • 表單標題
    • 頁首文字
    • 免責宣告標籤
    • 免責宣告
    • 免責宣告文字
    • 輔色:在檔案或記錄PDF中呈現標頭文字和分隔線的色彩
    • 字型系列:記錄檔案PDF中文字的字型系列
    • 對於核取方塊與選項按鈕元件,僅顯示選取的值
    • 所選多個值的分隔符號
    • 包含未繫結至資料模型的表單物件
    • 從記錄檔案排除隱藏的欄位
    • 隱藏面板說明

    如果您選取的自訂XDP範本包含多個主版頁面,則這些頁面的屬性會顯示在 內容 的區段 記錄檔案 標籤。

    主版頁面屬性

    主版頁面的屬性包括標誌影像、頁首文字、表單標題、免責宣告標籤和免責宣告文字。 您可以將最適化表單或XDP範本屬性套用至記錄檔案。 AEM Forms預設會將範本屬性套用至記錄檔案。 您也可以定義主版頁面屬性的自訂值。 如需有關如何在記錄檔案中套用多個主版頁面的資訊,請參閱 套用多個主版頁面至記錄檔案.

    note note
    NOTE
    如果您使用以6.3之前的Designer版本建立的調適型表單範本,為了使輔色和字型系列屬性發揮作用,請確定根子表單下的調適型表單範本中有以下內容:
    code language-xml
    <proto>
    <font typeface="Arial"/>
    <fill>
    <color value="4,166,203"/>
    </fill>
    <edge>
    <color value="4,166,203"/>
    </edge>
    </proto>
    
  5. 若要儲存品牌變更,請選取「完成」。

記錄檔案中面板的表格和欄配置 table-and-column-layouts-for-panels-in-document-of-record

您的最適化表單可能會很長,包含多個表單欄位。 您可能不想將記錄檔案儲存為最適化表單的精確副本。 現在您可以選擇表格或欄版面配置,以將一或多個最適化表單面板儲存在記錄檔案PDF中。

在產生記錄檔案之前,在面板的設定中,選取該面板的「記錄檔案配置」(Layout For the Document Of Record for the Panel),作為「表格」或「欄」。 面板中的欄位會在記錄檔案中進行相應的組織。

面板中的欄位在記錄檔案中以表格佈局呈現

面板中的欄位在記錄檔案中以表格佈局呈現

面板中的欄位在記錄檔案中的欄配置中轉譯

面板中的欄位在記錄檔案中的欄配置中轉譯

記錄檔案設定 document-of-record-settings

記錄檔案設定可讓您選擇要包含在記錄檔案中的選項。 例如,銀行可接受表單中的姓名、年齡、社保號碼和電話號碼。 此表單會產生銀行帳號及分行詳細資訊。 您可以選擇在記錄檔案中只顯示名稱、社會安全號碼、銀行帳戶和分行詳細資訊。

元件的記錄檔案設定可在其屬性下使用。 若要存取元件的屬性,請選取元件並按一下 cmppr 在覆蓋圖中。 屬性會列在側邊欄中,您可在其中找到下列設定。

欄位層級設定

  • 從記錄檔案排除:將屬性設定為true會從記錄檔案中排除欄位。 這是名為的指令碼屬性 excludeFromDoR. 其行為取決於 若隱藏自DoR排除欄位 表單層級屬性。

  • 以表格顯示面板: 如果面板中有少於6個欄位,設定屬性可將面板顯示為記錄檔案中的表格。 僅適用於面板。

  • 從記錄檔案排除標題: 設定屬性會從記錄檔案中排除面板/表格的標題。 僅適用於面板和表格。

  • 從記錄檔案排除描述: 設定屬性會從記錄檔案中排除面板/表格的說明。 僅適用於面板和表格。

  • 分頁 > 地標:決定您選取要置入面板的位置。

    • 地標 > 跟隨前一項:將面板放置在父面板中前一個物件的後面。
    • 地標 > 在內容區域中 >內容區域名稱:將面板放置在指定的內容區域中。
    • 地標 > 下一個內容區域頂端:將面板放置在下一個內容區域的頂端。
    • 地標 > 內容區域頂端 >內容區域名稱:將面板放置在指定內容區域的頂端。
    • 地標 > 在頁面上 >主版頁面的名稱:將面板放置在指定頁面上。 如果未自動插入分頁符號, AEM Forms 新增分頁符號。
    • 地標 > 下一頁頂端:將面板放置在下一頁的頂端。 如果未自動插入分頁符號, AEM Forms 新增分頁符號。
    • 地標 > 頁面頂端 >主版頁面的名稱:轉譯指定的頁面時,將面板放置在頁面頂端。 如果未自動插入分頁符號, AEM Forms 新增分頁符號。
  • 分頁 > 晚於:決定置入面板後要填滿的區域。下列欄位位於 晚於 區段:

    • 晚於 > 繼續填滿上層:繼續合併所有要填入上層面板中之剩餘物件的資料。
    • 晚於 > 移至下一個內容區域:在放置面板後開始填滿下一個內容區域。
    • 晚於 > 移至內容區域 >內容區域名稱:放置面板後,開始填入指定的內容區域。
    • 晚於 > 移至下一頁:在放置面板後開始填入下一頁。
    • 晚於 > 移至頁面 >頁面名稱:放置面板後開始填入指定的頁面。
  • 分頁 > 溢位:設定跨頁面之面板或表格的溢位。 下列欄位位於 溢位 區段:

    • 溢位 > :開始填寫下一頁。 如果未自動插入分頁符號, AEM Forms 新增分頁符號。
    • 溢位 > 移至內容區域 >內容區域名稱:開始填寫指定的內容區域。
    • 溢位 > 移至頁面 >頁面名稱:開始填入指定的頁面。
    note note
    NOTE
    分頁屬性不適用於最適化表單片段。

如需有關如何在記錄檔案中套用分頁符號和套用多個主版頁面的資訊,請參閱 在記錄檔案中套用分頁符號套用多個主版頁面至記錄檔案.

表單層級設定

  • 包括DoR中未繫結欄位: 設定屬性時,記錄檔案中會包含來自結構描述型最適化表單的未繫結欄位。 預設為true。
  • 若隱藏自DoR排除欄位: 設定屬性以排除隱藏欄位 記錄檔案 在提交表單時。 當您啟用時 在伺服器上重新驗證,伺服器會先重新計算隱藏欄位,然後再將這些欄位從 記錄檔案.

在記錄檔案中套用分頁符號 apply-page-breaks-in-dor

您可以使用多種方法在記錄檔案中套用分頁符號。

若要將分頁套用至記錄檔案:

  1. 選取面板並選取 設定

  2. 展開 記錄檔案 以檢視屬性。

  3. 分頁 區段,選取 資料夾 地標 欄位。

  4. 選取 下一頁頂端 並選取 選取. 您也可以選取 頁面頂端,選取主版頁面,然後選取 選取 以套用分頁符號。

  5. 選取 儲存 以儲存屬性。

選取的面板會移至下一頁。

套用多個主版頁面至記錄檔案 apply-multiple-master-pages-dor

如果您選取的自訂XDP範本包含多個主版頁面,則這些頁面的屬性會顯示在 內容 的區段 記錄檔案 標籤。 如需詳細資訊,請參閱 自訂記錄檔案中的品牌資訊.

您可以將不同的主版頁面套用至最適化表單的元件,以將多個主版頁面套用至記錄檔案。 使用 分頁 區段記錄檔案屬性以套用多個主版頁面。

以下是如何將多個主版頁面套用至記錄檔案的範例:您可以將包含四個主版頁面的XDP範本上傳至 AEM Forms 伺服器。 AEM Forms 預設會將範本屬性套用至記錄檔案。 AEM Forms 也會將範本中的第一個主版頁面屬性套用至記錄檔案。

若要將第二個主版頁面屬性套用至面板,並將第三個主版頁面屬性套用至後續面板,請執行下列步驟:

  1. 選取要套用第二個主版頁面的面板,然後選取 設定 .
  2. 分頁 區段,選取 資料夾 地標 欄位。
  3. 選取 在頁面上,選取第二個主版頁面並選取 選取.
    AEM Forms會套用第二個主版頁面至面板,以及最適化表單中的所有後續面板。
  4. 分頁 區段,選取 資料夾 晚於 欄位。
  5. 選取 移至頁面,選取第三個主版頁面,然後選取 選取.
  6. 選取 儲存 以儲存屬性。
    AEM Forms會套用第三個主版頁面至面板,以及最適化表單中的所有後續面板。
NOTE
您無法將多個主版頁面套用至最適化表單片段的記錄檔案。

使用記錄檔案時的主要考量事項 key-considerations-when-working-with-document-of-record

處理最適化表單的記錄檔案時,請謹記下列考量事項和限制。

  • 記錄範本的檔案不支援RTF文字。 因此,靜態最適化表單中或一般使用者填入的資訊中的任何RTF文字都會在記錄檔案中顯示為純文字。
  • 最適化表單中的檔案片段未出現在記錄檔案中。 不過,也支援最適化表單片段。
  • 不支援根據XML結構描述的最適化表單產生的記錄檔案中的內容繫結。
  • 當使用者請求轉譯記錄檔案時,會根據地區設定的需求建立記錄檔案的當地語系化版本。 記錄檔案本地化與最適化表單本地化同時發生。 如需記錄檔案和調適型表單本地化的詳細資訊,請參閱 使用AEM翻譯工作流程將最適化表單和記錄檔案本地化.

使用自訂XCI檔案

XCI檔案可協助您設定檔案的各種屬性。 您可以使用自訂XCI檔案來覆寫在現有XCI檔案中指定的一個或多個預設屬性。 例如,您可以選擇將字型內嵌到檔案中,或是為所有檔案啟用標籤屬性。 下表指定XCI選項:

XCI選項
說明
config/present/pdf/creator
使用檔案資訊字典中的建立者專案來識別檔案建立者。 如需關於此字典的資訊,請參閱 PDF參考指南.
config/present/pdf/producer
使用檔案資訊字典中的製作者專案來識別檔案製作者。 如需關於此字典的資訊,請參閱 PDF參考指南.
config/present/layout
控制輸出是單一面板還是分頁。
config/present/pdf/compression/level
指定產生PDF檔案時要使用的壓縮程度。
config/present/pdf/fontInfo/embed
控制輸出檔案中的字型內嵌。
config/present/pdf/scriptModel
控制輸出PDF檔案中是否包含XFA特定資訊。
config/present/common/data/adjustData
控制XFA應用程式是否會在合併後調整資料。
config/present/pdf/renderPolicy
控制頁面內容的產生是在伺服器上完成,還是延後至使用者端。
config/present/common/locale
指定輸出檔案中使用的預設地區設定。
config/present/destination
當由目前元素包含時,指定輸出格式。 當由openAction元素包含時,會指定在互動式使用者端中開啟檔案時要執行的動作。
config/present/output/type
指定要套用至檔案的壓縮型別,或是要產生的輸出型別。
config/present/common/temp/uri
指定表單URI。
config/present/common/template/base
提供表單設計中基本的URI位置。 當此元素不存在或空白時,會使用表單設計的位置作為基礎。
config/present/common/log/to
控制記錄資料或輸出資料寫入的位置。
config/present/output/to
控制記錄資料或輸出資料寫入的位置。
config/present/script/currentPage
指定開啟檔案時的初始頁面。
config/present/script/exclude
通知Formsas a Cloud Service忽略哪些事件。
config/present/pdf/linearized
控制是否將輸出PDF檔案線性化。
config/present/script/runScripts
控制Formsas a Cloud Service執行的指令碼集。
config/present/pdf/tagged
控制標籤在輸出PDF檔案中是否包含。 在PDF的內容中,標籤是包含在檔案中的其他資訊,用於公開檔案的邏輯結構。 標籤有助於協助協助工具及重新格式化。 例如,頁碼可能會被標籤為成品,這樣熒幕閱讀器就不會在文字中間朗讀它。 雖然標籤讓檔案變得更實用,但它們也會增加檔案的大小,以及建立檔案的處理時間。
config/present/pdf/fontInfo/alwaysEmbed
指定內嵌在輸出檔案中的字型。
config/present/pdf/fontInfo/neverEmbed
指定不得嵌入至輸出檔案的字型。
config/present/pdf/pdfa/part
指定檔案符合的PDF/A規格的版本號碼。
config/present/pdf/pdfa/amd
指定PDF/A規格的修訂層次。
config/present/pdf/pdfa/conformance
指定符合PDF/A規格的等級。
config/present/pdf/version
指定要產生的PDF檔案版本
config/present/pdf/version/map
指定檔案的回覆字型

在本機Forms開發環境中使用自訂XCI檔案

  1. 上傳XCI檔案至您的本機開發環境。
  2. 開啟 組態管理員。
  3. 找到並開啟 最適化Forms和互動式通訊Web Channel 設定。
  4. 指定XCI檔案的路徑並按一下 儲存.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2