設定資料來源

資料整合

Experience Manager Forms 資料整合允許您配置和連接到不同的資料源。 支援開箱即用的以下類型:

  • REST風格的Web服務
  • 基於SOAP的Web服務
  • OData服務(4.0版)
  • Microsoft動力
  • SalesForce
  • MicrosoftAzure Blob儲存

資料整合支援OAuth2.0、基本身份驗證和API密鑰身份驗證類型的開箱即用,並允許為訪問Web服務實施自定義身份驗證。 而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. 點擊 建立 建立為雲服務配置啟用的資料夾。

配置REST風格的Web服務

可使用 Swagger規格 JSON或YAML格式 Swagger 定義檔案。 在中配置REST風格的Web服務 Experience Manager as a Cloud Service,確保您 Swagger 檔案(Swagger 2.0版)或檔案所在的URL。

執行以下操作以配置REST風格的服務:

  1. 轉到 工具>Cloud Services>資料源。 點擊以選擇要在其中建立雲配置的資料夾。

    請參閱 為雲服務配置配置資料夾 有關為雲服務配置建立和配置資料夾的資訊。

  2. 點擊 建立 開啟 建立資料源配置嚮導。 指定配置的名稱和標題(可選),選擇 REST風格服務服務類型 下拉,(可選)瀏覽並選擇配置的縮略圖,然後點擊 下一個

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

    • 從中選擇URL或檔案 斯瓦格源 ,並相應地指定 Swagger URL 到​ Swagger 定義檔案或上載 Swagger 檔案。

    • 基於​ Swagger 源輸入,以下欄位預填充了值:

      • 方案:REST API使用的傳輸協定。 下拉清單中顯示的方案類型數取決於在 Swagger 源。

      • 主機:為REST API提供服務的主機的域名或IP地址。 這是一個強制欄位。

      • 基本路徑:所有API路徑的URL前置詞。 它是一個可選欄位。\

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

    • 選擇身份驗證類型 — 無、OAuth2.0、基本身份驗證、API密鑰或自定義身份驗證 — 以訪問REST風格的服務,並相應地提供身份驗證的詳細資訊。

    如果選擇 API密鑰 作為驗證類型,指定API密鑰的值。 API密鑰可以作為請求頭或查詢參數發送。 從 位置 下拉清單,並在 參數名稱 欄位。

  4. 點擊 建立 為REST風格服務建立雲配置。

表單資料模型HTTP客戶端配置以優化效能

Experience Manager Forms 當與REST風格的Web服務整合為資料源時,將形成資料模型,包括用於效能優化的HTTP客戶端配置。

設定以下屬性 REST資料源的表單資料模型HTTP客戶端配置 用於指定規則運算式的配置:

  • 使用 http.connection.max.per.route 屬性,用於設定表單資料模型和REST風格的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客戶端配置 對話框:

    • 指定表單資料模型和REST風格Web服務之間允許的最大連接數 連接限制總數 的子菜單。 預設值為20個連接。

    • 指定中每個路由允許的最大連接數 每個路由的連接限制 的子菜單。 預設值為2個連接。

    • 指定持續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,並執行以下操作:

  1. 轉到 工具>Cloud Services>資料源。 點擊以選擇要在其中建立雲配置的資料夾。

    請參閱 為雲服務配置配置資料夾 有關為雲服務配置建立和配置資料夾的資訊。

  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 Configurations,並將設定部署至您的 Cloud Service 執行個體。

配置OData服務

OData服務由其服務根URL標識。 在中配置OData服務 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服務建立雲配置。

後續步驟

您已配置資料源。 接下來,您可以建立表單資料模型,或者如果您已經建立了一個沒有資料源的表單資料模型,則可以將其與剛剛配置的資料源關聯。 請參閱 建立表單資料模型 的雙曲餘切值。

本頁內容