設定資料來源 configure-data-sources

版本
文章連結
AEM 6.5
按一下這裡
AEM as a Cloud Service
本文章

資料整合

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

  • 關聯式資料庫 — MySQL、Microsoft® SQL Server、IBM® DB2®、postgreSQL和Oracle RDBMS
  • RESTful Web服務
  • SOAP型網站服務
  • OData服務(4.0版)
  • Microsoft® Dynamics
  • SalesForce
  • Microsoft® Azure Blob儲存體

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

設定關聯式資料庫 configure-relational-database

先決條件

在使用Experience Manager Web主控台組態設定關聯式資料庫之前,必須:

設定關聯式資料庫的步驟

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

  1. 移至https://server:host/system/console/configMgr的Experience Manager網頁主控台。

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

    JDBC聯結器集區

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

    • JDBC驅動程式的Java™類別名稱

    • JDBC連線URI

    • 與JDBC驅動程式建立連線的使用者名稱和密碼

    • 在​ 驗證查詢 ​欄位中指定SQL SELECT查詢,以驗證集區的連線。 查詢至少必須傳回一列。 根據您的資料庫,指定下列其中一項:

      • 選取1 (MySQL和MS® SQL)
      • 選取1個(雙Oracle)
    • 資料來源的名稱

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

    code language-text
       "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"
    
    note note
    NOTE
    如需詳細資訊,請參閱使用JDBC DataSourcePool🔗的SQL連線。
  4. 選取​ 儲存 ​以儲存組態。

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

設定雲端服務設定的資料夾 cloud-folder

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

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

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

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

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

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

    2. 在​ 設定屬性 ​對話方塊中,啟用​ 雲端設定

    3. 選取​ 儲存並關閉 ​以儲存設定並結束對話方塊。

  3. 在​ 設定瀏覽器 ​中,選取​ 建立

  4. 在​ 建立設定 ​對話方塊中,指定資料夾的標題,並啟用​ 雲端設定

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

設定RESTful Web服務 configure-restful-web-services

可在Swagger定義檔中使用JSON或YAML格式的Swagger規格來描述RESTful Web服務。 若要以Experience Manageras a Cloud Service設定RESTful Web服務,請確定您的檔案系統上有Swagger檔案(Swagger 2.0版)或Swagger檔案(Swagger 3.0版),或是裝載該檔案的URL。

設定Open API規格版本2.0的RESTful服務 configure-restful-services-open-api-2.0

  1. 移至​ 工具>Cloud Service>資料來源。 選取以選取您要建立雲端設定的資料夾。

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

  2. 選取​ 建立 ​以開啟​ 建立資料Source設定精靈。 指定設定的名稱及標題,從​ 服務型別 ​下拉式清單中選取​ RESTful服務,選擇性地瀏覽並選取設定的縮圖影像,然後選取​ 下一步

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

    • 從Swagger Source下拉式清單中選取URL或檔案,並相應地指定​ Swagger定義檔案的Swagger URL或從您的本機檔案系統上傳Swagger檔案。

    • 根據​ Swagger Source輸入,下列欄位已預先填入值:

      • 配置: REST API使用的傳輸通訊協定。 下拉式清單中顯示的配置型別數目,取決於Swagger來源中定義的配置。
      • 主機:提供REST API之主機的網域名稱或IP位址。 這是必填欄位。
      • 基本路徑:所有API路徑的URL首碼。 它是選用欄位。
        如有需要,請編輯這些欄位的預先填入值。
    • 選取驗證型別 — 無、OAuth2.0(授權碼使用者端認證)、基本驗證、API金鑰或自訂驗證 — 以存取RESTful服務,並相應地提供驗證的詳細資料。

    如果您選取​ API金鑰 ​作為驗證型別,請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從​ 位置 ​下拉式清單中選取其中一個選項,並相應地在​ 引數名稱 ​欄位中指定標頭名稱或查詢引數。

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

