設定資料來源

Experience Manager Forms 資料整合可讓您設定並連線至不同的資料來源。 下列是支援的現成可用型別：

• 關聯式資料庫 — MySQL、 Microsoft® SQL Server， IBM® DB2®、 postgreSQL和 Oracle RDBMS
• RESTful Web服務
• 以SOAP為基礎的web服務
• OData服務（4.0版）
• Microsoft® Dynamics
• SalesForce
• Microsoft® Azure Blob儲存體

資料整合支援OAuth2.0(授權代碼， 使用者端認證)、基本驗證和API金鑰驗證是現成可用的型別，可實作自訂驗證以存取網站服務。 設定RESTful、SOAP型和OData服務的同時 Experience Manager as a Cloud Service，關聯式資料庫的JDBC和聯結器 Experience Manager 使用者設定檔設定於 Experience Manager 網頁主控台。

設定關聯式資料庫

先決條件

使用設定關聯式資料庫之前 Experience Manager Web主控台設定，必須：

• 透過Cloud Manager API啟用進階網路，因為連線埠預設為停用。
• 在Maven中新增JDBC驅動程式相依性.

設定關聯式資料庫的步驟

您可以使用以下專案設定關聯式資料庫： Experience Manager Web主控台設定。 請執行下列動作：

1. 前往 Experience Manager Web主控台： https://server:host/system/console/configMgr.

2. 尋找 Day Commons JDBC連線集區 設定。 選取以在編輯模式中開啟設定。

   

3. 在設定對話方塊中，指定您要設定的資料庫詳細資訊，例如：

   • JDBC驅動程式的Java™類別名稱
   • JDBC連線URI
   • 與JDBC驅動程式建立連線的使用者名稱和密碼
   • 指定SQL SELECT查詢 驗證查詢 欄位以驗證來自集區的連線。 查詢至少必須傳回一列。 根據您的資料庫，指定下列其中一項：
     • 選取1 (MySQL和MS® SQL)
     • 選取1個(雙Oracle)
   • 資料來源的名稱

   設定關聯式資料庫的範例字串：

      "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連線 以取得更多詳細資訊。

4. 選取 儲存 以儲存組態。

現在，您可以將已設定的關聯式資料庫與表單資料模型搭配使用。

設定雲端服務設定的資料夾

設定RESTful、SOAP和OData服務的雲端服務時，需要設定雲端服務資料夾的設定。

中的所有雲端服務設定 Experience Manager 在中整合 /conf 資料夾位置 Experience Manager 存放庫。 根據預設， conf 資料夾包含 global 資料夾，您可在其中建立雲端服務設定。 不過，您必須手動為雲端設定啟用它。 您也可以在中建立其他資料夾 conf 建立和組織雲端服務組態。

若要設定雲端服務設定的資料夾：

1. 前往​工具 > 一般 > 設定瀏覽器。

   • 請參閱 設定瀏覽器 檔案以取得詳細資訊。

2. 請執行以下操作來啟用雲端設定的全域資料夾，或跳過此步驟來建立和設定雲端服務設定的另一個資料夾。

   1. 在 設定瀏覽器，選取 global 資料夾並選取 屬性.

   2. 在 設定屬性 對話方塊，啟用 雲端設定.

   3. 選取 儲存並關閉 以儲存組態並結束對話方塊。

3. 在 設定瀏覽器，選取 建立.

4. 在 建立設定 對話方塊，指定資料夾的標題，然後啟用 雲端設定.

5. 選取 建立 以建立為雲端服務設定啟用的資料夾。

設定RESTful Web服務

RESTful Web服務可使用以下方式描述 Swagger規格 JSON或YAML格式的 Swagger 定義檔。 若要在中設定RESTful Web服務 Experience Manager as a Cloud Service，請確定您擁有 Swagger 檔案(Swagger 2.0版)或 Swagger 檔案(Swagger 3.0版)，或檔案託管所在的URL中。

為Open API規格2.0版設定RESTful服務

1. 前往 「工具>Cloud Service>資料來源」. 選取以選取您要建立雲端設定的資料夾。

   另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。

