設定資料來源

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

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

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

設定關聯式資料庫

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

1. 前往AEM網頁主控台，網址為 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. 在中指定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. 點選 儲存 以儲存設定。

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

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

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

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

   • 請參閱 設定瀏覽器 說明檔案以取得詳細資訊。

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

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

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

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

3. 在 設定瀏覽器，點選 建立.

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

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

設定RESTful Web服務

RESTful Web服務可使用以下方式描述： Swagger規格 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 Web服務時，因為資料來源包括用於效能最佳化的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 Services>資料來源」. 點選以選取您要建立雲端設定的資料夾。

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

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

3. 指定SOAP Web服務的下列專案：

   • Web服務的WSDL URL。

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

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

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

     如果您選取 相互驗證 做為驗證型別，請參閱 RESTful和SOAP Web服務的憑證式相互驗證.

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

設定OData服務

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

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. 設定 SOAP 或 RESTful 以網站服務作為資料來源，然後選取 相互驗證 做為驗證型別。 如果您為以下專案設定多個自我簽署憑證： fd-cloudservice 使用者，指定憑證的金鑰別名。

後續步驟

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

Business.Adobe.com 資源

Automated Onboarding Cms Cloud Content Intelligence Personalized Communications Headless Cms Digital Asset Management