| At line 1 added 104 lines |
| %%(display:none) |
| {{{ |
| WikiUp |
| }}} |
| /% |
| [{TableOfContents }]\\ |
| In webup sono presenti diverse funzionalità che possono aiutare nell'osservazione e nel debugging di ciò che sta succedendo nell'applicazione.\\ |
| \\ |
| !! Il terminale\\ |
| Una funzionalità di debug molto utile messa a disposizione da webup è il terminale, dal quale possono essere digitati comandi testuali.\\ |
| Il terminale è accessibile:\\ |
| * quando si è loggati, usando l'icona del terminale\\ |
| \\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_039.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| ed inserendo l'apposita password;\\ |
| * quando non si è loggati, alla pagina http://<Indirizzo Webup>/views/terminal.jsf\\ |
| Per la lista di tutti i comandi eseguibili basta digitare "help":\\ |
| \\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_040.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| Tra i più utilizzati si segnalano:\\ |
| * comp - visualizza l'albero dei principali componenti nella scheda corrente;\\ |
| * last - elenca le ultime fun eseguite in sessione con i relativi tempi di esecuzione. Digitando "last n" si ottiene l'xml dell'n-esima fun presente nella lista;\\ |
| * env - elenca le informazioni relative alla sessione, come l'utente e l'id di sessione.\\ |
| \\ |
| __N.B.__ digitando help prima di un comando si ottengono le informazioni relative a quel comando. Ad esempio, con "help last" viene spiegato cosa fa il comando e gli eventuali parametri che si possono passare in aggiunta.\\ |
| \\ |
| \\ |
| !! La vista di debug\\ |
| Webup mette a disposizione una vista di debug, che permette di ridisegnare la pagina aggiungendo informazioni utili a capire quello che si sta vedendo. La vista debug si può attivare cliccando sull'icona\\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_041.png' caption='' width='100%' style='max-width: 100%;'}]la cui presenza è configurabile da console di amministrazione nella sezione relativa ai menu buttons.\\ |
| In questa immagine si mostra come cambia la visualizzazione cliccando sull'icona di debug. Tra i bottoni gialli che compaiono i principali sono:\\ |
| * debug utils\\ |
| * debug info\\ |
| \\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_042.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| ! Debug utils\\ |
| All'interno del debug utils troviamo informazioni di carattere generale, tra cui:\\ |
| * variabili di sessione;\\ |
| * xml iniziale, che viene comunicato dal server all'avvio della sessione;\\ |
| * albero dei componenti della scheda corrente (è lo stesso che si ottiene digitando "comp" nel terminale).\\ |
| \\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_074.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| ! Debug info\\ |
| Questa sezione serve per avere informazioni riguardo ad un singolo componente grafico. Infatti avremo un bottone "debug info XXX" nelle vicinanze di ogni componente della pagina corrente, dove XXX indica la tipologia del componente.\\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_075.png' caption='' width='100%' style='max-width: 100%;'}][{Image src='immagini/MBDOC-WEBASE_03/WEBASE_076.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| Nelle varie sezioni del debug info troviamo informazioni relative ai suoi setup, ai dinamismi impostati, l'xml dei dati e l'eventuale fun chiamata per ottenerli, e alcune funzionalità di debug che riguardano l'implementazione tramite la tecnologia ketchup.\\ |
| \\ |
| __N.B. __ in base al componente, il debug info potrebbe presentare informazioni aggiuntive. Ad esempio:\\ |
| \\ |
| __Integrazione per scheda__\\ |
| Oltre ai tab base, sono presenti altre viste, quali:\\ |
| * Tree - mostra l'albero dei componenti associati alla scheda;\\ |
| * EXD styles - mostra gli stili G.STY definiti per quella scheda e la loro preview;\\ |
| * Script - visualizza lo script di scheda.\\ |
| \\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_077.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| __Integrazione per input panel__\\ |
| Per l'input panel si segnala l'importante sezione "extended info" che registra la comunicazione con il server. È molto utile per intercettare problemi in caso di malfunzionamenti.\\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_078.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| \\ |
| !! Altri strumenti di debug\\ |
| In aggiunta a terminale e vista di debug esistono in webup molti altri strumenti di debug, tra cui si citano quelli riportati nei paragrafi sottostanti.\\ |
| \\ |
| __Toolbar di componente__\\ |
| La toolbar di componente può assumere diverse forme, quali ad esempio in overlay, collassata, standard. Possono essere configurate da admin e inoltre possono essere sovrascritte sul singolo componente da opportuni attributi quali ad esempio ToolbarInvisibile o ToolbarTemplate.\\ |
| Si mostra l'esempio di toolbar di tipo overlay, visibile tenendo premuto Ctrl+Alt.\\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_079.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| La toolbar permette tra le altre cose di:\\ |
| * abilitare la vista di debug sul componente (la stessa che si ottiene in modalità debug cliccando su debug info);\\ |
| * mostrare lo stesso contenuto informativo modificando il componente di visualizzazione (es: si è su un box e si può scegliere di vedere i dati in modalità matrice);\\ |
| * effettuare il refresh o lo zoom del componente.\\ |
| \\ |
| __Growl__\\ |
| Appare in alto a destra in modalità di debug quando viene eseguita un'azione (anche in batch) ed è utile per vedere le fun eseguite ed i dinamismi in real time. Scompare automaticamente dopo qualche secondo.\\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_080.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| __Conteggio fun chiamate__\\ |
| Cliccando sull'icona\\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_081.png' caption='' width='100%' style='max-width: 100%;'}]la cui presenza è configurabile da console di amministrazione nella sezione relativa ai menu buttons, si ottiene un resoconto delle fun eseguite dall'inizio della sessione\\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_082.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| \\ |
| __Monitoring delle performance__\\ |
| In webup sono attivabili alcune utili funzionalità di monitoring delle performance, quali ad esempio il monitoring di sessione o l'attivazione di notifiche sulle fun più lente di X secondi. Per dettagli si rimanda ad apposita documentazione in materia.\\ |
| \\ |
| \\ |
| !! Mobile Observability\\ |
| \\ |
| Alcuni strumenti di debug sono visibili anche da mobile. Per attivare la modalità di debug occorre aprire il menu laterale e switchare il "debug mode" a Yes. Una volta attivata, il menu laterale si chiude e compare in basso a destra l'icona di debug\\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_083.png' caption='' width='100%' style='max-width: 100%;'}]Se premuta visualizza l'albero dei componenti della pagina corrente. Scegliendo uno dei componenti dell'albero si apre una dialog\\ |
| \\ |
| [{Image src='immagini/MBDOC-WEBASE_03/WEBASE_084.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
| che riassume la fun eseguita per visualizzare il componente e altre informazioni aggiuntive come:\\ |
| * Variables;\\ |
| * Setup;\\ |
| * xml.\\ |
| queste informazioni rispecchiano i contenuti disponibili in web. In particolare, il pulsante "download" nella sezione "xml" consente di copiare l'xml negli appunti del telefono.\\ |
| \\ |
| __Video utili__\\ |
| \\ |
| [https://youtu.be/pLp7feADiY8]\\ |
| [https://www.youtube.com/embed/zC6z9WV7VVs]\\ |
| \\ |
| \\ |
| \\ |
| \\ |
