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:interface:schede [2024/04/03 13:05] giorgio.scali [gwOrgChart] |
gwusermanual:interface:schede [2024/10/29 18:00] (versione attuale) giorgio.scali |
||
---|---|---|---|
Linea 60: | Linea 60: | ||
| [[gwusermanual:interface:schede#gwMnemonicCodeSheet|gwMnemonicCodeSheet]]| Scheda per la visualizzazione dei record organizzati gerarchicamente sulla base di un codice parlante | | | [[gwusermanual:interface:schede#gwMnemonicCodeSheet|gwMnemonicCodeSheet]]| Scheda per la visualizzazione dei record organizzati gerarchicamente sulla base di un codice parlante | | ||
| [[gwusermanual:interface:schede#gwPhoto360|gwPhoto360]]| Scheda per la visualizzazione di una scheda gwPhoto360| | | [[gwusermanual:interface:schede#gwPhoto360|gwPhoto360]]| Scheda per la visualizzazione di una scheda gwPhoto360| | ||
- | | [[gwusermanual:interface:schede#gwOrgChart|gwOrgChart]]| Scheda per la visualizzazione/esportazione di grafici gerarchici| | + | | [[gwusermanual:interface:schede#gwOrgChart|gwOrgChart]]| Scheda per la visualizzazione/esportazione di grafici gerarchici| |
+ | | [[gwusermanual:interface:schede#gwXlsxViewer|gwXlsxViewer]]| Scheda/floatingPane per la preview di file xlsx| | ||
+ | |||
+ | |||
+ | |||
===== Configurazione schede ===== | ===== Configurazione schede ===== | ||
Linea 1443: | Linea 1448: | ||
* espone funzionalità per espandere/collassare il grafo (da toolbar) | * espone funzionalità per espandere/collassare il grafo (da toolbar) | ||
* permette di configurare l'orientamento con il quale si sviluppa il grafo (parametro iniziale) | * permette di configurare l'orientamento con il quale si sviluppa il grafo (parametro iniziale) | ||
+ | * permette di stilizzare le entità omogenee (ma anche singolarmente) (configurazione iniziale) {{ :custom:gworgchart_3_.png |}} | ||
* permette l'esportazione del grafo come immagine .png (da toolbar) | * permette l'esportazione del grafo come immagine .png (da toolbar) | ||
* permette l'esportazione del grafo come file .pdf (da toolbar) | * permette l'esportazione del grafo come file .pdf (da toolbar) | ||
Linea 1448: | Linea 1454: | ||
* permette di impostare un livello rappresentante la profondità iniziale del grafo. Gli elementi di livello superiore saranno visualizzati, se presenti, solo agendo sulle frecce di espansione degli elementi figlio oppure tramite il button in toolbar 'Exapand All' (parametro iniziale) | * permette di impostare un livello rappresentante la profondità iniziale del grafo. Gli elementi di livello superiore saranno visualizzati, se presenti, solo agendo sulle frecce di espansione degli elementi figlio oppure tramite il button in toolbar 'Exapand All' (parametro iniziale) | ||
* permette di impostare un livello rappresentante la profondità del grafo, a partire dalla quale, in ottica di migliorarne la leggibilità, gli elementi vengono visualizzati in verticale. (parametro iniziale e poi modificabile da toolbar) | * permette di impostare un livello rappresentante la profondità del grafo, a partire dalla quale, in ottica di migliorarne la leggibilità, gli elementi vengono visualizzati in verticale. (parametro iniziale e poi modificabile da toolbar) | ||
- | * permette di stilizzare le entità omogenee (ma anche singolarmente) {{ :custom:gworgchart_3_.png |} | + | |
- | + | ||
__**Requisisti**__\\ | __**Requisisti**__\\ | ||
Linea 1456: | Linea 1462: | ||
* **entity_parent_id** integer chiave che lega l'entità corrente dell'entità padre | * **entity_parent_id** integer chiave che lega l'entità corrente dell'entità padre | ||
* **entity_name** String NOT NULL titolo del nodo, che compare nella banda colorata | * **entity_name** String NOT NULL titolo del nodo, che compare nella banda colorata | ||
- | * **entity_descr** String descrizione del nodo che comparirà nel corpo dello stesso | + | * **entity_descr** String descrizione del nodo che comparirà nel corpo dello stesso (E' supportata tutta la **notazione HTML per la stilizzazione** compresi i ritorni a capo //<br>//) |
* **gw_class_name** String nome della classe, da usare congiuntamente a item_id per aprire eventualmente il dettaglio di classe | * **gw_class_name** String nome della classe, da usare congiuntamente a item_id per aprire eventualmente il dettaglio di classe | ||
* **item_id** String chiave del record, da usare congiuntamente a gw_class_name per aprire eventualmente il dettaglio di classe | * **item_id** String chiave del record, da usare congiuntamente a gw_class_name per aprire eventualmente il dettaglio di classe | ||
Linea 1496: | Linea 1502: | ||
|pan|Boolean, optional, default false. flag che abilita fin dall'inizio la funzionalità di pan (che può essere abilitata anche in seguito da comando in toolbar)| | |pan|Boolean, optional, default false. flag che abilita fin dall'inizio la funzionalità di pan (che può essere abilitata anche in seguito da comando in toolbar)| | ||
|zoom|Boolean, optional, default false. flag che abilita fin dall'inizio la funzionalità di zoom (che può essere abilitata anche in seguito da comando in toolbar)| | |zoom|Boolean, optional, default false. flag che abilita fin dall'inizio la funzionalità di zoom (che può essere abilitata anche in seguito da comando in toolbar)| | ||
- | |depth|Integer, optional, default 999. Intero rappresentante la profondità massima del grafo. Gli elementi di livello superiore a depth (con elemento root = livello 1) NON verranno visualizzati {{ :custom:gworgchart_8_.png |}}| | + | |depth|Integer, optional, default 999. Intero rappresentante la profondità massima del grafo. Gli elementi di livello superiore a depth (con elemento root = livello 1) NON verranno visualizzati {{ :custom:gworgchart_8_.png}}| |
|visibleLevel|Integer, optional, default 999. Intero rappresentante la profondità iniziale del grafo. Gli elementi di livello superiore a visibleLevel (con elemento root = livello 1) saranno visualizzati, se presenti, solo agendo sulle frecce di espansione degli elementi figlio oppure tramite il button in toolbar 'Exapand All'| | |visibleLevel|Integer, optional, default 999. Intero rappresentante la profondità iniziale del grafo. Gli elementi di livello superiore a visibleLevel (con elemento root = livello 1) saranno visualizzati, se presenti, solo agendo sulle frecce di espansione degli elementi figlio oppure tramite il button in toolbar 'Exapand All'| | ||
- | |verticalLevel|Integer, optional, default null. Intero rappresentante la profondità del grafo, a partire dalla quale, in ottica di migliorarne la leggibilità, gli elementi vengono visualizzati in verticale. {{ :custom:gworgchart_4_.png |} {{ :custom:gworgchart_5_.png |} {{ :custom:gworgchart_6_.png |}| | + | |verticalLevel|Integer, optional, default null. Intero rappresentante la profondità del grafo, a partire dalla quale, in ottica di migliorarne la leggibilità, gli elementi vengono visualizzati in verticale. {{ :custom:gworgchart_4_.png }} {{ :custom:gworgchart_5_.png }} {{ :custom:gworgchart_6_.png }} | |
- | |direction|String, optional, default 't2b'. Possibili valori: ['t2b', 'b2t', 'l2r', 'r2l']. Determina la direzione nella quale si sviluppa il grafo. Rispettivamente | + | |direction| String, optional, default 't2b'. Possibili valori: **['t2b', 'b2t', 'l2r', 'r2l']**. Determina la direzione nella quale si sviluppa il grafo. Rispettivamente: dall'alto verso il basso (default), dal basso verso l'alto, da sinistra verso destra e da destra verso sinistra {{ :custom:gworgchart_9_.png }} {{ :custom:gworgchart_10_.png }} {{ :custom:gworgchart_11_.png }} | |
- | - dall'alto verso il basso (default) | + | |
- | - dal basso verso l'alto {{ :custom:gworgchart_9_.png |}} | + | |
- | - da sinitra verso destra {{ :custom:gworgchart_10_.png |}} | + | |
- | - da destra verso sinistra {{ :custom:gworgchart_11_.png |}}| | + | |
|updateOnChangeInGwClassNameList|String, optional, default null. Lista di gwClassName, separati da virgola (',') tali per cui la scheda si aggiorna in automatico di fronte ad un evento di insert/update/delete su quelle classi| | |updateOnChangeInGwClassNameList|String, optional, default null. Lista di gwClassName, separati da virgola (',') tali per cui la scheda si aggiorna in automatico di fronte ad un evento di insert/update/delete su quelle classi| | ||
+ | |openDetailOnDClick|Boolean, optional, default false. Quando è a true e sono presenti gw_class_name e item_id sul DB, viene aperto il relativo dettaglio di classe al doppio click| | ||
+ | |nodeWidth|Integer, optional, default 130 (px). Quando impostato rappresenta la width, in pixel, applicata a tutti i nodi dell'orgChart| | ||
+ | |nodeHeight|Integer, optional, default 20 (px). Quando impostato rappresenta la height (della sola parte descrittiva del nodo), in pixel, applicata a tutti i nodi dell'orgChart| | ||
Linea 1569: | Linea 1573: | ||
<parameter name="entityid" value="17000619" hideToClient="false"></parameter> | <parameter name="entityid" value="17000619" hideToClient="false"></parameter> | ||
<parameter name="direction" value="l2r" hideToClient="false"></parameter> | <parameter name="direction" value="l2r" hideToClient="false"></parameter> | ||
+ | </leafItem> | ||
+ | </code> | ||
+ | |||
+ | apertura dettaglio con doppio click | ||
+ | <code xml> | ||
+ | <leafItem name="li_6" label="verticalLevel 3" image="eyJjc3NDbGFzcyI6ImZhLXNvbGlkIGZhLXNpdGVtYXAiLCJ3aWR0aCI6IjMycHgiLCJoZWlnaHQiOiIzMnB4IiwiY29sb3IiOiIjMDA3QUMyIn0=" type="gwOrgChart"> | ||
+ | <parameter name="relationName" value="test_gw_org_chart" hideToClient="false"></parameter> | ||
+ | <parameter name="entityid" value="17000619" hideToClient="false"></parameter> | ||
+ | <parameter name="openDetailOnDClick" value="true" hideToClient="false"></parameter> | ||
+ | </leafItem> | ||
+ | </code> | ||
+ | |||
+ | width nodi impostata a 200px | ||
+ | <code xml> | ||
+ | <leafItem name="li_7" label="nodeWidth 200" image="eyJjc3NDbGFzcyI6ImZhLXNvbGlkIGZhLXNpdGVtYXAiLCJ3aWR0aCI6IjMycHgiLCJoZWlnaHQiOiIzMnB4IiwiY29sb3IiOiIjMDA3QUMyIn0=" type="gwOrgChart"> | ||
+ | <parameter name="relationName" value="test_gw_org_chart" hideToClient="false"></parameter> | ||
+ | <parameter name="entityid" value="17000619" hideToClient="false"></parameter> | ||
+ | <parameter name="nodeWidth" value="200" hideToClient="false"></parameter> | ||
+ | </leafItem> | ||
+ | </code> | ||
+ | |||
+ | height parte descrittiva nodi impostata a 80px | ||
+ | <code xml> | ||
+ | <leafItem name="li_7" label="nodeWidth 200" image="eyJjc3NDbGFzcyI6ImZhLXNvbGlkIGZhLXNpdGVtYXAiLCJ3aWR0aCI6IjMycHgiLCJoZWlnaHQiOiIzMnB4IiwiY29sb3IiOiIjMDA3QUMyIn0=" type="gwOrgChart"> | ||
+ | <parameter name="relationName" value="test_gw_org_chart" hideToClient="false"></parameter> | ||
+ | <parameter name="entityid" value="17000619" hideToClient="false"></parameter> | ||
+ | <parameter name="nodeHeight" value="80" hideToClient="false"></parameter> | ||
</leafItem> | </leafItem> | ||
</code> | </code> | ||
Linea 1574: | Linea 1605: | ||
esempio di utilizzo di tutti i parametri | esempio di utilizzo di tutti i parametri | ||
<code xml> | <code xml> | ||
- | <leafItem name="li_7" label="direction left to right" image="eyJjc3NDbGFzcyI6ImZhLXNvbGlkIGZhLXNpdGVtYXAiLCJ3aWR0aCI6IjMycHgiLCJoZWlnaHQiOiIzMnB4IiwiY29sb3IiOiIjMDA3QUMyIn0=" type="gwOrgChart"> | + | <leafItem name="li_8" label="direction left to right" image="eyJjc3NDbGFzcyI6ImZhLXNvbGlkIGZhLXNpdGVtYXAiLCJ3aWR0aCI6IjMycHgiLCJoZWlnaHQiOiIzMnB4IiwiY29sb3IiOiIjMDA3QUMyIn0=" type="gwOrgChart"> |
<parameter name="relationName" value="test_gw_org_chart" hideToClient="false"></parameter> | <parameter name="relationName" value="test_gw_org_chart" hideToClient="false"></parameter> | ||
<parameter name="entityid" value="17000171" hideToClient="false"></parameter> | <parameter name="entityid" value="17000171" hideToClient="false"></parameter> | ||
Linea 1583: | Linea 1614: | ||
<parameter name="pan" value="true" hideToClient="false"></parameter> | <parameter name="pan" value="true" hideToClient="false"></parameter> | ||
<parameter name="verticalLevel " value="4" hideToClient="false"></parameter> | <parameter name="verticalLevel " value="4" hideToClient="false"></parameter> | ||
+ | <parameter name="openDetailOnDClick" value="true" hideToClient="false"></parameter> | ||
<parameter name="updateOnChangeInGwClassNameList" value="test_gw_org_chart" hideToClient="false"></parameter> | <parameter name="updateOnChangeInGwClassNameList" value="test_gw_org_chart" hideToClient="false"></parameter> | ||
+ | <parameter name="nodeWidth" value="200" hideToClient="false"></parameter> | ||
+ | <parameter name="nodeHeight" value="80" hideToClient="false"></parameter> | ||
</leafItem> | </leafItem> | ||
+ | </code> | ||
+ | |||
+ | |||
+ | |||
+ | ==== gwXlsxViewer ==== | ||
+ | |||
+ | La scheda/floatingPane gwXlsxViewer rende disponibile una preview di file .xlsx all'interno del browser. | ||
+ | |||
+ | Come tab | ||
+ | {{ :custom:xlsx_su_tab.jpg |}} | ||
+ | Come floatingPane | ||
+ | {{ :custom:xlsx_su_floatingPane_readonly.jpg |}} | ||
+ | |||
+ | Introdotta in **4.7.3** ([[https://gitlab.com/geowebframework/geowebframework/-/issues/1417|issue #1417]]) | ||
+ | |||
+ | Il visualizzatore è basato su [[https://dream-num.github.io/LuckysheetDocs/guide/config.html#configuration-item|LuckySheet]] | ||
+ | |||
+ | **PARAMETRI** | ||
+ | ^ Parametro ^ Descrizione ^ | ||
+ | |href| String, required, default gwContextPath+'/rest/exportByGroovyExecution'. url del controller che genera i bytes| | ||
+ | |method| String, required, default 'POST' method associato ad href| | ||
+ | |fileName| String, required, nome del file che verrà generato| | ||
+ | |data| Object, optional, Dati da postare in acciazione a href e method Es: { groovy: 'export_pianificazione.groovy', fileName: fileName, otherStuff: 1 }| | ||
+ | |viewerOptions| Object, optional, default null. Opzioni passabili al visualizzatore basato su LuckySheet per sovrascrivere il comportamento di default (full readonly). Parametri https://dream-num.github.io/LuckysheetDocs/guide/config.html#configuration-item| | ||
+ | |||
+ | __**JavaScript**__\\ | ||
+ | Consulta l'apposita sezione di javascrip API [[:custom:api_js_opengwxlsxviewertab|Apertura gwXlsxViewer ]]. | ||
+ | |||
+ | __**LeafItem**__\\ | ||
+ | Non dovrebbe essere mai integrato come leafItem, ma è supportato. | ||
+ | Set minimale, usando i vari default | ||
+ | <code xml> | ||
+ | <leafItem name="li_1" label="all defaults" image="eyJjc3NDbGFzcyI6ImZhLXNvbGlkIGZhLXNpdGVtYXAiLCJ3aWR0aCI6IjMycHgiLCJoZWlnaHQiOiIzMnB4IiwiY29sb3IiOiIjMDA3QUMyIn0=" type="gwXlsxViewer "> | ||
+ | <parameter name="data" value="{ groovy: 'export_pianificazione.groovy', fileName: 'preview.xlsx'}" hideToClient="false"></parameter> | ||
+ | </leafItem> | ||
</code> | </code> |