設定Open API規格3.0版的RESTful服務 configure-restful-services-open-api-3.0

  1. 移至​ 工具>Cloud Service>資料來源。 選取以選取您要建立雲端設定的資料夾。

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

  2. 選取​ 建立 ​以開啟​ 建立資料Source設定精靈。 指定設定的名稱及標題,從​ 服務型別 ​下拉式清單中選取​ RESTful服務,選擇性地瀏覽並選取設定的縮圖影像,然後選取​ 下一步

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

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

    如果您選取​ API金鑰 ​作為驗證型別,請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從​ 位置 ​下拉式清單中選取其中一個選項,並相應地在​ 引數名稱 ​欄位中指定標頭名稱或查詢引數。

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

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

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

如需詳細資訊,請參閱OpenAPI 3.0規格

表單資料模型(FDM) HTTP使用者端設定可最佳化效能 fdm-http-client-configuration

Experience Manager Forms在與RESTful Web服務整合時形成資料模型,因為資料來源包括用於效能最佳化的HTTP使用者端設定。

設定REST資料來源​ 組態的 ​表單資料模型HTTP使用者端組態的下列屬性,以指定規則運算式:

  • 使用http.connection.max.per.route屬性設定表單資料模型(FDM)與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使用者端設定對話方塊中:

    • 在​ 連線限制(共 ​個欄位)中,指定表單資料模型(FDM)與RESTful Web服務之間允許的最大連線數目。 預設值為20個連線。

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

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

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

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

設定SOAP網站服務 configure-soap-web-services

以SOAP為基礎的Web服務是使用Web服務描述語言(WSDL)規格來描述。 Experience Manager Forms不支援RPC樣式的WSDL模型。

若要以Experience Manageras a Cloud Service設定SOAP架構的Web服務,請確定您擁有Web服務的WSDL URL,並執行下列動作:

  1. 移至​ 工具>Cloud Service>資料來源。 選取以選取您要建立雲端設定的資料夾。

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

  2. 選取​ 建立 ​以開啟​ 建立資料Source設定精靈。 指定組態的名稱與標題,從​ 服務型別 ​下拉式清單中選取​ SOAP Web服務,瀏覽並選取組態的縮圖影像,然後選取​ 下一步

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

    • Web服務的WSDL URL。

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

    • 選取驗證型別 — None、OAuth2.0(授權碼使用者端認證)、Basic Authentication或Custom Authentication — 以存取SOAP服務,並相應地提供驗證的詳細資料。

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

啟用在SOAP Web服務WSDL中使用匯入陳述式 enable-import-statements

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

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

{
  "importAllowlistPattern": ".*"
}

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

設定OData服務 config-odata

OData服務由其服務根URL識別。 若要以Experience Manageras a Cloud Service設定OData服務,請確定您有服務的服務根URL,並執行下列動作:

NOTE
表單資料模型(FDM)支援OData 4版。
如需設定Microsoft®® Dynamics 365 (線上或內部部署)的逐步指南,請參閱Microsoft® Dynamics OData設定
  1. 移至​ 工具>Cloud Service>資料來源。 選取以選取您要建立雲端設定的資料夾。

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

  2. 選取​ 建立 ​以開啟​ 建立資料Source設定精靈。 指定組態的名稱與標題,從​ 服務型別 ​下拉式清單中選取​ OData服務,選擇性地瀏覽並選取組態的縮圖影像,然後選取​ 下一步

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

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

    如果您選取​ API金鑰 ​作為驗證型別,請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從​ 位置 ​下拉式清單中選取其中一個選項,並相應地在​ 引數名稱 ​欄位中指定標頭名稱或查詢引數。

    note note
    NOTE
    選取OAuth 2.0驗證型別,以使用OData端點作為服務根來連線至Microsoft®® Dynamics服務。
  4. 選取​ 建立 ​以建立OData服務的雲端設定。

後續步驟 next-steps

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab