ACG Vision4 Exit Documento generale

Transcript

1 ACG Vision4 Exit Documento generale Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 1 di 19

2 Settima Edizione (Giugno 2014) Questa edizione si riferisce alla Versione 1 Rilascio 4 livello di modifica 0 e alla Versione 1 Rilascio 5 livello di modifica 0 dei prodotti ACG Vision4 e a tutti i successivi rilasci e modifiche, se non altrimenti indicati in nuove edizioni o lettere di accompagnamento. La presente pubblicazione può includere imprecisioni tecniche o errori di ortografia. Modifiche al documento potranno essere disponibili nelle successive edizioni. La ACG SRL può introdurre miglioramenti e/o variazioni ai prodotti e/o programmi descritti nella presente pubblicazione in qualsiasi momento e senza preavviso. Note Tutti i contenuti del presente documento e i diritti ad essi correlati sono riservati. Tali contenuti pertanto possono essere consultati esclusivamente per finalità d informazione personale, essendo espressamente vietato ogni diverso utilizzo senza il preventivo consenso scritto di ACG. Sebbene sia stata usata ogni ragionevole cura nel raccogliere e presentare le informazioni contenute nel presente documento, nessuna garanzia è prestata in ordine alla loro esattezza, completezza, utilità, né ai loro possibili impieghi da parte degli utenti; è pertanto esclusa ogni responsabilità di ACG per errori, inesattezze od omissioni relative a dette informazioni. I contenuti del presente documento sono soggetti a continuo aggiornamento e sono da ritenersi puramente indicativi e suscettibili di eventuali errori e/o imprecisioni. Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 2 di 19

3 ACG può introdurre miglioramenti e/o variazioni ai prodotti e/o programmi descritti nel presente documento in qualsiasi momento e senza preavviso. Il presente documento può contenere informazioni che riguardano programmi e propositi futuri, che vengono descritti di volta in volta mediante l utilizzo di termini come "attendersi", "stimare", "prevedere", "prospettare" e "programmare". Tali dichiarazioni per loro natura non comportano alcun impegno a carico di ACG, che pertanto non assume in relazione ad essi alcuna responsabilità di realizzazione. Qualunque riferimento a siti web diversi da è fornito a solo titolo esemplificativo e non costituisce invito all utilizzo e/o navigazione. I contenuti dei siti web referenziati non sono parte dei prodotti ACG e il loro eventuale utilizzo da parte dell utente è effettuato a suo esclusivo rischio. Le informazioni relative a prodotti non ACG contenute nel presente documento sono fornite dai rispettivi fornitori, dagli annunci pubblicitari e da informazioni liberamente disponibili. ACG non ha collaudato tali prodotti e non può confermarne l accuratezza delle prestazioni, la compatibilità con i prodotti ACG o qualunque altra caratteristica. Qualunque richiesta sulle caratteristiche operative dei prodotti non ACG deve essere rivolta direttamente ai rispettivi fornitori. Fatti salvi i danni causati da dolo o colpa grave, ACG non assume nessuna responsabilità circa i contenuti del presente documento. In particolare, tali contenuti non rappresentano una promessa o garanzia relativa alla all idoneità a determinati scopi dei prodotti ACG oppure alla non violazione, da parte dei prodotti ACG stessi, di leggi di qualsivoglia natura. Trademarks ACG e ACG Vision4 sono marchi di ACG S.r.l., con socio unico e soggetta all attività di direzione e coordinamento di TeamSystem S.p.A., sede legale in Via Yuri Gagarin, Pesaro (PU), Cap. Soc i.v., codice fiscale e iscrizione al Registro delle Imprese di Milano n (di seguito ACG ) - Tutti i diritti riservati. I marchi e loghi riportati nel presente documento diversi da ACG e ACG Vision4 (ivi inclusi, a mero titolo esemplificativo e non esaustivo, IBM, il logo IBM, Adobe, il logo Adobe, PostScript, il logo PostScript, Intel, il logo Intel, Intel Inside, il logo Intel Inside, Intel Centrino, il logo Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium e Pentium, Linux, Microsoft, Windows, Windows NT e il logo di Windows, UNIX, Java, Novell, il logo Novell, opensuse e il logo opensuse, AS/400, BladeCenter, Cognos, DB2, DB2 Universal Database, eserver, i5/os, iseries, OpenPower, OS/400, POWER, Power Systems, pseries, Rational, System i, System i5, System p, System p5, System Storage, System x, WebSphere, etc.) sono di titolarità di soggetti terzi. ACG rispetta i diritti di proprietà intellettuale di terzi. Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 3 di 19