2. 選取 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題（選擇性），選取 RESTful服務 從 服務型別 下拉式清單(可選擇瀏覽並選取設定的縮圖影像，然後選取 下一個.

3. 指定RESTful服務的下列詳細資料：

   • 選取URL或檔案，從 Swagger來源 下拉式清單，並據此指定 Swagger URL 至​ Swagger 定義檔案或上傳 Swagger 從您的本機檔案系統傳送檔案。

   • 根據​ Swagger 來源輸入。下列欄位會預先填入值：

     • 配置： REST API使用的傳輸通訊協定。 下拉式清單中顯示的配置型別數目，視以下清單中定義的配置而定： Swagger 來源。

     • 主機：提供REST API之主機的網域名稱或IP位址。 這是必填欄位。

     • 基本路徑：所有API路徑的URL首碼。 它是選用欄位。\

       如有需要，請編輯這些欄位的預先填入值。

   • 選取驗證型別 — 無、OAuth2.0(授權代碼， 使用者端認證)、基本驗證、API金鑰或自訂驗證 — 存取RESTful服務，並相應地提供驗證的詳細資訊。

   如果您選取 API金鑰 由於是驗證型別，請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從以下選項中選取其中一個選項： 位置 下拉式清單，並在「 」中指定標頭的名稱或查詢引數 引數名稱 欄位中輸入。

4. 選取 建立 以建立RESTful服務的雲端設定。

為Open API規格3.0版設定RESTful服務

1. 前往 「工具>Cloud Service>資料來源」. 選取以選取您要建立雲端設定的資料夾。

   另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。

2. 選取 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題（選擇性），選取 RESTful服務 從 服務型別 下拉式清單(可選擇瀏覽並選取設定的縮圖影像，然後選取 下一個.

3. 指定RESTful服務的下列詳細資料：

   • 選取URL或檔案，從 Swagger來源 下拉式清單，並據此指定 Swagger 3.0 URL 至​ Swagger 定義檔案或上傳 Swagger 從您的本機檔案系統傳送檔案。
   • 根據​ Swagger 來源輸入，會顯示與目標伺服器的連線資訊。
   • 選取驗證型別 — 無、OAuth2.0(授權代碼， 使用者端認證)、基本驗證、API金鑰或自訂驗證 — 存取RESTful服務，並相應地提供驗證的詳細資訊。

   如果您選取 API金鑰 由於是驗證型別，請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從以下選項中選取其中一個選項： 位置 下拉式清單，並在「 」中指定標頭的名稱或查詢引數 引數名稱 欄位中輸入。

4. 選取 建立 以建立RESTful服務的雲端設定。

RESTful Services Open API Specification 3.0版不支援的作業包括：

• 回呼
• oneof/any of
• 遠端參考
• 連結
• 針對單一作業的不同MIME型別，有不同的要求內文

另請參閱 OpenAPI 3.0規格 以取得詳細資訊。

表單資料模型HTTP使用者端設定可最佳化效能

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"
}

1. 選取 REST資料來源的表單資料模型HTTP使用者端設定.

2. 在 REST資料來源的表單資料模型HTTP使用者端設定 對話方塊：

   • 指定表單資料模型與RESTful Web服務之間允許的最大連線數。 連線總數限制 欄位。 預設值為20個連線。

   • 指定中每個路由的允許連線數目上限。 每個路由的連線限制 欄位。 預設值是兩個連線。

   • 在「 」中指定持續HTTP連線持續運作的持續時間 保持連線 欄位。 預設值為15秒。

   • 指定持續時間，期間為 Experience Manager Forms 伺服器會等待連線建立，在 連線逾時 欄位。 預設值為10秒。

   • 指定中兩個資料封包之間閒置的最長時間 通訊端逾時 欄位。 預設值為30秒。

設定SOAP Web服務

以下說明以SOAP為基礎的Web服務： Web服務描述語言(WSDL)規格. Experience Manager Forms 不支援RPC樣式的WSDL模型。

若要在中設定以SOAP為基礎的Web服務 Experience Manager as a Cloud Service，請確定您擁有Web服務的WSDL URL，並執行下列動作：

1. 前往 「工具>Cloud Service>資料來源」. 選取以選取您要建立雲端設定的資料夾。

   另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。

2. 選取 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題（選擇性），選取 SOAP Web服務 從 服務型別 下拉式清單(可選擇瀏覽並選取設定的縮圖影像，然後選取 下一個.

3. 為SOAP Web服務指定下列專案：

   • Web服務的WSDL URL。

   • 服務端點。 在此欄位中指定值，以覆寫WSDL中提及的服務端點。

   • 選取驗證型別 — 無、OAuth2.0(授權代碼， 使用者端認證)、基本驗證或自訂驗證 — 存取SOAP服務，並相應地提供驗證的詳細資訊。

4. 選取 建立 以建立SOAP Web服務的雲端設定。

啟用在SOAP Web服務WSDL中使用匯入陳述式

您可以指定規則運算式，用來篩選允許做為SOAP Web服務WSDL中匯入陳述式的絕對URL。 依預設，此欄位中沒有值。 因此， Experience Manager 會封鎖WSDL中可用的所有匯入陳述式。 如果您指定 .* 作為此欄位中的值， Experience Manager 允許所有匯入陳述式。

設定 importAllowlistPattern 的屬性 表單資料模型SOAP Web服務匯入允許清單 用於指定規則運算式的設定。 下列JSON檔案顯示範例：

{
  "importAllowlistPattern": ".*"
}

若要設定值，請使用 AEM SDK 產生 OSGi 設定，並將設定部署至您的 Cloud Service 執行個體。

設定OData服務

OData服務由其服務根URL識別。 若要在中設定OData服務 Experience Manager as a Cloud Service，請確定您有服務的服務根URL，然後執行下列動作：

1. 前往 「工具>Cloud Service>資料來源」. 選取以選取您要建立雲端設定的資料夾。

   另請參閱 設定雲端服務設定的資料夾 以取得為雲端服務設定建立和設定資料夾的資訊。

2. 選取 建立 以開啟 建立資料來源設定精靈. 指定設定的名稱及標題（選擇性），選取 OData服務 從 服務型別 下拉式清單(可選擇瀏覽並選取設定的縮圖影像，然後選取 下一個.

3. 指定OData服務的下列詳細資料：

   • 要設定之OData服務的服務根URL。
   • 選取驗證型別 — 無、OAuth2.0(授權代碼， 使用者端認證)、基本驗證、API金鑰或自訂驗證 — 存取OData服務，並相應地提供驗證的詳細資訊。

   如果您選取 API金鑰 由於是驗證型別，請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從以下選項中選取其中一個選項： 位置 下拉式清單，並在「 」中指定標頭的名稱或查詢引數 引數名稱 欄位中輸入。

   注意

   選取要連線的OAuth 2.0驗證型別 Microsoft®® Dynamics 使用OData端點做為服務根目錄的服務。

4. 選取 建立 以建立OData服務的雲端設定。

後續步驟

您已設定資料來源。 接下來，您可以建立表單資料模型，或者，如果您已建立不含資料來源的表單資料模型，則可以將其與您設定的資料來源建立關聯。 另請參閱 建立表單資料模型 以取得詳細資訊。