Experience Manager Forms 資料整合可讓您設定並連線至不同的資料來源。 下列是支援的現成可用型別:
資料整合支援OAuth2.0(授權代碼, 使用者端認證)、基本驗證和API金鑰驗證型別為現成可用,並允許實作自訂驗證以存取Web服務。 設定RESTful、SOAP和OData服務的時間 Experience Manager as a Cloud Service,關聯式資料庫的JDBC和聯結器 Experience Manager 使用者設定檔設定於 Experience Manager 網頁主控台。
使用設定關聯式資料庫之前 Experience Manager Web主控台設定,必須:
您可以使用以下專案設定關聯式資料庫: Experience Manager Web主控台設定。 請執行下列動作:
前往 Experience Manager Web主控台: https://server:host/system/console/configMgr
.
尋找 Day Commons JDBC連線集區 設定。 點選以在編輯模式中開啟設定。
在設定對話方塊中,指定您要設定的資料庫詳細資訊,例如:
設定關聯式資料庫的範例字串:
"datasource.name": "sqldatasourcename-mysql",
"jdbc.driver.class": "com.mysql.jdbc.Driver",
"jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
參考 使用JDBC DataSourcePool的SQL連線 以取得更多詳細資訊。
點選 儲存 以儲存設定。
現在,您可以將已設定的關聯式資料庫與表單資料模型搭配使用。
設定RESTful、SOAP和OData服務的雲端服務需要雲端服務資料夾的設定。
中的所有雲端服務設定 Experience Manager 已整合至 /conf
資料夾位於 Experience Manager 存放庫。 根據預設, conf
資料夾包含 global
資料夾,您可在其中建立雲端服務設定。 不過,您必須手動為雲端設定啟用它。 您也可以在中建立其他資料夾 conf
建立和組織Cloud Service設定。
若要設定雲端服務設定的資料夾:
前往 「工具」>「一般」>「設定瀏覽器」.
請執行以下操作來啟用雲端設定的全域資料夾,或跳過此步驟來建立和設定雲端服務設定的另一個資料夾。
在 設定瀏覽器,選取 global
資料夾並點選 屬性.
在 設定屬性 對話方塊,啟用 雲端設定.
點選 儲存並關閉 以儲存設定並結束對話方塊。
在 設定瀏覽器,點選 建立.
在 建立設定 對話方塊,指定資料夾的標題,然後啟用 雲端設定.
點選 建立 以建立為雲端服務設定啟用的資料夾。
RESTful Web服務可使用以下方式描述: Swagger規格 JSON或YAML格式 Swagger 定義檔案。 若要在中設定RESTful Web服務 Experience Manager as a Cloud Service,請確定您擁有 Swagger 檔案(Swagger 2.0版)或 Swagger 檔案(Swagger 3.0版)或託管檔案的URL上。
前往 「工具>Cloud Services>資料來源」. 點選以選取您要建立雲端設定的資料夾。
另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。
點選 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題(選擇性),選取 RESTful服務 從 服務型別 下拉式清單(選擇性)瀏覽並選取設定的縮圖影像,然後點選 下一個.
指定RESTful服務的下列詳細資料:
選取URL或檔案,從 Swagger來源 下拉式清單,並據此指定 Swagger URL 至 Swagger 定義檔案或上傳 Swagger 從您的本機檔案系統取得的檔案。
根據 Swagger 來源輸入。下列欄位已預先填入值:
配置: REST API使用的傳輸通訊協定。 下拉式清單中所顯示的配置型別數目,取決於 Swagger 來源。
主機:提供REST API之主機的網域名稱或IP位址。 它是必填欄位。
基本路徑:所有API路徑的URL首碼。 此為選用欄位。\
如有需要,請編輯這些欄位的預先填入值。
選取驗證型別 — 無、OAuth2.0(授權代碼, 使用者端認證)、基本驗證、API金鑰或自訂驗證 — 存取RESTful服務,並相應地提供驗證的詳細資訊。
如果您選取 API金鑰 由於是驗證型別,請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從以下選項中選取其中一個選項: 位置 下拉式清單,並在 引數名稱 欄位中輸入。
點選 建立 以建立RESTful服務的雲端設定。
前往 「工具>Cloud Services>資料來源」. 點選以選取您要建立雲端設定的資料夾。
另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。
點選 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題(選擇性),選取 RESTful服務 從 服務型別 下拉式清單(選擇性)瀏覽並選取設定的縮圖影像,然後點選 下一個.
指定RESTful服務的下列詳細資料:
如果您選取 API金鑰 由於是驗證型別,請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從以下選項中選取其中一個選項: 位置 下拉式清單,並在 引數名稱 欄位中輸入。
點選 建立 以建立RESTful服務的雲端設定。
RESTful服務Open API Specification 3.0版不支援的部分操作包括:
您可參閱 OpenAPI 3.0規格 詳細資訊。
Experience Manager Forms 表單資料模型,當整合RESTful Web服務時,因為資料來源包括用於效能最佳化的HTTP使用者端設定。
設定以下屬性 REST資料來源的表單資料模型HTTP使用者端設定 設定以指定規則運算式:
使用 http.connection.max.per.route
屬性來設定表單資料模型和RESTful Web服務之間允許的最大連線數目。 預設值為20個連線。
使用 http.connection.max
屬性,指定每個路由允許的連線數目上限。 預設值為40個連線。
使用 http.connection.keep.alive.duration
屬性來指定持續性HTTP連線持續運作的持續時間。 預設值為15秒。
使用 http.connection.timeout
屬性來指定持續時間,而 Experience Manager Forms 伺服器會等待建立連線。 預設值為10秒。
使用 http.socket.timeout
屬性,指定兩個資料封包之間閒置的最長時間。 預設值為30秒。
下列JSON檔案會顯示範例:
{
"http.connection.keep.alive.duration":"15",
"http.connection.max.per.route":"20",
"http.connection.timeout":"10",
"http.socket.timeout":"30",
"http.connection.idle.connection.timeout":"15",
"http.connection.max":"40"
}
點選 REST資料來源的表單資料模型HTTP使用者端設定.
在 REST資料來源的表單資料模型HTTP使用者端設定 對話方塊:
指定表單資料模型和RESTful Web服務之間允許的最大連線數。 連線總數限制 欄位。 預設值為20個連線。
指定中每個路由允許的連線數目上限 每個路由的連線限制 欄位。 預設值為兩個連線。
在「 」中指定持續HTTP連線保持連線的持續時間 保持連線 欄位。 預設值為15秒。
指定持續時間,期間為 Experience Manager Forms 伺服器會等待連線建立,在 連線逾時 欄位。 預設值為10秒。
指定中兩個資料封包之間閒置的最長時間 通訊端逾時 欄位。 預設值為30秒。
以下說明以SOAP為基礎的Web服務: Web服務描述語言(WSDL)規格. Experience Manager Forms 不支援RPC樣式WSDL模型。
若要在中設定以SOAP為基礎的Web服務 Experience Manager as a Cloud Service,請確定您有Web服務的WSDL URL,並執行下列動作:
前往 「工具>Cloud Services>資料來源」. 點選以選取您要建立雲端設定的資料夾。
另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。
點選 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題(選擇性),選取 SOAP Web服務 從 服務型別 下拉式清單(選擇性)瀏覽並選取設定的縮圖影像,然後點選 下一個.
指定SOAP Web服務的下列專案:
點選 建立 建立SOAP Web服務的雲端設定。
您可以指定一個規則運算式,用來篩選允許在SOAP Web服務WSDL中作為匯入陳述式的絕對URL。 依預設,此欄位中沒有值。 因此, Experience Manager 會封鎖WSDL中可用的所有匯入陳述式。 如果您指定 .*
作為此欄位中的值, Experience Manager 允許所有匯入陳述式。
設定 importAllowlistPattern
的屬性 表單資料模型SOAP Web服務匯入允許清單 設定以指定規則運算式。 下列JSON檔案會顯示範例:
{
"importAllowlistPattern": ".*"
}
若要設定值,請使用 AEM SDK 產生 OSGi Configurations,並將設定部署至您的 Cloud Service 執行個體。
OData服務由其服務根URL識別。 若要在中設定OData服務 Experience Manager as a Cloud Service,請確定您有服務的服務根URL,然後執行下列動作:
表單資料模型支援 OData版本4.
如需設定的逐步指南 Microsoft® Dynamics 365,線上或內部部署,請參閱 Microsoft® Dynamics OData設定.
前往 「工具>Cloud Services>資料來源」. 點選以選取您要建立雲端設定的資料夾。
另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。
點選 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題(選擇性),選取 OData服務 從 服務型別 下拉式清單(選擇性)瀏覽並選取設定的縮圖影像,然後點選 下一個.
指定OData服務的下列詳細資料:
如果您選取 API金鑰 由於是驗證型別,請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從以下選項中選取其中一個選項: 位置 下拉式清單,並在 引數名稱 欄位中輸入。
您必須選取要連線的OAuth 2.0驗證型別 Microsoft® Dynamics 使用OData端點作為服務根的服務。
點選 建立 以建立OData服務的雲端設定。
您已設定資料來源。 接下來,您可以建立表單資料模型,或者,如果您已建立不含資料來源的表單資料模型,則可以將其與您設定的資料來源建立關聯。 另請參閱 建立表單資料模型 以取得詳細資訊。