4 INDICE Tabella degli aggiornamenti Introduzione Gestione exit Exit automatiche Exit non automatiche Exit predefinite Exit lato server Tabella degli aggiornamenti Data PTF id Descrizione 05/04/2013 SVB140097D Passaggio parametro "actionconfig" alle classi di exit automatica - modificato paragrafo /05/2013 SVB140099D Passaggio parametro "exitoperationid" alle classi di exit predefinita - modificato paragrafo 2.3 Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 4 di 19

5 1. Introduzione Il documento elenca i punti di exit applicativa presenti nelle funzioni del prodotto ACG Vision4 al fine di consentirne la personalizzazione e l integrazione applicativa di terze parti. La personalizzabilità del prodotto si realizza attraverso l uso di exit, punti prestabiliti (exit points) nel codice standard delle ACG Vision4 dai quali è possibile invocare automaticamente o su richiesta dell utente del codice personalizzato, per realizzare estensioni delle funzionalità standard e/o implementare comportamenti ad hoc. ll codice di personalizzazione che può essere invocato deve essere scritto secondo il programming model ACG Vision4, dovendo rispettare convenzioni e specifiche proprie dell architettura. L infrastruttura ACG Vision4 permette inoltre la definizione/configurazione di exit points personalizzati in aggiunta a quelli predefiniti nel prodotto. ACG Vision4 prevede le seguenti tipologie di exit che possono essere attivate nell ambito della interazione utente-user interface o nell ambito del codice java servente di una funzionalità: exit Automatiche di tipo PRE o POST exit Non automatiche, richiamabili da finestra a seguito della pressione di un tasto funzionale; exit Predefinite, inserite nel codice standard di gestione della User Interface ACG Vision4; exit Server (deprecate) 2. Gestione exit ACG Vision4 prevede la possibilità di invocare automaticamente o su richiesta dell utente funzionalità o parti di codice personalizzati, al fine di realizzare estensioni delle funzionalità standard ed implementare comportamenti ad hoc. Il codice personalizzato che può essere invocato deve essere scritto secondo il programming model ACG Vision4, dovendo rispettare convenzioni e specifiche proprie dell architettura V4. Il meccanismo attraverso il quale è stata realizzata l invocazione a funzioni di personalizzazione è rappresentato dall attivazione delle cosiddette exit, vale a dire dall attivazione di punti di uscita del codice standard. Sono state individuate quattro tipologie di exit che possono essere attivate nell ambito di una funzionalità: 1. exit automatiche 2. exit non automatiche, richiamabili da finestra a seguito della pressione di un tasto funzionale 3. exit predefinite, inserite in punti ben precisi del codice standard ACG 4. exit di tipo server Nel seguito vengono dettagliate le quattro tipologie di exit. Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 5 di 19

6 2.1 Exit automatiche Il meccanismo delle exit automatiche si basa sulla possibilità di invocare un metodo specifico di una classe di personalizzazione ogni qualvolta viene invocato un metodo di un azione Struts ACG Vision4. La Exit puo essere richiamata in modalità POST o in modalità PRE rispetto all esecuzione dell azione Struts ACG Vision4; nel primo caso sarà eseguita dopo l invocazione del metodo dell azione Struts, nel secondo caso prima. L associazione tra le exit da invocare ed i metodi o le azioni su cui si intende attivare il meccanismo delle exit stesso è realizzata attraverso la funzione Associazione operazioni-exit inclusa nel menu Operazioni ed autorizzazioni di ACG Service Bus; è necessario il ruolo di amministratore di sistema (SYSTEM_ADM) per accedere a tale funzione. La tabella SQL contentente le associazioni è ACGGGA.KOPEX00F. La funzione succitata consente di creare, modificare, cancellare un record che definisce il legame tra un operazione (o un action) e la sua exit (metodo utente). Nel caso in cui si debba creare un associazione tra un metodo specifico di un action ed un operazione di exit, il codice dell operazione (Id operazione, KOPEX00F.KOPID) associato al metodo dell azione Struts deve corrispondere alla concatenazione dei seguenti elementi: 1. action id dell azione Struts da invocare (la classe java..action di Struts) 2. carattere underscore (trattino basso) 3. metodo da invocare Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 6 di 19

