AEM Forms資料整合可讓您設定並連線至不同的資料來源。 下列類型可立即使用。 不過,只要很少自訂,您也可以整合其他資料來源。
資料整合支援OAuth2.0、基本驗證和API金鑰驗證類型,且可立即使用,並可實作自訂驗證以存取網站服務。 雖然AEM雲端服務中已設定RESTful、SOAP型和OData服務,但AEM web主控台中已設定關係資料庫的JDBC和AEM使用者設定檔的連接器。
您可以使用AEM Web控制台配置配置關係資料庫。 請執行下列動作:
前往AEM Web主控台,網址為 https://server:host/system/console/configMgr
.
尋找 Apache Sling Connection Pooled DataSource 設定。 點選以在編輯模式中開啟設定。
在配置對話框中,指定要配置的資料庫的詳細資訊,例如:
在配置資料源之前,請確保加密密碼等敏感資訊。 要加密:
加密的文字會顯示在「受保護的文字」欄位中,您可以在配置中指定該欄位。
啟用 借閱時測試 或 返回時測試 指定在從和中借用對象或將對象返回到池之前,分別驗證對象。
在 驗證查詢 欄位,驗證池中的連接。 查詢必須至少返回一行。 根據您的資料庫,指定下列任一項:
點選 儲存 以儲存設定。
如果您的Forms資料模型包含的物件是關係資料庫的保留關鍵字,可能會導致資料新增、更新或擷取問題。 因此,請避免在表單資料模型中使用這類物件。
您可以使用AEM Web Console中的「使用者設定檔連接器」設定來設定AEM使用者設定檔。 請執行下列動作:
前往AEM Web主控台,網址為https://'[伺服器]:[埠]'system/console/configMgr.
尋找 AEM Forms資料整合 — 使用者設定檔連接器設定 並點選以在編輯模式中開啟設定。
在「用戶配置檔案連接器配置」對話框中,可以添加、刪除或更新用戶配置檔案屬性。 指定的屬性可用於表單資料模型。 使用以下格式指定用戶配置檔案屬性:
name=[property_name_with_location_in_user_profile],type=[property_type]
範例:
name=profile/phoneNumber,type=string
name=profile/empLocation/*/city,type=string
此 * 在上例中,表示 profile/empLocation/
節點(在CRXDE結構中)。 這表示表單資料模型可以存取 city
類型屬性 string
存在於 profile/empLocation/
節點。 但是,包含指定屬性的節點必須遵循一致的結構。
點選 儲存 以儲存設定。
為RESTful、SOAP和OData服務配置雲服務時,需要配置雲服務資料夾。
AEM中的所有雲端服務設定皆已整合至 /conf
資料夾。 依預設, conf
資料夾包含 global
可在其中建立雲端服務設定的資料夾。 不過,您必須為雲端設定手動啟用此功能。 您也可以在 conf
來建立和組織雲端服務設定。
要配置雲端服務配置的資料夾:
前往 工具>一般>設定瀏覽器.
請執行下列操作以啟用雲配置的全局資料夾,或跳過此步驟以建立和配置雲服務配置的其他資料夾。
在 配置瀏覽器,請選取 global
資料夾和點選 屬性.
在 配置屬性 對話框,啟用 雲端設定.
點選 儲存並關閉 以保存配置並退出對話框。
在 配置瀏覽器,點選 建立.
在 建立配置 對話框,指定資料夾的標題並啟用 雲端設定.
點選 建立 建立雲端服務設定啟用的資料夾。
RESTful Web服務可使用 Swagger規格 JSON或YAML格式。 若要在AEM雲端服務中設定RESTful Web服務,請確定您的檔案系統上有Swagger檔案,或檔案托管所在的URL。
請執行以下操作來配置RESTful服務:
前往 工具>Cloud Services>資料來源. 點選以選取您要建立雲端設定的資料夾。
請參閱 配置雲端服務配置的資料夾 如需建立和設定雲端服務設定資料夾的相關資訊。
點選 建立 開啟 建立資料源配置嚮導. 指定配置的名稱和(可選)標題,選擇 RESTful服務 從 服務類型 下拉式清單,(可選)瀏覽並選取設定的縮圖影像,然後點選 下一個.
為RESTful服務指定以下詳細資訊:
從「Swagger來源」下拉式清單中選取「URL」或「檔案」,並據此指定Swagger URL至Swagger定義檔案,或從本機檔案系統上傳Swagger檔案。
根據Swagger來源輸入,下列欄位會預先填入值:
方案:REST API使用的傳輸通訊協定。 下拉式清單中顯示的配置類型數目取決於Swagger來源中定義的配置。
主機:提供REST API之主機的網域名稱或IP位址。 這是必填欄位。
基本路徑:所有API路徑的URL首碼。 此為選用欄位。\
如有必要,請編輯這些欄位的預先填入值。
選擇身份驗證類型(無、OAuth2.0、基本身份驗證、API密鑰、自定義身份驗證或相互身份驗證)以訪問RESTful服務,並相應地提供身份驗證的詳細資訊。
如果您選取 API金鑰 作為驗證類型,請指定API金鑰的值。 API金鑰可以以要求標題或查詢參數的形式傳送。 從 位置 下拉式清單中,並指定標題的名稱或 參數名稱 欄位。
如果您選取 相互驗證 如需驗證類型,請參閱 RESTful和SOAP Web服務的基於證書的相互驗證.
點選 建立 為RESTful服務建立雲配置。
Experience Manager Forms 表單資料模型與RESTful網站服務整合時,作為資料來源時包含HTTP用戶端設定,以達到效能最佳化。
執行下列步驟來設定表單資料模型HTTP用戶端:
登入 Experience Manager Forms 以管理員身分撰寫執行個體,並前往 Experience Manager web控制台套件組合。 預設URL為 https://localhost:4502/system/console/configMgr.
點選 REST資料來源的表單資料模型Http用戶端設定.
在 REST資料來源的表單資料模型Http用戶端設定 對話框:
指定表單資料模型與RESTful Web服務之間允許的最大連接數,位於 連線總數限制 欄位。 預設值為20個連線。
指定 每個路由的連接限制 欄位。 預設值為2個連線。
在 保持活力 欄位。 預設值為15秒。
指定持續時間,其 Experience Manager Forms 伺服器會等待連線以建立,位於 連線逾時 欄位。 預設值為10秒。
指定 通訊端逾時 欄位。 預設值為30秒。
描述基於SOAP的Web服務,使用 網站服務描述語言(WSDL)規範. 若要在AEM雲端服務中設定以SOAP為基礎的網站服務,請確定您有網站服務的WSDL URL,並執行下列動作:
前往 工具>Cloud Services>資料來源. 點選以選取您要建立雲端設定的資料夾。
請參閱 配置雲端服務配置的資料夾 如需建立和設定雲端服務設定資料夾的相關資訊。
點選 建立 開啟 建立資料源配置嚮導. 指定配置的名稱和(可選)標題,選擇 SOAP Web服務 從 服務類型 下拉式清單,(可選)瀏覽並選取設定的縮圖影像,然後點選 下一個.
為SOAP Web服務指定以下內容:
Web服務的WSDL URL。
服務端點. 在此欄位中指定一個值,以覆蓋WSDL中提及的服務端點。
選取驗證類型(無、OAuth2.0、基本驗證、自訂驗證、X509代號或相互驗證)以存取SOAP服務,並據此提供驗證的詳細資訊。
如果您選取 X509代號 作為「驗證」類型,請配置X509證書。 如需詳細資訊,請參閱 設定憑證.
在 密鑰別名 欄位。 在 存留時間 欄位。 (可選)選擇簽署消息正文或時間戳標頭或兩者。
如果您選取 相互驗證 如需驗證類型,請參閱 RESTful和SOAP Web服務的基於證書的相互驗證.
點選 建立 為SOAP Web服務建立雲配置。
OData服務由其服務根URL識別。 若要在AEM雲端服務中設定OData服務,請確定您有服務的服務根URL,並執行下列操作:
表單資料模型支援 OData第4版.
有關配置Microsoft Dynamics 365的線上或內部部署的逐步指南,請參閱 Microsoft Dynamics OData設定.
前往 工具>Cloud Services>資料來源. 點選以選取您要建立雲端設定的資料夾。
請參閱 配置雲端服務配置的資料夾 如需建立和設定雲端服務設定資料夾的相關資訊。
點選 建立 開啟 建立資料源配置嚮導. 指定配置的名稱和(可選)標題,選擇 OData服務 從 服務類型 下拉式清單,(可選)瀏覽並選取設定的縮圖影像,然後點選 下一個.
指定OData服務的以下詳細資訊:
您必須選取OAuth 2.0驗證類型,才能以OData端點作為服務根連線至Microsoft Dynamics服務。
點選 建立 為OData服務建立雲配置。
當您為表單資料模型啟用相互驗證時,執行表單資料模型的資料來源和AEM Server會先驗證彼此的身分,再共用任何資料。 您可以對REST和SOAP連線(資料來源)使用相互驗證。 若要在AEM Forms環境中為表單資料模型設定相互驗證:
fd-cloudservice
使用者和點選 屬性.fd-cloudservice
用戶,指定證書的密鑰別名。您已設定資料來源。 接下來,您可以建立表單資料模型,或者如果您已建立表單資料模型而不使用資料來源,則可將其與您設定的資料來源建立關聯。 請參閱 建立表單資料模型 以取得詳細資訊。