AEM Forms Data Integration可讓您設定並連線至不同的資料來源。 下列類型是現成可用的支援。 不過,只需少量自訂,您也可以整合其他資料來源。
資料整合支援OAuth2.0、基本驗證和API金鑰驗證類型立即可用,並可實作自訂驗證以存取網站服務。 雖然RESTful、SOAP架構和OData服務已在AEM Cloud Services中設定,但AEM Web主控台中已設定關係式資料庫的JDBC和AEM使用者設定檔的連接器。
您可以使用AEM Web Console Configuration來設定關係式資料庫。 執行下列動作:
前往https://server:host/system/console/configMgr的AEM網頁主控台。
尋找Apache Sling Connection Pooled DataSource組態。 點選以在編輯模式中開啟設定。
在配置對話框中,指定要配置的資料庫的詳細資訊,例如:
在設定資料來源之前,請務必先加密機密資訊,例如密碼。 要加密:
加密的文字會出現在「受保護的文字」欄位中,您可在設定中指定。
啟用「借用時測試」或「返回時測試」,以指定在分別從池借用或返回對象之前先驗證對象。
在驗證查詢欄位中指定SQL SELECT查詢,以驗證池中的連接。 查詢至少必須返回一行。 根據您的資料庫,指定下列其中一項:
點選「儲存」以儲存設定。
您可以在AEM Web Console中使用「使用者描述檔連接器」設定來設定AEM使用者描述檔。 執行下列動作:
前往https://'[server]的AEM網頁主控台:[port]'system/console/configMgr。
尋找AEM Forms Data Integrations - User Profile Connector Configuration,然後點選以編輯模式開啟設定。
在「用戶配置檔案連接器配置」對話框中,可以添加、刪除或更新用戶配置檔案屬性。 指定的屬性將可用於表單資料模型中。 使用以下格式指定用戶配置檔案屬性:
name=[property_name_with_location_in_user_profile],type=[property_type]
範例:
name=profile/phoneNumber,type=string
name=profile/empLocation/*/city,type=string
上例中的*****表示CRXDE結構中AEM用戶配置檔案中profile/empLocation/
節點下的所有節點。 這表示表單資料模型可以訪問profile/empLocation/
節點下任何節點中存在的city
類型string
屬性。 但是,包含指定屬性的節點必須遵循一致的結構。
點選「儲存」以儲存設定。
為RESTful、SOAP和OData服務配置雲端服務時,需要配置雲端服務資料夾。
AEM中的所有雲端服務設定都整合在AEM存放庫的/conf
資料夾中。 依預設,conf
資料夾包含global
資料夾,您可在其中建立雲端服務組態。 不過,您必須針對雲端組態手動啟用它。 您也可以在conf
中建立其他資料夾,以建立並組織雲端服務組態。
要為雲端服務配置配置資料夾:
前往工具>一般>組態瀏覽器。
請執行下列動作,為雲端設定啟用全域資料夾,或略過此步驟,為雲端服務設定建立並設定另一個資料夾。
在配置瀏覽器中,選擇global
資料夾並按一下屬性。
在配置屬性對話框中,啟用雲配置。
點選儲存並關閉以儲存設定並退出對話方塊。
在配置瀏覽器中,按一下建立。
在建立設定對話方塊中,指定資料夾的標題並啟用雲端設定。
點選「建立」以建立可用於雲端服務組態的資料夾。
REST風格的Web服務可在Swagger定義檔案中使用Swagger規格的JSON或YAML格式來說明。 若要在AEM雲端服務中設定REST風格的網站服務,請確定您的檔案系統上有Swagger檔案,或是檔案所在的URL。
執行以下操作以配置REST風格的服務:
前往工具>雲端服務>資料來源。 點選以選取您要建立雲端設定的檔案夾。
如需建立和設定雲端服務組態資料夾的相關資訊,請參閱設定雲端服務組態資料夾。
點選Create以開啟建立資料來源設定精靈。 指定配置的名稱和可選的標題,從服務類型下拉式清單中選擇RESTful Service,選擇瀏覽並選擇配置的縮略圖,然後點選Next。
為RESTful服務指定以下詳細資訊:
從「Swagger來源」下拉式清單中選取「URL」或「檔案」,並據以指定Swagger定義檔案的Swagger URL,或從本機檔案系統上傳Swagger檔案。
根據Swagger來源輸入,下列欄位會預先填入值:
方案:REST API使用的傳輸通訊協定。 下拉式清單中顯示的方案類型數目取決於Swagger來源中定義的方案。
主機:提供REST API的主機的域名或IP地址。 這是一個強制欄位。
基本路徑:所有API路徑的URL首碼。 此欄位為選擇性欄位。\
如有必要,請編輯這些欄位的預先填入值。
選擇驗證類型— 無、OAuth2.0、基本驗證、API金鑰、自訂驗證或相互驗證— 訪問REST風格的服務,並相應地提供驗證的詳細資訊。
如果您選擇API金鑰作為驗證類型,請指定API金鑰的值。 API金鑰可以以請求標題或查詢參數的形式傳送。 從位置下拉式清單中選擇其中一個選項,並在參數名稱欄位中指定標題或查詢參數的名稱。
如果選擇互相驗證作為驗證類型,請參見基於證書的REST風格和SOAP Web服務。
點選Create以建立REST風格服務的雲端設定。
Experience Manager Forms 當與REST風格的Web服務整合作為資料源時,將形成資料模型,包括用於效能優化的HTTP客戶端配置。執行以下步驟來配置表單資料模型HTTP客戶端:
以管理員身分登入「Experience Manager Forms作者例項」,並前往「Experience Manager網頁主控台組合」。 預設URL為https://localhost:4502/system/console/configMgr。
點選「表單資料模型Http用戶端設定」以取得REST資料來源。
在表單資料模型REST資料源的Http客戶端配置對話框中:
在總數欄位中的「連接限制」中,指定表單資料模型與REST風格Web服務之間允許的最大連接數。 預設值為20個連接。
在Connection limit on per route basis欄位中,指定每條路由允許的最大連接數。 預設值為2個連接。
在Keep alive欄位中,指定持續HTTP連線保持有效的持續時間。 預設值為15秒。
在連接超時欄位中,指定Experience Manager Forms伺服器等待連接建立的持續時間。 預設值為10秒。
在通訊端逾時欄位中,指定兩個資料封包之間未活動的最長時段。 預設值為30秒。
使用網站服務描述語言(WSDL)規範來說明以SOAP為基礎的網站服務。 若要在AEM雲端服務中設定以SOAP為基礎的Web服務,請確定您擁有Web服務的WSDL URL,並執行下列動作:
前往工具>雲端服務>資料來源。 點選以選取您要建立雲端設定的檔案夾。
如需建立和設定雲端服務組態資料夾的相關資訊,請參閱設定雲端服務組態資料夾。
點選Create以開啟建立資料來源設定精靈。 指定配置的名稱和可選的標題,從服務類型下拉式清單中選擇SOAP Web Service,選擇瀏覽並選擇配置的縮略圖,然後點選Next。
為SOAP Web服務指定以下內容:
Web服務的WSDL URL。
服務端點. 在此欄位中指定一個值,以覆蓋WSDL中提及的服務端點。
選擇驗證類型— 無、OAuth2.0、基本驗證、自訂驗證、X509 Token或相互驗證— 存取SOAP服務,並據以提供驗證的詳細資訊。
如果您選擇X509 Token作為驗證類型,請配置X509證書。 如需詳細資訊,請參閱設定憑證。
在鍵別名欄位中為X509證書指定KeyStore別名。 在即時時間欄位中,指定驗證要求保持有效的時間(以秒為單位)。 (可選)選擇簽署消息正文或時間戳標題或兩者。
如果選擇互相驗證作為驗證類型,請參見基於證書的REST風格和SOAP Web服務。
點選「建立」以建立SOAP網站服務的雲端設定。
OData服務由其服務根URL標識。 若要在AEM雲端服務中設定OData服務,請確定您有服務的服務根URL,並執行下列動作:
有關配置Microsoft Dynamics 365的逐步指南(線上或內部),請參閱Microsoft Dynamics OData Configuration。
前往工具>雲端服務>資料來源。 點選以選取您要建立雲端設定的檔案夾。
如需建立和設定雲端服務組態資料夾的相關資訊,請參閱設定雲端服務組態資料夾。
點選Create以開啟建立資料來源設定精靈。 指定配置的名稱和可選標題,從服務類型下拉式清單中選擇OData服務,選擇瀏覽並選擇配置的縮略圖,然後點選Next。
為OData服務指定以下詳細資訊:
您必須選擇OAuth 2.0驗證類型,以OData端點作為服務根目錄與Microsoft Dynamics服務連接。
點選Create以建立OData服務的雲端設定。
當您為表單資料模型啟用相互驗證時,執行表單資料模型的資料來源和AEM Server都會先驗證彼此的身分,然後再共用任何資料。 您可以對基於REST和SOAP的連接(資料源)使用相互驗證。 若要在AEM Forms環境上為表單資料模型設定相互驗證:
fd-cloudservice
用戶,然後點選屬性。fd-cloudservice
用戶配置多個自簽名證書,請指定證書的「密鑰別名」。您已設定資料來源。 接下來,您可以建立表單資料模型,或如果您已建立不含資料來源的表單資料模型,則可將其與您剛設定的資料來源建立關聯。 如需詳細資訊,請參閱建立表單資料模型。