服務容器

位於服務容器中的AEM Forms服務(包括標準服務,例如加密服務、長期和短期程式)可使用各種提供者(例如EJB提供者)來呼叫。 EJB提供者可讓AEM Forms服務透過RMI/IIOP來呼叫。 Web服務提供者使用標準(例如SOAP/HTTP和SOAP/JMS),將服務公開為Web服務(WSDL產生)。

下表說明您以程式設計方式叫用AEM Forms服務的不同方式。

調用方法

說明

遠端整合

遠端整合可讓Flex用戶端叫用服務作業。 (請參閱使用(AEM表單已過時)AEM Forms Remoting叫用AEM Forms。)

Java API

Java API可以叫用AEM Forms服務。 Java API會組織為用戶端程式庫和Java呼叫API。 (請參閱使用Java API叫用AEM Forms。)

網站服務

AEM Forms支援網站服務標準,例如SOAP/HTTP。 服務可以公開為Web服務,而WSDL符合W3C所定義的Web服務標準。

可以從任何Web服務堆棧(包括。NET Framework和Sun™ Web Services SDK)調用服務。 (請參閱使用Web Services叫用AEM Forms)。

REST請求

AEM Forms支援REST請求。 您可以直接從HTML頁面呼叫服務。 (請參閱使用REST請求叫用AEM表單)。

下圖以視覺化方式呈現AEM Forms服務以程式設計方式呼叫的不同方式。

注意

除了使用AEM Forms SDK建立可叫用AEM Forms服務的用戶端應用程式外,您也可以建立可部署至服務容器的元件。 例如,您可以建立包含可用於流程的自訂資料類型的Bank元件。 也就是說,您可以建立資料類型,例如com.adobe.idp.BankAccount。 然後,您可以在客戶端應用程式中建立com.adobe.idp.BankAccount實例。

服務容器提供下列功能:

  • 可讓AEM Forms服務使用不同的方法來呼叫。 您可以通過設定端點來配置服務,以便使用所有方法調用該服務:遠端、Java API、web services和REST。 (請參閱以程式設計方式管理端點)。

  • 將消息轉換為稱為調用請求的標準化格式。 調用請求從客戶端應用程式(或其他服務)發送到位於服務容器中的服務。 調用請求包含諸如要調用的服務的名稱和執行該操作所需的資料值之類的資訊。 許多服務都需要檔案來執行操作。 因此,呼叫請求通常包含檔案,檔案可以是PDF資料、XDP資料、XML資料等。

  • 將調用請求路由到適當的服務(要調用的服務的名稱是調用請求的一部分)。

  • 執行任務,例如確定呼叫者是否具有調用指定服務操作的權限。 呼叫請求必須包含有效的AEM表單使用者名稱和密碼。

    向服務發送調用請求有不同的方法。 此外,傳送所需輸入值至服務的方式也不同。 例如,假設您使用Java API來叫用需要PDF檔案的服務。 對應的Java方法包含接受PDF檔案的參數。 在這種情況下,參數的資料類型為com.adobe.idp.Document。 (請參閱「使用Java API](/docs/experience-manager-64/forms/developing/invoking-aem-forms-using-java.html?lang=zh-Hant#passing-data-to-aem-forms-services-using-the-java-api)將資料傳送至AEM Forms服務」)。[

    如果您使用監視資料夾調用服務,則在將檔案放置到已配置的監視資料夾中時,將發送調用請求。 如果您使用電子郵件叫用服務,則當電子郵件訊息送達已設定的收件匣時,會將呼叫請求傳送至服務。

    一旦執行操作,服務容器就發回調用響應。 調用響應包含操作結果等資訊。 例如,如果操作修改PDF文檔,則調用響應將包含修改的PDF文檔。 如果操作失敗,則調用響應包含錯誤消息。

    可以以發送調用請求的相同方式檢索調用響應。 也就是說,如果調用請求是使用Java API發送的,則可以使用Java API檢索調用響應。 例如,假設某個操作修改了PDF文檔。 您可以取得呼叫服務之Java方法的傳回值,以擷取已修改的PDF檔案。

    當調用長壽命進程時,調用響應包含與調用請求相關聯的標識符值。 使用此標識符值,您可以稍後檢查進程的狀態。 例如,請考慮MortgageLoan長期服務。 使用標識符值,可以檢查以確定流程是否成功完成。 (請參閱叫用以人為中心的長壽命進程。)

    下圖顯示調用服務的客戶端應用程式(使用Java API)。

    當用戶端應用程式叫用服務時,會發生三個事件:

    1. 客戶端應用程式向服務發送調用請求。
    2. 服務執行調用請求中指定的操作。
    3. 服務容器返回對客戶端應用程式的調用響應。

另請參閱

瞭解AEM Forms流程

使用(AEM表單不建議使用)AEM Forms Remoting叫用AEM Forms

使用Java API叫用AEM Forms

使用Web Services叫用AEM Forms

調用以人為中心的長壽命進程

使用REST請求叫用AEM Forms

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free