Servicecontainer

De diensten van AEM Forms die in de de dienstcontainer worden gevestigd (met inbegrip van standaarddiensten zoals de encryptiedienst, langlevende, en kortstondige processen) kunnen worden aangehaald gebruikend diverse leveranciers, zoals een leverancier EJB. Met een EJB-provider kunnen AEM Forms-services worden aangeroepen via RMI/IIOP. Een webserviceprovider stelt services beschikbaar als webservices (WSDL Generation) met standaarden zoals SOAP/HTTP en SOAP/JMS.

De volgende lijst beschrijft de verschillende manieren waarin u de diensten van AEM Forms programmatically kunt aanhalen.

De volgende illustratie biedt een visuele weergave van de verschillende manieren waarop AEM Forms-services via programmacode kunnen worden aangeroepen.

De servicecontainer biedt de volgende functionaliteit:

• Hiermee kunnen AEM Forms-services met verschillende methoden worden aangeroepen. U kunt de dienst vormen door eindpunten te plaatsen zodat het kan worden aangehaald gebruikend alle methodes: Verwijderen, de Java API, webservices en REST. (Zie Programmaticaal het leiden Eindpunten.)

• Converteert een bericht naar een genormaliseerde indeling die een aanroepingsverzoek wordt genoemd. Een aanroepingsverzoek wordt verzonden van een cliënttoepassing (of een andere dienst) naar de dienst die in de de dienstcontainer wordt gevestigd. Een aanroepingsverzoek bevat informatie zoals de naam van de dienst om aan te halen en gegevenswaarden die worden vereist om de verrichting uit te voeren. Vele diensten vereisen een document om een verrichting uit te voeren. Daarom bevat een aanroepingsverzoek gewoonlijk een document, dat PDF-gegevens, XDP-gegevens, XML-gegevens enzovoort kan zijn.

• Routes oproepend verzoeken aan de aangewezen diensten (de naam van de dienst om te roepen maakt deel uit van het oproepingsverzoek).

• Voert taken zoals het bepalen uit of de bezoeker toestemming heeft om de gespecificeerde de dienstverrichting aan te halen. De aanroepingsaanvraag moet een geldige gebruikersnaam en wachtwoord voor AEM formulieren bevatten.

  Er zijn verschillende manieren om een aanroepingsverzoek naar de dienst te verzenden. Er zijn ook verschillende manieren om de vereiste invoerwaarden naar de service te verzenden. Stel dat u de Java API gebruikt om een service aan te roepen waarvoor een PDF-document nodig is. De overeenkomstige Java-methode bevat een parameter die een PDF-document accepteert. In deze situatie is het gegevenstype van de parameter com.adobe.idp.Document. (Zie Gegevens doorgeven aan AEM Forms-services met de Java API.)

  Als u een service aanroept met gecontroleerde mappen, wordt een aanroepingsverzoek verzonden wanneer u een bestand in een geconfigureerde controlemap plaatst. Als u de dienst gebruikend e-mail aanhaalt, dan wordt een aanroepingsverzoek verzonden naar de dienst wanneer een e-mailbericht in gevormd inbox aankomt.

  De de dienstcontainer verzendt een aanroepingsreactie terug zodra de verrichting wordt uitgevoerd. Een aanroepingsreactie bevat informatie zoals de bewerkingsresultaten. Als de bewerking bijvoorbeeld een PDF-document wijzigt, bevat de aanroepingsreactie het gewijzigde PDF-document. Als de bewerking is mislukt, bevat de aanroepingsreactie een foutbericht.

  Een aanroepingsreactie kan op dezelfde manier worden opgehaald als een aanroepingsverzoek. Als de oproepaanvraag wordt verzonden met de Java API, kan een oproepingsreactie worden opgehaald met de Java API. Stel bijvoorbeeld dat een bewerking een PDF-document wijzigt. U kunt het gewijzigde document van de PDF terugwinnen door de terugkeerwaarde van de methode van Java te krijgen die de dienst aanhaalde.

  Wanneer een langdurig proces wordt aangeroepen, bevat een aanroepingsreactie een waarde voor de id die aan de aanroepingsaanvraag is gekoppeld. Met deze id-waarde kunt u de status van het proces op een later tijdstip controleren. Neem bijvoorbeeld de service MortgaugeLoan voor lange tijd. Met de id-waarde kunt u controleren of het proces is voltooid. (Zie Het aanhalen van mens-Centric langlevende Processen.)

  In het volgende diagram ziet u een clienttoepassing (die de Java API gebruikt) die een service aanroept.

  Wanneer een cliënttoepassing de dienst aanhaalt, komen drie gebeurtenissen voor:

  1. Een cliënttoepassing verzendt een aanroepingsverzoek naar de dienst.
  2. De service voert de bewerking uit die in de aanroepingsaanvraag is opgegeven.
  3. De servicecontainer retourneert een aanroepingsreactie op de clienttoepassing.

Zie ook

AEM Forms-processen begrijpen

AEM Forms aanroepen met (Vervangen voor AEM formulieren) AEM Forms Remoting

AEM Forms aanroepen met de Java API

AEM Forms aanroepen met webservices

Het aanhalen van mens-Centric langlevende Processen

AEM Forms aanroepen met REST-verzoeken