人間中心の長期間有効なプロセスの呼び出し

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=ja#invoking-aem-forms-using-the-java-ap)を参照してください。）
• Web サービスを使用する ASP.NET アプリケーションです。 （Web サービスを使用した AEM Forms の呼び出しを参照してください。）
• Remoting を使用する Flex で構築されたクライアントアプリケーション。 （AEM forms では非推奨の AEM Forms Remoting を使用した AEM Forms の呼び出し。）

呼び出される長期間有効なプロセスの名前は​FirstAppSolution/PreLoanProcess​です。このプロセスは、 最初の AEM Forms アプリケーションの作成に規定されたチュートリアルに従って作成できます。

人間中心のプロセスには、Workspace を使用してユーザーが応答できるタスクが含まれます。 例えば、Workbench を使用して、銀行の担当者がローン申し込みを承認または拒否できるプロセスを作成できます。 次の図に、プロセスを示します FirstAppSolution/PreLoanProcess。

この FirstAppSolution/PreLoanProcess プロセスには、データタイプが XML の、formData という名前の入力パラメターを入力できます。 この XML データは、PreLoanForm.xdp​という名前のフォームデザインとマージされます。. 次の図に、ユーザーに割り当てられた、ローン申し込みを承認または拒否するタスクを表すフォームを示します。 ユーザーは Workspace を使用して、アプリケーションを承認または拒否します。 Workspace ユーザーは、次の図に示す「承認」ボタンをクリックして、ローン申し込みを承認できます。 同様に、ユーザーは「拒否」ボタンをクリックして、ローンの申し込みを拒否できます。

長期間有効なプロセスは非同期で呼び出され、次の要因により、同期で呼び出すことができません。

• プロセスが長い時間を要する。
• プロセスが、複数の組織にまたがっている。
• プロセスを完了するには、他人による入力が必要。例えば、不在の管理者にフォームが送信された場合を考えてみましょう。 この場合、上司が帰社しフォームを入力するまで、プロセスは完了しません。

長期間有効なプロセスが呼び出されると、AEM Forms はレコードの作成の一環として、呼び出し識別子の値を作成します。 このレコードは、長期間有効なプロセスのステータスを追跡し、AEM Forms データベースに保存されます。 呼び出し識別子の値を使用して、長期間有効なプロセスのステータスを追跡できます。さらにはプロセス呼び出し識別子の値を使用して、実行中のプロセスインスタンスの終了など、Process Manager の操作を実行できます。

この 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 Web アプリケーションの作成

人間中心の長期間有効なプロセスを呼び出す、Flex で構築されたクライアントアプリケーションの作成

人間中心の長期間有効なプロセスを呼び出す Java Web アプリケーションの作成

Java サーブレットを使用してをFirstAppSolution/PreLoanProcessプロセス呼び出す Web ベースのアプリケーションを作成できます 。 Java サーブレットからこのプロセスを呼び出すには、Java サーブレット内で呼び出し API を使用します。 （Java API を使用した AEM Forms の呼び出しを参照してください。）

次の図に、名前、電話（またはメール）および値を投稿する Web ベースのクライアントアプリケーションを示します。 これらの値は、ユーザーが「アプリケーションを送信」ボタンをクリックすると、Java サーブレットに送信されます。

Java サーブレットは、以下のタスクを実行します。

• 「HTML」ページから Java サーブレットに投稿された値を取得します。
• FirstAppSolution/PreLoanProcess プロセスに渡す XML データソースを動的に作成します。名前、電話（またはメール）、金額の値は、XML データソースで指定されます。
• AEM Forms Invocation API を使用して FirstAppSolution/PreLoanProcess プロセスを呼び出します。
• クライアント web ブラウザーに呼び出し識別子の値を返します。

手順の概要

FirstAppSolution/PreLoanProcess プロセスを呼び出す Java web ベースのアプリケーションを作成するには次の手順を実行します。

