設定資料來源

上次更新: 2023-12-08
版本 文章連結
AEM as a Cloud Service 按一下這裡
AEM 6.5 本文章

資料整合

AEM Forms資料整合可讓您設定並連線至不同的資料來源。 下列是支援的現成可用型別。 不過,只要很少自訂,您也可以整合其他資料來源。

  • 關聯式資料庫 — MySQL、Microsoft SQL Server、IBM DB2、OracleRDBMS、postgreSQL和Sybase
  • AEM使用者設定檔
  • RESTful Web服務
  • 以SOAP為基礎的web服務
  • OData服務

資料整合支援OAuth2.0(授權代碼使用者端認證)、基本驗證和API金鑰驗證是現成可用的型別,可實作自訂驗證以存取網站服務。 雖然已在AEMCloud Service中設定RESTful、SOAP型和OData服務,但在AEM Web主控台中設定關聯式資料庫的JDBC和AEM使用者設定檔的聯結器。

設定關聯式資料庫

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

  1. 前往AEM網頁主控台,位於 https://server:host/system/console/configMgr.

  2. 尋找 Apache Sling連線集區資料來源 設定。 選取以在編輯模式中開啟設定。

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

    • 資料來源的名稱
    • 儲存資料來源名稱的資料來源服務屬性
    • JDBC驅動程式的Java類別名稱
    • JDBC連線URI
    • 與JDBC驅動程式建立連線的使用者名稱和密碼
    注意

    在設定資料來源之前,請務必先加密機密資訊,例如密碼。 若要加密:

    1. 前往https://'[伺服器]:[連線埠]'/system/console/crypto.
    2. 純文字 欄位,指定要加密的密碼或任何字串,然後選取 Protect.

    加密的文字會顯示在「受保護的文字」欄位中,您可以在設定中指定該欄位。

  4. 啟用 借入時測試回訪時測試 以指定物件在從集區借入或傳回集區之前,先進行驗證。

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

    • 選取1 (MySQL和MS SQL)
    • 選取1個(雙Oracle)
  6. 選取 儲存 以儲存組態。

    注意

    如果您的Forms資料模型包含物件,而該物件是關聯式資料庫的保留關鍵字,則可能會導致資料新增、更新或擷取問題。 因此,請避免在表單資料模型中使用這類物件。

設定AEM使用者設定檔

您可以使用AEM Web Console中的使用者設定檔聯結器組態來設定AEM使用者設定檔。 請執行下列動作:

  1. 前往AEM網頁主控台: https://'[伺服器]:[連線埠]'system/console/configMgr.

  2. 尋找 AEM Forms資料整合 — 使用者設定檔聯結器設定 並選取以在編輯模式中開啟設定。

  3. 在「使用者設定檔聯結器組態」對話方塊中,您可以新增、移除或更新使用者設定檔屬性。 指定的屬性可用於表單資料模型。 使用下列格式指定使用者設定檔屬性:

    name=[property_name_with_location_in_user_profile],type=[property_type]

    範例:

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    注意

    * 在上述範例中,代表 profile/empLocation/ CRXDE結構的AEM使用者設定檔中的節點。 這表示表單資料模型可以存取 city 型別的屬性 string 出現在下的任何節點中 profile/empLocation/ 節點。 不過,包含指定屬性的節點必須遵循一致結構。

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

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

注意

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

AEM中的所有雲端服務設定都會整合至 /conf AEM存放庫中的資料夾。 根據預設, conf 資料夾包含 global 資料夾,您可在其中建立雲端服務設定。 不過,您需要為雲端設定手動啟用它。 您也可以在中建立其他資料夾 conf 建立和組織雲端服務組態。

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

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

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

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

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

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

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

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

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

設定RESTful Web服務

RESTful Web服務可使用以下方式描述 Swagger規格 JSON或YAML格式的Swagger定義檔案中。 若要在AEM雲端服務中設定RESTful Web服務,請確保您的檔案系統上有Swagger檔案,或該檔案託管所在的URL。

執行下列操作以設定RESTful服務:

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

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

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

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

    • 從「Swagger來源」下拉式清單中選取「URL」或「檔案」,並相應地指定Swagger URL至Swagger定義檔案或從本機檔案系統上傳Swagger檔案。

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

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

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

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

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

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

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

    如果您選取 相互驗證 由於是驗證型別,請參閱 RESTful和SOAP Web服務的憑證式相互驗證.

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

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

Experience Manager Forms 表單資料模型已與RESTful網路服務整合,可作為資料來源使用,且包括用於效能最佳化的HTTP使用者端設定。
執行以下步驟來設定表單資料模型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個連線。

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

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

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

設定SOAP Web服務

以下說明以SOAP為基礎的Web服務: Web服務描述語言(WSDL)規格. 若要在AEM雲端服務中設定以SOAP為基礎的Web服務,請確定您擁有Web服務的WSDL URL,並執行下列動作:

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

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

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

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

    • Web服務的WSDL URL。

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

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

      如果您選取 X509 Token 以「驗證」型別,請設定X509憑證。 如需詳細資訊,請參閱 設定憑證.
      在中指定X509憑證的KeyStore別名 金鑰別名 欄位。 請以秒數指定時間,直到驗證要求保持有效,請在 存留時間 欄位。 或者,選取以簽署訊息本文或時間戳記標題,或兩者皆簽署。

      如果您選取 相互驗證 由於是驗證型別,請參閱 RESTful和SOAP Web服務的憑證式相互驗證.

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

設定OData服務

OData服務由其服務根URL識別。 若要在AEM雲端服務中設定OData服務,請確定您擁有該服務的服務根URL,並執行下列動作:

注意

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

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

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

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

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

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

    選取OAuth 2.0驗證型別,以使用OData端點作為服務根來與Microsoft Dynamics服務連線。

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

RESTful和SOAP Web服務的憑證式相互驗證

當您啟用表單資料模型的相互驗證時,資料來源和執行表單資料模型的AEM Server會在共用任何資料之前先驗證彼此的身分。 您可以針對以REST和SOAP為基礎的連線(資料來源)使用相互驗證。 若要在您的AEM Forms環境中設定表單資料模型的相互驗證:

  1. 上傳私密金鑰(憑證)至 AEM Forms 伺服器。 若要上傳私密金鑰:
    1. 登入您的 AEM Forms server作為管理員。
    2. 瀏覽至 工具 > 安全性 > 使用者. 選取 fd-cloudservice 使用者並選取 屬性.
    3. 開啟 金鑰存放區 標籤,展開 從KeyStore檔案新增私人金鑰 選項,上傳KeyStore檔案,指定別名、密碼,然後選取 提交. 憑證已上傳。 私密金鑰別名會在憑證中提及,並在建立憑證時設定。
  2. 將信任憑證上傳至全域信任存放區。 若要上傳憑證:
    1. 瀏覽至 工具 > 安全性 > 信任存放區.
    2. 展開 從CER檔案新增憑證 選項,選取 選取憑證檔案,上傳憑證,然後選取 提交.
  3. 設定 SOAPRESTful 以網站服務作為資料來源,然後選取 相互驗證 做為驗證型別。 如果您設定多個自我簽署憑證 fd-cloudservice 使用者,指定憑證的金鑰別名。

後續步驟

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

本頁內容