Informazioni sui processi di AEM Forms understanding-aem-forms-processes
Gli esempi e gli esempi contenuti in questo documento sono solo per AEM Forms in ambiente JEE.
Un caso d’uso comune prevede che un set di servizi AEM Forms funzioni su un singolo documento. Puoi inviare una richiesta al contenitore del servizio creando un processo utilizzando Workbench. Un processo rappresenta un processo aziendale che si sta automatizzando. Per informazioni sulla creazione di processi, vedere Utilizzo di Workbench.
Una volta attivato, il processo diventa un servizio e può essere richiamato come altri servizi. Una differenza tra un servizio standard, ad esempio Crittografia, e un servizio che ha avuto origine da un processo, è che quest'ultimo ha un'operazione che esegue molte azioni. Al contrario, un servizio standard ha molte operazioni. Ogni operazione in genere esegue un'azione, ad esempio l'applicazione di una policy a un documento o la crittografia 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 è stato richiamato. 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 restituito.
Tuttavia, in alcune situazioni un processo non può essere completato in modo sincrono a causa di fattori quali:
-
Un processo può richiedere molto tempo.
-
Un processo può estendersi oltre i confini dell’organizzazione.
-
Per completare un processo è necessario un input esterno. Si consideri ad esempio una situazione in cui un modulo viene inviato a un manager fuori sede. In questa situazione, il processo non viene completato fino a quando il manager non restituisce e compila il modulo.
Questi tipi di processi sono noti come processi di lunga durata. Un processo di lunga durata viene eseguito in modo asincrono, consentendo ai sistemi di interagire quando le risorse lo consentono e consentendo il tracciamento e il monitoraggio dell'operazione. Quando viene richiamato un processo di lunga durata, AEM Forms crea un valore di identificativo di chiamata come parte di un record che tiene traccia dello stato del processo di lunga durata. Il record viene memorizzato nel database di AEM Forms. È possibile eliminare i record di processi di lunga durata quando non sono più necessari.
Utilizzando il valore dell'identificatore di chiamata, è possibile 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 Gestione processi, ad esempio la chiusura di un'istanza del processo in esecuzione.
Esempio di processo di breve durata
Nell'illustrazione seguente viene illustrato un processo di breve durata denominato MyApplication/EncryptDocument.
MyApplication/EncryptDocument
utilizzando Workbench. (Vedi Utilizzo di Workbench.)Quando viene richiamato, questo processo di breve durata esegue le azioni seguenti:
-
Ottiene il documento PDF non protetto passato al processo come valore di input.
-
Crittografa 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 la relativa operazione èinvoke
.note note NOTE In genere, un processo di breve durata è costituito da più di tre azioni. È possibile creare un processo utilizzando Workbench. (Vedi Utilizzo di Workbench.) La programmazione con moduli AEM descrive i seguenti modi in cui è possibile richiamare a livello di programmazione questo processo di breve durata:
- Richiamare un processo di breve durata passando un documento non sicuro tramite AEM Forms Remoting (utilizzando un'applicazione Flex)
- Richiamo di un processo di breve durata tramite l'API di chiamata (API di chiamata Java™)
- Richiamo di AEM Forms tramite la 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 AEM Forms tramite dati BLOB tramite HTTP (esempio di servizio Web)
- Richiamo di AEM Forms tramite DIME (esempio di servizio Web)
- Richiamare il processo MyApplication/EncryptDocument tramite REST
Esempio di processo di lunga durata
L’illustrazione seguente è un esempio di processo di lunga durata.
Questo processo viene richiamato quando un richiedente presenta un modulo di prestito. Il processo non è completo finché un responsabile del prestito non approva o rifiuta la richiesta di prestito. Il nome di questo processo di lunga durata è FirstAppSolution/PreLoanProcess e la relativa operazione è invoke_Async
. Questo processo deve essere richiamato in modo asincrono. Per informazioni sul richiamo programmatico di questo processo di lunga durata, vedere Richiamo di processi di lunga durata incentrati sull'uomo.