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

您可以使用下列用戶端應用程式,以程式設計方式叫用在Workbench中建立的以人為中心的長期流程:

  • 使用調用API的Java基於Web的客戶端應用程式。 (請參閱使用Java API叫用AEM Forms(/docs/experience-manager-65/forms/developer-reference/programming-aem-forms-jee/invoking-aem-forms-jee-apis/invoking-aem-forms-using-java.html?lang=zh-Hant#ucking-aem-forms-using-the-java-api))。
  • 使用web services的ASP.NET應用程式。 (請參閱使用Web Services叫用AEM Forms)。
  • 使用Flex建立的用戶端應用程式,使用Remoting。 (請參閱使用(AEM表單已過時)AEM Forms Remoting叫用AEM Forms。)

調用的長期進程名為​FirstAppSolution/PreLoanProcess。 您可以依照建立您的第一個AEM Forms應用程式中指定的教學課程來建立此程式。

以人為中心的程式涉及使用者可使用工作區來回應的工作。 例如,您可以使用「工作台」建立流程,讓銀行經理核准或拒絕貸款申請。 下圖顯示了進程​FirstAppSolution/PreLoanProcess

FirstAppSolution/PreLoanProcess​處理接受名為​formData​的輸入參數,其資料類型為XML。 XML資料與名為​PreLoanForm.xdp​的表單設計合併。 下圖顯示一個表單,它代表指派給用戶以批准或拒絕貸款申請的任務。 使用者使用「工作區」核准或拒絕應用程式。 「工作區」使用者可以按一下下圖所示的「核准」按鈕,以核准貸款要求。 同樣地,使用者也可以按一下拒絕按鈕來拒絕貸款要求。

由於以下因素,長壽命進程被非同步調用,且無法同步調用:

  • 流程可以跨越大量時間。
  • 流程可以跨越組織界限。
  • 流程需要外部輸入才能完成。 例如,假設某個表單被傳送給不在辦公室的經理。 在這種情況下,在管理員返回並填寫表單之前,該過程不會完成。

當呼叫長期處理時,AEM Forms會建立呼叫識別碼值,做為建立記錄的一部分。 記錄會追蹤長期處理的狀態,並儲存在AEM Forms資料庫中。 使用調用標識符值,可以跟蹤長壽命進程的狀態。 此外,您可以使用進程調用標識符值來執行進程管理器操作,如終止正在運行的進程實例。

注意

AEM Forms不會在呼叫短暫的程式時建立呼叫識別碼值或記錄。

當申請人提交申請書時,會叫用FirstAppSolution/PreLoanProcess程式,該申請書以XML資料表示。 輸入進程變數的名稱為formData ,其資料類型為XML。 在本討論中,假設以下XML資料是用於FirstAppSolution/PreLoanProcess進程的輸入。

 <?xml version="1.0" encoding="UTF-8"?>
 <LoanApp>
 <Name>Sam White</Name>
 <LoanAmount>250000</LoanAmount>
 <PhoneOrEmail>(555)555-5555</PhoneOrEmail>
 <ApprovalStatus>PENDING APPROVAL</ApprovalStatus>
 </LoanApp>

傳遞至流程的XML資料必須與流程中使用的表單中的欄位相符。 否則,表單中不會顯示資料。 所有調用FirstAppSolution/PreLoanProcess進程的應用程式都必須傳遞此XML資料源。 在​叫用以人為中心的長壽命進程​中建立的應用程式從用戶輸入到Web客戶端的值動態建立XML資料源。

使用用戶端應用程式,您可以傳送​FirstAppSolution/PreLoanProcess​處理所需的XML資料。 長期進程返回調用標識符值作為其返回值。 下圖顯示調用*FirstAppSolution/PreLoanProcess的客戶端應用程式。 用戶端應用程式會傳送XML資料,並回傳代表呼叫識別碼值的字串值。

另請參閱

建立Java Web應用程式,以叫用以人為中心的長壽命程式

建立ASP.NET網路應用程式,以叫用以人為中心的長壽命程式

建立使用Flex建立的用戶端應用程式,以叫用以人為中心的長壽命程式

建立調用以人為中心的長壽命進程的Java Web應用程式

您可以建立基於Web的應用程式,該應用程式使用Java servlet調用FirstAppSolution/PreLoanProcess進程。 要從Java servlet調用此進程,請使用Java servlet中的調用API。 (請參閱使用Java API叫用AEM Forms。)

下圖顯示以Web為基礎的用戶端應用程式,其中會發佈名稱、電話(或電子郵件)和金額值。 當使用者按一下「提交應用程式」按鈕時,這些值會傳送至Java servlet。

Java servlet將執行以下任務:

  • 檢索從HTML頁張貼到Java servlet的值。
  • 動態建立XML資料來源以傳遞至​FirstAppSolution/PreLoanProcess​程式。 名稱、電話(或電子郵件)和金額值會在XML資料來源中指定。
  • 使用AEM Forms Invocation API叫用​FirstAppSolution/PreLoanProcess​程式。
  • 將調用標識符值返回到客戶端Web瀏覽器。

步驟摘要

要建立調用FirstAppSolution/PreLoanProcess進程的基於Java的Web應用程式,請執行以下步驟:

  1. 建立網頁專案
  2. 為servlet建立Java應用程式邏輯
  3. 為Web應用程式建立網頁
  4. 將Web應用程式打包到WAR檔案
  5. 將WAR檔案部署至代管AEM Forms的J2EE應用程式伺服器
  6. 測試您的Web應用程式
注意

其中一些步驟取決於部署AEM Forms的J2EE應用程式。 例如,您用來部署WAR檔案的方法取決於您使用的J2EE應用程式伺服器。 假設AEM Forms已部署在JBoss®上。

建立Web項目

建立Web應用程式的第一步是建立Web專案。 本檔案所基於的Java IDE是Eclipse 3.3。使用Eclipse IDE,建立Web項目並將所需的JAR檔案添加到項目中。 將名為​index.html​的HTML頁面和Java servlet新增至您的專案。

以下清單指定要包含在Web項目中的JAR檔案:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • J2EE.jar

有關這些JAR檔案的位置,請參見 Including AEM Forms Java library files

注意

J2EE.jar檔案定義Java servlet使用的資料類型。 您可從部署AEM Forms的J2EE應用程式伺服器取得此JAR檔案。

建立網頁專案

  1. 啟動Eclipse,然後按一下「檔案​ > 新專案」。
  2. 在​新建項目​對話框中,選擇​Web > 動態Web項目
  3. 鍵入InvokePreLoanProcess作為項目名稱,然後按一下​完成

將所需的JAR檔案添加到項目中

  1. 在「項目瀏覽器」窗口中,按一下右鍵InvokePreLoanProcess項目,然後選擇​屬性
  2. 按一下​Java組建路徑 ,然後按一下​​頁籤。
  3. 按一下​添加外部JAR​按鈕並瀏覽至要包含的JAR檔案。

將Java Servlet添加到項目

  1. 在「項目瀏覽器」窗口中,按一下右鍵InvokePreLoanProcess項目,然後選擇「新建」>「其他」
  2. 展開​Web​資料夾,選擇​Servlet ,然後按一下​Next
  3. 在「建立Servlet」對話框中,鍵入SubmitXML作為servlet的名稱,然後按一下​完成

新增HTML頁面至您的專案

  1. 在「項目瀏覽器」窗口中,按一下右鍵InvokePreLoanProcess項目,然後選擇「新建」>「其他」
  2. 展開​Web​資料夾,選擇​HTML ,然後按一下​Next
  3. 在「新建HTML」對話框中,鍵入index.html作為檔案名,然後按一下​完成
注意

有關建立調用SubmitXML Java servlet的HTML內容的資訊,請參閱為Web應用程式建立網頁

為servlet建立Java應用程式邏輯

建立從Java servlet內調用FirstAppSolution/PreLoanProcess進程的Java應用程式邏輯。 以下代碼顯示SubmitXML Java Servlet的語法:

     public class SubmitXML extends HttpServlet implements Servlet {
         public void doGet(HttpServletRequest req, HttpServletResponse resp
         throws ServletException, IOException {
         doPost(req,resp);
 
         }
         public void doPost(HttpServletRequest req, HttpServletResponse resp
         throws ServletException, IOException {
             //Add code here to invoke the FirstAppSolution/PreLoanProcess process
             }

通常,您不會將用戶端程式碼置於Java servlet的doGetdoPost方法中。 更好的程式設計實務是將此程式碼放在個別類別中。 然後從doPost方法(或doGet方法)實例化類,並調用相應的方法。 但是,對於代碼簡寫,代碼示例將保持在最小值,並放在doPost方法中。

要使用調用API調用FirstAppSolution/PreLoanProcess進程,請執行以下任務:

  1. 在您Java專案的類別路徑中包含用戶端JAR檔案,例如adobe-livecycle-client.jar。 如需這些檔案位置的詳細資訊,請參閱包含AEM Forms Java程式庫檔案

  2. 擷取從HTML頁面提交的名稱、電話和金額值。 使用這些值動態建立傳送至FirstAppSolution/PreLoanProcess程式的XML資料來源。 您可以使用org.w3c.dom類別來建立XML資料來源(此應用程式邏輯如下列程式碼範例所示)。

  3. 建立包含連接屬性的ServiceClientFactory對象。 (請參閱設定連接屬性。)

  4. 使用其建構子並傳遞ServiceClientFactory對象,建立ServiceClient對象。 ServiceClient物件可讓您叫用服務作業。 它可處理如定位、調度和路由調用請求等任務。

  5. 使用其建構子建立java.util.HashMap對象。

  6. 請針對每個輸入參數叫用java.util.HashMap物件的put方法,以傳遞至長壽命的程式。 請確定您指定流程輸入參數的名稱。 由於FirstAppSolution/PreLoanProcess進程需要一個類型XML(名為formData)的輸入參數,因此只需調用put方法一次。

     //Get the XML to pass to the FirstAppSolution/PreLoanProcess process
     org.w3c.dom.Document inXML = GetDataSource(name,phone,amount);
     
     //Create a Map object to store the parameter value
     Map params = new HashMap();
     params.put("formData", inXML);
    
  7. 調用ServiceClientFactory對象的createInvocationRequest方法並傳遞以下值,以建立InvocationRequest對象:

    • 一個字串值,它指定要調用的長生命週期進程的名稱。 要調用FirstAppSolution/PreLoanProcess進程,請指定FirstAppSolution/PreLoanProcess
    • 表示流程操作名稱的字串值。 長壽命進程操作的名稱為invoke
    • java.util.HashMap物件,其中包含服務作業所需的參數值。
    • 指定false的布林值,可建立非同步請求(此值適用於叫用長壽命的程式)。
    注意

    將值true傳入createInvocationRequest方法的第四個參數,即可叫用短暫的程式。傳遞值true會建立同步請求。

  8. 呼叫ServiceClient物件的invoke方法並傳遞InvocationRequest物件,將呼叫請求傳送至AEM Forms。 invoke方法返回InvocationReponse對象。

  9. 長期進程返回一個字串值,該字串值表示調用標識值。 調用InvocationReponse物件的getInvocationId方法來擷取此值。

     //Send the invocation request to the long-lived process and
     //get back an invocation response object
     InvocationResponse lcResponse = myServiceClient.invoke(lcRequest);
     String invocationId = lcResponse.getInvocationId();
    
  10. 將調用標識值寫入客戶端Web瀏覽器。 您可以使用java.io.PrintWriter實例將此值寫入客戶端Web瀏覽器。

快速入門:使用調用API調用長壽命進程

以下Java代碼示例表示調用FirstAppSolution/PreLoanProcess進程的Java servlet。

 /*
     * This Java Quick Start uses the following JAR files
     * 1. adobe-livecycle-client.jar
     * 2. adobe-usermanager-client.jar
     *
     * (Because this  quick start is implemented as a Java servlet, it is
     * not necessary to include J2EE specific JAR files - the Java project
     * that contains this quick start is exported as a WAR file which
     * is deployed to the J2EE application server)
     *
     * These JAR files are located in the following path:
     * <install directory>/sdk/client-libs/common
     *
     * For complete details about the location of these JAR files,
     * see "Including AEM Forms library files" in Programming with AEM forms
     * */
 import java.io.ByteArrayOutputStream;
 import java.io.File;
 import java.io.IOException;
 import java.io.PrintWriter;
 
 import javax.servlet.ServletException;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 import java.util.*;
 import com.adobe.idp.dsc.clientsdk.ServiceClientFactory;
 import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties;
 import javax.xml.parsers.DocumentBuilder;
 import javax.xml.parsers.DocumentBuilderFactory;
 import javax.xml.transform.Transformer;
 import javax.xml.transform.TransformerFactory;
 import javax.xml.transform.dom.DOMSource;
 import javax.xml.transform.stream.StreamResult;
 
 import com.adobe.idp.dsc.InvocationRequest;
 import com.adobe.idp.dsc.InvocationResponse;
 import com.adobe.idp.dsc.clientsdk.ServiceClient;
 import org.w3c.dom.Element;
 
     public class SubmitXML extends javax.servlet.http.HttpServlet implements javax.servlet.Servlet {
       static final long serialVersionUID = 1L;
 
        public SubmitXML() {
         super();
     }
 
 
     protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
         // TODO Auto-generated method stub
         doPost(request,response);
     }
 
     protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
 
         try{
             //Set connection properties required to invoke AEM Forms
             Properties connectionProps = new Properties();
             connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://localhost:1099");
             connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
             connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
             connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
             connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
 
             //Create a ServiceClientFactory object
             ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps);
 
             //Create a ServiceClient object
             ServiceClient myServiceClient = myFactory.getServiceClient();
 
             //Get the values that are passed from the Loan HTML page
             String name = (String)request.getParameter("name");
             String phone = (String)request.getParameter("phone");
             String amount = (String)request.getParameter("amount");
 
             //Create XML to pass to the FirstAppSolution/PreLoanProcess process
             org.w3c.dom.Document inXML = GetDataSource(name,phone,amount);
 
             //Create a Map object to store the XML input parameter value
             Map params = new HashMap();
             params.put("formData", inXML);
 
             //Create an InvocationRequest object
             InvocationRequest lcRequest =  myFactory.createInvocationRequest(
                 "FirstAppSolution/PreLoanProcess", //Specify the long-lived process name
                     "invoke",           //Specify the operation name
                     params,               //Specify input values
                     false);               //Create an asynchronous request
 
             //Send the invocation request to the long-lived process and
             //get back an invocation response object
             InvocationResponse lcResponse = myServiceClient.invoke(lcRequest);
             String invocationId = lcResponse.getInvocationId();
 
             //Create a PrintWriter instance
             PrintWriter pp = response.getWriter();
 
             //Write the invocation identifier value back to the client web browser
             pp.println("The job status identifier value is: " +invocationId);
 
         }catch (Exception e) {
              System.out.println("The following exception occurred: "+e.getMessage());
       }
     }
 
 
      //Create XML data to pass to the long-lived process
      private static org.w3c.dom.Document GetDataSource(String name, String phone, String amount)
      {
             org.w3c.dom.Document document = null;
 
             try
             {
                 //Create DocumentBuilderFactory and DocumentBuilder objects
                 DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
                 DocumentBuilder builder = factory.newDocumentBuilder();
 
                 //Create a new Document object
                 document = builder.newDocument();
 
                 //Create MortgageApp - the root element in the XML
                 Element root = (Element)document.createElement("LoanApp");
                 document.appendChild(root);
 
                 //Create an XML element for Name
                 Element nameElement = (Element)document.createElement("Name");
                 nameElement.appendChild(document.createTextNode(name));
                 root.appendChild(nameElement);
 
                 //Create an XML element for Phone
                 Element phoneElement = (Element)document.createElement("PhoneOrEmail");
                 phoneElement.appendChild(document.createTextNode(phone));
                 root.appendChild(phoneElement);
 
                 //Create an XML element for amount
                 Element loanElement = (Element)document.createElement("LoanAmount");
                 loanElement.appendChild(document.createTextNode(amount));
                 root.appendChild(loanElement);
 
                 //Create an XML element for ApprovalStatus
                 Element approveElement = (Element)document.createElement("ApprovalStatus");
                 approveElement.appendChild(document.createTextNode("PENDING APPROVAL"));
                 root.appendChild(approveElement);
 
               }
          catch (Exception e) {
                   System.out.println("The following exception occurred: "+e.getMessage());
                }
         return document;
          }
         }

為Web應用程式建立網頁

index.html​網頁提供了調用FirstAppSolution/PreLoanProcess進程的Java servlet的入口點。 此網頁是基本的HTML表單,包含HTML表單和送出按鈕。 當使用者按一下提交按鈕時,表單資料會張貼至SubmitXML Java servlet。

Java servlet會使用下列Java程式碼,從HTML頁面擷取張貼的資料:

 //Get the values that are passed from the Loan HTML page
 String name = request.getParameter("name");
 String phone = request.getParameter("phone");
 String amount = request.getParameter("amount");

以下HTML程式碼代表在設定開發環境期間建立的index.html檔案。 (請參閱建立Web專案。)

 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <title>Insert title here</title>
 </head>
 <body>
 <table>
     <TBODY>
         <TR>
             <td><img src="financeCorpLogo.jpg" width="172" height="62"></TD>
             <td><FONT size="+2"><strong>Java Loan Application Page</strong></FONT></TD>
             <td> </TD>
             <td> </TD>
         </TR>
 
     </TBODY>
 </TABLE>
     <FORM action="https://hiro-xp:8080/PreLoanProcess/SubmitXML" method="post">
        <table>
          <TBODY>
                <TR>
                      <td><LABEL for="name">Name: </LABEL></TD>
                  <td><INPUT type="text" name="name"></TD>
                  <td><input type="submit" value="Submit Application"></TD>
                  </TR>
            <TR>
                  <td> <LABEL for="phone">Phone/Email: </LABEL></TD>
              <td><INPUT type="text" name="phone"></TD>
                  <td></TD>
              </TR>
 
            <TR>
                  <td><LABEL for="amount">Amount: </LABEL></TD>
              <td><INPUT type="text" name="amount"></TD>
                 <td></TD>
             </TR>
          </TBODY>
 </TABLE>
       </FORM>
 </body>
 </html>

將Web應用程式打包到WAR檔案

要部署調用FirstAppSolution/PreLoanProcess進程的Java servlet,請將Web應用程式打包到WAR檔案。 請確定WAR檔案中也包含元件商業邏輯所依賴的外部JAR檔案,例如adobe-livecycle-client.jar和adobe-usermanager-client.jar。

下圖顯示Eclipse專案的內容,此內容已封裝為WAR檔案。

注意

在上圖中,JPG檔案可以由任何JPG影像檔案取代。

將Web應用程式打包到WAR檔案:

  1. 在​項目瀏覽器​窗口中,按一下右鍵InvokePreLoanProcess項目並選擇​導出 > WAR檔案
  2. 在​Web模組​文本框中,鍵入InvokePreLoanProcess作為Java項目的名稱。
  3. 在​Destination​文本框中,為​檔案名鍵入PreLoanProcess.war,指定WAR檔案的位置,然後按一下「完成」。

將WAR檔案部署至代管AEM Forms的J2EE應用程式伺服器

將WAR檔案部署至部署AEM Forms的J2EE應用程式伺服器。 要將WAR檔案部署到J2EE應用程式伺服器,請將WAR檔案從導出路徑複製到[AEM Forms Install]\Adobe\Adobe Experience Manager Forms\jboss\server\lc_turnkey\deploy

注意

如果AEM Forms未部署在JBoss上,則您必須依照代管AEM Forms的J2EE應用程式伺服器部署WAR檔案。

測試您的Web應用程式

部署Web應用程式後,您可以使用Web瀏覽器來測試它。 假設您使用的是代管AEM Forms的相同電腦,您可以指定下列URL:

  • http://localhost:8080/PreLoanProcess/index.html

    在HTML表單欄位中輸入值,然後按一下「提交申請」按鈕。 如果發生問題,請查看J2EE應用程式伺服器的記錄檔。

注意

要確認Java應用程式調用了該流程,請啟動Workspace並接受貸款。

建立ASP.NET Web應用程式,該應用程式調用以人為中心的長壽命進程

您可以建立調用FirstAppSolution/PreLoanProcess進程的ASP.NET應用程式。 要從ASP.NET應用程式調用此過程,請使用web services。 (請參閱使用Web Services叫用AEM Forms)。

下圖顯示ASP.NET客戶端應用程式從最終用戶獲取資料。 資料會放入XML資料來源中,當使用者按一下「提交應用程式」按鈕時,就會傳送至FirstAppSolution/PreLoanProcess程式。

注意,調用過程後,將顯示調用標識符值。 建立調用標識符值作為跟蹤長期進程狀態的記錄的一部分。

ASP.NET應用程式執行以下任務:

  • 擷取使用者在網頁中輸入的值。
  • 動態建立XML資料來源,並傳遞至* FirstAppSolution/PreLoanProcess *process。 這三個值在XML資料源中指定。
  • 使用web services叫用* FirstAppSolution/PreLoanProcess *進程。
  • 將調用標識符值和長期操作的狀態返回到客戶端Web瀏覽器。

步驟摘要

要建立能夠調用FirstAppSolution/PreLoanProcess的ASP.NET應用程式,請執行以下步驟:

  1. 建立ASP.NET網頁應用程式
  2. 建立叫用FirstAppSolution/PreLoanProcess的ASP頁面
  3. 運行ASP.NET應用程式

建立ASP.NET Web應用程式

建立Microsoft .NET C# ASP.NET Web應用程式。 下圖顯示名為​InvokePreLoanProcess​的ASP.NET項目的內容。

注意,在「服務參考」下,有兩個項目。 第一個項目名為* JobManager*。 此參考使ASP.NET應用程式能夠調用Job Manager服務。 此服務會傳回有關長期流程狀態的資訊。 例如,如果進程當前正在運行,則此服務將返回一個數值,該數值指定當前正在運行的進程。 第二個引用的名稱為​PreLoanProcess。 本服務參考代表對* FirstAppSolution/PreLoanProcess *進程的參考。 建立「服務參考」後,與AEM Forms服務關聯的資料類型即可用於您的。NET專案中。

建立ASP.NET項目:

  1. 啟動Microsoft Visual Studio 2008。
  2. 從​檔案​菜單中,選擇​新建網站
  3. 在​模板​清單中,選擇​ASP.NET網站
  4. 在​位置​方塊中,選取專案的位置。 將您的專案命名為​InvokePreLoanProcess
  5. 在​語言​框中,選擇Visual C#
  6. 按一下「確定」。

添加服務引用:

  1. 在「項目」菜單中,選擇​添加服務參考

  2. 在​地址​對話框中,為作業管理器服務指定WSDL。

     https://hiro-xp:8080/soap/services/JobManager?WSDL&lc_version=9.0.1
    
  3. 在「名稱空間」欄位中,鍵入JobManager

  4. 按一下​前往,然後按一下​確定

  5. 在​Project​菜單中,選擇​添加服務參考

  6. 在​Address​對話方塊中,指定FirstAppSolution/PreLoanProcess程式的WSDL。

     https://hiro-xp:8080/soap/services/FirstAppSolution/PreLoanProcess?WSDL&lc_version=9.0.1
    
  7. 在「名稱空間」欄位中,鍵入PreLoanProcess

  8. 按一下​前往,然後按一下​確定

注意

hiro-xp取代為代管AEM Forms之J2EE應用程式伺服器的IP位址。 lc_version選項可確保AEM Forms功能(例如MTOM)可供使用。 若未指定lc_version選項,就無法使用MTOM叫用AEM Forms。 (請參閱使用MTOM叫用AEM Forms。)

建立叫用FirstAppSolution/PreLoanProcess的ASP頁面

在ASP.NET專案中,新增負責向貸款申請人顯示HTML頁面的Web表單(ASPX檔案)。 Web表單基於從System.Web.UI.Page派生的類。 調用FirstAppSolution/PreLoanProcess的C#應用程式邏輯位於Button1_Click方法中(此按鈕代表「提交應用程式」按鈕)。

下圖顯示ASP.NET應用程式

下表列出屬於此ASP.NET應用程式的控制項。

控制項名稱

說明

TextBoxName

指定客戶的名字和姓氏。

TextBoxPhone

指定客戶的電話或電子郵件地址。

TextBoxAmount

指定貸款金額。

Button1

表示「提交申請」按鈕。

LabelJobID

一個標籤控制,它指定調用標識符值的值。

LabelStatus

指定作業狀態值的標籤控制。 通過調用作業管理器服務來檢索此值。

作為ASP.NET應用程式一部分的應用程式邏輯必須動態建立XML資料來源,以傳遞至FirstAppSolution/PreLoanProcess程式。 必須在XML資料來源中指定申請人在HTML頁面中輸入的值。 當在工作區中檢視表單時,這些資料值會合併到表單中。 位於System.Xml命名空間中的類用於建立XML資料源。

當從ASP.NET應用程式叫用需要XML資料的程式時,您可使用XML資料類型。 也就是說,不能將System.Xml.XmlDocument實例傳遞給進程。 要傳遞給進程的此XML實例的完全限定名稱為InvokePreLoanProcess.PreLoanProcess.XML。 將System.Xml.XmlDocument實例轉換為InvokePreLoanProcess.PreLoanProcess.XML。 您可以使用下列程式碼來執行此工作。

 //Create the XML to pass to the FirstAppSolution/PreLoanProcess process
 XmlDocument myXML = CreateXML(userName, phone, amount);
 
 //Convert the XML to a InvokePreLoanProcess.PreLoanProcess.XML instance
 StringWriter sw = new StringWriter();
 XmlTextWriter xw = new XmlTextWriter(sw);
 myXML.WriteTo(xw);
 
 InvokePreLoanProcess.PreLoanProcess.XML inXML = new XML();
 inXML.document = sw.ToString();

要建立調用FirstAppSolution/PreLoanProcess進程的ASP頁,請在Button1_Click方法中執行以下任務:

  1. 使用其預設建構子建立FirstAppSolution_PreLoanProcessClient對象。

  2. 使用System.ServiceModel.EndpointAddress建構函式建立FirstAppSolution_PreLoanProcessClient.Endpoint.Address物件。 將指定WSDL的字串值傳遞至AEM Forms服務和編碼類型:

     https://hiro-xp:8080/soap/services/FirstAppSolution/PreLoanProcess?blob=mtom
    

    您不需要使用lc_version屬性。 建立服務參考時,將使用此屬性。 不過,請確定您指定?blob=mtom

    注意

    hiro-xp取代為代管AEM Forms之J2EE應用程式伺服器的IP位址。

  3. 獲取FirstAppSolution_PreLoanProcessClient.Endpoint.Binding資料成員的值,建立System.ServiceModel.BasicHttpBinding對象。 將返回值轉換為BasicHttpBinding

  4. System.ServiceModel.BasicHttpBinding物件的MessageEncoding資料成員設為WSMessageEncoding.Mtom。 此值可確保使用MTOM。

  5. 執行下列工作以啟用基本HTTP驗證:

    • 將AEM表單使用者名稱指派給資料成員FirstAppSolution_PreLoanProcessClient.ClientCredentials.UserName.UserName
    • 為資料成員FirstAppSolution_PreLoanProcessClient.ClientCredentials.UserName.Password分配相應的口令值。
    • 將常數值HttpClientCredentialType.Basic分配給資料成員BasicHttpBindingSecurity.Transport.ClientCredentialType
    • 將常數值BasicHttpSecurityMode.TransportCredentialOnly分配給資料成員BasicHttpBindingSecurity.Security.Mode

    下列程式碼範例顯示這些工作。

     //Enable BASIC HTTP authentication
     BasicHttpBinding b = (BasicHttpBinding)mortgageClient.Endpoint.Binding;
     b.MessageEncoding = WSMessageEncoding.Mtom;
     mortgageClient.ClientCredentials.UserName.UserName = "administrator";
     mortgageClient.ClientCredentials.UserName.Password = "password";
     b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
     b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
     b.MaxReceivedMessageSize = 2000000;
     b.MaxBufferSize = 2000000;
     b.ReaderQuotas.MaxArrayLength = 2000000;
    
  6. 擷取使用者在網頁中輸入的名稱、電話和金額值。 使用這些值動態建立傳送至FirstAppSolution/PreLoanProcess程式的XML資料來源。 建立一個System.Xml.XmlDocument,該<a0/>表示要傳遞到進程的XML資料源(此應用程式邏輯如下面的代碼示例所示)。

  7. System.Xml.XmlDocument實例轉換為InvokePreLoanProcess.PreLoanProcess.XML(此應用程式邏輯如下面的代碼示例所示)。

  8. 叫用FirstAppSolution_PreLoanProcessClient物件的invoke_Async方法,以叫用FirstAppSolution/PreLoanProcess程式。 此方法返回一個字串值,該字串值表示長壽命進程的調用標識符值。

  9. 使用is建構子建立JobManagerClient。 (請確定您已經為Job Manager服務設定了服務參考。)

  10. 重複步驟1-5。 指定步驟2的下列URL:https://hiro-xp:8080/soap/services/JobManager?blob=mtom

  11. 使用其建構子建立JobId對象。

  12. 使用FirstAppSolution_PreLoanProcessClient物件的invoke_Async方法的傳回值,設定JobId物件的id資料成員。

  13. value true分配給JobId對象的persistent資料成員。

  14. 通過調用JobManagerService對象getStatus方法並傳遞JobId對象來建立JobStatus對象。

  15. 通過檢索JobStatus對象的statusCode資料成員的值來獲取狀態值。

  16. 將調用標識符值分配給LabelJobID.Text欄位。

  17. 將狀態值分配給LabelStatus.Text欄位。

快速入門:使用Web服務API調用長壽命進程

以下C#代碼示例調用FirstAppSolution/PreLoanProcess進程。

 ???/**
     * Ensure that you create a .NET project that uses
     * MS Visual Studio 2008 and version 3.5 of the .NET
     * framework. This is required to invoke a
     * AEM Forms service using MTOM.
 
 
 using System;
 using System.Collections;
 using System.Configuration;
 using System.Data;
 using System.Linq;
 using System.Web;
 using System.ServiceModel;
 using System.Web.Security;
 using System.Web.UI;
 using System.Web.UI.HtmlControls;
 using System.Web.UI.WebControls;
 using System.Web.UI.WebControls.WebParts;
 using System.Xml.Linq;
 using System.Xml;
 using System.IO;
 
 //A reference to FirstAppSolution/PreLoanProcess
 using InvokePreLoanProcess.PreLoanProcess;
 
 //A reference to JobManager service
 using InvokePreLoanProcess.JobManager;
 
 
 namespace InvokePreLoanProcess
 {
        public partial class _Default : System.Web.UI.Page
        {
            //This method is called when the Submit Application button is
            //Clicked
            protected void Button1_Click(object sender, EventArgs e)
            {
                //Create a FirstAppSolution_PreLoanProcessClient object
                FirstAppSolution_PreLoanProcessClient mortgageClient = new FirstAppSolution_PreLoanProcessClient();
                mortgageClient.Endpoint.Address = new System.ServiceModel.EndpointAddress("https://hiro-xp:8080/soap/services/FirstAppSolution/PreLoanProcess?blob=mtom");
 
                //Enable BASIC HTTP authentication
                BasicHttpBinding b = (BasicHttpBinding)mortgageClient.Endpoint.Binding;
                b.MessageEncoding = WSMessageEncoding.Mtom;
                mortgageClient.ClientCredentials.UserName.UserName = "administrator";
                mortgageClient.ClientCredentials.UserName.Password = "password";
                b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
                b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
                b.MaxReceivedMessageSize = 2000000;
                b.MaxBufferSize = 2000000;
                b.ReaderQuotas.MaxArrayLength = 2000000;
 
                //Retrieve values that user entered into the web page
                String userName = TextBoxName.Text;
                String phone = TextBoxPhone.Text;
                String amount = TextBoxAmount.Text;
 
                //Create the XML to pass to the FirstAppSolution/PreLoanProcess process
                XmlDocument myXML = CreateXML(userName, phone, amount);
 
                StringWriter sw = new StringWriter();
                XmlTextWriter xw = new XmlTextWriter(sw);
                myXML.WriteTo(xw);
 
                InvokePreLoanProcess.PreLoanProcess.XML inXML = new XML();
                inXML.document = sw.ToString();
 
                //INvoke the FirstAppSolution/PreLoanProcess process
                String invocationID =  mortgageClient.invoke_Async(inXML);
 
                //Create a JobManagerClient object to obtain the status of the long-lived operation
                JobManagerClient jobManager = new JobManagerClient();
                jobManager.Endpoint.Address = new System.ServiceModel.EndpointAddress("https://hiro-xp:8080/soap/services/JobManager?blob=mtom");
 
                //Enable BASIC HTTP authentication
                BasicHttpBinding b1 = (BasicHttpBinding)jobManager.Endpoint.Binding;
                b1.MessageEncoding = WSMessageEncoding.Mtom;
                jobManager.ClientCredentials.UserName.UserName = "administrator";
                jobManager.ClientCredentials.UserName.Password = "password";
                b1.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
                b1.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
                b1.MaxReceivedMessageSize = 2000000;
                b1.MaxBufferSize = 2000000;
                b1.ReaderQuotas.MaxArrayLength = 2000000;
 
 
                //Create a JobID object that represents the status of the
                //long-lived operation
                JobId jobId = new JobId();
                jobId.id = invocationID;
                jobId.persistent = true;
                JobStatus jobStatus = jobManager.getStatus(jobId);
                System.Int16 val2 = jobStatus.statusCode;
                LabelJobID.Text = "The job status identifier value is " + invocationID;
                LabelStatus.Text = "The status of the long-lived operation is " + getJobDescription(val2);
 
            }
 
            private static XmlDocument CreateXML(String name, String phone, String amount)
            {
                //This method dynamically creates a DDX document
                //to pass to the FirstAppSolution/PreLoanProcess process
                XmlDocument xmlDoc = new XmlDocument();
 
                //Create the root element and append it to the XML DOM
                System.Xml.XmlElement root = xmlDoc.CreateElement("LoanApp");
                xmlDoc.AppendChild(root);
 
                //Create the Name element
                XmlElement nameElement = xmlDoc.CreateElement("Name");
                nameElement.AppendChild(xmlDoc.CreateTextNode(name));
                root.AppendChild(nameElement);
 
                //Create the LoanAmount element
                XmlElement LoanAmount = xmlDoc.CreateElement("LoanAmount");
                LoanAmount.AppendChild(xmlDoc.CreateTextNode(amount));
                root.AppendChild(LoanAmount);
 
                //Create the PhoneOrEmail element
                XmlElement PhoneOrEmail = xmlDoc.CreateElement("PhoneOrEmail");
                PhoneOrEmail.AppendChild(xmlDoc.CreateTextNode(phone));
                root.AppendChild(PhoneOrEmail);
 
                //Create the ApprovalStatus element
                XmlElement ApprovalStatus = xmlDoc.CreateElement("ApprovalStatus");
                ApprovalStatus.AppendChild(xmlDoc.CreateTextNode("PENDING APPROVAL"));
                root.AppendChild(ApprovalStatus);
 
                //Return the XmlElement instance
                return xmlDoc;
            }
 
 
            //Returns the String value of the Job Manager status code
            private String getJobDescription(int val)
            {
                switch(val)
                {
                    case 0:
                        return "JOB_STATUS_UNKNOWN";
 
                    case 1:
                        return "JOB_STATUS_QUEUED";
 
                    case 2:
                        return "JOB_STATUS_RUNNING";
 
                    case 3:
                        return "JOB_STATUS_COMPLETED";
 
                    case 4:
                        return "JOB_STATUS_FAILED";
 
                     case 5:
                        return "JOB_STATUS_COMPLETED";
 
                    case 6:
                        return "JOB_STATUS_SUSPENDED";
 
                    case 7:
                        return "JOB_STATUS_COMPLETE_REQUESTED";
 
                    case 8:
                        return "JOB_STATUS_TERMINATE_REQUESTED";
 
                     case 9:
                        return "JOB_STATUS_SUSPEND_REQUESTED";
 
                       case 10:
                        return "JOB_STATUS_RESUME_REQUESTED";
                }
 
                return "";
            }
       }
 }
 
注意

getJobDescription用戶定義方法中的值對應於Job Manager服務返回的值。

運行ASP.NET應用程式

編譯和部署ASP.NET應用程式後,您可以使用Web瀏覽器執行它。 假設ASP.NET項目的名稱為​InvokePreLoanProcess,請在Web瀏覽器中指定以下URL:

*http://localhost:1629/InvokePreLoanProcess/*Default.aspx

其中, localhost是代管ASP.NET項目的Web伺服器的名稱,1629是埠號。 編譯和構建ASP.NET應用程式時,Microsoft Visual Studio會自動進行部署。

注意

要確認ASP.NET應用程式調用了該流程,請啟動Workspace並接受貸款。

建立使用Flex建立的用戶端應用程式,以叫用以人為中心的長壽命程式

您可以建立使用Flex建立的用戶端應用程式,以叫用​FirstAppSolution/PreLoanProcess​程式。 此應用程式使用Remoting來叫用​FirstAppSolution/PreLoanProcess​程式。 (請參閱使用(AEM表單已過時)AEM Forms Remoting叫用AEM Forms。)

下圖顯示以Flex建立的用戶端應用程式,可收集使用者的資料。 資料會放入XML資料來源中,並傳送至程式。

注意,調用過程後,將顯示調用標識符值。 建立調用標識符值作為跟蹤長期進程狀態的記錄的一部分。

使用Flex建立的用戶端應用程式會執行下列工作:

  • 擷取使用者在網頁中輸入的值。
  • 動態建立傳遞至​FirstAppSolution/PreLoanProcess​程式的XML資料來源。 這三個值在XML資料源中指定。
  • 使用Remoting調用​FirstAppSolution/PreLoanProcess​進程。
  • 返回長壽命進程的調用標識符值。

步驟摘要

若要建立以Flex建立的用戶端應用程式,以叫用FirstAppSolution/PreLoanProcess程式,請執行下列步驟:

  1. 開始新的Flex專案。

  2. 在專案的類別路徑中加入adobe-remoting-provider.swc檔案。 (請參閱包含AEM Forms Flex程式庫檔案)。

  3. 透過ActionScript或MXML建立mx:RemoteObject例項。 (請參閱建立mx:RemoteObject例項

  4. 設定ChannelSet例項以與AEM Forms通訊,並將它與mx:RemoteObject例項建立關聯。 (請參閱建立AEM Forms的頻道)。

  5. 呼叫ChannelSet的login方法或服務的setCredentials方法,以指定使用者識別碼值和密碼。 (請參閱使用單一登入)。

  6. 建立XML資料來源,以便透過建立XML例項傳遞至FirstAppSolution/PreLoanProcess程式。 (此應用程式邏輯如下列程式碼範例所示。)

  7. 使用其建構子建立Object類型的對象。 指定程式輸入參數的名稱,將XML指派給物件,如下列程式碼所示:

     //Get the XML data to pass to the AEM Forms process
     var xml:XML = createXML();
     var params:Object = new Object();
     params["formData"]=xml;
    
  8. 呼叫mx:RemoteObject例項的invoke_Async方法,以叫用FirstAppSolution/PreLoanProcess程式。 傳遞包含輸入參數的Object。 (請參閱傳遞輸入值。)

  9. 檢索從長壽命進程返回的調用標識值,如以下代碼所示:

     // Handles async call that invokes the long-lived process
     private function resultHandler(event:ResultEvent):void
     {
     ji = event.result as JobId;
     jobStatusDisplay.text = "Job Status ID: " + ji.jobId as String;
     }
    

使用Remoting調用長壽命進程

以下Flex程式碼範例會叫用FirstAppSolution/PreLoanProcess程式。

 <?xml version="1.0" encoding="utf-8"?>
 
 <mx:Application  xmlns="*" backgroundColor="#FFFFFF"
      creationComplete="initializeChannelSet();">
 
 <mx:Script>
          <![CDATA[
 
             import mx.controls.Alert;
             import mx.rpc.events.FaultEvent;
             import mx.rpc.events.ResultEvent;
             import flash.net.navigateToURL;
             import mx.messaging.ChannelSet;
             import mx.messaging.channels.AMFChannel;
             import mx.collections.ArrayCollection;
             import mx.rpc.livecycle.JobId;
             import mx.rpc.livecycle.JobStatus;
             import mx.rpc.livecycle.DocumentReference;
             import mx.formatters.NumberFormatter;
 
             // Holds the job ID returned by LC.JobManager
             private var ji:JobId;
 
             private function initializeChannelSet():void
              {
              var cs:ChannelSet= new ChannelSet();
         cs.addChannel(new AMFChannel("remoting-amf", "https://hiro-xp:8080/remoting/messagebroker/amf"));
         LC_MortgageApp.setCredentials("tblue", "password");
         LC_MortgageApp.channelSet = cs;
              }
 
            private function submitApplication():void
             {
             //Get the XML data to pass to the AEM Forms process
             var xml:XML = createXML();
             var params:Object = new Object();
             params["formData"]=xml;
             LC_MortgageApp.invoke_Async(params);
             }
 
             // Handles async call that invokes the long-lived process
             private function resultHandler(event:ResultEvent):void
             {
                ji = event.result as JobId;
                jobStatusDisplay.text = "Job Status ID: " + ji.jobId as String;
             }
 
             private function createXML():XML
             {
                //Calculate the Mortgage value to place in the XML data
                var propertyPrice:String = txtAmount.text ;
                var name:String = txtName.text ;
                var phone:String = txtPhone.text ;;
 
                var model:XML =
 
                  <LoanApp>
                           <Name>{name}</Name>
                           <LoanAmount>{propertyPrice}</LoanAmount>
                           <PhoneOrEmail>{phone}</PhoneOrEmail>
                           <ApprovalStatus>PENDING APPROVAL</ApprovalStatus>
                  </LoanApp>
 
              return model;
             }
 
 
          ]]>
       </mx:Script>
 
       <!-- Declare the RemoteObject and set its destination to the mortgage-app remoting endpoint defined in AEM Forms. -->
       <mx:RemoteObject id="LC_MortgageApp" destination="FirstAppSolution/PreLoanProcess" result="resultHandler(event);">
          <mx:method name="invoke_Async" result="resultHandler(event)"/>
      </mx:RemoteObject>
 
 
     <mx:Grid x="229" y="186">
         <mx:GridRow width="100%" height="100%">
             <mx:GridItem width="100%" height="100%">
                 <mx:Image>
                     <mx:source>file:///D|/LiveCycle_9/FirstApp/financeCorpLogo.jpg</mx:source>
                 </mx:Image>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
                 <mx:Label text="Flex Loan Application Page" fontSize="20"/>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
             </mx:GridItem>
         </mx:GridRow>
         <mx:GridRow width="100%" height="100%">
             <mx:GridItem width="100%" height="100%">
                 <mx:Label text="Name:" fontSize="12" fontWeight="bold"/>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
                 <mx:TextInput id="txtName"/>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
                 <mx:Button label="Submit Application" click="submitApplication()"/>
             </mx:GridItem>
         </mx:GridRow>
         <mx:GridRow width="100%" height="100%">
             <mx:GridItem width="100%" height="100%">
                 <mx:Label text="Phone/Email:" fontSize="12" fontWeight="bold"/>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
                 <mx:TextInput id="txtPhone"/>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
             </mx:GridItem>
         </mx:GridRow>
         <mx:GridRow width="100%" height="100%">
             <mx:GridItem width="100%" height="100%">
                 <mx:Label text="Amount:" fontSize="12" fontWeight="bold"/>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
                 <mx:TextInput id="txtAmount"/>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
             </mx:GridItem>
         </mx:GridRow>
         <mx:GridRow width="100%" height="100%">
             <mx:GridItem width="100%" height="100%">
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
                 <mx:Label text="Label" id="jobStatusDisplay" enabled="true" fontSize="12" fontWeight="bold"/>
             </mx:GridItem>
             <mx:GridItem width="100%" height="100%">
             </mx:GridItem>
         </mx:GridRow>
     </mx:Grid>
 
 </mx:Application>
 

本頁內容

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