Dienst-Container

Die Beispiele in diesem Dokument gelten nur für eine AEM Forms on JEE-Umgebung.

AEM Forms-Services, die sich im Service-Container befinden (einschließlich Standard-Services wie dem Verschlüsselungs-Service, langlebigen und kurzlebigen Prozessen), können mit verschiedenen Providern, wie z. B. einem EJB-Provider, aufgerufen werden. Ein EJB-Anbieter ermöglicht den Aufruf von AEM Forms-Services über RMI/IIOP. Ein Webservice-Anbieter stellt Services als Web-Services (WSDL-Generierung) unter Verwendung von Standards wie SOAP/HTTP und SOAP/JMS bereit.

In der folgenden Tabelle werden die verschiedenen Methoden zum programmgesteuerten Aufrufen von AEM Forms-Services beschrieben.

Aufrufmethode

Beschreibung

Remote-Integration

Die Remote-Integration bietet Flex-Clients die Möglichkeit, Service-Vorgänge aufzurufen. (Siehe Aufrufen von AEM Forms mithilfe von AEM Forms Remoting (für AEM-Formulare nicht mehr unterstützt).)

Java-API

Eine Java-API kann einen AEM Forms-Service aufrufen. Die Java-API ist in Client-Bibliotheken und die Java-Aufruf-API unterteilt. (Siehe Aufrufen von AEM Forms mithilfe der Java-API.)

Web-Services

AEM Forms unterstützt Webservice-Standards wie SOAP/HTTP. Ein Service kann als Webservice verfügbar gemacht werden, wobei die WSDL den vom W3C definierten Webservice-Standards entspricht.

Ein Service kann von jedem Webservice-Stapel aus aufgerufen werden, einschließlich .NET Framework und Sun™ Web Services SDK. (Siehe Aufrufen von AEM Forms mithilfe von Web-Services.)

REST-Anfragen

AEM Forms unterstützt REST-Anfragen. Ein Service kann direkt von einer HTML-Seite aus aufgerufen werden. (Siehe Aufrufen von AEM Forms mithilfe von REST-Anfragen.)

Die folgende Abbildung zeigt die verschiedenen Möglichkeiten, wie AEM Forms-Services programmgesteuert aufgerufen werden können.

HINWEIS

Sie können das AEM Forms-SDK nicht nur zum Erstellen von Client-Programmen verwenden, die AEM Forms-Services aufrufen können, sondern auch zum Erstellen von Komponenten, die im Service-Container bereitgestellt werden können. Sie können beispielsweise eine Bankkomponente erstellen, die benutzerdefinierte Datentypen enthält, die in Prozessen verwendet werden können. Das heißt, Sie können einen Datentyp wie com.adobe.idp.BankAccount erstellen. Anschließend können Sie com.adobe.idp.BankAccount-Instanzen in Ihren Client-Programmen erstellen.

Der Service-Container bietet die folgenden Funktionen:

  • 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 einem Client-Programm (oder einem anderen Service) an einen Service gesendet, der sich im Service-Container befindet. 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.

Siehe auch

Grundlagen zu AEM Forms-Prozessen

Aufrufen von AEM Forms mithilfe von AEM Forms Remoting (für AEM Forms nicht mehr unterstützt)

AEM Forms mit der JavaAPI aufrufen

AEM Forms mit Web Services aufrufen

An Menschen orientierte langlebige Prozesse aufrufen

Aufrufen von AEM Forms mithilfe von REST-Anforderungen

Auf dieser Seite