Het aanhalen van mens-Centric langlevende Processen
Gemaakt voor:
- Developer
U kunt mens-centric langlevende processen programmatically aanhalen die in Workbench gebruikend deze cliënttoepassingen werden gecreeerd:
- Een Java-clienttoepassing op het web die de Invocation-API gebruikt. (Zie AEM Forms aanroepen met de Java API(https://experienceleague.adobe.com/docs/experience-manager-64/forms/developer-reference/programming-aem-forms-jee/invoking-aem-forms-jee-apis/invoking-aem-forms-using-java.html?lang=nl#invoking-aem-forms-using-the-java-api).
- Een toepassing ASP.NET die de Webdiensten gebruikt. (Zie AEM Forms aanroepen met webservices.)
- Een clienttoepassing die is gebouwd met Flex die Remoting gebruikt. (Zie AEM Forms aanroepen met (Vervangen voor AEM formulieren) AEM Forms Remoting.)
Het langlevende proces dat wordt aangehaald wordt genoemd FirstAppSolution/PreLoanProcess. U kunt dit proces maken door de in Uw eerste AEM Forms-toepassing maken.
Een mens-centrisch proces impliceert een taak die een gebruiker kan antwoorden aan door Werkruimte te gebruiken. Met Workbench kunt u bijvoorbeeld een proces maken waarmee een bankmanager een leningtoepassing kan goedkeuren of weigeren. In de volgende afbeelding ziet u het proces FirstAppSolution/PreLoanProcess.
Het proces* FirstAppSolution/PreLoanProcess* accepteert een invoerparameter met de naam* formData* waarvan het gegevenstype XML is. De XML-gegevens worden samengevoegd met een formulierontwerp met de naam PreLoanForm.xdp. In de volgende afbeelding ziet u een formulier dat een taak vertegenwoordigt die aan een gebruiker is toegewezen om een leningtoepassing goed te keuren of te weigeren. De gebruiker keurt of ontkent de toepassing door Workspace te gebruiken. De gebruiker van de Werkruimte kan het leningsverzoek goedkeuren door de knoop van Goedkeuren te klikken die in de volgende illustratie wordt getoond. Op dezelfde manier kan de gebruiker het verzoek om een lening weigeren door op de knop Weigeren te klikken.
Een proces van lange duur wordt asynchroon aangehaald en kan niet synchroon wegens de volgende factoren worden aangehaald:
- Een proces kan veel tijd in beslag nemen.
- Een proces kan organisatorische grenzen overspannen.
- Een proces heeft externe input nodig om het te voltooien. Neem bijvoorbeeld een situatie waarin een formulier wordt verzonden naar een manager die zich buiten het kantoor bevindt. In dit geval is het proces niet volledig totdat de manager het formulier retourneert en invult.
Wanneer een langdurig proces wordt aangeroepen, maakt AEM Forms een waarde voor de aanroepings-id als onderdeel van het maken van een record. De record houdt de status van het langlevende proces bij en wordt opgeslagen in de AEM Forms-database. Met de waarde voor de oproepings-id kunt u de status van het langlevende proces volgen. Bovendien kunt u de waarde van de proces aanroepings herkenningsteken gebruiken om verrichtingen van de Manager van het Proces uit te voeren zoals het beëindigen van een lopende procesinstantie.
De FirstAppSolution/PreLoanProcess
Het proces wordt opgeroepen wanneer een aanvrager een aanvraag indient, die wordt weergegeven als XML-gegevens. De naam van de invoerprocesvariabele is formData
en het gegevenstype is XML. Ga er in deze discussie van uit dat de volgende XML-gegevens worden gebruikt als invoer voor de FirstAppSolution/PreLoanProcess
proces.
<?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-gegevens die aan een proces worden doorgegeven, moeten overeenkomen met de velden in het formulier dat in het proces wordt gebruikt. Anders worden de gegevens niet weergegeven in het formulier. Alle toepassingen die de FirstAppSolution/PreLoanProcess
Deze XML-gegevensbron moet worden doorgegeven. De toepassingen die zijn gemaakt in Het aanhalen van mens-Centric langlevende Processen Maak dynamisch de XML-gegevensbron op basis van waarden die een gebruiker in een webclient heeft ingevoerd.
Met een clienttoepassing kunt u de *FirstAppSolution/PreLoanProcess verzenden de vereiste XML-gegevens verwerken. Een langlevend proces retourneert een waarde voor de oproepings-id als geretourneerde waarde. In de volgende afbeelding ziet u hoe clienttoepassingen het FirstAppSolution/PreLoanProcess *langlevend proces. De clienttoepassingen verzenden XML-gegevens en krijgen een tekenreekswaarde die de waarde van de aanroepings-id vertegenwoordigt.
Zie ook
Een Java-webtoepassing maken die een menselijk-centrisch proces van lange duur oproept
Creërend een Asp.net- Webtoepassing die een mens-centric langlevend proces aanhaalt
Een Java-webtoepassing maken die een menselijk-centrisch proces van lange duur oproept
U kunt een webtoepassing maken die een Java-servlet gebruikt om de FirstAppSolution/PreLoanProcess
proces. Als u dit proces vanuit een Java-servlet wilt aanroepen, gebruikt u de API voor aanroepen in de Java-servlet. (Zie AEM Forms aanroepen met de Java API.)
In de volgende afbeelding ziet u een clienttoepassing op het web waarmee de naam, telefoon (of e-mail) en waarden worden gepost. Deze waarden worden naar de Java-server verzonden wanneer de gebruiker op de knop Toepassing verzenden klikt.
Java servlet voert de volgende taken uit:
- Haalt de waarden op die van de pagina HTML naar het Java-servlet zijn gepost.
- Hiermee wordt dynamisch een XML-gegevensbron gemaakt die wordt doorgegeven aan het process FirstAppSolution/PreLoanProcess. De naam, telefoon (of e-mail) en de waarden voor de hoeveelheid worden opgegeven in de XML-gegevensbron.
- Roept de FirstAppSolution/PreLoanProcess verwerken met de AEM Forms Invocation API.
- Hiermee wordt de waarde van de oproepings-id geretourneerd aan de webbrowser van de client.
Overzicht van de stappen
Een Java-webtoepassing maken die het FirstAppSolution/PreLoanProcess
Voer de volgende stappen uit:
Een webproject maken
De eerste stap voor het maken van een webtoepassing is het maken van een webproject. De Java-IDE waarop dit document is gebaseerd, is Eclipse 3.3. Gebruikend IDE van de Verduistering, creeer een Webproject en voeg de vereiste JAR dossiers aan uw project toe. Voeg een HTML-pagina met de naam *index.html *en een Java-servlet toe aan uw project.
In de volgende lijst worden de JAR-bestanden weergegeven die in uw webproject moeten worden opgenomen:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- J2EE.jar
Ga voor de locatie van deze JAR-bestanden naar Inclusief AEM Forms Java-bibliotheekbestanden.
Een webproject maken
- Eclipse starten en klikken Bestand > Nieuw project.
- In de Nieuw project dialoogvenster selecteert u Web > Dynamisch webproject.
- Type
InvokePreLoanProcess
voor de naam van uw project en klik vervolgens op Voltooien.
Vereiste JAR-bestanden toevoegen aan uw project
- Van het venster van de Ontdekkingsreiziger van het Project, klik met de rechtermuisknop aan
InvokePreLoanProcess
project en selecteer Eigenschappen. - Klikken Java-ontwikkelpad en klik vervolgens op de knop Bibliotheken tab.
- Klik op de knop Externe JAR's toevoegen en blader naar de JAR-bestanden die u wilt opnemen.
Een Java-servlet toevoegen aan uw project
- Van het venster van de Ontdekkingsreiziger van het Project, klik met de rechtermuisknop aan
InvokePreLoanProcess
project en selecteer Nieuw > Overige. - Breid uit Web map, selecteert u Servlet en klik vervolgens op Volgende.
- Typ in het dialoogvenster Servlet maken
SubmitXML
voor de naam van de servlet en klik vervolgens op Voltooien.
Een HTML-pagina toevoegen aan uw project
- Van het venster van de Ontdekkingsreiziger van het Project, klik met de rechtermuisknop aan
InvokePreLoanProcess
project en selecteer Nieuw > Overige. - Breid uit Web map, selecteert u HTML en klik op Volgende.
- Typ in het dialoogvenster Nieuwe HTML
index.html
voor de bestandsnaam en klik vervolgens op Voltooien.
Java-toepassingslogica voor de servlet maken
Java-toepassingslogica maken die de FirstAppSolution/PreLoanProcess
proces vanuit de Java-servlet. De volgende code toont de syntaxis van 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
}
Normaal gesproken plaatst u geen clientcode in een Java-servlet doGet
of doPost
methode. Een betere programmeerpraktijk is deze code binnen een afzonderlijke klasse te plaatsen. Instantieer vervolgens de klasse vanuit de doPost
methode (of doGet
methode) en roept de aangewezen methodes aan. Voor de beknoptheid van de code worden codevoorbeelden echter tot een minimum beperkt en in de doPost
methode.
Om het FirstAppSolution/PreLoanProcess
Voer de volgende taken uit met behulp van de API voor oproepen:
-
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project. Voor informatie over de locatie van deze bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.
-
Haal de naam, de telefoon, en de waardewaarden op van de HTML pagina die worden voorgelegd. Gebruik deze waarden om dynamisch een XML-gegevensbron te maken die naar de
FirstAppSolution/PreLoanProcess
proces. U kuntorg.w3c.dom
klassen om de XML-gegevensbron te maken (deze toepassingslogica wordt in het volgende codevoorbeeld weergegeven). -
Een
ServiceClientFactory
object dat verbindingseigenschappen bevat. (Zie Verbindingseigenschappen instellen.) -
Een
ServiceClient
object door de constructor ervan te gebruiken en door te gevenServiceClientFactory
object. AServiceClient
kunt u een servicebewerking aanroepen. Het behandelt taken zoals het lokaliseren van, het verzenden van, en het verpletteren van oproepingsverzoeken. -
Een
java.util.HashMap
object met behulp van de constructor. -
De
java.util.HashMap
objectput
methode voor elke inputparameter om tot het langlevende proces over te gaan. Zorg ervoor dat u de naam van de invoerparameters van het proces opgeeft. OmdatFirstAppSolution/PreLoanProcess
proces vereist één invoerparameter van typeXML
(benoemdformData
), hoeft u alleen deput
eenmaal.//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);
-
Een
InvocationRequest
door het object aan te roepenServiceClientFactory
objectcreateInvocationRequest
en geeft de volgende waarden door:- Een tekenreekswaarde die de naam aangeeft van het proces met een lange levensduur dat moet worden aangeroepen. Om het
FirstAppSolution/PreLoanProcess
proces, specificerenFirstAppSolution/PreLoanProcess
. - Een tekenreekswaarde die staat voor de naam van de procesbewerking. De naam van de langdurige procesbewerking is
invoke
. - De
java.util.HashMap
object dat de parameterwaarden bevat die de servicebewerking vereist. - Een Booleaanse waarde die
false
, die een asynchrone aanvraag maakt (deze waarde is van toepassing om een langlevend proces aan te roepen).
NOTE
Een proces van korte duur kan worden aangeroepen door de waarde true door te geven als de vierde parameter van de methode createInvocationRequest. Als u de waarde waar doorgeeft, wordt een synchrone aanvraag gemaakt. - Een tekenreekswaarde die de naam aangeeft van het proces met een lange levensduur dat moet worden aangeroepen. Om het
-
Verzend het oproepingsverzoek naar AEM Forms door het
ServiceClient
objectinvoke
en het doorgeven van deInvocationRequest
object. Deinvoke
methode retourneert eenInvocationReponse
object. -
Een langlevend proces retourneert een tekenreekswaarde die een aanroepende-identificatiewaarde vertegenwoordigt. Haal deze waarde op door het
InvocationReponse
objectgetInvocationId
methode.//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();
-
Schrijf de waarde voor de oproepidentificatie naar de webbrowser van de client. U kunt een
java.io.PrintWriter
-instantie om deze waarde naar de webbrowser van de client te schrijven.
Snel starten: Een langdurig proces aanroepen met de API voor aanroepen
In het volgende Java-codevoorbeeld wordt de Java-servlet weergegeven die het FirstAppSolution/PreLoanProcess
proces.
/*
* 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;
}
}
De webpagina voor de webtoepassing maken
De webpagina* index.html *biedt een ingangspunt voor de Java-servlet die de FirstAppSolution/PreLoanProcess
proces. Deze webpagina is een basisformulier voor HTML dat een HTML-formulier en een verzendknop bevat. Wanneer de gebruiker op de verzendknop klikt, worden formuliergegevens naar de SubmitXML
Java servlet.
De Java-servlet legt de gegevens vast die vanuit de HTML-pagina zijn gepost met behulp van de volgende Java-code:
//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");
De volgende HTML code vertegenwoordigt het bestand index.html dat tijdens de installatie van de ontwikkelomgeving is gemaakt. (Zie Een webproject maken.)
<!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>
De webtoepassing verpakken naar een WAR-bestand
Om de servlet van Java op te stellen die het FirstAppSolution/PreLoanProcess
-proces, verpakt uw webtoepassing in een WAR-bestand. Zorg ervoor dat externe JAR-bestanden waarvan de bedrijfslogica van de component afhankelijk is, zoals adobe-livecycle-client.jar en adobe-usermanager-client.jar, ook in het WAR-bestand worden opgenomen.
De volgende illustratie toont de inhoud van het project Eclipse, die aan een dossier van WAR wordt verpakt.
Een webtoepassing verpakken naar een WAR-bestand:
- Van de Projectverkenner venster, klikt u met de rechtermuisknop op de knop
InvokePreLoanProcess
project en selecteer Exporteren > WAR-bestand. - In de Webmodule tekstvak, tekst
InvokePreLoanProcess
voor de naam van het Java-project. - In de Doel tekstvak, tekst
PreLoanProcess.war
voor de Geef de locatie van het WAR-bestand op en klik op Voltooien.
WAR-bestand implementeren op de J2EE-toepassingsserver die als host fungeert voor AEM Forms
Implementeer het WAR-bestand op de J2EE-toepassingsserver waarop AEM Forms is geïmplementeerd. Als u het WAR-bestand wilt implementeren op de J2EE-toepassingsserver, kopieert u het WAR-bestand van het exportpad naar [AEM Forms installeren]\Adobe\Adobe Experience Manager Forms\jboss\server\lc_turnkey\deploy.
Uw webtoepassing testen
Nadat u de webtoepassing hebt geïmplementeerd, kunt u deze testen met een webbrowser. Ervan uitgaande dat u dezelfde computer gebruikt als die waarop AEM Forms wordt gehost, kunt u de volgende URL opgeven:
-
http://localhost:8080/PreLoanProcess/index.html
Voer waarden in de formuliervelden HTML in en klik op de knop Toepassing verzenden. Als er problemen optreden, raadpleegt u het logbestand van de J2EE-toepassingsserver.
NOTE
Als u wilt bevestigen dat de Java-toepassing het proces heeft aangeroepen, start u Workspace en accepteert u de lening.
Creërend een Asp.net- Webtoepassing die een mens-centric langlevend proces aanhaalt
U kunt een toepassing tot stand brengen ASP.NET die aanhaalt FirstAppSolution/PreLoanProcess
proces. Om dit proces van een toepassing aan te halen ASP.NET, gebruik de Webdiensten. (Zie AEM Forms aanroepen met webservices.)
De volgende illustratie toont een ASP.NET cliënttoepassing die gegevens van een eind verkrijgen - gebruiker. De gegevens worden in een XML-gegevensbron geplaatst en naar de FirstAppSolution/PreLoanProcess
verwerken wanneer de gebruiker op de knop Toepassing verzenden klikt.
Nadat het proces is aangeroepen, wordt een waarde voor de aanroepings-id weergegeven. Een waarde voor de oproepings-id wordt gemaakt als onderdeel van een record die de status van het proces met een lange levensduur bijhoudt.
De toepassing ASP.NET voert de volgende taken uit:
- Haalt de waarden op die de gebruiker op de webpagina heeft ingevoerd.
- Creeert dynamisch een gegevensbron van XML die tot* FirstAppSolution/PreLoanProcess *process wordt overgegaan. De drie waarden worden opgegeven in de XML-gegevensbron.
- Roept het* FirstAppSolution/PreLoanProcess *process aan door de Webdiensten te gebruiken.
- Retourneert de aanroepings-id-waarde en de status van de langdurige bewerking naar de webbrowser van de client.
Overzicht van de stappen
Om een toepassing tot stand te brengen ASP.NET die het proces kan aanhalen FirstAppSolution/PreLoanProcess, voer de volgende stappen uit:
Een ASP.NET-webtoepassing maken
Creeer een toepassing van het Web van Microsoft .NET C# ASP.NET. De volgende illustratie toont de inhoud van het genoemde project ASP.NET InvokePreLoanProcess.
Bericht onder de Verwijzingen van de Dienst, zijn er twee punten. Het eerste item heeft de naam* JobManager*. Deze verwijzing laat de toepassing ASP.NET toe om de dienst van de Manager van de Baan aan te halen. Deze dienst keert informatie over het statuut van een lang-levend proces terug. Als het proces bijvoorbeeld op dat moment wordt uitgevoerd, retourneert deze service een numerieke waarde die aangeeft dat het proces momenteel wordt uitgevoerd. De tweede verwijzing krijgt de naam PreLoanProcess. Deze serviceverwijzing vertegenwoordigt de verwijzing naar het process FirstAppSolution/PreLoanProcess. Nadat u een Verwijzing van de Dienst creeert, zijn de gegevenstypes verbonden aan de dienst van AEM Forms beschikbaar voor gebruik binnen uw .NET project.
Maak een ASP.NET-project:
- Start Microsoft Visual Studio 2008.
- Van de Bestand menu, selecteert u Nieuw, Website.
- In de Sjablonen list, selecteer ASP.NET-website.
- In de Locatie selecteert u een locatie voor uw project. Geef uw project een naam InvokePreLoanProcess.
- In de Taal doos, uitgezochte Visuele C#
- Klik op OK.
Serviceverwijzingen toevoegen:
-
Selecteer in het menu Project de optie Serviceverwijzing toevoegen.
-
In de Adres geeft u de WSDL op in de taakbeheerservice.
https://hiro-xp:8080/soap/services/JobManager?WSDL&lc_version=9.0.1
-
Typ in het veld Namespace
JobManager
. -
Klikken Ga en klik vervolgens op OK.
-
In de Project menu, selecteert u Serviceverwijzing toevoegen.
-
In de Adres geeft u de WSDL op voor het proces FirstAppSolution/PreLoanProcess.
https://hiro-xp:8080/soap/services/FirstAppSolution/PreLoanProcess?WSDL&lc_version=9.0.1
-
Typ in het veld Namespace
PreLoanProcess
. -
Klikken Ga en klik vervolgens op OK.
hiro-xp
met het IP-adres van de J2EE-toepassingsserver die als host fungeert voor AEM Forms. De lc_version
zorgt ervoor dat AEM Forms-functionaliteit, zoals MTOM, beschikbaar is. Zonder het lc_version
kunt u AEM Forms niet aanroepen met MTOM. (Zie AEM Forms aanroepen met MTOM.)Maak een ASP-pagina die FirstAppSolution/PreLoanProcess aanroept
Voeg binnen het ASP.NET-project een webformulier (een ASPX-bestand) toe dat verantwoordelijk is voor de weergave van een HTML-pagina bij de aanvrager van de lening. Het webformulier is gebaseerd op een klasse die is afgeleid van System.Web.UI.Page
. De C# toepassingslogica die aanhaalt FirstAppSolution/PreLoanProcess
bevindt zich in de Button1_Click
(deze knop vertegenwoordigt de knop Toepassing verzenden).
De volgende illustratie toont de toepassing ASP.NET
De volgende lijst maakt een lijst van de controles die deel van deze toepassing ASP.NET uitmaken.
De toepassingslogica die deel van de toepassing ASP.NET uitmaakt moet dynamisch tot een gegevensbron van XML leiden om tot over te gaan FirstAppSolution/PreLoanProcess
proces. De waarden die de aanvrager op de pagina HTML heeft ingevoerd, moeten in de XML-gegevensbron worden opgegeven. Deze gegevenswaarden worden in het formulier samengevoegd wanneer het formulier wordt weergegeven in Workspace. De klassen in het dialoogvenster System.Xml
naamruimte worden gebruikt om de XML-gegevensbron te maken.
Wanneer het aanhalen van een proces dat de gegevens van XML van een toepassing ASP.NET vereist, is een gegevenstype van XML beschikbaar voor u aan gebruik. Dat wil zeggen dat u geen System.Xml.XmlDocument
toe aan het proces. De volledig gekwalificeerde naam van deze XML-instantie die aan het proces moet worden doorgegeven, is InvokePreLoanProcess.PreLoanProcess.XML
. Zet de System.Xml.XmlDocument
instantie aan InvokePreLoanProcess.PreLoanProcess.XML
. U kunt deze taak uitvoeren door de volgende code te gebruiken.
//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();
Als u een ASP-pagina wilt maken die het FirstAppSolution/PreLoanProcess
de volgende taken uitvoeren in de Button1_Click
methode:
-
Een
FirstAppSolution_PreLoanProcessClient
object met de standaardconstructor. -
Een
FirstAppSolution_PreLoanProcessClient.Endpoint.Address
object gebruikenSystem.ServiceModel.EndpointAddress
constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service en het coderingstype:https://hiro-xp:8080/soap/services/FirstAppSolution/PreLoanProcess?blob=mtom
U hoeft de
lc_version
kenmerk. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Zorg er echter voor dat u?blob=mtom
.NOTE
Vervangenhiro-xp
* met het IP-adres van de J2EE-toepassingsserver die als host fungeert voor AEM Forms. * -
Een
System.ServiceModel.BasicHttpBinding
object door de waarde van het object op te halenFirstAppSolution_PreLoanProcessClient.Endpoint.Binding
lid. De geretourneerde waarde omzetten inBasicHttpBinding
. -
Stel de
System.ServiceModel.BasicHttpBinding
objectMessageEncoding
lid van de gegevens aanWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van de AEM aan het gegevenslid toe
FirstAppSolution_PreLoanProcessClient.ClientCredentials.UserName.UserName
. - Wijs de overeenkomstige wachtwoordwaarde aan het gegevenslid toe
FirstAppSolution_PreLoanProcessClient.ClientCredentials.UserName.Password
. - De constante waarde toewijzen
HttpClientCredentialType.Basic
aan het gegevenslidBasicHttpBindingSecurity.Transport.ClientCredentialType
. - De constante waarde toewijzen
BasicHttpSecurityMode.TransportCredentialOnly
aan het gegevenslidBasicHttpBindingSecurity.Security.Mode
.
In het volgende codevoorbeeld worden deze taken getoond.
//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;
- Wijs de gebruikersnaam van de AEM aan het gegevenslid toe
-
Haal de naam, de telefoon, en de bedragen op die de gebruiker in de Web-pagina inging. Gebruik deze waarden om dynamisch een XML-gegevensbron te maken die naar de
FirstAppSolution/PreLoanProcess
proces. EenSystem.Xml.XmlDocument
die de XML-gegevensbron vertegenwoordigt die aan het proces moet worden doorgegeven (deze toepassingslogica wordt in het volgende codevoorbeeld weergegeven). -
Zet de
System.Xml.XmlDocument
instantie aanInvokePreLoanProcess.PreLoanProcess.XML
(Deze toepassingslogica wordt getoond in het volgende codevoorbeeld). -
De
FirstAppSolution/PreLoanProcess
proces door hetFirstAppSolution_PreLoanProcessClient
objectinvoke_Async
methode. Deze methode retourneert een tekenreekswaarde die de aanroepende-id-waarde van het langlevende proces vertegenwoordigt. -
Een
JobManagerClient
door te gebruiken is constructor. (Controleer of u een serviceverwijzing hebt ingesteld naar de service Taakbeheer.) -
Herhaal stap 1-5. Geef de volgende URL op voor stap 2:
https://hiro-xp:8080/soap/services/JobManager?blob=mtom
. -
Een
JobId
object met behulp van de constructor. -
Stel de
JobId
objectid
gegevenslid met de geretourneerde waarde van deFirstAppSolution_PreLoanProcessClient
objectinvoke_Async
methode. -
Wijs het
value
waar voor deJobId
objectpersistent
lid. -
Een
JobStatus
door het object aan te roepenJobManagerService
objectgetStatus
en het doorgeven van deJobId
object. -
Haal de statuswaarde op door de waarde van de
JobStatus
objectstatusCode
lid. -
Wijs de waarde van de oproepings-id toe aan de
LabelJobID.Text
veld. -
Wijs de statuswaarde toe aan de
LabelStatus.Text
veld.
Snel starten: Een langdurig proces aanroepen met de webservice-API
Het volgende C# codevoorbeeld roept het FirstAppSolution/PreLoanProcess
proces.
???/**
* 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 "";
}
}
}
De toepassing ASP.NET uitvoeren
Nadat u uw toepassing ASP.NET compileert en opstelt, kunt u het uitvoeren gebruikend Webbrowser. Het veronderstellen van de naam van het project ASP.NET is InvokePreLoanProcess geeft u de volgende URL op in een webbrowser:
*http://localhost:1629/InvokePreLoanProcess/*Default.aspx
waarbij localhost de naam is van de webserver die als host fungeert voor het ASP.NET-project en 1629 het poortnummer. Wanneer u compileert en uw toepassing ASP.NET bouwt, stelt Microsoft Visual Studio automatisch het op.
Een clienttoepassing maken die is gebouwd met Flex en die een menselijk-centrisch proces van lange duur aanroept
U kunt een clienttoepassing maken die met Flex is gebouwd om het FirstAppSolution/PreLoanProcess proces. Deze toepassing gebruikt Remoting om het FirstAppSolution/PreLoanProcess proces. (Zie AEM Forms aanroepen met (Vervangen voor AEM formulieren) AEM Forms Remoting.)
In de volgende afbeelding ziet u een clienttoepassing die is gebouwd met Flex en die gegevens van een eindgebruiker verzamelt. De gegevens worden in een XML-gegevensbron geplaatst en naar het proces verzonden.
Nadat het proces is aangeroepen, wordt een waarde voor de aanroepings-id weergegeven. Een waarde voor de oproepings-id wordt gemaakt als onderdeel van een record die de status van het proces met een lange levensduur bijhoudt.
De clienttoepassing die met Flex is gebouwd, voert de volgende taken uit:
- Haalt de waarden op die de gebruiker op de webpagina heeft ingevoerd.
- Hiermee wordt dynamisch een XML-gegevensbron gemaakt die wordt doorgegeven aan de FirstAppSolution/PreLoanProcess proces. De drie waarden worden opgegeven in de XML-gegevensbron.
- Roept de FirstAppSolution/PreLoanProcess verwerken met Remoting.
- Retourneert de aanroepings-id-waarde van het langlevende proces.
Overzicht van de stappen
Voer de volgende stappen uit om een clienttoepassing te maken die met Flex is gebouwd en het proces FirstAppSolution/PreLoanProcess kan aanroepen:
-
Start een nieuw Flex-project.
-
Neem het bestand adobe-remoting-provider.swc op in het klassenpad van uw project. (Zie Het AEM Forms Flex-bibliotheekbestand opnemen.)
-
Een
mx:RemoteObject
via ActionScript of MXML. (Zie Een mx:RemoteObject-instantie maken) -
Een
ChannelSet
-instantie om te communiceren met AEM Forms en deze te koppelen aan demx:RemoteObject
-instantie. (Zie Een kanaal naar AEM Forms maken.) -
De ChannelSet aanroepen
login
methode of desetCredentials
methode om de waarde en het wachtwoord van de gebruikersidentificatie op te geven. (Zie Single Sign-On gebruiken.) -
Maak de XML-gegevensbron die aan de
FirstAppSolution/PreLoanProcess
door een XML-instantie te maken. (Deze toepassingslogica wordt getoond in het volgende codevoorbeeld.) -
Maak een object van het type Object met behulp van de constructor. Wijs XML aan het voorwerp toe door de naam van de de inputparameter van het proces, zoals aangetoond in de volgende code te specificeren:
//Get the XML data to pass to the AEM Forms process var xml:XML = createXML(); var params:Object = new Object(); params["formData"]=xml;
-
De
FirstAppSolution/PreLoanProcess
proces door demx:RemoteObject
vaninvoke_Async
methode. Geef deObject
die de invoerparameter bevat. (Zie Invoerwaarden doorgeven.) -
Haal de aanroepings-identificatiewaarde op die door een langdurig proces wordt geretourneerd, zoals in de volgende code wordt getoond:
// 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; }
Een langdurig proces aanroepen met Verwijderen
In het volgende Flex-codevoorbeeld wordt het FirstAppSolution/PreLoanProcess
proces.
<?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>