gwusermanual:gwobjects:start

Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

Link a questa pagina di confronto

Entrambe le parti precedenti la revisione Revisione precedente
Prossima revisione
Revisione precedente
gwusermanual:gwobjects:start [2023/01/16 16:08]
mariasole.angelucci [Eventi]
gwusermanual:gwobjects:start [2023/01/16 16:57] (versione attuale)
mariasole.angelucci [Eventi]
Linea 402: Linea 402:
 L'​evento (chiamato GeowEvent) è un oggetto interno a Geoweb che ha lo scopo di registrare un'​azione svolta dall'​utente oppure eseguita automaticamente dal sistema. Questa azione, ovviamente, deve essere in qualche modo importante da registrare: questo vuol dire che potrebbe essere visualizzata dall'​utente in uno storico degli eventi e potrebbe essere notificata all'​utente o a più utenti tramite un sistema di notifiche. L'​evento (chiamato GeowEvent) è un oggetto interno a Geoweb che ha lo scopo di registrare un'​azione svolta dall'​utente oppure eseguita automaticamente dal sistema. Questa azione, ovviamente, deve essere in qualche modo importante da registrare: questo vuol dire che potrebbe essere visualizzata dall'​utente in uno storico degli eventi e potrebbe essere notificata all'​utente o a più utenti tramite un sistema di notifiche.
  
-L'​oggetto GeowEvent contiene diversi campi necessari alla registrazione dell'​azione che è stata svolta, memorizzando al contempo le informazioni riguardanti l'​oggetto sul quale è stata effettuata l'​azione. Di fondamentale importanza sono i campi che categorizzano l'​evento,​ cioè **eventCategory** ed **eventSubcategory**. Questi ​campi vanno compilati in modo coerente (eventi con categoria uguale devono avere il campo eventCategory compilato allo stesso modo).+L'​oggetto GeowEvent contiene diversi campi necessari alla registrazione dell'​azione che è stata svolta, memorizzando al contempo le informazioni riguardanti l'​oggetto sul quale è stata effettuata l'​azione. Di fondamentale importanza sono i campi che categorizzano l'​evento,​ cioè **eventCategory** ed **eventSubcategory**; questi ​campi vanno compilati in modo coerente (eventi con categoria uguale devono avere il campo eventCategory compilato allo stesso modo). 
 Di seguito viene riportato il codice groovy necessario alla creazione dell'​oggetto evento e alla sua registrazione tramite il servizio eventManagementService. Nell'​esempio sono riportati, con il loro commento, tutti i campi che compongono l'​evento. Si ricorda che **codSolution** e **codModule** sono obbligatori! Di seguito viene riportato il codice groovy necessario alla creazione dell'​oggetto evento e alla sua registrazione tramite il servizio eventManagementService. Nell'​esempio sono riportati, con il loro commento, tutti i campi che compongono l'​evento. Si ricorda che **codSolution** e **codModule** sono obbligatori!
  
-<​code ​GeowEvent ​GeowEvent.groovy> ​+<​code ​Groovy ​GeowEvent.groovy> ​
 import com.geowebframework.transfer.objects.event.GeowEvent;​ import com.geowebframework.transfer.objects.event.GeowEvent;​
  
Linea 414: Linea 415:
 event.setEventOrigin("​user"​); ​   //STRINGA - Origine dell'​evento:​ può assumere solo 2 valori '​user'​ oppure '​system'​ event.setEventOrigin("​user"​); ​   //STRINGA - Origine dell'​evento:​ può assumere solo 2 valori '​user'​ oppure '​system'​
 event.setEventUser("​esc"​);​ //STRINGA - Utente che crea l'​evento. Deve essere valorizzato solo se eventOrigin=user event.setEventUser("​esc"​);​ //STRINGA - Utente che crea l'​evento. Deve essere valorizzato solo se eventOrigin=user
