最適化表單片段 adaptive-form-fragments
Adobe 建議使用新式且可擴充的資料擷取核心元件,用來建立新的最適化表單或將最適化表單新增到 AEM Sites 頁面。這些元件代表最適化表單建立方面的重大進步,可確保令人印象深刻的使用者體驗。本文會介紹使用基礎元件編寫最適化表單的舊方法。
雖然每個表單都是為特定目的而設計,但大多數表單中都有一些常見的區段,例如提供個人詳細資訊,例如姓名和地址、家庭詳細資訊和收入詳細資訊。 每次建立新表單時,表單開發人員都必須建立這些通用區段。
調適型表單提供一種便利的機制,讓您只需建立一次表單區段(例如面板或欄位群組),即可在調適型表單中重複使用。 這些可重複使用的獨立區段稱為最適化表單片段。
建立片段 create-a-fragment
您可以從頭開始創建自適應表單片段,也可以將現有自適應表單中的面板另存為片段。
從頭開始建立片段 create-fragment-from-scratch
-
在https://[主機名稱]:[連線埠]/aem/forms.html登入AEM Forms作者執行個體。
-
按一下 建立>最適化表單片段。
-
指定片段的標題、名稱、說明和標籤。
note note NOTE 請確定您為片段指定唯一的名稱。 如果存在另一個相同名稱的片段,則無法建立片段。 -
按一下以開啟 表單模型 標籤,然後從 選取自 下拉式功能表中,為片段選取下列其中一個模型:
-
無:指定從頭開始建立片段,而不使用任何表單模型。
note note NOTE 在基於核心元件的最適化Forms中,您可以在表單中多次使用單一表單片段。 它支援無型和結構描述型表單片段。 -
表單範本:指定使用上傳至AEM Forms的XDP範本建立片段。 選取適當的XDP範本作為片段的表單模型。
所選表單範本中標籤為片段的子表單也會顯示。 您可以從下拉式清單中選取最適化表單片段的子表單。
此外,您可以在下拉式方塊中指定子表單的SOM運算式,藉此使用未在表單範本中標示為片段的子表單建立最適化表單片段。
- XML結構描述:指定使用上傳至AEM Forms的XML結構描述來建立片段。 您可以上傳或從可用的XML結構描述中選取作為片段的表單模型。
您也可以從下拉式方塊選取所選結構描述中存在的complexType,以建立最適化表單片段。
-
-
按一下[建立] ,然後按一下[開啟] ,以編輯模式開啟具有預設範本的片段。
在編輯模式中,您可以將任何最適化表單元件從AEM sidekick拖放至片段上。 如需最適化表單元件的相關資訊,請參閱製作最適化表單簡介。
此外,如果您選取XML結構描述或XDP表單範本作為片段的表單模型,內容尋找器中會出現一個顯示表單模型階層的新索引標籤。 它可讓您將表單模型元素拖放至片段上。 新增的表單模型元素會轉換為表單元件,同時保留關聯XDP或XSD的原始屬性。
將面板另存為片段 save-panel-as-a-fragment
-
開啟包含您要另存為最適化表單片段的面板的最適化表單。
-
在面板工具列中按一下 另存為片段。 另存為片段對話方塊隨即開啟。
note note NOTE 如果您儲存為片段的面板包含子面板,則產生的片段會包含這些面板。 -
在「片段建立」對話方塊中,指定下列資訊:
-
名稱:片段的名稱。 預設值為面板的元素名稱。 這是必填欄位。
note note NOTE 請確定您為片段指定唯一的名稱。 如果存在另一個相同名稱的片段,則無法建立片段。 -
Title:片段的標題。 預設值為面板的標題。
-
描述:片段的描述。
-
標籤:片段的標籤中繼資料。
-
目標路徑:儲存片段的存放庫路徑。 若您未指定路徑,則會在包含最適化表單的節點旁建立與片段名稱相同的節點。 片段會儲存在此節點中。
-
表單模型:根據最適化表單的表單模型,此欄位會顯示 XML結構描述、表單範本 或 無。 這是不可編輯的欄位。
-
片段模型根:僅出現在XSD型最適化表單中。 它會指定片段模型的根。 您可以從下拉式清單中選擇 / 或XSD複雜型別。 只有在選取複雜型別作為片段模型根時,才能在另一個最適化表單中重複使用片段。
如果您選擇 / 作為片段模型根目錄,則最適化表單資料模型標籤中會顯示根目錄的完整XSD樹狀結構。 對於複雜型別片段模型根,在調適型表單資料模型標籤中只會顯示所選複雜型別的子系。 如果您建立片段並選擇複雜型別做為 片段模型根,則您可以在使用該複雜型別的地方使用它,無論是在相同表單中還是在多個表單中。 -
XSD Ref:僅出現在XSD型最適化表單中。 它顯示XML綱要的位置。
-
XDP Ref:僅出現在XDP型最適化表單中。 它顯示XDP表單範本的位置。
另存為片段對話方塊
-
-
按一下 「確定」。
面板會儲存在存放庫 中的指定位置或預設位置。 在自適應表單中,面板被片段快照取代。 如下所示,「常規資訊」面板及其子面板「個人資訊」和「位址」將另存為片段。
若要編輯片段,請按一下面板工具列中的 編輯資產。 片段會在編輯模式的新標籤或視窗中開啟。
使用片段 working-with-fragments
設定片段外觀 configure-fragment-appearance
您在自適應表單中插入的任何片段都會顯示為佔位元元圖像。 佔位元顯示片段中最多十個子面板的標題。 您可以設定AEM Forms以顯示完整片段,而非佔位元影像。
執行以下步驟,以便您可以在表單中顯示完整的片段:
-
要前往 https:[主機:[ 連接埠 ]]/system/console/configMgr AEM Web 控制面板設定頁面。
-
Search並選擇 「自適應表單」和「互動式通信 Web 通道配置 」以在編輯模式下打開它。
-
停用 啟用預留位置來取代片段 核取方塊,以便您可以顯示完整的片段,而非預留位置影像。
在最適化表單中插入片段 insert-a-fragment-in-an-adaptive-form
您建立的自適應表單片段會顯示在AEM內容尋找器的「自適應表單片段」標籤中。 若要以最適化表單插入最適化表單片段:
-
以編輯模式開啟最適化表單,您要在其中插入最適化表單片段。
-
按一下側邊欄中的 Assets 。 在資產瀏覽器中,從下拉式清單中選取 最適化表單片段。
您也可以選擇顯示所有最適化表單片段,或根據其表單模式進行篩選 — 表單範本、XML結構描述或基本。
-
將最適化表單片段拖放至最適化表單上。
note note NOTE 未啟用最適化表單片段來從最適化表單內進行製作。 此外,您無法在JSON型最適化表單中使用XSD型片段,反之亦然。
最適化表單片段會以參考方式插入最適化表單中,並與獨立的最適化表單片段同步。 這表示當您更新最適化表單片段時,這些變更會反映在使用該片段的所有最適化表格中。
在自適應表單中嵌入片段 embed-a-fragment-in-adaptive-form
您可以選擇在新增片段的面板工具列上按一下「內嵌資產: <fragmentName>」按鈕,在自適應表單中內嵌自適應表單片段,如下列範例影像所示。
在片段中使用片段 using-fragments-within-fragments
您可以建立巢狀自適應表單片段,這表示您可以將片段拖放到另一個片段中,而且可以有巢狀片段結構。
變更片段 change-fragments
您可以使用自適應表單片段面板的「編輯」元件對話方塊中的 選取片段資產 屬性,以其他片段取代或變更自適應表單片段。
產生最適化表單片段的記錄檔案 generate-DOR-for-fragments
記錄檔案(DOR)可協助您以列印或檔案格式保留表單資訊。 有鑑於此,它有助於您之後隨時追蹤客戶的相關資訊,您也可以使用記錄檔案,以PDF格式將表單與內容一起封存。 瞭解如何產生最適化表單片段的記錄檔案。
在最適化表單中多次使用表單片段 using-form-fragment-mutiple-times-in-af
您可以在調適型表單中多次使用結構描述型表單片段,以唯一儲存每個表單片段欄位的資料。 例如,您可以使用地址表單片段來收集地址詳細資訊,以便永久性、通訊和在貸款申請表中呈現有效地址。
- 如果您在適用性表單中多次使用無架構表單片段,則會發生片段欄位之間的資料同步。 核心元件型表單片段中不會發生資料同步問題,您可以在表單中多次使用結構描述型或無型片段。
自動對應資料繫結的片段 auto-mapping-of-fragments-for-data-binding
當您使用XFA表單範本或XSD複雜型別建立最適化表單片段,並將片段拖放至最適化表單時,XFA片段或XSD複雜型別會自動被對應的最適化表單片段取代,其片段模型根已對應至XFA片段或XSD複雜型別。
您可以從「編輯元件」對話方塊變更片段資產及其連結。
管理片段 manage-fragments
您可以使用AEM Forms UI對最適化表單片段執行數個操作。
-
前往
https://[hostname]:'port'/aem/forms.html
。 -
按一下AEM Forms UI工具列中的 選取,然後選取最適化表單片段。 工具列會顯示您可對所選最適化表單片段執行的下列操作。
當地語系化包含片段的自適應表單 localizing-adaptive-form-containing-fragments
若要將包含自適應表單片段的自適應表單本地化,您必須分別將片段和表單本地化。 其構想是將片段本地化一次,並在多個最適化表單中重複使用。
使用片段時要記住的關鍵點 key-points-to-remember-when-working-with-fragments
- 確保片段名稱是唯一的。 如果存在具有相同名稱的現有片段,則片段無法建立。
- 在XDP型最適化表單中,如果您將面板儲存為包含其他XDP片段的片段,則產生的片段會自動與子XDP片段繫結。 如果存在XSD型最適化表單,則產生的片段會與結構描述根繫結。
- 建立最適化表單片段時,會在CRXDE Lite中建立片段節點,該節點類似於最適化表單的guideContainer節點。
- 不支援使用不同表單資料模型的最適化表單中的片段。 例如,XSD型最適化表單中不支援XDP型片段,反之亦然。
- 最適化表單片段可透過AEM內容尋找器中的最適化表單片段標籤使用。
- 透過參考插入或嵌入自適應表單時,獨立自適應表單片段中的任何運算式、指令碼或樣式都會保留。
- 您無法從最適化表單中編輯依參考插入的最適化表單片段。 若要編輯,請編輯獨立的自適應表單片段,或將片段嵌入自適應表單中。
- 發佈自適應表單時,必須發佈通過引用插入到自適應表單中的獨立自適應表單片段。
- 當您重新發佈更新的自適應表單片段時,更改會反映在使用片段的自適應表單的已發佈實例中。
- 包含驗證元件的自適應表單不支援匿名使用者。 同時,不建議在最適化窗體片段中使用驗證元件。
- (僅限 Mac)為了確保表單片段功能在所有場景中都能完美運行,請將以下內容添加到 /private/etc/hosts 檔中:
127.0.0.1 <Host machine>
主機電腦:部署AEM Forms的Apple Mac電腦。
參考片段 reference-fragments
您可以使用參考的最適化表單片段來建立您的表單。 如需詳細資訊,請參閱參考片段。