7 Nel caso in cui si voglia associare un operazione di exit ad un action, bisognerà specificare nel campo Operazione l action id associato all azione Struts. La exit sarà caricata e gestita dall applicazione, qualunque sia il metodo dell azione Struts che viene invocato. Tipicamente questo tipo di associazione deve essere previsto per le exit di tipo non automatico (si veda paragrafo successivo) mentre per le exit di tipo automatico ha senso definire un associazione tra la exit e l operazione associata al metodo specifico dell azione Struts. Ad esempio, se si vuol attivare una exit ogni volta che viene richiamato il metodo create() della gestione dell anagrafica agenti, basata sull azione Struts con action id Agent, occorre specificare il codice operazione Agent_create. Per individuare la action id e il nome della operazione è utile attivare la window di debug JavaScript (Strumenti->Debug->Raccolta informazioni->stampa log e successivamente lanciare l applicazione/funzione da personalizzare in modo da reperire il nome dell azione Struts e il nome del metodo invocato). La exit (Id exit, KOPEX00F.KOPEX) da associare è a sua volta un operazione identificata da un codice di fantasia, definito dall autore della exit; nell esempio, il codice dell operazione associata alla exit è Agent_create_exit_0. I valori ammissibili per il campo Nr exit sono: 0 per contrassegnare le exit automatiche di tipo POST. La exit automatica di tipo POST verrà eseguita dopo l esecuzione dell azione Struts alla quale è associata. -1 per contrassegnare le exit automatiche di tipo PRE. La exit automatica di tipo PRE verrà eseguita prima dell esecuzione dell azione Struts alla quale è associata. > 0 per identificare le exit richiamabili da finestra (exit non automatiche). Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 7 di 19

8 L operazione Agent_create_exit_0 deve essere codificata nell anagrafico delle operazioni KOPER00F; l url che contiene i nomi della classe di exit e del relativo metodo da invocare deve seguire la seguente codifica: class=nome_classe_exit;method=metodo_exit_da_richiamare oppure class=nome_classe_exit;method=metodo_exit_da_richiamare;extf=id_tabella_logica_astb300f essendo nome_classe_exit = il nome qualificato (incluso il package) della classe di exit da richiamare metodo_exit_da_richiamare = il nome del metodo di exit da richiamare extf = se presente, viene impostato con un codice alla tabella estesa EXTF (Personalizzazione funzioni) di ASTB300F. Tale codice permette di attivare o meno la exit in dipendenza di un determinato sistema informativo. Il campo funzione della exit consente di modificare il nome del metodo della exit in dipendenza del sistema informativo. Ad esempio, se la exit Agent_create_exit_0 deve richiamare il metodo aftercreate() della classe com.ibm.acgv4.exit.bp.agentexit, si deve impostare l URL dell operazione Agent_create_exit_0 come segue: class=com.ibm.acgv4.exit.bp.agentexit;method=aftercreate Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 8 di 19

9 La classe di personalizzazione deve implementare un metodo la cui signature deve essere: methodname(acglogon logon, ActionForm form, HttpServletRequest request, String context) essendo previsto che riceva: l istanza di ACGLogon correntemente attiva il form dell Action Struts sulla quale si è attivata la exit la request http il parametro context dell Action Struts sulla quale si è attivata la exit Nell esempio il metodo della classe com.ibm.acgv4.exit.bp.agentexit è: oncreate(acglogon logon, ActionForm form, HttpServletRequest request, String context) Si fa presente che, se sull operazione della exit non viene impostato il campo Url, la exit non viene eseguita. ACG Vision4 precarica alcune associazioni operazioni-exit e le relative operazioni di exit, le quali hanno il campo Url non impostato. Il cliente/business Partner che intende attivare la exit dovrà semplicemente impostare il campo Url come specificato precedentemente. Nel caso sia stato associato un codice della tabella estesa Personalizzazione funzioni (EXTF), la exit verrà eseguita se il codice indicato nel parametro extf dell URL è presente nella tabella estesa nel sistema informativo collegato e risulta attivo ed abilitato. Ad esempio è possibile condizionare l esecuzione della exit Agent_create_exit_0 al codice AGENT della tabella EXTF; inoltre è possibile impostare il campo funzione per far sì che nell esecuzione della exit venga invocato il metodo specificato nel campo Funzione del record AGENT di EXTF in luogo del nome del metodo specificato nell url dell operazione di exit. Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 9 di 19