-event.setEventNotes("​Questa e' una nota dell'​evento ​che sto registrando. "); //STRINGA - Note a corredo dell'​evento (max 4000)+event.setEventNotes("​Questa e' una nota dell'​evento. "); //STRINGA - Note a corredo dell'​evento (max 4000)
  
  
-event.setEventClassnameObject("​cde_deliverable"​); ​      //STRINGA - Nome della classe dell'​oggetto su cui si è verificato l'​evento +event.setEventClassnameObject("​cde_deliverable"​); ​      /*STRINGA - Nome della classe dell'​oggetto su cui si è verificato ​ 
-event.setEventPkObject(3619269);​ //INTERO - Chiave dell'​oggetto (cioè del record) su cui si è verificato ​ +                                                        ​l'​evento*/ 
-                                                        ​//l'​evento +event.setEventPkObject(3619269);​ /*INTERO - Chiave dell'​oggetto (cioè del record) su cui si è  
-event.setEventCodObjectKey("​cod_deliverable_full"​); ​    //STRINGA - Nome del campo/​attributo della classe dell'​oggetto,​ (campo) che  +                                                        ​verificato ​l'​evento*/ 
-                                                        //contiene il codice dell'​oggetto su cui si è verificato l'​evento +event.setEventCodObjectKey("​cod_deliverable_full"​); ​    /*STRINGA - Nome del campo/​attributo della classe dell'​oggetto, ​ 
-event.setEventCodObjectValue("​PRE-001.01_000008_00"​); ​  //STRINGA - Valore del campo/​attributo codice dell'​oggetto +                                                        ​(campo) che contiene il codice dell'​oggetto su cui si è 
-event.setEventDescrObject("​Questa è una descrizione."​);​ //STRINGA - Descrizione dell'​oggetto su cui si è verificato l'​evento +                                                        ​verificato l'​evento*/ 
-event.setEventTypeObjectKey(null);​ /​*STRINGA - Nome del campo/​attributo della classe dell'​oggetto,​ (campo) che  +event.setEventCodObjectValue("​PRE-001.01_000008_00"​); ​  /*STRINGA - Valore del campo/​attributo codice dell'​oggetto*/ 
-                                                        ​contiene il tipo dell'​oggetto. Il tipo dell'​oggetto è utile solo  +event.setEventDescrObject("​Questa è una descrizione."​);​ /*STRINGA - Descrizione dell'​oggetto su cui si è verificato ​ 
- nel caso in cui oggetti della stessa classe ma di tipo diverso debbano avere  +                                                        ​l'​evento*/ 
-                                                        ​diverse notifiche o diversi destinatari di notifica*/​ +event.setEventTypeObjectKey(null);​ /​*STRINGA - Nome del campo/​attributo della classe dell'​oggetto, ​ 
-event.setEventTypeObjectValue(null);​ /​/STRINGA - Valore del campo/​attributo tipo dell'​oggetto+                                                        ​(campo) che contiene il tipo dell'​oggetto. Il tipo dell'​oggetto ​ 
 +                                                        ​è utile solo nel caso in cui oggetti della stessa classe ma di  
 +                                                        ​tipo diverso debbano avere diverse notifiche o diversi destinatari ​ 
 +                                                        ​di notifica*/​ 
 +event.setEventTypeObjectValue(null);​ /​*STRINGA - Valore del campo/​attributo tipo dell'​oggetto*/
  
  
-event.setCodSolution("​S01"​);​ /​/STRINGA - Campo obbligatorio!! Codice della soluzione, recuperabile dalla tabella gwa_solution+event.setCodSolution("​S01"​);​ /​*STRINGA - Campo obbligatorio!! Codice della soluzione, recuperabile dalla tabella ​ 
 +                                  ​gwa_solution*/
 event.setCodModule("​LLPP_PPM"​);​ //​STRINGA - Campo obbligatorio!! Codice del modulo, recuperabile dalla tabella gwa_module event.setCodModule("​LLPP_PPM"​);​ //​STRINGA - Campo obbligatorio!! Codice del modulo, recuperabile dalla tabella gwa_module
 event.setScopeObject(""​);​ //​STRINGA - Variabile di progetto in sessione event.setScopeObject(""​);​ //​STRINGA - Variabile di progetto in sessione
 event.setEventCategory("​CAMBIO STATO"​);​ //STRINGA - Categoria dell'​evento. Va sempre valorizzato!! event.setEventCategory("​CAMBIO STATO"​);​ //STRINGA - Categoria dell'​evento. Va sempre valorizzato!!
