設定資料來源

上次更新: 2023-12-05
  • 建立對象:
  • Beginner
    User
    Developer
版本 文章連結
AEM 6.5 按一下這裡
AEM as a Cloud Service 本文章

資料整合

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主控台設定,必須:

設定關聯式資料庫的步驟

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

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

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

    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,然後執行下列動作:

注意

表單資料模型支援 OData版本4.
如需設定的逐步指南 Microsoft®® Dynamics 365,線上或內部部署,請參閱 Microsoft® Dynamics OData設定.

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

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

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

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

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

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

    注意

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

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

後續步驟

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

此頁面上的