10 All'atto dell'invocazione di una exit automatica, sia essa di tipo pre o di tipo post, è stato previsto il passaggio dell'istanza della variabile org.apache.struts.config.actionconfig associata all'azione Struts dalla quale è scaturita l'invocazione della exit automatica. Il passaggio del parametro viene realizzato aggiungendolo ai dati del thread; la exit automatica invocata può recuperare il nuovo parametro come segue: ActionConfig actionconfig = (ActionConfig) InfoConnessione.getInfoConnessione().getData().getFromData("actionConfig"); Data la variabile actionconfig è possibile, ad esempio, ricavare l'operazione da cui è partita la exit come segue: String actionid = actionconfig.getproperty("actionid"); String operationid = actionid + "_" + request.getparameter("xmethod"); A partire dalla ptf SVB140072D è stata prevista la possibilità di far eseguire più classi java all invocazione di una exit automatica. La soluzione adottata si basa sull utilizzo del pattern COR (Chain of Responsability) che permette di richiamare in successione più classi java nell ambito di una stessa request, passando parametri ed oggetti da una classe all altra nell ambito della catena. Implementazione del pattern in Apache Commons Il progetto Apache Commons fornisce un implementazione del pattern basata sui Command (vedi Per implementare il pattern si utilizzano 5 interfacce: Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 10 di 19

11 Context: rappresenta lo stato dell applicazione (Stateful object) ed è implementato come una collezione con chiave java.util.map Command: rappresenta un unità di lavoro. Il Command espone un unico metodo pubblico: public boolean execute(context context). Il Command agisce sul Context ricevuto ma non mantiene lo stato (stateless). Si può costruire una catena (Chain) di Command; ciascun Command esegue un unità di lavoro e può far avanzare la catena (se il metodo execute restituisce false) oppure interromperla (se il metodo execute restituisce false) Chain: implementa l interfaccia Command; in questo modo il programma client può invocare in maniera trasparente la esecuzione di un Command che a runtime può risultare nell esecuzione di un singolo Command o di una Chain; una Chain può richiamare un altra Chain Filter: estensione che permette il rilascio controllato delle risorse allocate da un Command, tramite l aggiunta del metodo postprocess. All atto dell esecuzione di una chain e garantito il richiamo del metodo postprocess di tutti i command partecipanti Catalog: è una collezione di Command (e Chain) ad ognuno dei quali si assegna un nome. Il Client può quindi richiedere l esecuzione di un Command ( e/o Chain) tramite un nome logico, senza conoscere i nomi qualificati delle classi; questo permette di cambiare una catena (aggiungendo/rimuovendo Command) senza dover cambiare il codice Client che invoca l esecuzione della catena. Utilizzo Command nel meccanismo delle exit Vision4 Per utilizzare il pattern Chain of Responsibility per richiamare più classi java occorre definire i seguenti oggetti logici ed implementativi: Chain: definire un nome logico che verrà utilizzato per invocarne l esecuzione Catalog: il path del file xml che conterrà la definizione della catena e che a runtime permetterà di risolvere l associazione nome logico-classe Command da eseguire; questo permette di aggiungere /rimouvere personalizzazioni senza dover cambiare la classe Client. Command: uno o più Command che implementino ciascuno una logica di exit, ricevendo in input l oggetto ExitContext Definire come URL dell operazione che implementa la exit (e che verrà associata ad un operazione Vision4) secondo il formato chainname=chain_name;chainurl=catalog_path Ad esempio se si vuole invocare la chain ClientiInitExit descritta nel file conf/corclientexitcatalog.xml occorre impostare l url come segue : chainname=clientiinitexit;chainurl=/conf/corclientiexitcatalog.xml Per maggiori dettagli si faccia riferimento al paragrafo Chiamata di più exit in Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 11 di 19

12 cascata del documento ACG Vision4 Scenari di personalizzazione 2.2 Exit non automatiche Sono richiamabili da una finestra che viene emessa al clic sul tasto Exit inserito in una finestra Vision4 sulla quale ne sia stata predisposta la gestione. Nell esempio è stato inserito il tasto Exit che viene abilitato dal metodo aftercreate() della classe com.ibm.acgv4.exit.bp.agentexit. Alla pressione del tasto Exit viene emessa la seguente finestra: Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 12 di 19

13 Nella finestra Operazioni di exit eseguibili vengono visualizzate tutte le exit associate al metodo dell action Struts che ha emesso la finestra di gestione degli agenti, leggendo la tabella delle associazioni Operazioni-Exit. La finestra elenca tutti i record associati con numero exit maggiore di 0, visualizzando la descrizione e l url dell operazione di exit da eseguire. Qui di seguito viene mostrato l elenco delle exit associate all operazione Agent_update, relativa all esecuzione del metodo update() sull Action di gestione dell anagrafica Agenti. Le exit visualizzate hanno Nr Exit maggiore di zero e sono incrementali. Eseguendo un doppio clic sulla riga relativa alla Exit nella finestra Operazioni di exit eseguibili verrà eseguita la exit. L Url delle exit eseguibili può essere di due tipi: Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 13 di 19

14 può contenere un comando javascript (tipicamente si prevede il richiamo di funzioni standard dell UI engine Vision4); la sintassi è js:comando_javascript (esempio: js:xcrtwin( ) oppure js:xrun( )). Se nel comando javascript è presente la parola chiave parentwin, questa viene sostituita a run-time con l identificativo della finestra. Nell esempio, al doppio clic sulla prima riga js:window.open('../pages/exit.jsp?parm1=parentwin&parm2=agentform') viene trasformato in js:window.open('../pages/exit.jsp?parm1=2_f1_win_salagent&parm2=agentform') essendo 2_F1_WIN_SALAgent l identificativo della finestra di gestione degli agenti dalla quale è stata emessa la finestra di lancio della Exit. Tramite l identificativo della finestra di partenza e nell esempio il parametro 2 è possibile recuperare il form bean dell action di partenza (si veda la pagina pages/exit.jsp) può contenere il riferimento ad Action forward per il richiamo di un azione Struts. Ad esempio è possibile definire nell operazione l Url AgentExitAction avendo previsto di configurare il mapping dell azione di gestione di gestione delle Exit (definito nel file strutsexit.xml) come segue: <action path="/exitmanager" type="com.ibm.acgv4.action.exitmanageraction" name="exitmanagerform" scope="request" validate="false" input="/pages/output.vm" parameter="xmethod"> <set-property key="actionid" value="exit" /> <forward name="agentexitaction" path="/agentexitiaction.do?xmethod=create"/> </action> Come per quelle automatiche, l URL della exit non automatica può contenere il parametro extf tramite il quale è possibile che permette di attivare o meno la exit in dipendenza del sistema informativo. Pertanto, se ad esempio si vuole abilitare/disabilitare la exit Agent_create_create_1 su un sistema informativo in funzione dell elemento 0001 della tabella EXTF, si può impostare l url come segue: js:window.open('../pages/exit.jsp?parm1=parentwin&parm2=agentform');extf=0001 Se il codice 0001 è presente ed è attivo nella tabella estesa EXTF di un dato sistema informativo, la exit verrà presentata nella lista delle exit eseguibili, altrimenti verrà esclusa. 2.3 Exit predefinite Sono punti di exit inseriti in punti prestabiliti del codice java Vision 4 standard per consentire l invocazione di codice utente. L unica cosa che e necessario fare e definire l operazione nel Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 14 di 19

15 Koper00f. Il codice utente invocabile è rappresentato da un metodo dichiarato in una classe definita dal personalizzatore. Al momento sono state identificate due tipologie di signature: 1. nome_metodo(actionmapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response, Session hibsession, Object parentbo) throws Exception 2. void nome_metodo(map hashmap) throws Exception Il metodo (1) riceve: l action mapping dell azione Struts dalla quale è stato invocato l action form dell azione Struts dalla quale è stato invocato la request e la response http la sessione Hibernate utilizzata nel metodo chiamante dell azione Struts il BO utilizzato nel metodo chiamante dell azione Struts Ad esempio nel metodo save() dell azione di gestione dell Anagrafica Agenti è stato inserito un punto di Exit che permette il richiamo di un metodo utente su una classe definita dall utente. Il nome della classe ed il nome del metodo devono essere definiti nell url dell operazione di Exit il cui codice è predefinito nel metodo dell azione in cui si è inserita la exit, seguendo la convenzione: class=nome_classe_exit;method=metodo_exit_da_richiamare oppure class=nome_classe_exit;method=metodo_exit_da_richiamare;extf=id_record_extf Il parametro opzionale extf rappresenta il codice di un record della tabella estesa EXTF Personalizzazione funzioni ; si veda quanto riportato nel paragrafo relativo alle exit automatiche relativamente al significato di tale parametro. Il nome dell operazione di Exit da invocare nel caso della gestione anagrafica agenti è Agent_internalSave_exit; è necessario perciò conoscere il nome delle operazioni di exit predefinite per poter innescare l aggancio. Le operazioni associate alle exit predefinite vengono precaricate con url non impostato e pertanto non vengono eseguite; esse saranno attivate solo nel momento in cui l url viene impostato opportunamente dal personalizzatore. Si riporta a titolo d esempio il codice di un metodo di exit invocato a fronte di una exit predefinita, che prevede l aggiornamento di un file di estensione dell anagrafica agenti (BPAGE00F) con l impostazione di due campi (Field1 e Field2) recuperati dal form bean dell action chiamante. public void onsavebeforecommit(actionmapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response, Session hibsession, Object parentbo) throws BaseException,Exception { log.info("entered method onsavebeforecommit"); DynaValidatorForm actionform = (DynaValidatorForm) form; //Implement validation code Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 15 di 19

16 String field1 = actionform.getstring(field1).trim(); if(field1.equals("*all")) throw new BaseException(ERROR_MSG_RESOURCE_PATH, "BP0001", null); String codag = actionform.getstring("codag"); Bpage00f bo = null; String context = actionform.getstring(acgdispatchaction.xcontext).trim(); if (context.equals(utils.ctx_insert)) { bo = new Bpage00f(); bo.setcodag(codag); } else { bo = (new Bpage00fHome()).findById(codag); } } bo.setfield1(field1); bo.setfield2(actionform.getstring(field2).trim()); hibsession.saveorupdate(bo); Nell esempio viene anche mostrato come eseguire una semplice validazione a fronte della quale può derivare il lancio di una eccezione di tipo BaseException. Il metodo(2) ha un unico parametro da utilizzare sia per l input sia per l eventuale output. Si riporta qui di seguito un esempio di implementazione: HashMap hm = new HashMap(); hm.put( form, form); hm. put( request, request); hm. put( response, response); hm. put( session, session); Hm. put(..,..) //gli ulteriori parametri dipendono dalla exit / richieste degli utenti Nella classe Java ACG Vision4 è previsto che venga istanziata la classe com.ibm.acgv4.exit.exitoperation ed eseguito su di essa il metodo run(), passando come parametro la HashMap precedentemente definita. Ad esempio: HashMap hm = new HashMap(); hm. put( form, form); hm. put( request, request); hm. put( response, response); hm. put( session, session); ExitOperation eo = ExitOperation.getExitOperation( CLIENTI_Internal_Init ); if (eo!=null) { eo.run(hm);.. BigDecimal tot_fat = (BigDecimal) hm.get( RET_Totale_Fatturato ); BigDecimal tot_mat = (BigDecimal) hm.get( RET_Totale_Maturato );.. } Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 16 di 19

17 A partire dalla ptf SVB140099D all'atto dell'invocazione di una exit predefinita tramite la classe com.ibm.acgv4.exit.exitoperation è stato previsto il passaggio del codice di operazione di exit predefinita. Il passaggio del nuovo parametro viene realizzato aggiungendolo ai dati del thread, senza che venga modificata la signature del metodo invocato. La exit automatica invocata può recuperare il nuovo parametro come segue: String operationid = (String) InfoConnessione.getInfoConnessione().getData().getFromData("exitOperationId"); 2.4 Exit lato server Le exit di questo tipo sono state deprecate a partire dall aggiornamento SVB140027D di ACG Service Bus V1R4M0, potendo utilizzare in sostituzione le exit predefinite che implementano il metodo void nome_metodo(map hashmap) throws Exception. Nella libreria acg_base.jar è presente la classe denominata com.ibm.acgv4.base.serverexit, tramite la quale è possibile effettuare il richiamo di codice java come exit di classi "server" (che implementano cioè la componente model). Tali exit consentono la personalizzazione della logica di business prevedendo la possibilità di richiamare il codice utente al quale vengono passati una serie di parametri e sulla base dei quali può restituire dei valori di ritorno che possono sovrascrivere quelli previsti dalla logica di business standard ACG. La classe da richiamare (vale a dire la classe di personalizzazione) con il relativo metodo deve essere dichiarata nel campo "Url" di un'operazione che deve essere usata come exit della classe model, secondo la convenzione: class=nome_classe;method=nome_metodo (ad es. class=com.ibm.acgv4.exit.exitcalcolofido;method=calcola). Se l'url dell'operazione di exit non è impostato oppure l'operazione ha status diverso da blank, non viene eseguito nulla (la exit viene bypassata). Esempio d'utilizzo Si supponga di voler lanciare la exit associata all'operazione FORNITORI_Exit, che prevede il richiamo del metodo run() della classe com.ibm.acgv4.exitfornitoriexit. Il metodo run() riceve i parametri tramite una HashMap e restituisce come ritorno una HashMap. E' necessario eseguire le seguenti operazioni: 1) codificare l'operazione FORNITORI_Exit con URL class=com.ibm.acgv4.exit.fornitoriexit;method=run 2) Nel codice servente scrivere HashMap params = new HashMap(); Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 17 di 19

