在最適化表單中建立和使用最適化Forms片段 adaptive-form-fragments
雖然每個表單都是為特定目的而設計的,但大多數表單中有一些常見的部分,例如提供個人詳細資訊按讚姓名和位址、家庭詳細資訊、收入詳細資訊等。 每次建立新表單時,表單開發人員都必須建立這些通用區段。 自適應Forms提供了一種方便的機制,只需區段 按讚面板或字段群組創建表單一次,並在自適應Forms中重複使用它們。 這些可重複使用的獨立區段稱為「最適化表單片段」。
建立片段 create-a-fragment
您可以從頭開始建立最適化表單片段,或將現有最適化表單中的面板儲存為片段。
從頭開始建立片段 create-fragment-from-scratch
-
登入 AEM Forms 作者執行個體 https://[hostname]:[連接埠]/aem/forms.html。
-
按兩下 建立 >最適化表單片段。
-
指定片段的標題、名稱、描述和標籤。
note note NOTE 請確定您為片段指定唯一的名稱。 如果已經有另一個相同名稱的片段,則無法建立片段。 -
按一下以開啟 表單模型 標籤,然後從 選取自 下拉式功能表中,為片段選取下列其中一個模型:
-
無:指定從頭開始建立片段,而不使用任何表單模型。
note note NOTE 在Adaptive 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型Adaptive Forms中。 它會指定片段模型的根。 您可以從下拉式清單中選擇 / 或XSD複雜型別。 只有在您選取複雜型別作為片段模型根時,才能在另一個Adaptive Form中重複使用片段。
如果您選擇 / 作為片段模型根目錄,則最適化表單資料模型標籤中會顯示根目錄的完整XSD樹狀結構。 對於複雜型別片段模型根,在「最適化表單資料模型」索引標籤中只會顯示所選複雜型別的子系。 -
XSD Ref:僅出現在XSD型最適化Forms中。 它顯示XML綱要的位置。
-
XDP Ref:僅出現在XDP型最適化Forms中。 它顯示XDP表單範本的位置。
另存為片段對話方塊
-
-
按一下 「確定」。
面板會儲存在存放庫中的指定或預設位置。 在調適型表單中,面板會由片段的快照取代。 如下所示,「一般資訊」面板及其子面板「個人資訊和地址」會儲存為片段。
若要編輯片段,請按一下面板工具列中的 編輯資產。 片段會在編輯模式的新標籤或視窗中開啟。
使用片段 working-with-fragments
設定片段外觀 configure-fragment-appearance
您在 Adaptive Forms 中插入的任何片段都會顯示為佔位元影像。 佔位元顯示片段中最多十個子面板的標題。 您可以設定AEM Forms顯示完整的片段,而非預留位置影像。
執行以下步驟,在表單中顯示完整的片段:
-
移至https:[主機]:[連線埠]/system/console/configMgr的AEM Web主控台設定頁面。
-
搜尋並按一下 最適化表單設定服務,以在編輯模式中開啟。
-
停用 啟用預留位置來取代片段 核取方塊以顯示完整的片段,而非預留位置影像。
在自適應表單中插入片段 insert-a-fragment-in-an-adaptive-form
您建立的最適化窗体片段會显示在 AEM 內容 Finder 的「最適化窗体片段」標籤中。 要在最適化表單插入最適化表單片段:
-
在編輯模式中開啟您要插入最適化表單片段的最適化表單。
-
按一下側邊欄中的 Assets 。 在資產瀏覽器中,從下拉式清單中選取 最適化表單片段。
您也可以選擇顯示所有最適化表單片段,或根據其表單模型(表單範本、XML結構描述或基本)進行篩選。
-
將最適化表單片段拖放至最適化表單上。
note note NOTE 未啟用最適化表單片段來從最適化表單內進行製作。 此外,您無法在JSON型最適化表單中使用XSD型片段,反之亦然。
最適化表單片段會以參考方式插入最適化表單片段中,並與獨立的最適化表單片段同步。 這表示當您更新最適化表單片段時,變更會反映在使用片段的所有Adaptive Forms中。
在自適應表單中嵌入片段 embed-a-fragment-in-adaptive-form
您可以選擇在新增片段的面板工具列上按一下「內嵌資產: <fragmentName>」按鈕,將Adaptive Form片段內嵌到最適化表單中,如下列範例影像所示。
在片段中使用片段 using-fragments-within-fragments
您可以建立巢狀的Adaptive Form片段,這表示您可以將片段拖放到另一個片段中,而且可以有巢狀片段結構。
變更片段 change-fragments
您可以使用自適應表單片段面板的「編輯」元件對話方塊中的 選取片段資產 屬性,以其他片段取代或變更自適應表單片段。
在最適化表單中多次使用表單片段 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工具列中的 選取,然後選取最適化表單片段。 工具列會顯示您對選取的Adaptive Form片段可以執行的下列操作。
當地語系化包含片段的最適化表單 localizing-adaptive-form-containing-fragments
要本地化包含自適應表單片段的最適化表單,您需要分別當地語系化片段和表單。 這個想法是將片段當地語系化一次,然後在多個自適應Forms中重複使用。
使用片段時要記住的關鍵點 key-points-to-remember-when-working-with-fragments
- 確保片段名稱是唯一的。 如果存在具有相同名稱的現有片段,則片段無法建立。
- 在基於 XDP 的自適應表單中,如果將面板另存為包含另一個 XDP 片段的片段,則生成的片段將自動綁定到子 XDP 片段。 如果是基於 XSD 的最適化表單,則生成的片段將綁定到綱要根目錄。
- 當您建立最適化窗體片段時,會建立片段節點,類似於CRXDe Lite中最適化窗體的 guideContainer 節點。
- 不支援使用不同表單資料模型 (FDM) 的自適應表單片段。 例如,基於 XDP 的自適應表單不支援基於 XDP 的片段,反之亦然。
- 最適化表單片段可透過AEM內容尋找器中的最適化表單片段標籤使用。
- 透過參考插入或嵌入自適應表單時,獨立自適應表單片段中的任何運算式、指令碼或樣式都會保留。
- 您無法從最適化表單中編輯透過參考插入的最適化表單片段。 若要編輯,請編輯獨立的Adaptive Form片段或將片段嵌入到Adaptive Form中。
- 發佈最適化表單時,您需要發佈在最適化表單中透過參考插入的獨立最適化表單片段。
- 當您重新發佈更新的Adaptive Form片段時,變更會反映在使用片段的Adaptive Form的已發佈例項中。
- 包含Verify元件的調適型表單不支援匿名使用者。 此外,不建議在自適應表單片段中使用驗證元件。
- (僅限 Mac)為了確保表單片段功能在所有場景中都能完美運行,請將以下內容添加到 /private/etc/hosts 檔中:
127.0.0.1 <Host machine>
主機: 部署的 AEM Forms Apple Mac 電腦。