Tjänstbehållare service-container

Tillåter att AEM Forms tjänster anropas med olika metoder. Du kan konfigurera en tjänst genom att ange slutpunkter så att den kan anropas med alla metoder: Remoting, Java API, web services och REST. (Se Programmatisk hantering av slutpunkter.)

Konverterar ett meddelande till ett normaliserat format som kallas för en anropsbegäran. En anropsbegäran skickas från ett klientprogram (eller en annan tjänst) till en tjänst i tjänstbehållaren. En anropsbegäran innehåller information som namnet på tjänsten som ska anropas och datavärden som krävs för att utföra åtgärden. Många tjänster kräver ett dokument för att utföra en åtgärd. Därför innehåller en anropsbegäran vanligtvis ett dokument, som kan vara PDF data, XDP-data, XML-data osv.

Slussar anropsbegäranden till lämpliga tjänster (namnet på tjänsten som ska anropas är en del av anropsbegäran).

Utför uppgifter som att avgöra om anroparen har behörighet att anropa den angivna tjänståtgärden. Anropsbegäran måste innehålla ett giltigt användarnamn och lösenord för AEM.

Det finns olika sätt att skicka en anropsbegäran till en tjänst. Det finns också olika sätt att skicka obligatoriska indatavärden till tjänsten. Anta till exempel att du använder Java API för att anropa en tjänst som kräver ett PDF-dokument. Motsvarande Java-metod innehåller en parameter som godkänner ett PDF-dokument. I det här fallet är parameterns datatyp com.adobe.idp.Document. (Se Skicka data till AEM Forms-tjänster med Java API.)

Om du anropar en tjänst med bevakade mappar skickas en anropsbegäran när du monterar en fil i en konfigurerad bevakad mapp. Om du anropar en tjänst via e-post skickas en anropsbegäran till en tjänst när ett e-postmeddelande tas emot i en konfigurerad inkorg.

Tjänstbehållaren skickar tillbaka ett anropssvar när åtgärden har utförts. Ett anropssvar innehåller information om till exempel åtgärdsresultaten. Om åtgärden till exempel ändrar ett PDF-dokument innehåller anropssvaret det ändrade PDF-dokumentet. Om åtgärden misslyckades innehåller anropssvaret ett felmeddelande.

Ett anropssvar kan hämtas på samma sätt som en anropsbegäran skickas. Det innebär att om anropsbegäran skickas med Java API kan ett anropssvar hämtas med Java API. Anta till exempel att en åtgärd ändrar ett PDF-dokument. Du kan hämta det ändrade PDF-dokumentet genom att hämta returvärdet för Java-metoden som anropade tjänsten.

När en långvarig process anropas innehåller ett anropssvar ett identifierarvärde som är associerat med anropsbegäran. Med det här identifierarvärdet kan du kontrollera processens status vid ett senare tillfälle. Tänk dig till exempel den långa tjänsten MortgageLoan. Med hjälp av identifierarvärdet kan du kontrollera om processen har slutförts. (Se Anropar humancentrerade, långlivade processer.)

I följande diagram visas ett klientprogram (som använder Java API) som anropar en tjänst.

När ett klientprogram anropar en tjänst inträffar tre händelser:

1. Ett klientprogram skickar en anropsbegäran till en tjänst.
2. Tjänsten utför den åtgärd som anges i anropsbegäran.
3. Tjänstbehållaren returnerar ett anropssvar till klientprogrammet.