18 params.put("parm1", "Parametro 1"); params.put("parm2", "Parametro 2"); ServerExit se = new ServerExit(logon, null, null, "FORNITORI_Exit"); try { HashMap retexit = (HashMap) se.run(params); System.out.println(retExit); } catch (BaseException e) { e.printstacktrace(); } La classe richiamata deve implementare il metodo run() con segnature public Object methodname(acglogon logon, Session session, Connection conn, Object param) throws BaseException { Ad esempio: package com.ibm.acgv4.exit; import java.sql.connection; import java.util.hashmap; import org.hibernate.session; import com.ibm.acgv4.base.acglogon; import com.ibm.acgv4.utils.utils; public class FornitoriExit { public HashMap run(acglogon logon, Session session, Connection conn, HashMap hm) throws BaseException { if (logon == null) throw Utils.createBaseException("BASE0018", null, null); Utils.printHashMap((HashMap) hm, "Input parameters"); hm.put("parm1", "Parametro 1 cambiato"); hm.put("parm3", "Parametro 3 aggiunto"); hm.remove("parm2"); } } return hm; La classe com.ibm.acgv4.exit.serverexit deve essere istanziata passando i seguenti parametri: ACGLogon: obbligatorio (deve essere not null) Session: sessione hibernate (opzionale) se la si vuol far condividere tra le classi chiamante e chiamata Connection: connessione jdbc (opzionale) se la si vuol far condividere tra le classi chiamante e chiamata OperationId: obbligatorio Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 18 di 19

19 La classe ServerExit implementa il metodo run() che riceve un Object che rappresenta il parametro (può essere una stringa o un oggetto di tipo list, map o bean o altro oggetto java) e restituisce a sua volta un oggetto (ancora una volta stringa, map, list, bean, etc.). La classe richiamata può sollevare eccezioni di tipo com.ibm.acgv4.base.baseexception; altri tipi di eccezione andranno intercettati e rimappati come com.ibm.acgv4.base.baseexception. La classe ServerExit può sollevare le seguenti eccezioni: BASE0018 per logon null BASE0065 per id operazione null BASE0021 per operazione non trovata in KOPER00F BASE0019 per utente non autorizzato all'operazione BASE0068 per errore in invocazione della classe richiamata (classe di exit inesistente, metodo da richiamare con signature sbagliata, etc) qualsiasi BaseException sollevata dalla classe richiamata (dato che le eccezioni sollevate dalla classe custom vengono catturate e rilanciate) Copyright ACG Srl 2014 Tutti i diritti riservati. Pagina 19 di 19