gwusermanual:interface:widget

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:interface:widget [2025/02/04 18:55]
giorgio.scali [Widget Base] 		gwusermanual:interface:widget [2025/04/07 10:52] (versione attuale)
giorgio.scali [LABEL_VALUE_JSON_WIDGET]
Linea 52: Linea 52:
 |Posizione nella mappa o nella planimetria |[[gwusermanual:​interface:​widget#​position_widget|POSITION_WIDGET]] | 35| | |Posizione nella mappa o nella planimetria |[[gwusermanual:​interface:​widget#​position_widget|POSITION_WIDGET]] | 35| |
 |:::​ |[[gwusermanual:​interface:​widget#​position2_widget|POSITION2_WIDGET]]| 42|Il widget Position2 permette di memorizzare l'​informazione della posizione di un record di una classe. La posizione è rappresentata dal codice di un site o di un building o di una room o di una workstation o di una generic position| |:::​ |[[gwusermanual:​interface:​widget#​position2_widget|POSITION2_WIDGET]]| 42|Il widget Position2 permette di memorizzare l'​informazione della posizione di un record di una classe. La posizione è rappresentata dal codice di un site o di un building o di una room o di una workstation o di una generic position|
-|JSON | [[gwusermanual:​interface:​widget#​labelValueJsonWidget|LABEL_VALUE_JSON_WIDGET]] | 66 | Il widget permette di visualizzare nel dettaglio di classe le informazioni (come sequenza coppie chiave-valore),​ presenti in un campo JSON (solo le key del primo livello) **(dalla 4.7.4, issue #1484)** |+|JSON | [[gwusermanual:​interface:​widget#​LABEL_VALUE_JSON_WIDGET|LABEL_VALUE_JSON_WIDGET]] | 66 | Il widget permette di visualizzare nel dettaglio di classe le informazioni (come sequenza coppie chiave-valore),​ presenti in un campo JSON (solo le key del primo livello) **(dalla 4.7.4, issue #1484)** |
  
  
Linea 593: Linea 593:
 ^ Parametro ^ Descrizione ^ ^ Parametro ^ Descrizione ^
 | textHtml| String. Codice html che verrà formattato e visualizzato | | textHtml| String. Codice html che verrà formattato e visualizzato |
-| behaviorType | Integer. Se impostato a 0 permette ​di valutare il valore ​gli attributi ​della classe ​con la notazione ${nome_attributo} ​|+| behaviorType | Integer. Default 1. Possibili valori [1,0]. Di norma vengono sostituite dinamicamente tutte le espressioni del tipo //​${field_name}//​ e del tipo //​${session_var_name}//​ in base al contesto. Per la lista vengono passati i valori dei soli widget aggiunti in lista. Analogamente per il dettaglio di classe. Se behaviorType è impostato a 0 vengono valutati i valori ​di tutti gli attributi ​anche quelli non presenti nella lista o nel dettaglio. Questo comporta una query sul dettaglio aggiuntiva, che può causare dei rallentamenti. **Nota: behaviorType a 0 è tassativamente da evitare se il widget va in lista.** Come best practise vanno nel caso messi tutti i field di riferimento in lista, al limite nascondendoli agendo nell'​**xml del widget**, cosi: **<​listCellStyleRules>​display:​none;</​listCellStyleRules><​listCellHeaderStyleRules>​display:​none;</​listCellHeaderStyleRules>​**. Sul dettaglio di  ​classe, invece, si può valutare l'​utilizzo di behaviorType a 0 nel caso in cui nell'​htmlTemplate si richiamino molti attributi attualmente non presenti nel dettaglio, e non si voglia aggiungerli manualmente per poi nasconderli|
  
 ---- ----
Linea 904: Linea 904:
 (*) Il valore dello zoom minimo raggiungibile dalla mappa dipende SEMPRE dalla base cartografica utilizzata come sfondo. Ad esempio, GoogleMaps, per ogni zona del globo, ha diversi livelli di zoom differenziati sia in base alla tipologia della mappa che in base al dettaglio disponibile per le varie zone del mondo (le città hanno in genere dettaglio più grande rispetto agli oceani..). (*) Il valore dello zoom minimo raggiungibile dalla mappa dipende SEMPRE dalla base cartografica utilizzata come sfondo. Ad esempio, GoogleMaps, per ogni zona del globo, ha diversi livelli di zoom differenziati sia in base alla tipologia della mappa che in base al dettaglio disponibile per le varie zone del mondo (le città hanno in genere dettaglio più grande rispetto agli oceani..).
  
-==== POSITION_WIDGET ​(da finire) ​==== +==== POSITION_WIDGET ==== 
 +**(da finire)**
 Oltre ai [[gwusermanual:​interface:​widget#​Elenco dei Parametri comuni alla maggior parte degli widget|parametri comuni]], i parametri specifici sono i seguenti: Oltre ai [[gwusermanual:​interface:​widget#​Elenco dei Parametri comuni alla maggior parte degli widget|parametri comuni]], i parametri specifici sono i seguenti:
 ^ Parametro ^Descrizione ^ ^ Parametro ^Descrizione ^
Linea 924: Linea 924:
  
  
-==== POSITION2_WIDGET ​(da finire) ​====+==== POSITION2_WIDGET ==== 
 + 
 +**(da finire)**
  
 Il widget Position2 permette di memorizzare l'​informazione della posizione di un record di una classe. La posizione è rappresentata dal codice di un site o di un building o di una room o di una workstation o di una generic position. Il widget Position2 permette di memorizzare l'​informazione della posizione di un record di una classe. La posizione è rappresentata dal codice di un site o di un building o di una room o di una workstation o di una generic position.
Linea 938: Linea 940:
 | showMapSelectionButtonList | <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\    <​boolean>​true</​boolean>​ | | showMapSelectionButtonList | <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\    <​boolean>​true</​boolean>​ |
 | showZoomButtonList | <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\   <​boolean>​true</​boolean>​ | | showZoomButtonList | <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\ <​boolean>​true</​boolean>​ \\   <​boolean>​true</​boolean>​ |
 +
 +
 +==== LABEL_VALUE_JSON_WIDGET ====
 +
 +**(dalla 4.7.4, issue #1484)**
 +
 +
 +Il widget LabelValueJsonWidget permette di visualizzare le informazioni contenute in un campo JSON.
 +Rappresenta il corrispettivo del labelValuesXmlWidget,​ che invece lavora con tipo di dato testuale in formato xml.
 +Caratteristiche:​
 +  * In particolare vengono presentate le coppie chiave valore esclusivamente del primo livello.
 +  * Eventuali valori con JSON annidati vengono trasformati in String JSON e visualizzati come tali
 +  * Le coppie chiave valore sono rese tramite una elenco di coppie label-widget.
 +  * Le coppie label-widget possono essere raggruppati in sezioni.
 +  * Se dall'​elaborazione dei dati dovesse risultare un solo raggruppamento (configurato o automatico),​ la relativa intestazione non verrà visualizzata
 +  * I widget senza raggruppamento,​ vengono raccolti in un gruppo creato automaticamente //'​Altri'//​ (localizzato)
 +  * Di base i widget vengono resi mediante un semplice campo di testo in sola lettura.
 +  * Nel JSON possono essere configurati dei metadati (in "​_metadata",​ key riservata e pertanto non oggetto di rendering), che sono utilizzati per una rappresentazione più rispondente alla natura del dato.
 +  * I dati di tipo immagini sono sempre su documentale (supportati sia CMIS che CMS), ed il value è sempre il nome dell'​immagine,​ comprensivo di path relativo (che viene aggiunto in automatico al root path configurato nel configuration.properties)
 +  ​
 +
 +
 +Oltre ai [[gwusermanual:​interface:​widget#​Elenco dei Parametri comuni alla maggior parte degli widget|parametri comuni]], i parametri specifici sono i seguenti:
 +^ Parametro ^Descrizione ^
 +| labelWidth| string (html width), optional, default "​250px"​ usata per il dimensionamento delle label |
 +| valueWidth| string (html width), optional, default "​400px"​ usata per il dimensionamento dei widget dei valori |
 +
 +
 +Il widget si costruisce sopra un attributo con **dataType JSON** (costruito a sua volta su un campo appropriato nel database: //json// o //jsonb// per Postgres).
 +
 +Nella versione più semplice il JSON viene rappresentato automaticamente:​
 +  * usando la key per la label
 +  * usando il valore cosi come è dentro un TextBox in sola lettura
 +
 +<code json>
 +{
 + "​Label 1": "​uno",​
 + "​Label 2": 2,
 + "​Label 3": true
 +}
 +</​code>​
 +
 +A sinistra il JSON di origine in un widget //​codeEditor//,​ e a destra la relativa rappresentazione //​labelValueJsonWidget//​.
 +
 +{{:​gwusermanual:​interface:​labelvaluejsonwidget_simple.jpg?​600|}}
 +
 +
 +Opzionalmente,​ è possibile configurare nel valore JSON anche la key **_metadata**. Dentro sono presenti due sezioni:
 +  * **groups**, contiene informazioni relative ad eventuali raggruppamenti,​ ogni //key// rappresenta il //codice del gruppo// (in rapporto 1:1 con i vari "​group_code"​ in //​parameters//​),​ e per //value// un oggetto con:
 +    * **label** string, usata come intestazione del raggruppamento
 +    * **order** integer, usato per l'​ordinamento (gli elementi senza ordine hanno precedenza, in base all'​ordine di comparsa nel JSON)
 +  * **parameters**,​ contiene i metadati relativi alle singole coppie chiave valore, organizzate per chiave. **Ogni key è in rapporto 1:1 con le key di primo livello del JSON**, e nel relativo oggetto //value// sono presenti:
 +    * **type** string, optional, default "​string",​ valori possibili **string**, **numeric**,​ **date**, **boolean**,​ **image**, **html**
 +    * **label** string, optional, label da usare per la rappresentazione. In sua assenza viene usata la medesima //key// di primo livello del JSON
 +    * **order**, integer, optional, determina l'​ordine all'​interno del gruppo (gli elementi senza ordine hanno precedenza, in base all'​ordine di comparsa nel JSON)
 +    * **group_code**,​ string, optional, se configurato determina i quale gruppo verrà posizionata la coppia chiave-valore. In sua assenza verrà usato un raggruppamento predefinito con label localizzata //'​Altri'//​
 +    * **params**, object, optional, se configurato specializza la rappresentazione del valore. I parametri variano in base al //type//
 +      * //type string//
 +        * **useTextArea**,​ boolean, optional, default false. Quando a true viene usata una TextArea per la rappresentazione
 +        * **height**, string (HTML height), optional, default "​40px"​. Da usare solo con useTextArea true, determina l'​altezza iniziale della TextArea
 +        * **maxHeight**,​ string (HTML height), optional, default "​120px"​. Da usare solo con useTextArea true, determina l'​altezza massima della TextArea
 +      * //type numeric//
 +        * **constraints**,​ object, optional, default null. Con dentro:
 +          * **places** integer, optional, default null. Numero di cifre da visualizzare dopo la virgola nei numeri decimali (ha priorità sul pattern)
 +          * **pattern** string, optional, default null. Stesso funzionamento del //widget NumberBox//​. Esempi: "#​.",​ "#​.00",​ "#.## %", "#.00 €", "#. €"
 +      * //type date// (nel //value// del primo livello del JSON ammessi valori nel formato stringa e intero (data in millisecondi))
 +        * **constraints**,​ object, optional, default null. Con dentro:
 +          * **datePattern** string, optional, default "​dd/​MM/​yyyy"​. Formati ammessi: //"​dd-MM-yyyy",​ "​yyyy-MM-dd",​ "​yyyy/​MM/​dd",​ "​dd/​MM/​yyyy",​ "dd MMMM yyyy", "yyyy MMMM dd", "​yyyy/​MM/​dd HH:​mm:​ss",​ "​yyyy/​MM/​dd HH:​mm",​ "​yyyy-MM-dd HH:​mm:​ss",​ "​yyyy-MM-dd HH:​mm",​ "​dd-MM-yyyy HH:​mm:​ss",​ "​dd-MM-yyyy HH:​mm",​ "​dd/​MM/​yyyy HH:​mm:​ss",​ "​dd/​MM/​yyyy HH:​mm",​ "​HH:​mm:​ss":​ "​HH:​mm:​ss",​ "EEEE, dd MMMM yyyy"//​
 +        * **format** @Deprecated from 4.7.4 (usare constraints.datePattern),​ string, optional default "​dd/​MM/​yyyy"​. Formati ammessi: //"​dd-MM-yyyy",​ "​yyyy-MM-dd",​ "​yyyy/​MM/​dd",​ "​dd/​MM/​yyyy",​ "dd MMMM yyyy", "yyyy MMMM dd", "​yyyy/​MM/​dd HH:​mm:​ss",​ "​yyyy/​MM/​dd HH:​mm",​ "​yyyy-MM-dd HH:​mm:​ss",​ "​yyyy-MM-dd HH:​mm",​ "​dd-MM-yyyy HH:​mm:​ss",​ "​dd-MM-yyyy HH:​mm",​ "​dd/​MM/​yyyy HH:​mm:​ss",​ "​dd/​MM/​yyyy HH:​mm",​ "​HH:​mm:​ss":​ "​HH:​mm:​ss",​ "EEEE, dd MMMM yyyy"//​
 +      * //type image// (nel //value// del primo livello del JSON ammessi solo valori stringa (nome del file, con estenzione, con eventuale path relativo))
 +        * **height**, string (HTML height), optional, default "​100px"​. Quando usato imposta un'​altezza specifica per l'​immagine
 +      * //type boolean// (nel //value// del primo livello del JSON ammessi valori nel formato boolean true/false)
 +      * //type html// (nel //value// del primo livello del JSON ammessi solo valori stringa, contenenti codice html)
 +
 +
 +=== Esempi ===
 +
 +**Esempio semplificato**
 +Configurazione con metadati minimale per un tipo di dato stringa.
 +
 +<code json>
 +{
 + "​key_date_1":​ "​valore 1",
 +
 + "​_metadata":​ {
 + "​groups":​ {
 + "​group_1":​ {
 + "​label":​ "Testo (\"​type\":​ \"​string\"​)",​
 + "​order":​ 1
 + }
 + },
 + "​parameters":​ {
 + "​key_date_1":​ {
 + "​type":​ "​string",​
 + "​label":​ "Label visualizzata",​
 + "​order":​ 1,
 + "​group_code":​ "​group_1"​
 + }
 + }
 + }
 +
 +}
 +</​code>​
 +
 +
 +**Esempio esteso**
 +In questo esempio sono presenti tutte le tipologie di dato, predisposte con molte varianti di presentazione.
 +A sinistra del gwClassDetail è presente il dato JSON in un widget codeEditor. A destra il relativo risultato finale.
 +
 +{{:​gwusermanual:​interface:​labelvaluejsonwidget.jpg?​1000|}}
 +
 +Relativo dato JSON comprensivo di metadati
 +
 +<code json>
 +{
 + "​key_date_1":​ 1738573528392,​
 + "​key_date_2":​ "​2025-02-03T09:​16:​00.565Z",​
 + "​key_date_3":​ 1738573528392,​
 + "​key_date_4":​ "​2025-02-03T09:​16:​00.565Z",​
 + "​key_date_5":​ "​2025-02-03T09:​16:​00.565Z",​
 + "​key_html_1":​ "<​span style='​height:​ 40px; display: flex; align-items:​ center;'><​i class='​fa-solid fa-circle-check gwMainColor icon32x32'></​i><​span style='​margin-left:​ 15px; font-weight:​ bold;' >​Approved<​span/><​span/>",​
 + "​key_image_1":​ "​TEST/​Galleria/​12023.jpg",​
 + "​key_image_2":​ "​TEST/​Galleria/​download.jpg",​
 + "​key_string_1":​ "​Yes",​
 + "​key_string_2":​ "​Questa è una nota estesa. Questa è una nota estesa.",​
 + "​key_string_3":​ "​Questa è una nota estesa. Questa è una nota estesa. Questa è una nota estesa. Questa è una nota estesa. Questa è una nota estesa.",​
 + "​key_numeric_1":​ 12345,
 + "​key_numeric_2":​ 12.345,
 + "​key_numeric_3":​ 1,
 + "​key_numeric_4":​ 1,
 + "​key_numeric_5":​ 0.569,
 + "​key_numeric_7":​ 600000,
 + "​key_numeric_8":​ 10.57,
 + "​Image senza _metadata":​ "​TEST/​Galleria/​download.jpg",​
 + "​String senza _metadata":​ "​generic string",​
 + "Date senza _metadata ms": 1738573528392,​
 + "​Numeric senza _metadata":​ 999,
 + "Date senza _metadata string ISO-8601":​ "​2025-02-03T09:​16:​00.565Z",​
 +
 + "​_metadata":​ {
 + "​groups":​ {
 + "​group_1":​ {
 + "​label":​ "Testo (\"​type\":​ \"​string\"​)",​
 + "​order":​ 1
 + },
 + "​group_2":​ {
 + "​label":​ "​Numeri (\"​type\":​ \"​numeric\"​)",​
 + "​order":​ 2
 + },
 + "​group_3":​ {
 + "​label":​ "Date (\"​type\":​ \"​date\"​)",​
 + "​order":​ 3
 + },
 + "​group_4":​ {
 + "​label":​ "​Immagini (\"​type\":​ \"​image\"​)",​
 + "​order":​ 4
 + },
 + "​group_5":​ {
 + "​label":​ "HTML (\"​type\":​ \"​html\"​)",​
 + "​order":​ 5
 + }
 + },
 + "​parameters":​ {
 + "​key_date_1":​ {
 + "​type":​ "​date",​
 + "​label":​ "Data ms default",​
 + "​order":​ 1,
 + "​group_code":​ "​group_3"​
 + },
 + "​key_date_2":​ {
 + "​type":​ "​date",​
 + "​label":​ "Data string ISO-8601 default",​
 + "​order":​ 2,
 + "​group_code":​ "​group_3"​
 + },
 + "​key_date_3":​ {
 + "​type":​ "​date",​
 + "​label":​ "Data ms params.format '​yyyy-MM-dd HH:​mm:​ss'",​
 + "​order":​ 3,
 + "​params":​ {
 + "​constraints":​ {"​datePattern":​ "​yyyy-MM-dd HH:​mm:​ss"​}
 + },
 + "​group_code":​ "​group_3"​
 + },
 + "​key_date_4":​ {
 + "​type":​ "​date",​
 + "​label":​ "Data string ISO-8601 params.format '​dd-MM-yyyy HH:​mm:​ss'",​
 + "​order":​ 4,
 + "​params":​ {
 + "​constraints":​ {"​datePattern":​ "​dd-MM-yyyy HH:​mm:​ss"​}
 + },
 + "​group_code":​ "​group_3"​
 + },
 + "​key_date_5":​ {
 + "​type":​ "​date",​
 + "​label":​ "Data string ISO-8601 params.format '​HH:​mm:​ss'",​
 + "​order":​ 5,
 + "​params":​ {
 + "​constraints":​ {"​datePattern":​ "​HH:​mm:​ss"​}
 + },
 + "​group_code":​ "​group_3"​
 + },
 + "​key_html_1":​ {
 + "​type":​ "​html",​
 + "​label":​ "​custom html",
 + "​order":​ 1,
 + "​params":​ {},
 + "​group_code":​ "​group_5"​
 + },
 + "​key_image_1":​ {
 + "​type":​ "​image",​
 + "​label":​ "​Immagine da CMS (default)",​
 + "​order":​ 1,
 + "​group_code":​ "​group_4"​
 + },
 + "​key_image_2":​ {
 + "​type":​ "​image",​
 + "​label":​ "​Immagine da CMS (height 50px)",​
 + "​order":​ 2,
 + "​params":​ {
 + "​height":​ "​50px"​
 + },
 + "​group_code":​ "​group_4"​
 + },
 + "​key_string_1":​ {
 + "​type":​ "​string",​
 + "​label":​ "​Confermi?",​
 + "​order":​ 1,
 + "​group_code":​ "​group_1"​
 + },
 + "​key_string_2":​ {
 + "​type":​ "​string",​
 + "​label":​ "Testo (useTextArea true)",​
 + "​order":​ 2,
 + "​params":​ {
 + "​useTextArea":​ true
 + },
 + "​group_code":​ "​group_1"​
 + },
 + "​key_string_3":​ {
 + "​type":​ "​string",​
 + "​label":​ "Testo (useTextArea true, height 100px, maxHeight:​300px)",​
 + "​order":​ 3,
 + "​params":​ {
 + "​height":​ "​100px",​
 + "​maxHeight":​ "​300px",​
 + "​useTextArea":​ true
 + },
 + "​group_code":​ "​group_1"​
 + },
 + "​key_numeric_1":​ {
 + "​type":​ "​numeric",​
 + "​label":​ "​Numero intero",​
 + "​order":​ 1,
 + "​params":​ {
 + "​constraints":​ {
 + "​places":​ 0,
 + "​pattern":​ "#​."​
 + }
 + },
 + "​group_code":​ "​group_2"​
 + },
 + "​key_numeric_2":​ {
 + "​type":​ "​numeric",​
 + "​label":​ "​Numero decimale",​
 + "​order":​ 2,
 + "​params":​ {
 + "​constraints":​ {
 + "​places":​ 2,
 + "​pattern":​ "​00#​."​
 + }
 + },
 + "​group_code":​ "​group_2"​
 + },
 + "​key_numeric_3":​ {
 + "​type":​ "​numeric",​
 + "​label":​ "​Numero decimale places 4",
 + "​order":​ 3,
 + "​params":​ {
 + "​constraints":​ {
 + "​places":​ 4,
 + "​pattern":​ "#​."​
 + }
 + },
 + "​group_code":​ "​group_2"​
 + },
 + "​key_numeric_4":​ {
 + "​type":​ "​numeric",​
 + "​label":​ "​Numero intero 0 leading",​
 + "​order":​ 4,
 + "​params":​ {
 + "​constraints":​ {
 + "​places":​ 0,
 + "​pattern":​ "​000#​."​
 + }
 + },
 + "​group_code":​ "​group_2"​
 + },
 + "​key_numeric_5":​ {
 + "​type":​ "​numeric",​
 + "​label":​ "% completamento",​
 + "​order":​ 5,
 + "​params":​ {
 + "​constraints":​ {
 + "​places":​ 2,
 + "​pattern":​ "#.## %"
 + }
 + },
 + "​group_code":​ "​group_2"​
 + },
 + "​key_numeric_6":​ {
 + "​type":​ "​numeric",​
 + "​label":​ "% completamento places 2",
 + "​order":​ 6,
 + "​params":​ {
 + "​constraints":​ {
 + "​pattern":​ "#. %"
 + }
 + },
 + "​group_code":​ "​group_2"​
 + },
 + "​key_numeric_7":​ {
 + "​type":​ "​numeric",​
 + "​label":​ "​Importo",​
 + "​order":​ 7,
 + "​params":​ {
 + "​constraints":​ {
 + "​pattern":​ "#.00 €"
 + }
 + },
 + "​group_code":​ "​group_2"​
 + },
 + "​key_numeric_8":​ {
 + "​type":​ "​numeric",​
 + "​label":​ "​Importo no decimals",​
 + "​order":​ 8,
 + "​params":​ {
 + "​constraints":​ {
 + "​pattern":​ "#. €"
 + }
 + }
 + }
 + }
 + }
 +}
 +</​code>​
 +
 +=== Popolamento JSON tramite groovy ===
 +
 +Il widget nasce con finalità di presentazione del dato. Nelle varie piattaforme il dato tipicamente deriva da attributi variabili, ospitati in classi/​tabelle differenti dalla classe padre dove tipicamente dov'à essere usato questo widget.
 +
 +Nella classe padre si avrà quindi un campo JSON, che verrà popolato con solo una sintesi di tutta la mole di dati presente negli attributi variabili.
 +
 +Il popolamento del dato avviene tipicamente tramite groovy.
 +
 +Sotto un groovy di esempio per la creazione del JSON con relativi metadati.
 +
 +Si tenga presente che quando nel GwAdmin è impostato il tipo di dato JSON per un attributo, nella mappa destinata all'​insert/​update,​ si può usare indistintamente sia una string in formato JSON, che una mappa, con coppie chiave valore.
 +Per praticità conviene sempre usare una mappa.
 +Questo anche perchè nei anche nei vari metodi di seleizone il valoredi un field json viene restituito come mappa.
 +
 +<code java>
 +
 +String gwClassName = "​gw_class_name";​
 +
 +def map = [:];
 +
 +def jsonMap = [:];
 +
 +
 +//​popolamento key-value primo livello json
 +//TODO rinominare le key e recuperare i valori da altre classi/​tabelle ​
 +jsonMap.key_date_1 = 1738573528392;​
 +jsonMap.key_date_2 = "​2025-02-03T09:​16:​00.565Z";​
 +jsonMap.key_date_3 = 1738573528392;​
 +jsonMap.key_date_4 = "​2025-02-03T09:​16:​00.565Z";​
 +jsonMap.key_date_5 = "​2025-02-03T09:​16:​00.565Z";​
 +jsonMap.key_html_1 = "<​span style='​height:​ 40px; display: flex; align-items:​ center;'><​i class='​fa-solid fa-circle-check gwMainColor icon32x32'></​i><​span style='​margin-left:​ 15px; font-weight:​ bold;' >​Approved<​span/><​span/>";​
 +jsonMap.key_image_1 = "​TEST/​Galleria/​12023.jpg";​
 +jsonMap.key_image_2 = "​TEST/​Galleria/​download.jpg";​
 +jsonMap.key_string_1 = "​Yes";​
 +jsonMap.key_string_2 = "​Questa è una nota estesa. Questa è una nota estesa.";​
 +jsonMap.key_string_3 = "​Questa è una nota estesa. Questa è una nota estesa. Questa è una nota estesa. Questa è una nota estesa. Questa è una nota estesa.";​
 +jsonMap.key_numeric_1 = 12345;
 +jsonMap.key_numeric_2 = 12.345;
 +jsonMap.key_numeric_3 = 1;
 +jsonMap.key_numeric_4 = 1;
 +jsonMap.key_numeric_5 = 0.569;
 +jsonMap.key_numeric_7 = 600000;
 +jsonMap.key_numeric_8 = 10.57;
 +
 +//​popolamento key-value primo livello json senza _metadata (e con key complessa che viene usata come label)
 +jsonMap["​Image senza _metadata"​] = "​TEST/​Galleria/​download.jpg";​
 +jsonMap["​String senza _metadata"​] = "​generic string";​
 +jsonMap["​Date senza _metadata ms"] = 1738573528392;​
 +jsonMap["​Numeric senza _metadata"​] = 999;
 +jsonMap["​Date senza _metadata string ISO-8601"​] = "​2025-02-03T09:​16:​00.565Z";​
 +
 +
 +
 +//​popolamento key _metadata
 +
 +//​definizione dei gruppi
 +def groupsMap = [
 +    group_1: [
 +      label: "Testo (\"​type\":​ \"​string\"​)",​
 +      order: 1
 +    ],
 +    group_2: [
 +      label: "Testo (\"​type\":​ \"​numeric\"​)",​
 +      order: 2
 +    ],
 +    group_3: [
 +      label: "Testo (\"​type\":​ \"​date\"​)",​
 +      order: 3
 +    ],
 +    group_4: [
 +      label: "Testo (\"​type\":​ \"​image\"​)",​
 +      order: 4
 +    ],
 +    group_5: [
 +      label: "Testo (\"​type\":​ \"​html\"​)",​
 +      order: 5
 +    ]
 +];
 +
 +//​definizione dei parametri dei metadata
 +def parametersMap = [
 + key_string_1:​ [
 + type: "​string",​
 + label: "​Confermi?",​
 + order: 1,
 + group_code:​ "​group_1"​
 + ],
 + key_string_2:​ [
 + type: "​string",​
 + label: "Testo (useTextArea true)",​
 + order: 2,
 + params: [
 + useTextArea:​ true
 + ],
 + group_code:​ "​group_1"​
 + ],
 + key_string_3:​ [
 + type: "​string",​
 + label: "Testo (useTextArea true, height 100px, maxHeight:​300px)",​
 + order: 3,
 + params: [
 + useTextArea:​ true,
 + height: "​100px",​
 + maxHeight:​ "​300px"​
 + ],
 + group_code:​ "​group_1"​
 + ],
 +
 + key_numeric_1:​ [
 + type: "​numeric",​
 + label: "​Numero intero",​
 + order: 1,
 + params: [
 + constraints:​ [
 + places: 0,
 + pattern:​ "#​."​
 + ]
 + ],
 + group_code:​ "​group_2"​
 + ],
 + key_numeric_2:​ [
 + type: "​numeric",​
 + label: "​Numero decimale",​
 + order: 2,
 + params: [
 + constraints:​ [
 + places: 2,
 + pattern:​ "​00#​."​
 + ]
 + ],
 + group_code:​ "​group_2"​
 + ],
 + key_numeric_3:​ [
 + type: "​numeric",​
 + label: "​Numero decimale places 4",
 + order: 3,
 + params: [
 + constraints:​ [
 + places: 4,
 + pattern:​ "#​."​
 + ]
 + ],
 + group_code:​ "​group_2"​
 + ],
 + key_numeric_4:​ [
 + type: "​numeric",​
 + label: "​Numero intero 0 leading",​
 + order: 4,
 + params: [
 + constraints:​ [
 + places: 0,
 + pattern:​ "​000#​."​
 + ]
 + ],
 + group_code:​ "​group_2"​
 + ],
 + key_numeric_5:​ [
 + type: "​numeric",​
 + label: "% completamento",​
 + order: 5,
 + params: [
 + constraints:​ [
 + places: 2,
 + pattern:​ "#.## %"
 + ]
 + ],
 + group_code:​ "​group_2"​
 + ],
 + key_numeric_6:​ [
 + type: "​numeric",​
 + label: "% completamento places 2",
 + order: 6,
 + params: [
 + constraints:​ [
 + pattern:​ "#. %"
 + ]
 + ],
 + group_code:​ "​group_2"​
 + ],
 + key_numeric_7:​ [
 + type: "​numeric",​
 + label: "​Importo",​
 + order: 7,
 + params: [
 + constraints:​ [
 + pattern:​ "#.00 €"
 + ]
 + ],
 + group_code:​ "​group_2"​
 + ],
 + key_numeric_8:​ [
 + type: "​numeric",​
 + label: "​Importo no decimals",​
 + order: 8,
 + params: [
 + constraints:​ [
 + pattern:​ "#. €"
 + ]
 + ]
 + ],
 +
 + key_date_1:​ [
 + type: "​date",​
 + label: "Data ms default",​
 + order: 1,
 + group_code:​ "​group_3"​
 + ],
 + key_date_2:​ [
 + type: "​date",​
 + label: "Data string ISO-8601 default",​
 + order: 2,
 + group_code:​ "​group_3"​
 + ],
 + key_date_3:​ [
 + type: "​date",​
 + label: "Data ms params.format '​yyyy-MM-dd HH:​mm:​ss'",​
 + order: 3,
 + params: [
 + format: "​yyyy-MM-dd HH:​mm:​ss"​
 + ],
 + group_code:​ "​group_3"​
 + ],
 + key_date_4:​ [
 + type: "​date",​
 + label: "Data string ISO-8601 params.format '​dd-MM-yyyy HH:​mm:​ss'",​
 + order: 4,
 + params: [
 + format: "​dd-MM-yyyy HH:​mm:​ss"​
 + ],
 + group_code:​ "​group_3"​
 + ],
 + key_date_5:​ [
 + type: "​date",​
 + label: "Data string ISO-8601 params.format '​HH:​mm:​ss'",​
 + order: 5,
 + params: [
 + format: "​HH:​mm:​ss"​
 + ],
 + group_code:​ "​group_3"​
 + ],
 +
 + key_image_1:​ [
 + type: "​image",​
 + label: "​Immagine da CMS (default)",​
 + order: 1,
 + group_code:​ "​group_4"​
 + ],
 + key_image_2:​ [
 + type: "​image",​
 + label: "​Immagine da CMS (height 50px)",​
 + order: 2,
 + params: [
 + height: "​50px"​
 + ],
 + group_code:​ "​group_4"​
 + ],
 +
 + key_html_1:​ [
 + type: "​html",​
 + label: "​custom html",
 + order: 1,
 + params: [],
 + group_code:​ "​group_5"​
 + ]
 +];
 +
 +
 +jsonMap._metadata = [
 +  groups: groupsMap,
 +  parameters: parametersMap
 +];
 +
 +map.id_field = 123;
 +//...
 +map.jsonb_field = jsonMap;
 +
 +services.classService.updateClassRecord(gwClassName,​ map);
 +
 +</​code>​
 +
 +=== Note implementative per le date ===
 +
 +Sebbene il visualizzatore JSON supporto formalmente una grande varietà di formati supportati per il type '​date',​ nelle implementazioni va usato la versione stringa nel formato **'​dd-MM-yyyy HH:​mm:​ss'​** (uguale al //​timestamp//​ del database). Quindi NON la versione ISO-8601, con o senza TIMEZONE.
 +
 +Questo per le logiche dei filtri del queryBuilder di geoweb.
  
   ​   ​
  • gwusermanual/interface/widget.1738691742.txt.gz
  • Ultima modifica: 2025/02/04 18:55
  • da giorgio.scali