Grundlagen zu AEM Forms-Prozessen understanding-aem-forms-processes
Die Beispiele in diesem Dokument gelten nur für eine AEM Forms on JEE-Umgebung.
Ein gängiges Anwendungsbeispiel besteht darin, dass eine Reihe von AEM Forms-Services mit einem einzigen Dokument arbeiten kann. Sie können eine Anfrage an den Service-Container senden, indem Sie einen Prozess mithilfe von Workbench erstellen. Ein Workflow stellt einen Geschäftsprozess dar, den Sie automatisieren. Informationen zum Erstellen von Prozessen finden Sie unter Verwenden von Workbench.
Sobald ein Prozess aktiviert wird, wird er zu einem Service und kann wie andere Services aufgerufen werden. Ein Unterschied zwischen einem Standard-Service, wie dem Verschlüsselungs-Service, und einem Service, der aus einem Prozess entstanden ist, besteht darin, dass letzterer einen Vorgang hat, die viele Aktionen ausführt. Ein Standard-Service weist dagegen viele Vorgänge auf. Jeder Vorgang führt in der Regel nur eine Aktion durch, z. B. das Anwenden einer Richtlinie auf ein Dokument oder das Verschlüsseln eines Dokuments.
Prozesse können kurzlebig oder langlebig sein. Ein kurzlebiger Prozess ist ein Vorgang, der synchron und in demselben Ausführungs-Thread ausgeführt wird, von dem aus er aufgerufen wurde. Kurzlebige Vorgänge sind mit dem Standardverhalten in den meisten Programmiersprachen vergleichbar, bei dem ein Client-Programm eine Methode aufruft und auf einen Rückgabewert wartet.
Es gibt jedoch Situationen, in denen ein Prozess aufgrund von Faktoren wie den folgenden nicht synchron abgeschlossen werden kann:
-
Ein Prozess kann eine erhebliche Zeitspanne umfassen.
-
Ein Prozess kann organisatorische Grenzen überschreiten.
-
Zur Beendigung eines Prozesses ist eine externe Eingabe erforderlich. Angenommen, ein Formular wird an einen Manager gesendet, der nicht im Büro ist. In diesem Fall ist der Prozess erst abgeschlossen, wenn der Manager das Formular zurückgibt und ausfüllt.
Diese Arten von Prozessen werden als langlebige Prozesse bezeichnet. Ein langlebiger Prozess wird asynchron ausgeführt, sodass Systeme so interagieren können, wie es die Ressourcen zulassen, und das Tracking und die Überwachung des Vorgangs ermöglicht wird. Wenn ein langlebiger Prozess aufgerufen wird, erstellt AEM Forms einen Aufrufkennungswert als Teil eines Datensatzes, der den langlebigen Prozessstatus verfolgt. Der Datensatz wird in der AEM Forms-Datenbank gespeichert. Sie können langlebige Prozesseinträge löschen, wenn sie nicht mehr benötigt werden.
Mithilfe des Werts für die Aufrufkennung können Sie den Status des langlebigen Prozesses verfolgen. Sie können zum Beispiel den Wert der Prozessaufrufskennung verwenden, um Vorgänge in Process Manager durchzuführen, z. B. um eine laufende Prozessinstanz zu beenden.
Beispiel für einen kurzlebigen Prozess
Die folgende Abbildung zeigt ein Beispiel für einen kurzlebigen Prozess mit dem Namen MyApplication/EncryptDocument.
MyApplication/EncryptDocument. (Siehe Verwenden von Workbench.)Wenn dieser kurzlebige Prozess aufgerufen wird, führt er die folgenden Aktionen durch:
-
Ruft das ungesicherte PDF-Dokument ab, das als Eingabewert an den Prozess übergeben wird.
-
Sie verschlüsselt das PDF-Dokument mit einem Kennwort. Der Name des Eingabeparameters für diesen Prozess lautet
inDoc, und der Datentyp ist „document“. -
Speichert das kennwortverschlüsselte PDF-Dokument als PDF-Datei im lokalen Dateisystem. Dieser Prozess gibt das verschlüsselte PDF-Dokument als Ausgabewert zurück. Der Name des Ausgabeparameters für diesen Prozess lautet
outDoc, und der Datentyp ist „document“.Dieser Prozess wird synchron im selben Ausführungs-Thread abgeschlossen, von dem aus er aufgerufen wurde. Der Name dieses kurzlebigen Prozesses lautet
MyApplication/EncryptDocument, und sein Vorgang istinvoke.note note NOTE In der Regel besteht ein kurzlebiger Prozess aus mehr als drei Aktionen. Sie erstellen einen Prozess mithilfe von Workbench. (Siehe Verwenden von Workbench.) Unter Programmieren mit AEM Forms werden die folgenden Methoden beschrieben, mit denen Sie diesen kurzlebigen Prozess programmgesteuert aufrufen können:
- Aufrufen eines kurzlebigen Prozesses durch Übergeben eines unsicheren Dokuments mithilfe von AEM Forms Remoting (Verwenden eines Flex-Programms)
- Aufrufen eines kurzlebigen Prozesses mithilfe der Aufruf-API (Java™ Invocation API)
- Aufrufen von AEM Forms mithilfe der Base64-Codierung (Beispiel für einen Webservice)
- Aufrufen von AEM Forms mithilfe von MTOM (Beispiel für einen Webservice)
- Aufrufen von AEM Forms mithilfe von SwaRef (Beispiel für einen Webservice)
- Aufrufen von AEM Forms mithilfe von BLOB-Daten über HTTP (Beispiel für einen Webservice)
- Aufrufen von AEM Forms mithilfe von DIME (Beispiel für einen Webservice)
- Aufrufen des Prozesses MyApplication/EncryptDocument mithilfe von REST
Beispiel für einen langlebigen Prozess
Die folgende Abbildung zeigt ein Beispiel für einen langlebigen Prozess.
Dieser Prozess wird aufgerufen, wenn ein Antragsteller ein Darlehensformular einreicht. Das Verfahren ist erst abgeschlossen, wenn ein Kreditsachbearbeiter den Kreditantrag genehmigt oder ablehnt. Der Name dieses langlebigen Prozesses lautet FirstAppSolution/PreLoanProcess, und sein Vorgang ist invoke_Async. Dieser Prozess muss asynchron aufgerufen werden. Informationen zum programmgesteuerten Aufrufen dieses langlaufenden Prozesses finden Sie unter Aufrufen von an Menschen orientierten langlaufenden Prozessen.