-event.setEventSubcategory("​PUBBLICAZIONE"​);​ //STRINGA - Sottocategoria dell'​evento. Potrebbe essere nullo se l'​evento può essere ​ +event.setEventSubcategory("​PUBBLICAZIONE"​);​ /*STRINGA - Sottocategoria dell'​evento. Potrebbe essere nullo se l'​evento ​  
-                                                 //descritto solo dalle categorie. +                                                 può essere descritto solo dalle categorie*/ 
-event.setEventTitle("​Cambio stato - pubblicazione"​); ​ //STRINGA - Titolo dell'​evento. Se è nullo appare come concatenazione di  +event.setEventTitle("​Cambio stato - pubblicazione"​); ​ /*STRINGA - Titolo dell'​evento. Se è nullo appare come   
-                                                      ​//categoria e sottocategoria. +                                                      ​concatenazione di categoria e sottocategoria*/ 
-event.setEventDescription("​Questo elaborato ha cambiato stato: ora e' pubblicato. "​); ​ //STRINGA - Eventuale descrizione dell'​evento +event.setEventDescription("​Questo elaborato ha cambiato stato: ora e' pubblicato. "​); ​ /*STRINGA - Eventuale descrizione ​ 
-event.setEventMessage("​L'​elaborato con nome {{nome}} e' stato pubblicato dall'​utente {{user}}."​);​ /*STRINGA - Messaggio legato ​ +                                                             dell'​evento*/ 
-                                                 all'​evento e alla sua (futura) notifica. Se e' valorizzato,​ in fase di  +event.setEventMessage("​L'​elaborato con nome {{nome}} e' stato pubblicato dall'​utente {{user}}."​);​ /*STRINGA - Messaggio ​ 
-                                                 notifica, l'​utente vedrà il messaggio salvato su questo campo.  +                                           legato all'​evento e alla sua (futura) notifica. Se e' valorizzato,​ in fase  
-                                                 Eventuali ​variabili dinamiche possono essere inserite all'​interno della  +                                           di notifica, l'​utente vedrà il messaggio salvato su questo campo. ​Eventuali  
-                                                 stringa con la notazione doppia graffa: {{nome_variabile}}. */+                                           ​variabili dinamiche possono essere inserite all'​interno della stringa con 
 +                                           la notazione doppia graffa: {{nome_variabile}}. */
   ​     ​  
 def map = [:]; def map = [:];
Linea 450: Linea 457:
 map.nome = "​Elaborato di test PRE-001"​ map.nome = "​Elaborato di test PRE-001"​
  
-event.setEventFields(map); ​ /​*MAP(STRING,​OBJECT) - Mappa che contiene le variabili dinamiche che sono state inserite nel messaggio. ​  +event.setEventFields(map); ​ /​*MAP(STRING,​OBJECT) - Mappa che contiene le variabili dinamiche che sono state inserite ​ 
-                          ​Il messaggio può contenere uno dei campi dell'​evento compilati sopra oppure altri campi aggiuntivi. In  +                          ​nel messaggio. Il messaggio può contenere uno dei campi dell'​evento compilati sopra oppure ​ 
-                          ​questo ultimo caso i campi aggiuntivi vanno inseriti in questa mappa (con nomi diversi rispetto ai campi +                          ​altri campi aggiuntivi. In questo ultimo caso i campi aggiuntivi vanno inseriti in questa ​ 
-   ​sopraelencati) */+                          ​mappa (con nomi diversi rispetto ai campi sopraelencati) */
  
  
Linea 461: Linea 468:
 </​code>​ </​code>​
  
 +Per abilitare il salvataggio degli eventi sul gestore di dati NoSql ElasticSearch,​ vanno aggiunte le seguenti proprietà al configuration.properties:​
 +<​code>​
 +######################################################################​
 +#    E L A S T I C   S E A R C H 
 +######################################################################​
 +elastic.search.url=http://​elastic.k8s.gwcloud.it/​
 +elastic.search.user=geoweb
 +elastic.search.password=<​password>​
 +elastic.search.index.name=test ​
 +</​code>​
  
  • gwusermanual/gwobjects/start.1673881694.txt.gz
  • Ultima modifica: 2023/01/16 16:08
  • da mariasole.angelucci