Dienst-Container service-container

Ermöglicht den Aufruf von AEM Forms-Services mit verschiedenen Methoden. Sie können einen Service konfigurieren, indem Sie Endpunkte festlegen, damit er mit allen Methoden aufgerufen werden kann: Remoting, die Java-API, Web-Services und REST. (Siehe Programmgesteuertes Verwalten von Endpunkten.)

Konvertiert eine Nachricht in ein normalisiertes Format, das als Aufrufanfrage bezeichnet wird. Eine Aufrufanfrage wird von einer Client-Anwendung (oder einem anderen Dienst) an einen Dienst im Dienst-Container gesendet. Eine Aufrufanfrage enthält Informationen wie den Namen des aufzurufenden Services und Datenwerte, die zur Durchführung des Vorgangs erforderlich sind. Viele Services benötigen ein Dokument, um einen Vorgang auszuführen. Daher enthält eine Aufrufanfrage normalerweise ein Dokument, bei dem es sich um PDF-Daten, XDP-Daten, XML-Daten usw. handeln kann.

Sendet Aufrufanfragen an entsprechende Services (der Name des aufzurufenden Services ist Teil der Aufrufanfrage).

Führt Aufgaben durch wie die Bestimmung, ob der Aufrufer berechtigt ist, den angegebenen Service-Vorgang aufzurufen. Die Aufrufanfrage muss einen gültigen Benutzernamen und ein gültiges Kennwort für AEM Forms enthalten.

Es gibt verschiedene Möglichkeiten, eine Aufrufanfrage an einen Service zu senden. Außerdem gibt es verschiedene Möglichkeiten, erforderliche Eingabewerte an den Service zu senden. Angenommen, Sie verwenden die Java-API zum Aufrufen eines Services, für den ein PDF-Dokument erforderlich ist. Die entsprechende Java-Methode enthält einen Parameter, der ein PDF-Dokument akzeptiert. In diesem Fall lautet der Datentyp des Parameters com.adobe.idp.Document. (Siehe Übergeben von Daten an AEM Forms-Services mithilfe der Java-API.)

Wenn Sie einen Service mithilfe von überwachten Ordnern aufrufen, wird eine Aufrufanfrage gesendet, sobald Sie eine Datei in einem konfigurierten überwachten Ordner platzieren. Wenn Sie einen Service per E-Mail aufrufen, wird eine Aufrufanfrage an einen Service gesendet, sobald eine E-Mail-Nachricht in einem konfigurierten Posteingang eingeht.

Der Service-Container sendet nach Durchführung des Vorgangs eine Aufrufantwort zurück. Eine Aufrufantwort enthält Informationen wie die Vorgangsergebnisse. Wenn der Vorgang beispielsweise ein PDF-Dokument ändert, enthält die Aufrufantwort das geänderte PDF-Dokument. Wenn der Vorgang nicht erfolgreich war, enthält die Aufrufantwort eine Fehlermeldung.

Eine Aufrufantwort kann auf dieselbe Weise abgerufen werden wie eine Aufrufanfrage. Das heißt, wenn die Aufrufanfrage mit der Java-API gesendet wird, kann mit der Java-API eine Aufrufantwort abgerufen werden. Angenommen, ein Vorgang ändert ein PDF-Dokument. Sie können das geänderte PDF-Dokument abrufen, indem Sie den Rückgabewert der Java-Methode abrufen, die den Service aufgerufen hat.

Wenn ein langlebiger Prozess aufgerufen wird, enthält eine Aufrufantwort einen Kennungswert, der mit der Aufrufanfrage verknüpft ist. Mithilfe dieses Kennungswerts können Sie den Status des Prozesses zu einem späteren Zeitpunkt überprüfen. Nehmen wir zum Beispiel den langlebigen Service MortgageLoan. Mithilfe des Kennungswerts können Sie überprüfen, ob der Prozess erfolgreich abgeschlossen wurde. (Siehe An Menschen orientierte langlebige Prozesse aufrufen.)

Das folgende Diagramm zeigt ein Client-Programm (das die Java-API verwendet), das einen Service aufruft.

Wenn ein Client-Programm einen Service aufruft, treten drei Ereignisse auf:

1. Ein Client-Programm sendet eine Aufrufanfrage an einen Service.
2. Der Service führt den in der Aufrufanfrage angegebenen Vorgang aus.
3. Der Service-Container gibt eine Aufrufantwort an das Client-Programm zurück.