AEM Forms資料整合可讓您設定並連線至不同的資料來源。 下列是支援的現成可用型別。 不過,只需少量自訂,您也可以整合其他資料來源。
資料整合支援OAuth2.0(授權代碼, 使用者端認證)、基本驗證和API金鑰驗證型別為現成可用,並允許實作自訂驗證以存取Web服務。 雖然RESTful、SOAP型和OData服務是在AEM雲端服務中設定,但關聯式資料庫的JDBC和AEM使用者設定檔的聯結器是在AEM Web主控台中設定。
您可以使用「AEM Web主控台組態」來設定關聯式資料庫。 請執行下列動作:
前往AEM網頁主控台,網址為 https://server:host/system/console/configMgr
.
尋找 Apache Sling Connection Pooled DataSource 設定。 點選以在編輯模式中開啟設定。
在設定對話方塊中,指定您要設定的資料庫詳細資訊,例如:
在設定資料來源之前,請務必先加密機密資訊,例如密碼。 若要加密:
加密的文字會顯示在「受保護的文字」欄位中,您可以在設定中指定該欄位。
啟用 借入時測試 或 回訪時測試 指定物件在從和返回集區之前,先進行驗證。
在中指定SQL SELECT查詢 驗證查詢 用於驗證來自集區的連線的欄位。 查詢至少必須傳回一列。 根據您的資料庫,指定下列其中一項:
點選 儲存 以儲存設定。
如果您的Forms資料模型包含物件,而該物件是關聯式資料庫的保留關鍵字,則可能會導致資料新增、更新或擷取問題。 因此,請避免在表單資料模型中使用這類物件。
您可以使用AEM Web Console中的使用者設定檔聯結器設定來設定AEM使用者設定檔。 請執行下列動作:
前往AEM網頁主控台,網址為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結構的AEM使用者設定檔中的節點。 這表示表單資料模型可以存取 city
型別的屬性 string
出現在下的任何節點中 profile/empLocation/
節點。 不過,包含指定屬性的節點必須遵循一致結構。
點選 儲存 以儲存設定。
設定RESTful、SOAP和OData服務的雲端服務需要雲端服務資料夾的設定。
AEM中的所有雲端服務設定都會整合在 /conf
AEM存放庫中的資料夾。 根據預設, conf
資料夾包含 global
資料夾,您可在其中建立雲端服務設定。 不過,您需要為雲端設定手動啟用它。 您也可以在中建立其他資料夾 conf
建立和組織Cloud Service設定。
若要設定雲端服務設定的資料夾:
前往 「工具」>「一般」>「設定瀏覽器」.
請執行以下操作來啟用雲端設定的全域資料夾,或跳過此步驟來建立和設定雲端服務設定的另一個資料夾。
在 設定瀏覽器,選取 global
資料夾並點選 屬性.
在 設定屬性 對話方塊,啟用 雲端設定.
點選 儲存並關閉 以儲存設定並結束對話方塊。
在 設定瀏覽器,點選 建立.
在 建立設定 對話方塊,指定資料夾的標題並啟用 雲端設定.
點選 建立 以建立為雲端服務設定啟用的資料夾。
RESTful Web服務可使用以下方式描述: Swagger規格 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 Web服務時,因為資料來源包括用於效能最佳化的HTTP使用者端設定。
執行以下步驟來設定表單資料模型HTTP使用者端:
登入 Experience Manager Forms 以管理員身分編寫執行個體並前往 Experience Manager Web控制檯套裝。 預設URL為 https://localhost:4502/system/console/configMgr.
點選 REST資料來源的表單資料模型Http使用者端設定.
在 REST資料來源的表單資料模型Http使用者端設定 對話方塊:
指定表單資料模型和RESTful Web服務之間允許的最大連線數。 連線總數限制 欄位。 預設值為20個連線。
指定中每個路由允許的連線數目上限 每個路由的連線限制 欄位。 預設值為2個連線。
在「 」中指定持續HTTP連線保持連線的持續時間 保持連線 欄位。 預設值為15秒。
指定持續時間,期間為 Experience Manager Forms 伺服器會等待連線建立,在 連線逾時 欄位。 預設值為10秒。
指定中兩個資料封包之間閒置的最長時間 通訊端逾時 欄位。 預設值為30秒。
以下說明以SOAP為基礎的Web服務: Web服務描述語言(WSDL)規格. 若要在AEM雲端服務中設定以SOAP為基礎的Web服務,請確定您擁有Web服務的WSDL URL,並執行下列動作:
前往 「工具>Cloud Services>資料來源」. 點選以選取您要建立雲端設定的資料夾。
另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。
點選 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題(選擇性),選取 SOAP Web服務 從 服務型別 下拉式清單(選擇性)瀏覽並選取設定的縮圖影像,然後點選 下一個.
指定SOAP Web服務的下列專案:
Web服務的WSDL URL。
服務端點. 在此欄位中指定值,以覆寫WSDL中提到的服務端點。
選取驗證型別 — 無、OAuth2.0(授權代碼, 使用者端認證)、基本驗證、自訂驗證、X509 Token或相互驗證 — 以存取SOAP服務,並相應地提供驗證的詳細資訊。
如果您選取 X509 Token 以「驗證」型別,設定X509憑證。 如需詳細資訊,請參閱 設定憑證.
在中指定X509憑證的KeyStore別名 金鑰別名 欄位。 指定驗證請求保持有效的時間(以秒為單位),並位於 存留時間 欄位。 或者,選取以簽署訊息本文或時間戳記標頭,或兩者皆簽署。
如果您選取 相互驗證 做為驗證型別,請參閱 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
使用者,指定憑證的金鑰別名。您已設定資料來源。 接下來,您可以建立表單資料模型,或者,如果您已建立不含資料來源的表單資料模型,則可以將其與您設定的資料來源建立關聯。 另請參閱 建立表單資料模型 以取得詳細資訊。