1. Web プロジェクトを作成します。
2. サーブレット用の Java アプリケーションロジックの作成します。
3. Web アプリケーション用の web ページの作成
4. Web アプリケーションを WAR ファイルにパッケージ化します。
5. AEM Forms をホストする J2EE アプリケーションサーバーに WAR ファイルをデプロイします。
6. Web アプリケーションをテストします。

Web プロジェクトを作成

Web アプリケーションを作成する最初の手順は、web プロジェクトを作成することです。このドキュメントの基になる Java IDE は Eclipse 3.3 です。Eclipse IDE を使用して、Web プロジェクトを作成し、必要な JAR ファイルをプロジェクトに追加します。index.html という名前の HTML ページと Java サーブレットをプロジェクトに追加します。

次のリストでは、web プロジェクトに含める JAR ファイルを指定します。

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

これらの JAR ファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。

Web プロジェクトの作成

1. Eclipse を起動し、ファイル／新規プロジェクト​をクリックします。
2. 新規プロジェクト​ダイアログボックスで、Web／ダイナミック Web プロジェクト​を選択します。
3. プロジェクト名として InvokePreLoanProcess と入力し、「終了」をクリックします。

必要な JAR ファイルをプロジェクトに追加する

1. プロジェクトエクスプローラーウィンドウで、InvokePreLoanProcess プロジェクトを右クリックして​プロパティ​を選択します。
2. 「Java ビルドパス」をクリックしてから「ライブラリ」タブをクリックします。
3. 「外部 JAR を追加」ボタンをクリックし、含める JAR ファイルを参照します。

プロジェクトに Java サーブレットを追加

1. プロジェクトエクスプローラーウィンドウで、InvokePreLoanProcess プロジェクトを右クリックして、新規／その他​を選択します。
2. Web フォルダーを展開し、「Servlet」を選択してから「次へ」をクリックします。
3. サーブレットを作成ダイアログボックスで、サーブレット名として SubmitXML と入力してから「終了」をクリックします。

プロジェクトに HTML ページを追加する

1. プロジェクトエクスプローラーウィンドウで、InvokePreLoanProcess プロジェクトを右クリックして、新規／その他​を選択します。
2. Web フォルダーを展開し 、「HTML」を選択してから「次へ」をクリックします。
3. 新規 HTML ダイアログボックスで、ファイル名として index.html と入力してから「終了」をクリックします。

サーブレット用の Java アプリケーションロジックの作成

Java サーブレット内から 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 サーブレットの doGet または doPost メソッドには配置しません。より優れたプログラミング方法は、このコードを別のクラスに配置することです。次に、doPost メソッド（または doGet メソッド）内からクラスをインスタンス化し、適切なメソッドを呼び出します。ただし、コードを簡潔にするために、コード例は最小限に抑えられ、doPost メソッドに配置されています。

Invocation API を使用して FirstAppSolution/PreLoanProcess プロセスを呼び出すには、次のタスクを実行します。

1. adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。これらのファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。

2. HTML ページから送信された名前、電話、金額の値を取得します。これらの値を使用して、FirstAppSolution/PreLoanProcess プロセスに送信される XML データソースを動的に作成します。org.w3c.dom クラスを使用して XML データソースを作成できます（このアプリケーションロジックを次のコード例に示します）。

3. 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。（接続プロパティの設定を参照。）

4. ServiceClient オブジェクトを作成するには、コントラクターを使用して、ServiceClientFactory オブジェクトを渡します。ServiceClient オブジェクトを使用すると、サービス操作を呼び出すことができます。呼び出し要求の検索、ディスパッチ、ルーティングなどのタスクを処理します。

5. コンストラクターを使用して java.util.HashMap オブジェクトを作成します。

