Informazioni sui processi AEM Forms understanding-aem-forms-processes
Un caso d’uso comune è quello di un set di servizi AEM Forms che operano su un singolo documento. Puoi inviare una richiesta al contenitore del servizio creando un processo utilizzando Workbench. Un processo rappresenta un processo aziendale automatizzato. Per informazioni sulla creazione dei processi, consulta Utilizzo di Workbench.
Quando un processo viene attivato, diventa un servizio e può essere richiamato come altri servizi. Una differenza tra un servizio standard, ad esempio il servizio di cifratura e un servizio originato da un processo, è che quest'ultimo dispone di un'operazione che esegue molte azioni. Al contrario, un servizio standard ha molte operazioni. In genere, ogni operazione esegue una sola azione, ad esempio l'applicazione di un criterio a un documento o la cifratura di un documento.
I processi possono essere di breve durata o di lunga durata. Un processo di breve durata è un’operazione eseguita in modo sincrono e sullo stesso thread di esecuzione da cui è stata richiamata. Le operazioni di breve durata sono paragonabili al comportamento standard rilevato nella maggior parte dei linguaggi di programmazione, in cui un'applicazione client chiama un metodo e attende un valore di ritorno.
Tuttavia, in alcune situazioni un processo non può essere completato in modo sincrono a causa di fattori come questi:
-
Un processo può avere un periodo di tempo significativo.
-
Un processo può superare i limiti organizzativi.
-
Per completare un processo, è necessario un input esterno. Ad esempio, si consideri una situazione in cui un modulo viene inviato a un responsabile che non è in ufficio. In questa situazione, il processo non viene completato finché il responsabile non restituisce e compila il modulo.
Questi tipi di processi sono noti come processi longevi. Un processo di lunga durata viene eseguito in modo asincrono, consentendo ai sistemi di interagire come le risorse lo consentono e consentendo il tracciamento e il monitoraggio dell'operazione. Quando si richiama un processo di lunga durata, AEM Forms crea un valore di identificatore di chiamata come parte di un record che tiene traccia dello stato del processo di lunga durata. Il record viene memorizzato nel database AEM Forms. È possibile eliminare i record di processo di lunga durata quando non sono più necessari.
Utilizzando il valore dell'identificatore di chiamata, puoi tenere traccia dello stato del processo di lunga durata. Ad esempio, è possibile utilizzare il valore dell'identificatore di chiamata del processo per eseguire operazioni di Process Manager, ad esempio la terminazione di un'istanza di processo in esecuzione.
Esempio di processo a breve termine
L’illustrazione seguente è un esempio di processo di breve durata denominato MyApplication/EncryptDocument.
MyApplication/EncryptDocument
utilizzo di Workbench. (Vedi Utilizzo di Workbench.)Quando si richiama questo processo di breve durata, vengono eseguite le azioni seguenti:
-
Ottiene il documento PDF non protetto passato al processo come valore di input.
-
Cifra il documento PDF con una password. Il nome del parametro di input per questo processo è
inDoc
e il tipo di dati è document. -
Salva il documento PDF crittografato con password come file PDF nel file system locale. Questo processo restituisce il documento PDF crittografato come valore di output. Il nome del parametro di output per questo processo è
outDoc
e il tipo di dati è document.Questo processo viene completato in modo sincrono sullo stesso thread di esecuzione da cui è stato richiamato. Il nome di questo processo di breve durata è
MyApplication/EncryptDocument
e il suo funzionamentoinvoke
.note note NOTE In genere, un processo di breve durata consiste in più di tre azioni. È possibile creare un processo utilizzando Workbench. (Vedi Utilizzo di Workbench.) Programmazione con moduli AEM descrive i seguenti modi in cui è possibile richiamare questo processo di breve durata a livello di programmazione:
- Richiamare un processo di breve durata passando un documento non sicuro utilizzando AEM Forms Remoting (Utilizzo di un'applicazione Flex)
- Richiamare un processo di breve durata utilizzando l’API di richiamo (API Java Invocation)
- Richiamo di AEM Forms con codifica Base64 (esempio di servizio Web)
- Richiamo di AEM Forms tramite MTOM (esempio di servizio Web)
- Richiamo di AEM Forms tramite SwaRef (esempio di servizio Web)
- Richiamo di dati AEM Forms tramite BLOB su HTTP (esempio di servizio Web)
- Richiamo di AEM Forms tramite DIME (esempio di servizio Web)
- Richiamo del processo MyApplication/EncryptDocument tramite REST
Esempio di processo a lungo termine
L'illustrazione seguente è un esempio di processo di lunga durata.
Questo processo viene invocato quando un richiedente presenta un modulo di prestito. Il processo non è completo finché un funzionario responsabile del prestito non approva o rifiuta la richiesta di prestito. Il nome di questo processo di lunga durata è* FirstAppSolution/PreLoanProcess *e il suo funzionamento è invoke_Async
. Questo processo deve essere richiamato in modo asincrono. Per informazioni su come richiamare questo processo a lungo termine a livello di programmazione, vedi Richiamo dei processi a lunga durata incentrati sull'uomo.