Differenze
Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.
| Entrambe le parti precedenti la revisione Revisione precedente Prossima revisione | Revisione precedente | ||
|
gwusermanual:gwobjects:start [2023/01/16 16:15] 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.setEventCodObjectValue("PRE-001.01_000008_00"); /*STRINGA - Valore del campo/attributo codice dell'oggetto*/ | ||
| + | event.setEventDescrObject("Questa è una descrizione."); /*STRINGA - Descrizione dell'oggetto su cui si è verificato | ||
| + | l'evento*/ | ||
| event.setEventTypeObjectKey(null); /*STRINGA - Nome del campo/attributo della classe dell'oggetto, | event.setEventTypeObjectKey(null); /*STRINGA - Nome del campo/attributo della classe dell'oggetto, | ||
| - | (campo) che contiene il tipo dell'oggetto. Il tipo dell'oggetto è utile | + | (campo) che contiene il tipo dell'oggetto. Il tipo dell'oggetto |
| - | solo nel caso in cui oggetti della stessa classe ma di tipo diverso | + | è utile solo nel caso in cui oggetti della stessa classe ma di |
| - | debbano avere diverse notifiche o diversi destinatari di notifica*/ | + | tipo diverso debbano avere diverse notifiche o diversi destinatari |
| - | event.setEventTypeObjectValue(null); //STRINGA - Valore del campo/attributo tipo dell'oggetto | + | di notifica*/ |
| + | event.setEventTypeObjectValue(null); /*STRINGA - Valore del campo/attributo tipo dell'oggetto*/ | ||
| Linea 463: | 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> | ||