Puoi richiamare in modo programmatico i processi a vita lunga incentrati sull’uomo creati in Workbench utilizzando le seguenti applicazioni client:
Il processo di lunga durata richiamato è denominato FirstAppSolution/PreLoanProcess. Per creare questo processo, segui l’esercitazione specificata in Creazione della prima applicazione AEM Forms.
Un processo incentrato sull’uomo implica un’attività alla quale un utente può rispondere utilizzando Workspace. Ad esempio, utilizzando Workbench, è possibile creare un processo che consenta a un manager bancario di approvare o rifiutare una richiesta di prestito. Nella figura seguente viene illustrato il processo FirstAppSolution/PreLoanProcess.
Il FirstAppSolution/PreLoanProcess il processo accetta un parametro di input denominato formData di tipo XML. I dati XML vengono uniti a una struttura di modulo denominata PreLoanForm.xdp. Nella figura seguente viene illustrato un modulo che rappresenta un task assegnato a un utente per approvare o rifiutare una richiesta di prestito. L’utente approva o nega l’applicazione utilizzando Workspace. L’utente di Workspace può approvare la richiesta di prestito facendo clic sul pulsante Approve (Approva) illustrato nella figura seguente. Analogamente, l’utente può rifiutare la richiesta di prestito facendo clic sul pulsante Nega.
Un processo di lunga durata viene richiamato in modo asincrono e non può essere richiamato in modo sincrono a causa dei seguenti fattori:
Quando viene richiamato un processo di lunga durata, AEM Forms crea un valore di identificativo di chiamata come parte della creazione di un record. Il record tiene traccia dello stato del processo di lunga durata e viene memorizzato nel database di AEM Forms. Utilizzando il valore dell'identificatore di chiamata, è possibile tenere traccia dello stato del processo di lunga durata. È inoltre possibile utilizzare il valore dell'identificatore di chiamata del processo per eseguire operazioni di Gestione processi, ad esempio la chiusura di un'istanza del processo in esecuzione.
AEM Forms non crea un valore di identificatore di chiamata o un record quando viene richiamato un processo di breve durata.
Il FirstAppSolution/PreLoanProcess
Il processo viene richiamato quando un richiedente presenta un'applicazione, rappresentata come dati XML. Il nome della variabile di processo di input è formData
e il relativo tipo di dati è XML. Ai fini della presente discussione, si supponga che i seguenti dati XML vengano utilizzati come input per FirstAppSolution/PreLoanProcess
processo.
<?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>
I dati XML passati a un processo devono corrispondere ai campi presenti nel modulo utilizzato nel processo. In caso contrario, i dati non verranno visualizzati all'interno del modulo. Tutte le applicazioni che richiamano FirstAppSolution/PreLoanProcess
Il processo deve passare questa origine dati XML. Le applicazioni create in Richiamare processi a lunga durata incentrati sull'uomo creare dinamicamente l'origine dati XML dai valori immessi da un utente in un client Web.
Utilizzando un’applicazione client, puoi inviare FirstAppSolution/PreLoanProcess elabora i dati XML richiesti. Un processo di lunga durata restituisce un valore dell'identificatore di chiamata come valore restituito. L’illustrazione seguente mostra le applicazioni client che richiamano il processo di lunga durata*FirstAppSolution/PreLoanProcess. Le applicazioni client inviano dati XML e restituiscono un valore stringa che rappresenta il valore dell'identificatore di chiamata.
Consulta anche
Creazione di un’applicazione web Java che richiama un processo di lunga durata incentrato sull’uomo
Puoi creare un’applicazione basata sul web che utilizza un servlet Java per richiamare FirstAppSolution/PreLoanProcess
processo. Per richiamare questo processo da un servlet Java, utilizza l’API di chiamata all’interno del servlet Java. (vedere Richiamare AEM Forms tramite l’API Java.)
La figura seguente mostra un'applicazione client basata sul Web che pubblica i valori di nome, telefono (o e-mail) e importo. Questi valori vengono inviati al servlet Java quando l’utente fa clic sul pulsante Invia applicazione.
Il servlet Java esegue le seguenti attività:
Per creare un'applicazione Java basata sul Web che richiama FirstAppSolution/PreLoanProcess
processo, effettuare le seguenti operazioni:
Alcuni di questi passaggi dipendono dall’applicazione J2EE su cui viene distribuito AEM Forms. Ad esempio, il metodo utilizzato per distribuire un file WAR dipende dal server applicazioni J2EE in uso. Si presume che AEM Forms sia implementato su JBoss®.
Il primo passaggio per creare un’applicazione web consiste nel creare un progetto web. L’IDE Java su cui si basa questo documento è Eclipse 3.3. Utilizzando l’IDE Eclipse, crea un progetto web e aggiungi al progetto i file JAR richiesti. Aggiungi una pagina HTML denominata index.html e un servlet Java per il progetto.
L’elenco seguente specifica i file JAR da includere nel progetto web:
Per il percorso di questi file JAR, vedi Inclusione dei file della libreria Java di AEM Forms.
Il file J2EE.jar definisce i tipi di dati utilizzati da un servlet Java. Puoi ottenere questo file JAR dal server applicazioni J2EE in cui viene distribuito AEM Forms.
Creare un progetto web
InvokePreLoanProcess
per il nome del progetto, quindi fai clic su Fine.Aggiungi i file JAR richiesti al progetto
InvokePreLoanProcess
progetto e selezione Proprietà.Aggiungere un servlet Java al progetto
InvokePreLoanProcess
progetto e selezione Nuovo > Altro.SubmitXML
per il nome del servlet, quindi fai clic su Fine.Aggiungere una pagina HTML al progetto
InvokePreLoanProcess
progetto e selezione Nuovo > Altro.index.html
per il nome del file, quindi fare clic su Fine.Per informazioni sulla creazione di contenuto HTML che richiama il servlet Java SubmitXML, vedere Creare la pagina web per l’applicazione web.
Creare una logica dell’applicazione Java che richiami FirstAppSolution/PreLoanProcess
processo dall’interno del servlet Java. Il codice seguente mostra la sintassi del SubmitXML
Servlet Java:
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
}
Normalmente, non inserisci il codice client all’interno di un servlet Java doGet
o doPost
metodo. Una migliore pratica di programmazione consiste nel posizionare questo codice all'interno di una classe separata. Crea un'istanza della classe dall'interno di doPost
metodo (o doGet
e chiamare i metodi appropriati. Tuttavia, per brevità del codice, gli esempi di codice sono limitati al minimo e vengono inseriti nel doPost
metodo.
Per richiamare FirstAppSolution/PreLoanProcess
processo che utilizza l'API di richiamo, eseguire le attività seguenti:
Includi i file JAR dei client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, vedere Inclusione dei file della libreria Java di AEM Forms.
Recupera i valori di nome, telefono e importo inviati dalla pagina HTML. Utilizzare questi valori per creare in modo dinamico un'origine dati XML inviata al FirstAppSolution/PreLoanProcess
processo. È possibile utilizzare org.w3c.dom
classi per creare l'origine dati XML (questa logica di applicazione è illustrata nell'esempio di codice seguente).
Creare un ServiceClientFactory
oggetto che contiene proprietà di connessione. (vedere Impostazione delle proprietà di connessione.)
Creare un ServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto. A ServiceClient
object consente di richiamare un'operazione di servizio. Gestisce attività quali l’individuazione, l’invio e l’instradamento delle richieste di chiamata.
Creare un java.util.HashMap
mediante il costruttore.
Richiama java.util.HashMap
dell'oggetto put
metodo per ciascun parametro di input da passare al processo di lunga durata. Assicurarsi di specificare il nome dei parametri di input del processo. Perché il FirstAppSolution/PreLoanProcess
il processo richiede un parametro di input di tipo XML
(denominato formData
), è sufficiente richiamare put
una volta.
//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);
Creare un InvocationRequest
oggetto richiamando il ServiceClientFactory
dell'oggetto createInvocationRequest
e fornendo i seguenti valori:
FirstAppSolution/PreLoanProcess
processo, specificare FirstAppSolution/PreLoanProcess
.invoke
.java.util.HashMap
oggetto contenente i valori dei parametri richiesti dall'operazione di servizio.false
, che crea una richiesta asincrona (questo valore è applicabile per richiamare un processo di lunga durata).Un processo di breve durata può essere richiamato passando il valore true come quarto parametro del metodo createInvocationRequest. Se si passa il valore true, viene creata una richiesta sincrona.
Invia la richiesta di chiamata ad AEM Forms richiamando ServiceClient
dell'oggetto invoke
e passando il InvocationRequest
oggetto. Il invoke
il metodo restituisce un InvocationReponse
oggetto.
Un processo di lunga durata restituisce un valore stringa che rappresenta un valore di identificazione di chiamata. Recupera questo valore richiamando il InvocationReponse
dell'oggetto getInvocationId
metodo.
//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();
Scrivere il valore di identificazione della chiamata nel browser Web client. È possibile utilizzare una java.io.PrintWriter
per scrivere questo valore nel browser web client.
L’esempio di codice Java seguente rappresenta il servlet Java che richiama FirstAppSolution/PreLoanProcess
processo.
/*
* 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;
}
}
Il index.html pagina Web fornisce un punto di ingresso al servlet Java che richiama FirstAppSolution/PreLoanProcess
processo. Questa pagina Web è un modulo HTML di base che contiene un modulo HTML e un pulsante di invio. Quando l’utente fa clic sul pulsante di invio, i dati del modulo vengono inviati al SubmitXML
Servlet Java.
Il servlet Java acquisisce i dati pubblicati dalla pagina HTML utilizzando il seguente codice Java:
//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");
Il codice HTML seguente rappresenta il file index.html creato durante l’installazione dell’ambiente di sviluppo. (vedere Creare un progetto 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>
Per distribuire il servlet Java che richiama FirstAppSolution/PreLoanProcess
processo, crea un pacchetto dell’applicazione web in un file WAR. Assicurati che nel file WAR siano inclusi anche i file JAR esterni da cui dipende la logica di business del componente, come adobe-livecycle-client.jar e adobe-usermanager-client.jar.
L’illustrazione seguente mostra il contenuto del progetto Eclipse, inserito in un pacchetto in un file WAR.
Nell'illustrazione precedente, il file JPG può essere sostituito da qualsiasi file di immagine JPG.
Creare un pacchetto di un’applicazione web in un file WAR:
InvokePreLoanProcess
progetto e selezione Esporta > File WAR.InvokePreLoanProcess
per il nome del progetto Java.PreLoanProcess.war
per nome file, specificare il percorso del file WAR e quindi fare clic su Fine.Distribuire il file WAR sul server applicazioni J2EE sul quale viene distribuito AEM Forms. Per distribuire il file WAR nel server applicazioni J2EE, copiare il file WAR dal percorso di esportazione in [AEM Forms Install]\Adobe\Adobe Experience Manager Forms\jboss\server\lc_turnkey\deploy
.
se AEM Forms non è distribuito su JBoss, è necessario distribuire il file WAR in conformità con il server applicazioni J2EE che ospita AEM Forms.
Dopo aver distribuito l’applicazione web, puoi testarla utilizzando un browser web. Se utilizzi lo stesso computer che ospita AEM Forms, puoi specificare il seguente URL:
http://localhost:8080/PreLoanProcess/index.html
Immettere i valori nei campi del modulo HTML e fare clic sul pulsante Sottometti applicazione. Se si verificano problemi, vedere il file di registro del server applicazioni J2EE.
Per confermare che l’applicazione Java ha richiamato il processo, avvia Workspace e accetta il prestito.
È possibile creare un'applicazione ASP.NET che richiami FirstAppSolution/PreLoanProcess
processo. Per richiamare questo processo da un'applicazione ASP.NET, utilizzare i servizi Web. (vedere Richiamare AEM Forms tramite servizi Web.)
La figura seguente mostra un'applicazione client ASP.NET che ottiene dati da un utente finale. I dati vengono inseriti in un'origine dati XML e inviati al FirstAppSolution/PreLoanProcess
processo quando l'utente fa clic sul pulsante Invia applicazione.
Avviso dopo che il processo è stato richiamato, viene visualizzato un valore dell'identificatore di chiamata. Un valore dell'identificatore di chiamata viene creato come parte di un record che tiene traccia dello stato del processo di lunga durata.
L'applicazione ASP.NET esegue le seguenti attività:
Per creare un'applicazione ASP.NET in grado di richiamare il processo FirstAppSolution/PreLoanProcess, effettuare le seguenti operazioni:
Creare un'applicazione Web Microsoft .NET C# ASP.NET. Nella figura seguente viene illustrato il contenuto del progetto ASP.NET denominato InvokePreLoanProcess.
Avviso in Riferimenti servizio sono disponibili due elementi. Il primo elemento è denominato* JobManager*. Questo riferimento consente all'applicazione ASP.NET di richiamare il servizio Gestione processi. Questo servizio restituisce informazioni sullo stato di un processo di lunga durata. Se ad esempio il processo è in esecuzione, il servizio restituisce un valore numerico che specifica che il processo è in esecuzione. Il secondo riferimento è denominato PreLoanProcess. Questo riferimento al servizio rappresenta il riferimento al processo* FirstAppSolution/PreLoanProcess *. Dopo aver creato un riferimento al servizio, i tipi di dati associati al servizio AEM Forms sono disponibili per l'utilizzo all'interno del progetto .NET.
Crea un progetto ASP.NET:
Aggiungi riferimenti servizio:
Nel menu Progetto, seleziona Aggiungi riferimento servizio.
In Indirizzo , specificare il file WSDL del servizio Gestione processi.
https://hiro-xp:8080/soap/services/JobManager?WSDL&lc_version=9.0.1
Nel campo Namespace, digita JobManager
.
Clic Vai e quindi fare clic su OK.
In Progetto menu, seleziona Aggiungi riferimento servizio.
In Indirizzo , specificare il file WSDL per il processo FirstAppSolution/PreLoanProcess.
https://hiro-xp:8080/soap/services/FirstAppSolution/PreLoanProcess?WSDL&lc_version=9.0.1
Nel campo Namespace, digita PreLoanProcess
.
Clic Vai e quindi fare clic su OK.
Sostituisci hiro-xp
con l'indirizzo IP del server applicazioni J2EE che ospita AEM Forms. Il lc_version
assicura la disponibilità della funzionalità AEM Forms, ad esempio MTOM. Senza specificare lc_version
, non è possibile richiamare AEM Forms utilizzando MTOM. (vedere Richiamare AEM Forms tramite MTOM.)
All’interno del progetto ASP.NET, aggiungi un modulo web (un file ASPX) responsabile della visualizzazione di una pagina HTML al richiedente del prestito. Il modulo web è basato su una classe derivata da System.Web.UI.Page
. Logica dell'applicazione C# che richiama FirstAppSolution/PreLoanProcess
si trova in Button1_Click
metodo (questo pulsante rappresenta il pulsante Invia applicazione ).
La figura seguente mostra l'applicazione ASP.NET
Nella tabella seguente sono elencati i controlli che fanno parte di questa applicazione ASP.NET.
Nome controllo |
Descrizione |
---|---|
TextBoxName |
Specifica nome e cognome del cliente. |
TextBoxPhone |
Specifica l’indirizzo di telefono o e-mail del cliente. |
Valore TextBoxAmount |
Specifica l’importo del prestito. |
Button1 |
Rappresenta il pulsante Invia applicazione. |
LabelJobID |
Controllo Label che specifica il valore dell'identificatore di chiamata. |
LabelStatus |
Controllo Label che specifica il valore dello stato del processo. Questo valore viene recuperato richiamando il servizio Gestione processi. |
La logica dell'applicazione che fa parte dell'applicazione ASP.NET deve creare in modo dinamico un'origine dati XML da passare al FirstAppSolution/PreLoanProcess
processo. I valori immessi dal richiedente nella pagina HTML devono essere specificati nell'origine dati XML. Questi valori di dati vengono uniti nel modulo quando questo viene visualizzato in Workspace. Le classi che si trovano in System.Xml
per creare l'origine dati XML.
Quando si richiama un processo che richiede dati XML da un'applicazione ASP.NET, è disponibile un tipo di dati XML da utilizzare. In altre parole, non è possibile trasmettere un System.Xml.XmlDocument
al processo. Il nome completo dell'istanza XML da passare al processo è InvokePreLoanProcess.PreLoanProcess.XML
. Converti il System.Xml.XmlDocument
istanza a InvokePreLoanProcess.PreLoanProcess.XML
. È possibile eseguire questa operazione utilizzando il codice seguente.
//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();
Per creare una pagina ASP che richiami FirstAppSolution/PreLoanProcess
processo, esegui le seguenti attività in Button1_Click
metodo:
Creare un FirstAppSolution_PreLoanProcessClient
utilizzando il costruttore predefinito.
Creare un FirstAppSolution_PreLoanProcessClient.Endpoint.Address
oggetto utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms e il tipo di codifica:
https://hiro-xp:8080/soap/services/FirstAppSolution/PreLoanProcess?blob=mtom
Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, assicurati di specificare ?blob=mtom
.
Sostituisci hiro-xp
* con l'indirizzo IP del server applicazioni J2EE che ospita AEM Forms. *
Creare un System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore del FirstAppSolution_PreLoanProcessClient.Endpoint.Binding
membro dati. Invia il valore restituito a BasicHttpBinding
.
Imposta il System.ServiceModel.BasicHttpBinding
dell'oggetto MessageEncoding
membro dati a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
FirstAppSolution_PreLoanProcessClient.ClientCredentials.UserName.UserName
.FirstAppSolution_PreLoanProcessClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al membro dati BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al membro dati BasicHttpBindingSecurity.Security.Mode
.Nell'esempio di codice riportato di seguito vengono illustrate queste attività.
//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;
Recupera i valori di nome, telefono e importo immessi dall’utente nella pagina web. Utilizzare questi valori per creare in modo dinamico un'origine dati XML inviata al FirstAppSolution/PreLoanProcess
processo. Creare un System.Xml.XmlDocument
che rappresenta l'origine dati XML da passare al processo (questa logica dell'applicazione è illustrata nell'esempio di codice seguente).
Converti il System.Xml.XmlDocument
istanza a InvokePreLoanProcess.PreLoanProcess.XML
(questa logica di applicazione è illustrata nel seguente esempio di codice).
Richiama FirstAppSolution/PreLoanProcess
processo richiamando il FirstAppSolution_PreLoanProcessClient
dell'oggetto invoke_Async
metodo. Questo metodo restituisce un valore stringa che rappresenta il valore dell'identificatore di chiamata del processo di lunga durata.
Creare un JobManagerClient
utilizzando il costruttore is. Verificare di aver impostato un riferimento al servizio Gestione processo.
Ripetere i passaggi da 1 a 5. Specifica il seguente URL per il passaggio 2: https://hiro-xp:8080/soap/services/JobManager?blob=mtom
.
Creare un JobId
mediante il costruttore.
Imposta il JobId
dell'oggetto id
membro dati con il valore restituito del FirstAppSolution_PreLoanProcessClient
dell'oggetto invoke_Async
metodo.
Assegna la value
true per JobId
dell'oggetto persistent
membro dati.
Creare un JobStatus
oggetto richiamando il JobManagerService
dell'oggetto getStatus
e passando il JobId
oggetto.
Ottieni il valore dello stato recuperando il valore della proprietà JobStatus
dell'oggetto statusCode
membro dati.
Assegna il valore dell’identificatore di chiamata a LabelJobID.Text
campo.
Assegna il valore dello stato a LabelStatus.Text
campo.
Nell'esempio di codice di C# riportato di seguito viene richiamato FirstAppSolution/PreLoanProcess
processo.
???/**
* 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 "";
}
}
}
I valori presenti nel metodo definito dall'utente getJobDescription corrispondono ai valori restituiti dal servizio Gestione processo.
Dopo aver compilato e distribuito l'applicazione ASP.NET, è possibile eseguirla utilizzando un browser Web. Se il nome del progetto ASP.NET è InvokePreLoanProcess, specifica il seguente URL in un browser web:
*http://localhost:1629/InvokePreLoanProcess/*Default.aspx
dove localhost è il nome del server web che ospita il progetto ASP.NET e 1629 è il numero di porta. Quando si compila e si genera l'applicazione ASP.NET, Microsoft Visual Studio, la distribuisce automaticamente.
Per confermare che l’applicazione ASP.NET ha richiamato il processo, avvia Workspace e accetta il prestito.
Puoi creare un’applicazione client creata con Flex per richiamare FirstAppSolution/PreLoanProcess processo. Questa applicazione utilizza Remoting per richiamare FirstAppSolution/PreLoanProcess processo. (vedere Richiamare AEM Forms tramite (obsoleto per i moduli AEM) AEM Forms Remoting.)
L’illustrazione seguente mostra un’applicazione client creata con Flex che raccoglie dati da un utente finale. I dati vengono inseriti in un'origine dati XML e inviati al processo.
Avviso dopo che il processo è stato richiamato, viene visualizzato un valore dell'identificatore di chiamata. Un valore dell'identificatore di chiamata viene creato come parte di un record che tiene traccia dello stato del processo di lunga durata.
L’applicazione client generata con Flex esegue le seguenti attività:
Per creare un'applicazione client generata con Flex in grado di richiamare il processo FirstAppSolution/PreLoanProcess, effettuare le seguenti operazioni:
Avvia un nuovo progetto Flex.
Includi il file adobe-remoting-provider.swc nel percorso della classe del progetto. (vedere Inclusione del file della libreria Flex di AEM Forms.)
Creare un mx:RemoteObject
tramite ActionScript o MXML. (vedere Creazione di un'istanza mx:RemoteObject)
Configurare un ChannelSet
per comunicare con AEM Forms e associarla al mx:RemoteObject
dell'istanza. (vedere Creare un canale per AEM Forms.)
Chiamare il login
metodo o del servizio setCredentials
per specificare il valore e la password dell'identificatore utente. (vedere Utilizzo del Single Sign-On.)
Creare l'origine dati XML da passare al FirstAppSolution/PreLoanProcess
processo creando un'istanza XML. Questa logica di applicazione è illustrata nell'esempio di codice seguente.
Creare un oggetto di tipo Object utilizzando il relativo costruttore. Assegnare il codice XML all'oggetto specificando il nome del parametro di input del processo, come illustrato nel codice seguente:
//Get the XML data to pass to the AEM Forms process
var xml:XML = createXML();
var params:Object = new Object();
params["formData"]=xml;
Richiama FirstAppSolution/PreLoanProcess
processo chiamando il mx:RemoteObject
dell’istanza invoke_Async
metodo. Passa il Object
contenente il parametro di input. (vedere Trasmissione dei valori di input.)
Recuperare il valore di identificazione della chiamata restituito da un processo di lunga durata, come illustrato nel codice seguente:
// 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;
}
Nell'esempio di codice di Flex riportato di seguito viene richiamato FirstAppSolution/PreLoanProcess
processo.
<?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>