設定資料來源

資料整合

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

  • 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 和連接器 Experience Manager 使用者設定檔設定於 Experience Manager web主控台。

注意

Experience Manager Forms 不支援關係資料庫。

配置雲端服務配置的資料夾

為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版),或托管檔案的URL。

請執行以下操作來配置RESTful服務:

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

    請參閱 配置雲端服務配置的資料夾 如需建立和設定雲端服務設定資料夾的相關資訊。

  2. 點選 建立 開啟 建立資料源配置嚮導. 指定配置的名稱和(可選)標題,選擇 RESTful服務服務類型 下拉式清單,(可選)瀏覽並選取設定的縮圖影像,然後點選 下一個.

  3. 為RESTful服務指定以下詳細資訊:

    • 從 Swagger源 下拉式清單,並據此指定 Swagger URL 到​ Swagger 定義檔案或上傳 Swagger 檔案。

    • 根據​ Swagger 來源輸入中,下列欄位會預先填入值:

      • 方案:REST API使用的傳輸通訊協定。 下拉式清單中顯示的配置類型數目取決於 Swagger 來源。

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

      • 基本路徑:所有API路徑的URL首碼。 此為選用欄位。\

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

    • 選取驗證類型(無、OAuth2.0、基本驗證、API密鑰或自訂驗證)以存取RESTful服務,並據此提供驗證的詳細資訊。

    如果您選取 API金鑰 作為驗證類型,請指定API金鑰的值。 API金鑰可以以要求標題或查詢參數的形式傳送。 從 位置 下拉式清單中,並指定標題的名稱或 參數名稱 欄位。

  4. 點選 建立 為RESTful服務建立雲配置。

表單資料模型HTTP用戶端設定,以最佳化效能

Experience Manager Forms 表單資料模型與RESTful網站服務整合時,作為資料來源時包含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"
}

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

執行下列步驟來設定表單資料模型HTTP用戶端:

  1. 登入 Experience Manager Forms 以管理員身分撰寫執行個體,並前往 Experience Manager web控制台套件組合。 預設URL為 https://localhost:4502/system/console/configMgr.

  2. 點選 REST資料來源的表單資料模型HTTP用戶端設定.

  3. 在 REST資料來源的表單資料模型HTTP用戶端設定 對話框:

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

    • 指定 每個路由的連接限制 欄位。 預設值為2個連線。

    • 保持活力 欄位。 預設值為15秒。

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

    • 指定 通訊端逾時 欄位。 預設值為30秒。

配置SOAP Web服務

描述基於SOAP的Web服務,使用 網站服務描述語言(WSDL)規範. Experience Manager Forms 不支援RPC樣式WSDL模型。

若要在 Experience Manager as a Cloud Service的是,請確保您具有Web服務的WSDL URL,並執行以下操作:

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

    請參閱 配置雲端服務配置的資料夾 如需建立和設定雲端服務設定資料夾的相關資訊。

  2. 點選 建立 開啟 建立資料源配置嚮導. 指定配置的名稱和(可選)標題,選擇 SOAP Web服務服務類型 下拉式清單,(可選)瀏覽並選取設定的縮圖影像,然後點選 下一個.

  3. 為SOAP Web服務指定以下內容:

    • Web服務的WSDL URL。

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

    • 選取驗證類型(無、OAuth2.0、基本驗證或自訂驗證)以存取SOAP服務,並據此提供驗證的詳細資訊。

  4. 點選 建立 為SOAP Web服務建立雲配置。

啟用在SOAP Web服務WSDL中使用導入語句

您可以指定規則運算式,作為絕對URL的篩選器,這些URL在SOAP網站服務WSDL中可作為匯入陳述式。 依預設,此欄位中沒有值。 因此, Experience Manager 阻止WSDL中可用的所有導入語句。 如果您指定 .* 作為此欄位中的值, Experience Manager 允許所有導入語句。

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

{
  "importAllowlistPattern": ".*"
}

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

配置OData服務

OData服務由其服務根URL識別。 若要在 Experience Manager as a Cloud Service,請確定您有服務的服務根URL,並執行下列操作:

注意

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

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

    請參閱 配置雲端服務配置的資料夾 如需建立和設定雲端服務設定資料夾的相關資訊。

  2. 點選 建立 開啟 建立資料源配置嚮導. 指定配置的名稱和(可選)標題,選擇 OData服務服務類型 下拉式清單,(可選)瀏覽並選取設定的縮圖影像,然後點選 下一個.

  3. 指定OData服務的以下詳細資訊:

    • 要配置的OData服務的服務根URL。
    • 選取驗證類型(無、OAuth2.0、基本驗證、API金鑰或自訂驗證)以存取OData服務,並據此提供驗證的詳細資訊。

    如果您選取 API金鑰 作為驗證類型,請指定API金鑰的值。 API金鑰可以以要求標題或查詢參數的形式傳送。 從 位置 下拉式清單中,並指定標題的名稱或 參數名稱 欄位。

    注意

    您必須選取OAuth 2.0驗證類型才能連線 Microsoft Dynamics 服務使用OData端點作為服務根。

  4. 點選 建立 為OData服務建立雲配置。

後續步驟

您已設定資料來源。 接下來,您可以建立表單資料模型,或者如果您已經建立了沒有資料源的表單資料模型,則可以將其與剛配置的資料源關聯。 請參閱 建立表單資料模型 以取得詳細資訊。

本頁內容