設定資料來源

資料整合

AEM Forms資料整合可讓您設定並連線至不同的資料來源。 下列類型可立即使用。 不過,只要很少自訂,您也可以整合其他資料來源。

  • 關係資料庫 — MySQL、Microsoft SQL Server、IBM DB2、OracleRDBMS和Sybase
  • AEM使用者設定檔
  • RESTful Web服務
  • 基於SOAP的Web服務
  • OData服務

資料整合支援OAuth2.0、基本驗證和API金鑰驗證類型,且可立即使用,並可實作自訂驗證以存取網站服務。 雖然AEM雲端服務中已設定RESTful、SOAP型和OData服務,但AEM web主控台中已設定關係資料庫的JDBC和AEM使用者設定檔的連接器。

配置關係資料庫

您可以使用AEM Web控制台配置配置關係資料庫。 請執行下列動作:

  1. 前往AEM Web主控台,網址為 https://server:host/system/console/configMgr.

  2. 尋找 Apache Sling Connection Pooled DataSource 設定。 點選以在編輯模式中開啟設定。

  3. 在配置對話框中,指定要配置的資料庫的詳細資訊,例如:

    • 資料源的名稱
    • 儲存資料源名稱的資料源服務屬性
    • JDBC驅動程式的Java類名
    • JDBC連接URI
    • 用於建立與JDBC驅動程式連接的用戶名和口令
    注意

    在配置資料源之前,請確保加密密碼等敏感資訊。 要加密:

    1. 前往https://'[伺服器]:[埠]「/system/console/crypto」。
    2. 純文字 欄位,指定要加密和點選的密碼或任何字串 Protect.

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

  4. 啟用 借閱時測試返回時測試 指定在從和中借用對象或將對象返回到池之前,分別驗證對象。

  5. 驗證查詢 欄位,驗證池中的連接。 查詢必須至少返回一行。 根據您的資料庫,指定下列任一項:

    • 選擇1(MySQL和MS SQL)
    • 從雙(Oracle)中選擇1
  6. 點選 儲存 以儲存設定。

    注意

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

設定AEM使用者設定檔

您可以使用AEM Web Console中的「使用者設定檔連接器」設定來設定AEM使用者設定檔。 請執行下列動作:

  1. 前往AEM Web主控台,網址為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結構中)。 這表示表單資料模型可以存取 city 類型屬性 string 存在於 profile/empLocation/ 節點。 但是,包含指定屬性的節點必須遵循一致的結構。

  4. 點選 儲存 以儲存設定。

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

注意

為RESTful、SOAP和OData服務配置雲服務時,需要配置雲服務資料夾。

AEM中的所有雲端服務設定皆已整合至 /conf 資料夾。 依預設, conf 資料夾包含 global 可在其中建立雲端服務設定的資料夾。 不過,您必須為雲端設定手動啟用此功能。 您也可以在 conf 來建立和組織雲端服務設定。

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

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

  2. 請執行下列操作以啟用雲配置的全局資料夾,或跳過此步驟以建立和配置雲服務配置的其他資料夾。

    1. 配置瀏覽器,請選取 global 資料夾和點選 屬性.

    2. 配置屬性 對話框,啟用 雲端設定.

    3. 點選 儲存並關閉 以保存配置並退出對話框。

  3. 配置瀏覽器,點選 建立.

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

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

配置RESTful Web服務

RESTful Web服務可使用 Swagger規格 JSON或YAML格式。 若要在AEM雲端服務中設定RESTful Web服務,請確定您的檔案系統上有Swagger檔案,或檔案托管所在的URL。

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

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

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

  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個連線。

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

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

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

配置SOAP Web服務

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

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

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

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

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

    • Web服務的WSDL URL。

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

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

      如果您選取 X509代號 作為「驗證」類型,請配置X509證書。 如需詳細資訊,請參閱 設定憑證.
      密鑰別名 欄位。 在 存留時間 欄位。 (可選)選擇簽署消息正文或時間戳標頭或兩者。

      如果您選取 相互驗證 如需驗證類型,請參閱 RESTful和SOAP Web服務的基於證書的相互驗證.

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

配置OData服務

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

注意

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

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

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

  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 伺服器。
    2. 導覽至 工具 > 安全性 > 使用者. 選取 fd-cloudservice 使用者和點選 屬性.
    3. 開啟 金鑰存放區 頁簽,展開 從KeyStore檔案新增私密金鑰 選項,上載KeyStore檔案,指定別名、密碼,然後點選 提交. 已上傳憑證。 私鑰別名在證書中提及,並在建立證書時設定。
  2. 上傳信任證書到全局信任儲存。 上傳憑證:
    1. 導覽至 工具 > 安全性 > 信任儲存.
    2. 展開 從CER檔案添加證書 選項,點選 選擇證書檔案,上傳憑證,然後點選 提交.
  3. 設定 SOAPRESTful 網站服務作為資料來源,並選取 相互驗證 作為驗證類型。 如果您為配置多個自簽名證書 fd-cloudservice 用戶,指定證書的密鑰別名。

後續步驟

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

本頁內容