Interfaccia BusinessFlowManagerService

L'interfaccia BusinessFlowManagerService mostra le funzioni del processo aziendale che possono essere richiamate da un'applicazione client.

I metodi che possono essere richiamati dall'interfaccia BusinessFlowManagerService dipendono dallo stato del processo o dall'attività e dai privilegi dell'utente che utilizza l'applicazione contenente il metodo. I metodi principali per la modifica degli oggetti del processo aziendale sono elencati di seguito. Per ulteriori informazioni su tali metodi ed altri metodi che sono disponibili nell'interfaccia BusinessFlowManagerService, consultare Javadoc nel pacchetto com.ibm.bpe.api.

Maschere del processo

Una maschera di processo è un modello di processo con versione, distribuito ed installato che contiene la specifica di un processo aziendale. È possibile eseguire l'istanza di tale modello ed avviarlo immettendo le richieste appropriate, ad esempio, sendMessage(). L'esecuzione di un'istanza di processo viene guidata automaticamente dal server.

Tabella 1. Metodi API per le maschere del processo
Metodo Descrizione
getProcessTemplate Richiama la maschera di processo specificata.
queryProcessTemplate Richiama le maschere del processo memorizzate nel database.

Istanze del processo

I metodi API di seguito riportati avviano le istanze di processo.

Tabella 2. Metodi API per l'avvio delle istanze di processo
Metodo Descrizione
call Crea ed esegue un microflusso.
callWithReplyContext Crea ed esegue un microflusso con un servizio di avvio univoco o un processo di lunga esecuzione con un servizio di avvio univoco dalla maschera di processo specificata. la chiamata attende in modo sincronico il risultato.
callWithUISettings Crea ed esegue un microflusso, quindi restituisce il messaggio di output e le impostazioni dell'interfaccia utente del client.
initiate Crea un'istanza di processo e ne inizia l'elaborazione. Utilizzare questo metodo per i processi di lunga esecuzione. Inoltre, è possibile utilizzare questo metodo per i microflussi che si desidera far scattare e dimenticare.
sendMessage Invia il messaggio specificato al servizio dell'attività specificata e all'istanza del processo. Se viene creata un'istanza di processo con gli stessi valori di serie di correlazioni non esiste , viene creata. Il processo può avere servizi di avvio univoci o non univoci.
getStartActivities Restituisce le informazioni sulle attività che possono avviare un'istanza di processo dalla maschera di processo specificata.
getActivityServiceTemplate Richiama la maschera del servizio dell'attività specificata.
Tabella 3. Metodi dell'API per il controllo del ciclo di vita delle istanze di processo
Metodo Descrizione
suspend Sospende l'esecuzione di un'istanza di processo di lunga esecuzione di livello superiore in stato di esecuzione o in errore.
resume Riprende l'esecuzione di un'istanza del processo di lunga esecuzione di livello superiore in stato sospeso.
restart Riavvia un'istanza di processo di livello superiore di lunga esecuzione, che si trova nello stato terminato o non riuscito.
forceTerminate Termina l'istanza del processo di livello superiore specificata, i relativi processi secondari con l'autonomia child e le relative attività in esecuzione, richieste o in attesa.
delete Elimina l'istanza di processo di livello superiore specificata ed i relativi processi secondari con l'autonomia child.
query Richiama le proprietà dal database che corrispondono ai criteri di ricerca.

Attività

Per le attività di richiamo, è possibile specificare nel modello di processo che tali attività continuino in situazioni di errore. Se il flag continueOnError è impostato su false e si verifica un errore non gestito, l'attività viene collocata in stato arrestato. Un amministratore del processo può quindi ripristinare l'attività. Il flag continuaOnError e le relative funzioni di ripristino possono, ad esempio, essere utilizzati in un processo a lunga esecuzione laddove di tanto in tanto un'attività di richiamo non riesce, ma lo sforzo richiesto per modellare la compensazione e la gestione dell'errore è troppo elevato.

I seguenti metodi sono disponibili per le attività di ripristino.

Tabella 4. Metodi dell'API per il controllo del ciclo di vita delle istanze di attività
Metodo Descrizione
claim Richiede l'istanza di un'attività pronta affinché un utente possa effettuare operazioni sull'attività.
cancelClaim Annulla la richiesta dell'istanza di attività.
complete Completa l'istanza dell'attività
completeAndClaimSuccessor Completa un'attività staff e richiede quella successiva nella stessa istanza di processo per l'utente collegato.
forceComplete Forza il completamento di un'istanza dell'attività che è in stato di esecuzione o arrestato.
forceRetry Forza la ripetizione di un'istanza dell'attività che è in stato di esecuzione o arrestato.
query Richiama le proprietà dal database che corrispondono ai criteri di ricerca.

Variabili e proprietà personalizzate

L'interfaccia fornisce i metodi get e set per richiamare ed impostare i valori per le variabili. Inoltre, è possibile associare le proprietà denominate e richiamare le proprietà denominate dalle istanza del processo e dell'attività. I nomi della proprietà personalizzate ed i valori devono essere del tipo java.lang.String.

Tabella 5. Metodi API per le variabili e le proprietà personalizzate
Metodo Descrizione
getVariable Richiama la variabile specificata.
setVariable Imposta la variabile specificata.
getCustomProperty Richiama la proprietà personalizzata denominata dell'attività specificata o dell'istanza del processo.
getCustomProperties Richiama le proprietà personalizzate dell'attività o dell'istanza di processo specificata.
getCustomPropertyNames Richiama i nomi delle proprietà personalizzate per l'attività specificata o per l'istanza di processo.
setCustomProperty Memorizza i valori specifici della personalizzazione per una determinata attività o istanza di processo.
Informazioni correlate
Funzioni deprecate

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)