6. 各入力パラメーターに対して java.util.HashMap オブジェクトの put メソッドを呼び出して、長期間有効なプロセスに渡します。プロセスの入力パラメーターの名前を必ず指定してください。FirstAppSolution/PreLoanProcess プロセスにはタイプ XML（formData という名前）の 1 つの入力パラメーターが必要なため、put メソッドを呼び出す必要があるのは 1 回だけです。

    //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 を指定するブール値が同期リクエストを作成します（この値は、長時間有効なプロセスを呼び出すために適用されます）。
   メモ

   createInvocationRequest メソッドの 4 番目のパラメーターとして値 true を渡すことによって、短期間有効なプロセスを呼び出すことができます。値 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. 呼び出し ID 値をクライアント web ブラウザーに書き込みます。java.io.PrintWriter インスタンスを使用して、この値をクライアント web ブラウザーに書き込みます。

クイックスタート：Invocation API を使用した長時間有効なプロセスの呼び出し

次の Java コード例は、FirstAppSolution/PreLoanProcess プロセスを呼び出す Java サーブレットを表しています。

 /*
     * 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 アプリケーション用の web ページの作成

index.html web ページは、FirstAppSolution/PreLoanProcess プロセスを呼び出す Java サーブレットへのエントリポイントを提供します。この web ページは、HTML フォームと送信ボタンを含む基本的な HTML フォームです。ユーザーが送信ボタンをクリックすると、フォームデータが SubmitXML Java サーブレットにポストされます。

Java サーブレットは、次の 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 サーブレットをデプロイするには、web アプリケーションを WAR ファイルにパッケージ化します。コンポーネントのビジネスロジックが依存する外部 JAR ファイル（ adobe-livecycle-client.jar や adobe-usermanager-client.jar など）も WAR ファイルに含めるようにします。

次のイラストは、WAR ファイルにパッケージ化された Eclipse プロジェクトのコンテンツを示しています。

Web アプリケーションを WAR ファイルにパッケージ化するには：

1. プロジェクトエクスプローラ​ウィンドウで、InvokePreLoanProcess プロジェクトを右クリックして、エクスポート／WAR ファイル​を選択します。
2. Web モジュール​テキストボックスで、Java プロジェクトの名前として InvokePreLoanProcess と入力します。
3. 宛先​テキストボックスで、ファイル名としてPreLoanProcess.war と入力し、WAR ファイルの場所を指定してから「終了」をクリックします。

AEM Forms をホストする J2EE アプリケーションサーバーに WAR ファイルをデプロイする

WAR ファイルを、AEM Forms がデプロイされている J2EE アプリケーションサーバーにデプロイします。WAR ファイルを J2EE アプリケーションサーバーにデプロイするには、WAR ファイルをエクスポートパスから [AEM Forms Install]\Adobe\Adobe Experience Manager Forms\jboss\server\lc_turnkey\deploy にコピーします。

Web アプリケーションのテスト

Web アプリケーションをデプロイした後、Web ブラウザーを使用してテストできます。 AEM Forms をホストしているコンピューターを使用している場合は、次の URL を指定できます。

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

  HTML フォームフィールドに値を入力し、「アプリケーションの送信」ボタンをクリックします。 問題が発生した場合は、J2EE アプリケーションサーバーのログファイルを参照してください。

人間中心の長期間有効なプロセスを呼び出す ASP.NET Web アプリケーションの作成

FirstAppSolution/PreLoanProcess プロセスを呼び出す ASP.NET アプリケーションを作成できます。ASP.NET アプリケーションからこのプロセスを呼び出すには、Web サービスを使用します。 （Web サービスを使用した AEM Forms の呼び出しを参照してください）。

次のイラストは、エンドユーザーからデータを取得する ASP.NET クライアントアプリケーションを示しています。データは XML データソースに配置され、ユーザーが「アプリケーションを送信」ボタンをクリックした際に FirstAppSolution/PreLoanProcess プロセスに送信されます。

プロセスの呼び出し後に、呼び出し識別子の値が表示されることに注意してください。呼び出し識別子の値は、長期間有効なプロセスのステータスを追跡するレコードの一部として作成されます。

ASP.NET アプリケーションは、次のタスクを実行します。

• ユーザーが web ページに入力した値を取得します。
• FirstAppSolution/PreLoanProcess プロセス に渡される XML データソースを動的に作成します。3 つの値は、XML データソースで指定されます。
• Web サービスを使用して、FirstAppSolution/PreLoanProcess プロセスを呼び出します。
• 呼び出し識別子の値と、長時間有効な操作のステータスをクライアント web ブラウザーに返します。

手順の概要

FirstAppSolution/PreLoanProcess プロセスを呼び出す ASP.NET アプリケーションを作成するには、次の手順を実行します。

1. ASP.NET Web アプリケーションを作成します。
2. FirstAppSolution/PreLoanProcess を呼び出す ASP ページを作成します。
3. ASP.NET アプリケーションを実行します。

ASP.NET Web アプリケーションの作成

Microsoft .NET C# ASP.NET Web アプリケーションを作成します。 次のイラストは、InvokePreLoanProcess という名前の ASP.NET プロジェクトのコンテンツを示します。

サービスリファレンスの下に、2 つの項目があることに注意してください。最初の項目の名前は JobManager です。 このリファレンスにより、ASP.NET アプリケーションは Job Manager サービスを呼び出すことができます。このサービスは、長期間有効なプロセスのステータスに関する情報を返します。例えば、プロセスが現在実行中の場合、このサービスは現在実行中のプロセスを示す数値を返します。 2 つ目のリファレンスは、PreLoanProcess という名前です。このサービスリファレンスは、FirstAppSolution/PreLoanProcess プロセスへの参照を表します。 サービスリファレンスを作成した後に、AEM Forms サービスに関連付けられているデータタイプを .NET プロジェクト内で使用できます。

ASP.NET プロジェクトの作成：

1. Microsoft Visual Studio 2008 を起動します。
2. ファイル​メニューから、「新規」、「Web サイト」を選択します。
3. テンプレート​リストから、「ASP.NET Web サイト」を選択します。
4. 「場所」ボックスで、プロジェクトの場所を選択します。 InvokePreLoanProcess とプロジェクトに名前を付けます。
5. 「言語」ボックスで、「ビジュアル C#」を選択します。
6. 「OK」をクリックします。

サービスリファレンスの追加：

1. プロジェクトメニューで、「サービスリファレンスを追加」を選択します。

2. アドレス​ダイアログボックスで、Job Manager サービスに対する WSDL を指定します。

    https://hiro-xp:8080/soap/services/JobManager?WSDL&lc_version=9.0.1
   

3. 「名前空間」フィールドに JobManager と入力します。

4. 「Go」をクリックし、「OK」をクリックします。

5. プロジェクト​メニューから、「サービスリファレンスを追加」を選択します。

6. 「アドレス」ダイアログボックスで、FirstAppSolution/PreLoanProcess プロセスの WSDL を指定します。

    https://hiro-xp:8080/soap/services/FirstAppSolution/PreLoanProcess?WSDL&lc_version=9.0.1
   

7. 「名前空間」フィールドに PreLoanProcess と入力します。

8. 「Go」をクリックし、「OK」をクリックします。

FirstAppSolution/PreLoanProcess を呼び出す ASP ページを作成する

ASP.NET プロジェクト内に、ローン申請者に HTML ページを表示する web フォーム（ASPX ファイル）を追加します。Web フォームは、System.Web.UI.Page から派生したクラスに基づいています。FirstAppSolution/PreLoanProcess を呼び出す C# アプリケーションロジックは Button1_Click メソッドにあります（このボタンは、「アプリケーションの送信」ボタンを表します）。

次のイラストは、ASP.NET アプリケーションを示しています

次のテーブルは、この ASP.NET アプリケーションの一部であるコントロールの一覧です。

ASP.NET アプリケーションの一部であるアプリケーションロジックは、XML データソースを動的に作成し、FirstAppSolution/PreLoanProcess プロセスに渡します。申請者が HTML ページに入力した値は、XML データソース内で指定する必要があります。これらのデータ値は、フォームが Workspace で表示される際に、フォームに結合されます。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 Forms ユーザー名をデータメンバー 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. ユーザーが web ページに入力した名前、電話、金額の値を取得します。これらの値を使用して、FirstAppSolution/PreLoanProcess プロセスに送信される XML データソースを動的に作成します。プロセスに渡す XML データソースを表す System.Xml.XmlDocument を作成します（次のコード例に、このアプリケーションロジックを示します）。

7. System.Xml.XmlDocument インスタンスを InvokePreLoanProcess.PreLoanProcess.XML に変換します（次のコード例に、このアプリケーションロジックを示します）。

8. FirstAppSolution_PreLoanProcessClient オブジェクトの invoke_Async メソッドを呼び出して、FirstAppSolution/PreLoanProcess プロセスを呼び出します。このメソッドは、長期間有効なプロセスの呼び出し識別子の値を表す文字列値を返します。

9. コンストラクターを使用して JobManagerClient を作成します。（Job Manager サービスへのサービス参照が設定されていることを確認してください）。

10. 手順 1 ～ 5 を繰り返します。手順 2 で URL https://hiro-xp:8080/soap/services/JobManager?blob=mtom を指定します。

11. コンストラクターを使用して JobId オブジェクトを作成します。

12. JobId オブジェクトの id データメンバーに FirstAppSolution_PreLoanProcessClient オブジェクトの invoke_Async メソッドの戻り値を設定します。

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 "";
            }
       }
 }

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 によって自動的にデプロイされます。

人間中心の長期間有効なプロセスを呼び出す、Flexで構築されたクライアントアプリケーションの作成

Flex で構築した FirstAppSolution/PreLoanProcess プロセスを呼び出すためのクライアントアプリケーションを作成できます。このアプリケーションは、Remoting を使用して FirstAppSolution/PreLoanProcess プロセスを呼び出します。（ AEM Forms では廃止となった AEM Forms Remoting を使用した AEM Forms の呼び出しを参照。）

次のイラストに、Flex で構築したクライアントアプリケーションでエンドユーザーからデータを収集する様子を示します。データは XML データソースに配置され、プロセスに送信されます。

プロセスの呼び出し後に、呼び出し識別子の値が表示されることに注意してください。呼び出し識別子の値は、長期間有効なプロセスのステータスを追跡するレコードの一部として作成されます。

Flex で構築されたクライアントアプリケーションは、次のタスクを実行します。

• ユーザーが web ページに入力した値を取得します。
• FirstAppSolution/PreLoanProcess プロセスに渡される XML データソースを動的に作成します。3 つの値は、XML データソースで指定されます。
• Remoting を使用して FirstAppSolution/PreLoanProcess プロセスをを呼び出します。
• 長期間有効なプロセスの呼び出し識別子の値を返します。

手順の概要

FirstAppSolution/PreLoanProcess プロセスを呼び出すことができる Flex で構築されたクライアントアプリケーションを作成するには、次の手順を実行します。

1. 新しい Flex プロジェクトを開始します。

2. プロジェクトのクラスパスに adobe-remoting-provider.swc ファイルを含めます。 （AEM Forms Flex ライブラリファイルを含めるを参照。）

3. ActionScript または MXML 経由でmx:RemoteObjectインスタンスを作成します。（mx:RemoteObject インスタンスの作成を参照。）

4. AEM Forms と通信するための ChannelSet インスタンスを設定し、それを mx:RemoteObject インスタンスに関連付けます。（AEM Forms へのチャンネルの作成を参照。）

5. ChannelSet のloginメソッドまたはサービスのsetCredentialsメソッドを使用して、ユーザー識別情報の値とパスワードを指定します。 （ シングルサインオンの使用を参照。）

6. XML インスタンスを作成して、FirstAppSolution/PreLoanProcess プロセスに渡す XML データソースを作成します。（このアプリケーションロジックを次のコード例に示します）。

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>