設定資料來源 configure-data-sources
Experience Manager Forms資料整合可讓您設定並連線至不同的資料來源。 下列是支援的現成可用型別：
- 關聯式資料庫 — MySQL、Microsoft® SQL Server、IBM® DB2®、postgreSQL、Azure SQL和Oracle RDBMS
- RESTful Web服務
- SOAP型網站服務
- OData服務（4.0版）
- Microsoft® Dynamics
- Salesforce
- Microsoft® Azure Blob儲存體
資料整合可支援OAuth2.0（授權代碼、使用者端認證）、基本驗證及API金鑰驗證型別，並且允許實作自訂驗證以存取Web服務。 在Experience Manager as a Cloud Service中設定RESTful、SOAP型和OData服務時，在Experience Manager Web主控台中設定關聯式資料庫的JDBC和Experience Manager使用者設定檔的聯結器。
設定關聯式資料庫 configure-relational-database
先決條件
在使用Experience Manager Web主控台組態設定關聯式資料庫之前，必須：
- 透過Cloud Manager API啟用進階網路，因為連線埠預設為停用。
- 在Maven中新增JDBC驅動程式相依性。
設定關聯式資料庫的步驟
您可以使用Experience Manager Web主控台組態來設定關聯式資料庫。 請執行下列動作：
步驟1：複製AEM as a Cloud Service Git存放庫
-
開啟命令列，並選擇要儲存AEM as a Cloud Service存放庫的目錄，例如
/cloud-service-repository/。 -
執行以下命令以複製存放庫：
code language-none git clone https://git.cloudmanager.adobe.com/<organization-name>/<app-id>/在哪裡可以找到此資訊？
如需尋找這些詳細資訊的逐步指示，請參閱Adobe Experience League文章"存取Git"。
當命令成功完成時，您會看到在本機目錄中建立的新資料夾。 此資料夾是以您的應用程式命名。
步驟2：瀏覽至設定資料夾
-
在編輯器中開啟存放庫資料夾。
-
導覽至
<application folder>中的下列目錄，其中應放置JDBC集區的OSGi設定：code language-bash cd ui.config/src/jcr_root/apps/<application folder>/osgiconfig/config/
步驟3：建立MySQL連線組態檔
-
建立檔案：
code language-bash com.day.commons.datasource.jdbcpool.JdbcPoolService~<application folder>-mysql.cfg.json -
新增下列幾行程式碼：
{
"jdbc.driver.class": "com.mysql.cj.jdbc.Driver",
"jdbc.connection.uri": "jdbc:mysql://<hostname>:<port>/<database>?useSSL=false",
"jdbc.username": "<your-db-username>",
"jdbc.password": "<your-db-password>",
"datasource.name": "<application folder>-mysql",
"datasource.svc.prop.name": "<application folder>-mysql"
}
將
<application folder>、<hostname>、<database>、<your-db-username>和<your-db-password>等預留位置取代為實際值。
步驟4：認可並推送變更
開啟終端機並執行下列命令：
git add .
git commit -m "<commit message>"
git push
步驟5：透過Cloud Manager管道部署變更
- 登入AEM Cloud Manager。
- 導覽至您的專案並執行管道以部署變更。
設定雲端服務設定的資料夾 cloud-folder
設定RESTful、SOAP和OData服務的雲端服務時，需要設定雲端服務資料夾。
Experience Manager中的所有雲端服務設定都已整合到/conf存放庫的Experience Manager資料夾中。 根據預設，conf資料夾包含您可以建立雲端服務設定的global資料夾。 不過，您必須手動為雲端設定啟用它。 您也可以在conf中建立其他資料夾，以建立並組織雲端服務設定。
若要設定雲端服務設定的資料夾：
-
前往工具 > 一般 > 設定瀏覽器。
- 如需詳細資訊，請參閱設定瀏覽器檔案。
-
請執行以下操作來啟用雲端設定的全域資料夾，或跳過此步驟來建立和設定雲端服務設定的另一個資料夾。
-
在 設定瀏覽器 中，選取
global資料夾並選取屬性。 -
在「設定屬性」對話框中，啟用雲端設定。
-
選取「儲存並關閉」，即可儲存設定並退出對話框。
-
-
在 設定瀏覽器 中，選取建立。
-
在 建立設定 對話方塊中，指定資料夾的標題，並啟用雲端設定。
-
選取 建立 以建立為雲端服務設定啟用的資料夾。
設定RESTful Web服務 configure-restful-web-services
可在定義檔或服務端點中使用JSON或YAML格式的Swagger規格Swagger來描述RESTful Web服務。
為Open API規格2.0版設定RESTful服務 configure-restful-services-open-api-2.0
-
移至工具>雲端服務>資料來源。 選取以選取您要建立雲端設定的資料夾。
請參閱設定雲端服務設定的資料夾，以取得關於建立和設定雲端服務設定的資料夾的資訊。
-
選取 建立 以開啟建立資料Source設定精靈。 指定設定的名稱及標題，從 服務型別 下拉式清單中選取RESTful服務，選擇性地瀏覽並選取設定的縮圖影像，然後選取下一步。
-
指定RESTful服務的下列詳細資料：
-
從Swagger Source下拉式清單中選取URL或檔案，並相應地指定Swagger URL定義檔案的 Swagger或從您的本機檔案系統上傳Swagger檔案。
-
根據 Swagger Source輸入，下列欄位已預先填入值：
- 配置： REST API使用的傳輸通訊協定。 下拉式清單中顯示的配置型別數目，取決於Swagger來源中定義的配置。
- 主機：提供REST API之主機的網域名稱或IP位址。 這是必填欄位。
- 基本路徑：所有API路徑的URL首碼。 它是選用欄位。
如有需要，請編輯這些欄位的預先填入值。
-
選取驗證型別 — 無、OAuth2.0（授權碼、使用者端認證）、基本驗證、API金鑰或自訂驗證 — 以存取RESTful服務，並相應地提供驗證的詳細資料。
如果您選取 API金鑰 作為驗證型別，請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從 位置 下拉式清單中選取其中一個選項，並相應地在 引數名稱 欄位中指定標頭名稱或查詢引數。
-
-
選取 建立 以建立RESTful服務的雲端設定。
為Open API規格3.0版設定RESTful服務 configure-restful-services-open-api-3.0
-
移至工具>雲端服務>資料來源。 選取以選取您要建立雲端設定的資料夾。
請參閱設定雲端服務設定的資料夾，以取得關於建立和設定雲端服務設定的資料夾的資訊。
-
選取 建立 以開啟建立資料Source設定精靈。 指定設定的名稱及標題，從 服務型別 下拉式清單中選取RESTful服務，選擇性地瀏覽並選取設定的縮圖影像，然後選取下一步。
-
指定RESTful服務的下列詳細資料：
- 從Swagger Source下拉式清單中選取URL或檔案，並相應地指定Swagger 3.0 URL定義檔案的 Swagger或從您的本機檔案系統上傳Swagger檔案。
- 根據 Swagger Source輸入，會顯示與目標伺服器的連線資訊。
- 選取驗證型別 — 無、OAuth2.0（授權碼、使用者端認證）、基本驗證、API金鑰或自訂驗證 — 以存取RESTful服務，並相應地提供驗證的詳細資料。
如果您選取 API金鑰 作為驗證型別，請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從 位置 下拉式清單中選取其中一個選項，並相應地在 引數名稱 欄位中指定標頭名稱或查詢引數。
-
選取 建立 以建立RESTful服務的雲端設定。
RESTful Services Open API Specification 3.0版不支援的作業包括：
- 回呼
- oneof/any of
- 遠端參考
- 連結
- 針對單一作業的不同MIME型別，有不同的要求內文
如需詳細資訊，請參閱OpenAPI 3.0規格。
使用服務端點設定RESTful服務 configure-restful-services-service-endpoint
Service Endpoint功能在Early Adopter Program之下，僅適用於核心元件。 您可以使用官方電子郵件 ID 寫信至 aem-forms-ea@adobe.com，以加入早期採用者計劃並要求存取該功能。
-
移至工具>雲端服務>資料來源。 選取以選取您要建立雲端設定的資料夾。
請參閱設定雲端服務設定的資料夾，以取得關於建立和設定雲端服務設定的資料夾的資訊。
-
選取 建立 以開啟建立資料Source設定精靈。
-
指定設定的名稱及標題，從 服務型別 下拉式清單中選取RESTful服務，選擇性地瀏覽並選取設定的縮圖影像，然後選取下一步。
-
在下一個頁面，從 RESTful服務下拉式清單 中選取服務端點。
-
指定服務端點URL。
note note NOTE 依預設，「方法型別」為POST。 1. 選取您要從下拉式清單中選擇的其中一個「內容型別」。 內容型別為多部分表單資料、JSON和URL編碼（索引鍵值配對）。
-
現在，您可以從下拉式清單中選取任一驗證型別，例如OAuth 2.0、基本驗證、API金鑰、自訂驗證。
-
按一下「建立」。
表單資料模型(FDM) HTTP使用者端設定可最佳化效能 fdm-http-client-configuration
Experience Manager Forms在與RESTful Web服務整合時形成資料模型，因為資料來源包括用於效能最佳化的HTTP使用者端設定。
設定REST資料來源 組態的 表單資料模型HTTP使用者端組態的下列屬性，以指定規則運算式：
-
使用
http.connection.max.per.route屬性設定表單資料模型(FDM)與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"
}
-
選取REST資料來源 的 表單資料模型HTTP使用者端組態。
-
在REST資料來源的表單資料模型HTTP使用者端設定對話方塊中：
-
在 連線限制（共 個欄位）中，指定表單資料模型(FDM)與RESTful Web服務之間允許的最大連線數目。 預設值為20個連線。
-
在 每個路由的連線限制 欄位中，指定每個路由允許的最大連線數目。 預設值是兩個連線。
-
在 保持連線 欄位中指定持續性HTTP連線持續運作的持續時間。 預設值為15秒。
-
在Experience Manager Forms連線逾時 欄位中指定 伺服器等待連線建立的持續時間。 預設值為10秒。
-
在 通訊端逾時 欄位中，指定兩個資料封包之間閒置的最長時間。 預設值為30秒。
-
設定SOAP網站服務 configure-soap-web-services
以SOAP為基礎的Web服務是使用Web服務描述語言(WSDL)規格來描述。 Experience Manager Forms不支援RPC樣式的WSDL模型。
若要在Experience Manager as a Cloud Service中設定SOAP式Web服務，請確定您擁有Web服務的WSDL URL，並執行下列動作：
-
移至工具>雲端服務>資料來源。 選取以選取您要建立雲端設定的資料夾。
請參閱設定雲端服務設定的資料夾，以取得關於建立和設定雲端服務設定的資料夾的資訊。
-
選取 建立 以開啟建立資料Source設定精靈。 指定設定的名稱及標題，從 服務型別 下拉式清單中選取SOAP Web服務，瀏覽並選取設定的縮圖影像，然後選取下一步。
-
針對SOAP Web服務指定下列專案：
-
選取 建立 以建立SOAP Web服務的雲端設定。
啟用在SOAP網站服務WSDL中使用匯入陳述式 enable-import-statements
您可以指定規則運算式，用來篩選在SOAP Web服務WSDL中允許做為匯入陳述式的絕對URL。 依預設，此欄位中沒有值。 因此，Experience Manager會封鎖WSDL中可用的所有匯入陳述式。 如果您在此欄位中指定.*為值，Experience Manager會允許所有匯入陳述式。
設定importAllowlistPattern表單資料模型SOAP Web服務匯入允許清單 設定的 屬性，以指定規則運算式。 下列JSON檔案顯示範例：
{
"importAllowlistPattern": ".*"
}
若要設定值，請使用 AEM SDK 產生 OSGi 設定，並將設定部署至您的 Cloud Service 執行個體。
設定OData服務 config-odata
OData服務由其服務根URL識別。 若要在Experience Manager as a Cloud Service中設定OData服務，請確定您擁有該服務的服務根URL，並執行下列動作：
-
移至工具>雲端服務>資料來源。 選取以選取您要建立雲端設定的資料夾。
請參閱設定雲端服務設定的資料夾，以取得關於建立和設定雲端服務設定的資料夾的資訊。
-
選取 建立 以開啟建立資料Source設定精靈。 指定組態的名稱與標題，從 服務型別 下拉式清單中選取OData服務，選擇性地瀏覽並選取組態的縮圖影像，然後選取下一步。
-
指定OData服務的下列詳細資料：
如果您選取 API金鑰 作為驗證型別，請指定API金鑰的值。 API金鑰可作為請求標頭或查詢引數傳送。 從 位置 下拉式清單中選取其中一個選項，並相應地在 引數名稱 欄位中指定標頭名稱或查詢引數。
note note NOTE 選取OAuth 2.0驗證型別，以使用OData端點作為服務根來連線至Microsoft®® Dynamics服務。 -
選取 建立 以建立OData服務的雲端設定。
後續步驟 next-steps
您已設定資料來源。 接下來，您可以建立表單資料模型(FDM)，或者，如果您已建立不含資料來源的表單資料模型(FDM)，則可以將其與您設定的資料來源建立關聯。 如需詳細資訊，請參閱建立表單資料模型。