階層式下拉式清單
階層式下拉式清單是一系列相依的DropDownList控制項,其中一個DropDownList控制項相依於父項或前一個DropDownList控制項。 DropDownList控制項中的專案是根據使用者從其他DropDownList控制項選取的專案填入。
使用案例示範
出於本教學課程的目的,我已使用Geonames REST API來示範此功能。
有許多組織提供這類服務,只要他們有妥善記錄的REST API,您就可以使用資料整合功能,輕鬆與AEM Forms整合
依照下列步驟,在AEM Forms中實作階層式下拉式清單
建立開發人員帳戶
建立具有Geonames的開發人員帳戶。 記下使用者名稱。 叫用geonames.org的REST API需要此使用者名稱。
建立Swagger/OpenAPI檔案
OpenAPI Specification (前身為Swagger Specification)是REST API的API說明格式。 OpenAPI檔案可讓您說明整個API,包括:
- 每個端點的可用端點(https://experienceleague.adobe.com/users?lang=zh-Hant)和操作(GET/users、POST/users)
- 作業引數每個作業的輸入和輸出
驗證方法 - 聯絡資訊、授權、使用條款及其他資訊。
- API規格可以用YAML或JSON撰寫。 該格式簡單易學,且可供人類和機器讀取。
若要建立您的第一個swagger/OpenAPI檔案,請依照OpenAPI檔案操作
使用swagger編輯器建立您的swagger檔案,以說明擷取所有國家/地區以及國家/地區或州別之子元素的作業。 swagger檔案可以建立JSON或YAML格式。
建立資料來源
若要將AEM/AEM Forms與協力廠商應用程式整合,我們必須在雲端服務設定中建立資料來源。 請使用swagger檔案建立您的資料來源。
您需要建立2個資料來源(一個用於擷取所有國家/地區,另一個用於取得子元素)
建立表單資料模型
AEM Forms資料整合提供直覺式使用者介面,可建立和使用表單資料模型。 讓表單資料模型以先前步驟建立的資料來源為基礎。 具有2個資料來源的表單資料模型
建立最適化表單
將表單資料模型的GET叫用與您的調適型表單整合,以填入下拉式清單。
使用2個下拉式清單建立最適化表單。 一個用於列出國家,另一個用於根據所選國家列出州/省。
填入國家下拉式清單
首次初始化表單時會填入國家/地區清單。 下列熒幕擷圖顯示規則編輯器,其設定為填入國家/地區下拉式清單的選項。 您必須提供使用者名稱和geonames帳戶,才能順利運作。
填入州/省下拉式清單
我們需要根據所選的國家/地區填入州/省下拉式清單。 以下熒幕擷取畫面顯示規則編輯器設定
練習
新增2個名為縣和市的下拉式清單,根據所選國家/地區和州/省列出縣和市。
Assets範例
您可以下載以下資產,以建立階層式下拉式清單範例來開一個好頭
可以從這裡下載已完成的swagger檔案
swagger檔案說明下列REST API
您可以從這裡🔗下載已完成的表單資料模型