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.

Inroeping, methode

Beschrijving

Externe integratie

Externe integratie biedt Flex-clients de mogelijkheid om servicebewerkingen aan te roepen. (Zie AEM Forms aanroepen met (Vervangen voor AEM formulieren) AEM Forms Remoting.)

Java API

Een Java API kan een AEM Forms-service oproepen. De Java API is geordend in clientbibliotheken en de Java Invocation-API. (Zie AEM Forms aanroepen met de Java API.)

Webservices

AEM Forms ondersteunt webservicenormen zoals SOAP/HTTP. Een service kan worden aangeboden als een webservice, waarbij de WSDL voldoet aan de webservicenormen die zijn gedefinieerd door W3C.

De dienst kan van om het even welke Web de dienststapel, met inbegrip van het .NET Kader en Sun™ de Diensten SDK van het Web worden aangehaald. (Zie AEM Forms aanroepen met behulp van webservices.)

REST-verzoeken

AEM Forms ondersteunt REST-aanvragen. Een service kan rechtstreeks vanuit een HTML-pagina worden aangeroepen. (Zie AEM Forms aanroepen met REST-verzoeken.)

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

OPMERKING

Naast het gebruiken van SDK van AEM Forms om cliënttoepassingen tot stand te brengen die de diensten van AEM Forms kunnen aanhalen, kunt u componenten ook tot stand brengen die aan de de dienstcontainer kunnen worden opgesteld. U kunt bijvoorbeeld een bankcomponent maken die aangepaste gegevenstypen bevat die in processen kunnen worden gebruikt. U kunt dus een gegevenstype maken, zoals com.adobe.idp.BankAccount. Vervolgens kunt u com.adobe.idp.BankAccount-instanties maken in uw clienttoepassingen.

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 bijbehorende 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 het oproepingsantwoord 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 PDF-document ophalen door de geretourneerde waarde op te halen van de Java-methode die de service heeft aangeroepen.

    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 Langdurige processen aanroepen vanuit menselijk-centraal systeem.)

    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

Op deze pagina