Manuale dell Amministratore: guida all uso del Controller Agent

Transcript

1 Manuale dell Amministratore: guida all uso del Controller Agent Introduzione Il Controller Agent è l agente centrale del sistema di gestione di Workflow Process WAT, Workflow Agent Tool. Esso è in grado di avviare l engine di workflow Shark, caricare i file XPDL che descrivono processi, avviare processi e distribuire il carico di lavoro agli utenti. Questo manuale è rivolto all amministratore del sistema, che sarà responsabile del corretto avvio di un processo e potrà monitorarne la corretta esecuzione. Il Controller Agent utilizza: L engine di workflow open source Enhydra Shark versione 1.1-2, [Errore. L'origine riferimento non è stata trovata.] La piattaforma ad agenti JADE 3.3 Le librerie java SDK 1.4_08. ContollerAgent Gui e Funzionalità Avvio Dalla Start-bar WAT del menu avvio fare doppio click sull icona avvio Jade no RMA per lanciare la piattaforma Jade senza interfaccia grafica, oppure sull icona avvio Jade RMA per lanciare la piattaforma Jade con l interfaccia grafica. Per avviare il Controller agent fare doppio click sull icona runwca Login Avviato il Controller Agent, dopo pochi secondi apparirà la finestra di login: qui l amministratore dovrà inserire il nome utente, la password e infine premere il pulsante Connect. Al primo avvio inserire lo username = admin e la password = enhydra

2 Se i dati inseriti non sono corretti verrà visualizzato il messaggio Connection Failed try again. Se saranno corretti si aprirà l interfaccia principale del programma. User Management Il primo pannello che viene visualizzato è quello relativo alla gestione degli utenti: Gestione utenti Gestione gruppi Questa finestra è divisa in due sezioni: Gestione Utenti Gestione Gruppi In gestione utenti vi sono tre pulsanti: New: inserisce un nuovo utente Edit: modifica i dati relativi all utente selezionato Delete: elimina l utente selezionato

3 Quando viene premuto il pulsante New viene visualizzata la seguente finestra di dialogo: In questa finestra è possibile inserire tutti i dati relativi ad un nuovo utente; inoltre, al momento dell inserimento, viene controllato se il gruppo di appartenenza inserito in Group name esiste. Qualora il group name non esistesse, viene chiesto se si vuole creare un nuovo gruppo utenti: Premendo il pulsante Edit si potranno invece modificare le seguenti informazioni: Non potrà essere modificato l Username e neanche il gruppo di appartenenza. Nel riquadro della gestione dei gruppi ritroviamo i tre pulsanti: New: inserisce un nuovo gruppo e la sua descrizione

4 Edit: modifica la descrizione del gruppo selezionato Delete: cancella il gruppo selezionato, se vi sono utenti in quel gruppo non potrà essere effettuata questa operazione e verrà visualizzato il seguente messaggio:

5 XPDL Management Da questa finestra è possibile predisporre l engine per l esecuzione dei processi. Vi sono 2 sezioni principali: Repository and Package Management User and Application Mapping Repository and Package Management User and Application Mapping Repository and Package Management Il repository è una lista di tutti i file di tipo xpdl presenti all interno della cartella /shark/repository/external.

6 Per poter caricare un package nell engine è necessario che esso si trovi in questa cartella. A questo scopo vi è il pulsante Find *.xpdl che permetterà all utente di cercare, all interno del file system, un file che verrà quindi copiato dentro la cartella di repository. Se il file contenente la definizione di processo è presente nel repository sarà allora possibile caricare un package all interno dell engine selezionando la voce nell elenco e clickando sul pulsante Load into engine. Se non vi sono errori nel file, il package relativo verrà visualizzato nella lista Package Management; altrimenti sarà segnalato un errore. Package Management è una lista di tutti i package caricati nel motore di workflow. Il bottone unload, inoltre, serve per togliere il package dalla memoria del motore. Bisogna fare attenzione: è consentito fare l unload solo di quei package che non hanno istanze di processo avviate o non cancellate. Se così non fosse verrà segnalata la presenza di istanze di processo attive.

7 User and Application Mapping Il mapping è quell operazione che lega le entità astratte della definizione di processo con la realtà e quindi con l istanza di un processo. Questa è un operazione molto delicata, ma necessaria al fine di garantire il corretto funzionamento del sistema. L amministratore dovrà avere informazioni aggiuntive riguardo i dati degli utenti e delle applicazioni, le quali potranno essere fornite dal progettista (ovvero da un responsabile del processo). User Mapping: All interno di una definizione di processo vi sono delle entità chiamate participant, che possono essere persone, società, ruoli o quant altro sia responsabile dello svolgimento di un attività. I participant non contengono però informazioni sulle persone fisiche che svolgeranno le attività, le quali inoltre, potranno essere diverse per ogni istanza di processo avviata. L User è un utente del nostro sistema, dotato di username e password che lo identificano univocamente. Inoltre gli utenti sono suddivisi in gruppi secondo mansioni, specializzazioni, abilità o altro. Nasce così l esigenza, soddisfatta dal pannello User mapping,di mappare user con participant. Quando si carica un package viene aggiornata la lista dei participant, che devono essere mappati (List of all participant). Sarà quindi possibile selezionare, in sequenza, il participant, poi un gruppo, poi uno User specifico oppure All User per indicare tutti i membri appartenenti a quel gruppo; infine si dovrà premere il pulsante Add participant user mapping : così sarà stato creato il mapping tra participant e user, e ne verra inserita la descrizione nella lista superiore. Inoltre verrà rimossa la voce relativa al participant dalla lista Lista of all Participant. Se la lista dei participant è vuota, tutti i participant sono stati mappati.

8 E possibile rimuovere questo mapping attraverso il pulsante Remove selected mapping. Application Mapping Tutte le applicazioni di una definizione di processo devono essere mappate affinché l engine colleghi l applicazione definita in xpdl con un applicazione reale. A tal fine sono presenti numerosi Tool Agent, che possono essere utilizzati per diversi scopi. Oltre ai Tool Agent propri di Shark, è stato inserito il JadeToolAgent, che può essere utilizzato nel caso in cui all applicazione da mappare sia legato un Action Agent. Per creare il mapping è necessario selezionare un applicazione dalla lista Applications:, selezionare un tool dalla lista ToolAgent, riempire almeno il campo obbligatorio Application Name ed eventualmente gli altri campi opzionali:

9 Process Management Se sono stati precedentemente caricati dei package, da questa finestra l amministratore può avviare uno o più processi e monitorarne l esecuzione. Gli elementi di questa finestra sono: Selezione del package L albero dei processi La lista delle attività in attesa La lista delle attività in corso La lista delle attività completate

10 L albero dei processi Individuato dal titolo Process instantiation management, l albero dei processi mostra tutti i workflow process che è possibile istanziare manualmente e tutti quelli in esecuzione nell engine di workflow. Le radici dell albero rappresentano i processi caricati nell engine. Questi, dopo essere stati selezionati, possono essere istanziati premendo il pulsante Instantiate. Se un processo possiede delle è visualizzato come una cartella dei dati. Questi rappresentano le processo all interno del motore di È possibile inoltre terminare un avviato selezionando l istanza di si vuole terminare e premendo il Terminate. Questa operazione Processo caricato nell engine Istanzia di processo istanze esso contenente istanze di un workflow. processo processo che pulsante chiude l istanza di processo ma non elimina i dati relativi alla sua esecuzione, che possono essere analizzati tramite il pannello Closed Process History. Se invece non si vogliono più analizzare i dati relativi a un processo, è possibile usare il pulsante Delete Selected per eliminare tutti i dati rimasti, oppure Delete Finished per eliminare i dati di tutti i processi terminati.

11 Liste delle attività Quando viene selezionata un istanza di processo, nelle tabelle di destra sono visualizzate le informazioni relative alle sue attività. Vi sono tre tabelle: Attività in attesa di essere prese in carico, Activity open but not running : mostra tutte le attività in attesa di essere svolte da un utente autorizzato, e per ogni attività mostra le seguenti informazioni: o Name: il nome dell attività o Priority: priorità dell attività o Key: chiave univoca di esecuzione o Resource mapped: utente o gruppo autorizzato a prendere in carico l attività. Inoltre possiede i seguenti pulsanti: o Suspend: sospende l attività selezionata o Resume: riprende l attività sospesa o Terminate: termina l attività selezionata o Info: mostra una finestra con informazioni su extended attributes dell attività o Force running: Modifica lo stato dell attività da not running in running. Attività prese in carico, Activity in running : mostra tutte le attività che sono state prese in carico da un utente autorizzato; per ogni attività mostra le seguenti informazioni: o Name: il nome dell attività o Priority: priorità dell attività o Key: chiave univoca di esecuzione o Duration: tempo trascorso dall accettazione dell attività o Performer: utente responsabile dell esecuzione dell attività. Inoltre possiede i seguenti pulsanti: o Suspend: sospende l attività selezionata o Resume: riprende l attività sospesa o Terminate: termina l attività selezionata o Info: mostra una finestra con informazioni su extended attributes dell attività o Force complete: Modifica lo stato dell attività da running in completed. Attività completate, Activity complete mostra tutte le attività che sono state completate e per ogni attività: o Name: il nome dell attività o Duration: tempo trascorso dall accettazione dell attività o Performer: utente responsabile dell esecuzione dell attività.

12 Attività in attesa Attività prese in carico Attività completate

13 Engine Monitor L engine monitor serve a visualizzare tutte le attività di tutte le istanze di processo che sono prese in carico o che sono in attesa; permette quindi di avere la stima del volume delle attività globali gestite dal Controller Agent.

14 Closed Process History In questo pannello è possibile visualizzare le informazioni sulle attività dei processi che sono stati conclusi. È possibile quindi sapere chi è stato il responsabile di una certa attività. Vi è inoltre un pulsante tramite il quale è possibile cancellare dal database tutti i processi terminati.