Nelle maschere utente vengono utilizzati dei controlli (tecnicamente widget) che sono associati agli attributi delle classi. Ognuno di essi è configurabile attraverso una serie di parametri, che vengono poi salvati e mantenuti in formato xml.
Ogni widget è inoltre codificato con un numero intero, denominato CTRL_TYPE, che viene utilizzato nelle tabelle dei metadati (GWM_ATTRIBUTES).
Le interfacce di amministrazione degli attributi in alcuni casi guidano alla configurazione, ma nella maggior parte dei casi presentano il contenuto dell’XML direttamente modificabile in forma testuale.
In questo paragrafo saranno elencati tutti i widget esistenti nella versione corrente, e descritti i parametri di configurazione attesi.
Esistono dei parametri comuni a tutti i tipi di controllo, che saranno trattati in un’unica soluzione all’inizio del paragrafo.

I widget sotto elencati sono disponibili nella versione Enterprise Edition, e sono compresi in appositi plugin, eventualmente forniti con tale versione.

(pagina da aggiornare)

^{(torna a elenco widget)}

(1) Nella modalità di visualizzazione Lista della classe, GW ordina normalmente in modo crescente (Ascending) utilizzando i primi 3 attributi presenti in lista. Usando i parametri isDefaultOrderBy… è possibile agire su questo criterio, definendo in autonomia per quali attributi debba essere ordinabile la lista, se crescente o decrescente, ecc.
(2) Gli attributi vengono presentati in Lista secondo dei criteri di stilizzazione standard GW. In particolari esigenze può essere utile renderizzare una colonna in maniera diversa dalle altre. Usando i parametri listCell… è possibile agire in tale senso. Ulteriori spiegazioni sono disponibili al paragrafo Personalizzazione stile dei controlli in Lista

Alcuni parametri dei Widget di tipo Selezione da una lista, possono utilizzare espressioni lato client, ovvero prevedere che il contenuto delle liste presentate dipenda, ad esempio, da un settaggio di un altro attributo.

La sintassi da utilizzare per riferirsi ad un altro attributo, che deve essere necessariamente definito nella classe e inserito in un gruppo attributi, anche se in modalità hidden, è la seguente:

cod_service_category=#{cod_service_category}

^{(torna a elenco widget)}
Definisce un pulsante, collocabile all'interno del form layout, al quale associare una Action definita a livello di classe.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Il controllo permette di salvare nel campo associato il valore del Gruppo attivo nella sessione corrente.

Non ci sono parametri oltre ai parametri comuni.

E' importante tenere presente che lo widget funziona correttamente SOLO se la classe viene movimentata attraverso l'interfaccia Utente di Geoweb. Non funziona, ad esempio, con il metodo API 'UpdateClassRecord'.

^{(torna a elenco widget)}

Il controllo permette di salvare nel campo associato il valore dell'Utente attivo nella sessione corrente.

Non ci sono parametri oltre ai parametri comuni.

E' importante tenere presente che lo widget funziona correttamente SOLO se la classe viene movimentata attraverso l'interfaccia Utente di Geoweb. Non funziona, ad esempio, con il metodo API 'UpdateClassRecord'.

^{(torna a elenco widget)}

Il controllo permette di salvare nel campo associato il valore dell'Utente che esegue la transazione di Inserimento del record.
Oltre ai parametri comuni, i parametri specifici sono i seguenti:

E' importante tenere presente che lo widget funziona correttamente SOLO se la classe viene movimentata attraverso l'interfaccia Utente di Geoweb. Non funziona, ad esempio, con il metodo API 'InsertClassRecord'.

^{(torna a elenco widget)}

Controllo per inserire un link che punta ad un url esterno al sistema. L'URL sarà aperto in una pagina nuova.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

L'attributo gwDigitalDocumentWidget è un componente di Geoweb complesso, che consente di gestire gli attributi di una classe in modalità Documento.

La definizione di Documento sottende alla gestione di informazioni che appartengono ad una singola entità, ma che possono essere inserite in momenti diversi e da utenti diversi.

Il componente permette di organizzare i dati di una singola anagrafica separandoli in sezioni, in modo che ogni sezione possa essere gestita in maniera autonoma, sia come modalità di rappresentazione che come livelli autorizzativi, che come comportamenti, legando questi aspetti allo Stato dell'entità e all'Utente che vi accede.

Il widget è illustrato in maniera più dettagliata a questa pagina

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Controllo per allegare al record un insieme di documenti, che vengono salvati in una cartella del gestore documentale configurato (es. alfresco).

Per utilizzare il widget è necessario che il gestore documentale sia raggiungibile, e che sia stata dedicata una cartella documenti all'applicazione.
Il widget non è associato ad alcun campo della anagrafica collegata alla classe. Tuttavia i documenti rimarranno associati al record corrente.
Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Questo controllo punta a un singolo documento contenuto nel gestore documentale configurato (es. alfresco). Il percorso del documento sarà sempre relativo al percorso definito nel configuration.properties, alla voce “cmisBasePath”. Tale percorso relativo può essere definito da una espressione, come una concatenazione di stringhe e/o contenuti di campi del DB
(es. /Punti Vendita/${cod_punto_vendita}/Allegati/).
Possono inoltre essere definiti due comportamenti:

1. Il documento caricato viene salvato in CMIS con il suo nome originale. Tale nome viene inoltre salvato nell'attributo a cui viene agganciato il widget.
2. Il documento caricato viene rinominato, al momento dell'upload, con un nome definito in un campo, configurato come attributo, che deve essere precompilato, o come default value, o nel trigger della classe, nella sezione 'beforeInsert'. In questo caso non devo agganciare il widget a un campo del DB, ma devo configurare nel parametro nameField il nome del campo (FISICO, non calcolato sulla Vista) da cui ottenere il nuovo nome. Il documento prenderà questo nome anche su CMIS.
   

Posso inoltre configurare attributi su cui salvare content_type e autore.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Inserimento di una data attraverso uso del calendario con inserimento opzionale dell’ora.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Questo tipo di controllo permette di gestire (visualizzare, inserire, modificare) un tipo di dato ora. Sul DataBase tale dato verrà comunque sempre persistito come Date (sempre comprensiva di ora, importante).

Il widget è implementato sia sul dettaglio della classe

, che su gwClassList/childList in visualizzazione

che su childList in editazione

Quando il record è in visualizzazione o readonly verrà semplicemente mostrata una stringa rappresentante la data formattata. Il widget è implementato con una casella di testo, della tipologia Spinner, che permesse la gestione del dato. Questo widget supporta multiple modalità di inserimento. La prima è la modalità libera da tastiera: l'utente può inserire una stringa che rispetti il pattern impostato in timePattern. La seconda modalità è agire sui tastini dello Spinner feccia su/freccia giu, che rispettivamente incrementato/decrementato l'ora corrente di un valore definito dalla coppia smallDelta/deltaUM del widget. Per esempio con smallDelta=15 e deltaUM='minute', ad ogni click su freccia su aumenterò la data corrente di 15 minuti. Una terza modalità è, quando il widget ha il focus, usare i tasti freccia su/freccia giu, che hanno effetti del tutto uguali a quelli dei tastini dello Spinner. La quarta modalità è agire, quando il mouse staziona sopra il widget, con la rotellina del mouse: ad ogni scatto della rotellina equivale un incremento/decremento di entità smallDelta/deltaUM. Inoltre è possibile incrementare/decrementare l'ora di un delta di entità largeDelta/deltaUM, quando il widget ha il focus, agendo rispettivamente sui tasti Page Up/Page Down della tastiera.

Il widget deriva direttamente dal widget WidgetBase, e ne eredita tutti i parametri:

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Casella con segno di spunta. Può assumere i significati: True, False e con la configurazione 'Gestisci 3 Stati' anche il Null.
Tali valori possono essere espressi attraverso stringhe (SI/NO, VERO/FALSO, ecc.) o numeri (0/1) e rappresentati in ogni caso attraverso etichette a scelta del configuratore.

Gestire il terzo stato significa definire che l'utente possa scegliere di NON EFFETTUARE una scelta, perché magari non conosce la risposta. Se non viene utilizzato bisogna necessariamente definire un valore di Default, per non confondere il FALSE con il NULL.

IMPORTANTE: per applicare un valore di default è necessario intervenire, oltre che sulla configurazione dell'attributo, anche nella definizione del campo su DB. Ci deve essere sempre allineamento, altrimenti il widget assume comportamenti non corretti.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Controllo che permette di scegliere un colore, che viene salvato nel campo associato sotto forma di codice Esadecimale (string) tramite la presentazione di una palette grafica.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Lista di scelta mono-selezione in cui i valori sono definiti internamente al widget.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Lista di scelta mono-selezione in cui i valori sono recuperati dal database tramite query da configurare.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Lista di scelta mono-selezione che presenta, oltre al testo, anche una immagine. I valori sono recuperati dal database tramite query da configurare. Le immagini da mostrare nel controllo dovranno già essere salvate nel database, nella stessa tabella da cui leggere i valori da mettere in lista.

Sarà buona norma utilizzare immagini con stessa larghezza e altezza (es. 50×50 px), e che abbiano le stesse dimensioni tra loro.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Casella di inserimento testo con funzioni di suggerimento da selezione dei valori presenti in una lista definita. La selezione può avvenire sulla stessa classe e sullo stesso campo che si sta configurando.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Elenco di scelta mono/multi selezione in cui i valori sono recuperati dal database tramite query da configurare. Questo controllo permette di mostrare all’utente più colonne dei record da selezionare. Viene mostrata con una finestra modale che si apre in pop-up.

Non richiede che sia definita una classe sulla tabella o vista utilizzata nella query di selezione. Per questo motivo occorre configurare nei parametri le intestazioni di colonna.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Controllo per gestire l’inserimento un singolo documento, che viene selezionato tramite una finestra standard Windows. Il documento selezionato può essere memorizzato su un campo del DB oppure su File System.

Il controllo va configurato sul campo stringa destinato a contenere il NOME del documento.
In particolare, se si vuole salvare il documento su DB, dovranno essere definiti tre campi:

• un campo stringa che conterrà il nome del documento, e sul quale viene agganciato e configurato il widget Document
• un campo binario, che conterrà il documento nel suo formato originale;
• un campo stringa, che conterrà il content-type del documento, per informare Geoweb riguardo a quale applicazione potrà essere utilizzata per riaprirlo da client.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

"documents/" + classname + "/" + filename

fsPath + "/" + filename

1. Nel field del document, ci deve essere solo il nome, comprensivo di estensione. Non ci devono essere sub-path espressi con /, che verrebbero mal interpretati dal Controller Spring. Il path, e la sua eventuale costruzione dinamica, deve essere spostato in fsPath, anche ricorrendo ad EL.
2. Nel caso di path assoluti iniziare il fsPath con

   file:///
   esempi:
   file:///C:/...
   file:///opt/...

3. In caso di folder sul file system, ci devono essere i permessi per le folder interessate.
4. In caso di fsPath costruiti con ${}, con widget in lista, bisogna assicurarsi che i campi utilizzati per la risoluzione siano presenti in lista. Al limite anche nascosti settando

   display: none;

   nei tag dell'xml del widget <listCellCssRules> <listHeaderCssRules>

^{(torna a elenco widget)}

Controllo per gestire l’inserimento un file immagine che viene salvata nel DB Il controllo mostrerà direttamente l’immagine in fase di consultazione o modifica del record corrente nel form L’immagine viene selezionata tramite una finestra standard windows

Controllo per gestire l’inserimento un file immagine, che viene selezionato tramite una finestra standard Windows. Il file immagine selezionato può essere memorizzato su un campo del DB oppure su File System.

Il controllo va configurato sul campo stringa destinato a contenere il NOME dell'immagine.
In particolare, se si vuole salvare il file immagine su DB, dovranno essere definiti tre campi:

• un campo stringa che conterrà il nome dell'immagine, e sul quale viene agganciato e configurato il widget Document
• un campo binario, che conterrà l'immagine nel suo formato originale;
• un campo stringa, che conterrà il content-type dell'immagine, per informare Geoweb riguardo a quale applicazione potrà essere utilizzata per riaprirla da client.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Il widget ImgPathGallery consente di inserire in una scheda un visualizzatore di una galleria di immagini. Le immagini sono recuperate tramite un percorso assoluto nel File System.

Il widget è illustrato in maniera più dettagliata a questa pagina.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Controllo per la gestione di tabelle di dominio condivise tra più anagrafiche.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Inserisce un testo descrittivo non collegato ad alcun campo del database. Viene utilizzato generalmente per qualificare il gruppo di attributi che lo seguono.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Questo widget serve per renderizzare codice html contenuto in un campo di una tabella di classe.
In pratica rende possible inserire nel dettaglio di classe un elemento di spicco, popolato a runtime o derivato da altre informazioni o calcoli della vista associata alla classe.

Ad esempio, per mostrare eventuali errori risultanti dalla validazione di un serviceTask di processo, a questa stringa sul db corrisponderà:

<div style=“padding: 4px 10px; width: calc(100% - 24px); text-align: left; font-weight: bold; color: red; background: #eeeeee; border: 2px solid #ff0000;” >Test messaggio errore. Test messaggio errore. Test messaggio errore. Test messaggio errore. Test messaggio errore. Test messaggio errore. Test messaggio errore. </div>

E' supportata anche la visualizzazione in lista.

E' possibile utilizzare un set di stili creati ad hoc. Questi possono essere definiti in apposite regole in un apposito foglio di stile, situato nel war del client:

  META-INF/static-resources/css/configuratorRules.css

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Il widget htmlTemplate permette di definire un testo fisso formattato in html definito in maniera fissa, sia nel contenuto che nella formattazione, in fase di configurazione. Può essere utilizzato, ad esempio, per mostrare all'utente delle istruzioni per la compilazione dei campi della classe.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}
Analogamente al widget Action, permette di inserire un pulsante all'interno della dettaglio/lista, al quale associare una Action definita a livello di classe. Questo pulsante ha un alto impatto visivo. Ha inoltre una stilizzazione dinamica che dipende dai dati, che determinano: label, tooltip, icon, color. Vengono eseguiti i check statici e dinamici sull'azione.

nella gwClassList, i campi che contengono le stilizzazioni del widget, devono essere presenti in lista (tuttalpiù nascosti nell'xml del widget con la regola css display: none; nello style della cella e dell'header) per poter funzionare con il widget in lista.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Il controllo permette di presentare il contenuto di una classe relazionata, all'interno della classe corrente. I record che vengono visualizzati sono unicamente quelli collegati 1 a N rispetto al record attivo. La classe collegata deve essere configurata attraverso la definizione di una relazione Geoweb esplicita.

La link list viene normalmente configurata per conto suo dentro ad un Gruppo Attributi, che viene a sua volta posizionato dentro ad una sezione del layout, adatta a contenere un elenco di record.

Le colonne visualizzate sono quelle definite in Lista nella classe relazionata. Viene inoltre riportata la toolbar di lista, completa di tutte le azioni e operazioni che possono essere eseguite nella classe relazionata, da parte dell'utente connesso.

Il click sull’elenco darà accesso al record visualizzato nel form di dettaglio e la navigazione si sposterà alla classe collegata, aprendo il record di dettaglio in pop-up o tab, secondo la configurazione già definita nel progetto per la classe collegata.
Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Il controllo permette di presentare il contenuto di una classe relazionata con collegamento N a M (molti a molti), all'interno della classe corrente. I record che vengono visualizzati sono unicamente quelli collegati rispetto al record attivo. Il tipo di collegamento N a M presuppone l'esistenza di una tabella/classe intermedia che mette in collegamento la classe padre con quella di destinazione, e nella quale sono presenti sia le chiave della classe padre che le chiavi della tabella/classe collegata. C
La classe collegata deve essere configurata attraverso la definizione di due relazioni Geoweb esplicite:

• la prima relazione è tra la classe padre e la tabella intermedia, ed è definita nella classe corrente.
• la seconda relazione è definita nella tabella intermedia, e deve puntare alla tabella\classe collegata.

Un esempio di relazione N a M è data tra clienti e prodotti: i clienti possono acquistare diversi prodotti e i prodotti possono essere acquistati da diversi clienti. La tabella intermedia può essere quella degli acquisti, in cui vengono annotati gli acquisti dei prodotti effettuati dai diversi clienti.

Configurazione e utilizzo

La link list viene normalmente configurata per conto suo dentro ad un Gruppo Attributi, che viene a sua volta posizionato dentro ad una sezione del layout, adatta a contenere un elenco di record.
Le colonne visualizzate sono quelle definite in Lista nella classe relazionata. Viene inoltre riportata la toolbar di lista, completa di tutte le azioni e operazioni che possono essere eseguite nella classe relazionata, da parte dell'utente connesso.

La selezione dei record associati avviene tramite la presentazione di un form che contiene: in basso i record che possono essere selezionati, in alto i record che vengono scelti per essere associati.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

Elenco di scelta mono/multi selezione che permette di selezionare uno o più valori presenti in una classe definita in Geoweb. Viene mostrata con una finestra modale che si apre in pop-up.

Il widget presenta le colonne definite in Lista nella classe di riferimento.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}
Questo controllo consente di gestire una sottotabella della anagrafica principale, permettendo l'editing dei record direttamente dalla lista visualizzata.

La relazione che c’è tra le anagrafiche è la seguente:

TabellaPartenza.CampoPartenza = TabellaDestinazione.CampoDestinazione

La sottotabella deve essere definita essa stessa come classe, in quanto lo widget fa riferimento alla sua definizione. Le colonne della lista sono le colonne della lista sono infatti quelle configurate nell’anagrafica di destinazione.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}
Questo tipo di controllo è una semplice casella di testo in cui viene editata e mostrata l’informazione. Il widget utilizza solamente i parametri comuni

^{(torna a elenco widget)}
Il numberbox è uno widget studiato per i valori di tipo numerico. E' possibile stabilire un pattern per le cifre, il numero di cifre dopo la virgola, e un formato di presentazione (es. Valuta, Percentuale, ecc.). Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}
Casella di testo pensata per inserire testi piuttosto lunghi, strutturati anche su più righe. La caseela di testo si può allungare o allargare anche a run-time, ovvero quando la maschera è in visualizzazione. Inoltre la casella di testo può essere renderizzata sia come sermplice boh html, che come un Editor di testo struttturato con gli strumenti base necessari ad una fromattazione del testo da inserire. Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget)}

L'html editor è un widget utile alla scrittura di testo formattato, pensato per il corpo delle email. In edit è possibile modificare e formattare il testo, mentre in visualize viene mostrato il testo formattato.

Il widget utilizza i parametri comuni

^{(torna a elenco widget)}
Analogo allo widget NORMAL, ma strutturato per il controllo raffinato dell'input. Permette di verificare il testo inserito tramite Espressioni regolari, e di modificare il testo appena inserito con trasformazioni in maiuscolo, minuscolo, ecc. Oltre ai parametri comuni, i parametri specifici sono i seguenti:

   function(constraints){ 
       if(true) return "\\d{5}"; 
       return "\\d{10}"; 
   }

^{(torna a elenco widget)}

Il widget si applica ai campi di tipo geometry, Point. Permette di gestire la visualizzazione, l'inserimento e la modifica, e di effettuare lo zoom su mappa o su planimetria, utilizzando il visualizzatore 2D.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

(*) 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..).

^{(torna a elenco widget)}

Il widget si applica ai campi di tipo geometry, Poligono. Permette di gestire la visualizzazione, l'inserimento e la modifica, e di effettuare lo zoom su mappa o su planimetria, utilizzando il visualizzatore 2D.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

(*) 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..).

^{(torna a elenco widget)}

Il widget si applica ai campi di tipo geometry, Polilinea. Permette di gestire la visualizzazione, l'inserimento e la modifica, e di effettuare lo zoom su mappa o su planimetria, utilizzando il visualizzatore 2D.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

(*) 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..).

(da finire) Oltre ai parametri comuni, i parametri specifici sono i seguenti:

(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.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

(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 parametri comuni, i parametri specifici sono i seguenti:

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

{
	"Label 1": "uno",
	"Label 2": 2,
	"Label 3": true
}

A sinistra il JSON di origine in un widget codeEditor, e a destra la relativa rappresentazione labelValueJsonWidget.

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, 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 html (nel value del primo livello del JSON ammessi solo valori stringa, contenenti codice html)

Esempio semplificato Configurazione con metadati minimale per un tipo di dato stringa.

{
	"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"
			}
		}
	}
 
}

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.

Relativo dato JSON comprensivo di metadati

{
	"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": "#. €"
					}
				}
			}
		}
	}	
}

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.

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);

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.

Questo plugin nasce per definire in Geoweb delle classi 'gerarchizzate' o 'classificate'. In particolare tali classi servono per descrivere degli oggetti che vanno inventariati e gestiti allo stesso modo tra loro, ma possono essere di diversa natura, e quindi avere una definizione di attributi diversa una dall'altra.

Tipicamente, in una azienda, classi di questo genere sono utili a descrivere l'elenco degli Asset che costituiscono l'inventario aziendale.

Ad esempio fanno parte degli Asset aziendali le apparecchiature informatiche, gli arredi, le auto aziendali ecc. Pur essendo quindi un insieme di oggetti che costituiscono nel loro insieme il patrimonio aziendale, questi oggetti hanno natura diversa e quindi caratteristiche diverse tra loro che occorre annotare e gestire.

Quindi la struttura della 'Classificazione' permette di raggruppare tali oggetti in Famiglie e SottoFamiglie (gerarchie di oggetti), e ognuna delle sottofamiglie può avere una serie di attributi che la caratterizzano per la sua particolare Natura (RAM del computer, piuttosto che cavalli fiscali dell'auto aziendale, ecc.).

Il plugin quindi fornisce una serie di componenti, quali un componente di Menu (leafItemClassificationMenu) che permette di sfogliare la gerarchia delle famiglie, di definire nuove famiglie e definire/modificare il set di attributi variabili. Il plugin mette a disposizione inoltre dei Widget che permettono di classificare un nuovo oggetto, modificarne uno esistente, visionare e inserire dati negli Attributi Variabili.

Di seguito il collegamento alla prima analisi di modello dati su cui è stato basato il plugin. classificazione_datamodel_vintage.pdf

^{(torna a elenco widget enterprise)}

Questo widget permette di definire la famiglia di appartenenza dell'Oggetto che si sta inserendo o modificando. Permette di scegliere la Famiglia grazie a un componente che fa sfogliare il tree su una pop-up.
In visualizzazione che ne presenta la gerarchia definita

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget enterprise)}

(to do)

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget enterprise)}

(to do)

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget Enterprise)}
Il plugin Workflow contiene le funzionalità di interfacciamento al motore Activiti. In questa sezione vengono descritti i soli widget, ma tutto l'argomento è trattato diffusamente nel capitolo workflow.

^{(torna a elenco widget Enterprise)}

Questi nuovi widget nascono dall’esigenza di rendere evidente all’utente tutti i processi in qualche maniera collegati ad una specifica entità in Geoweb (siano essi lanciabili, in corso o già terminati). Se questa entità potrà essere del tutto arbitraria, di fatto lo sviluppo dei nuovi componenti è stato dettato dalla necessità di esplicitare tutti i processi in qualche modo collegati a specifiche istanze dell’entità digital document (oggetto di uno sviluppo parallelo). Date le specifiche funzionali richieste, si è deciso di racchiudere il loro soddisfacimento nel widget gwRelatedProcessesWidget. Questo widget va a riunire e potenziare le funzionalità già implementate nei widget gwTasksWidget e gwArchivedProcessesWidget, che vengono ancora supportati, ma di fatto ne viene scoraggiato l’uso.

Questo widget rende fruibili per l’utente, in maniera semplice e concentrata in un unico cruscotto, le seguenti funzionalità relative all’oggetto collegato:

• Possibilità di avviare istanze di processo;
• Eventuale visualizzazione delle istanze di processo in corso;
• Eventuale visualizzazione delle istanze di processo concluse.

Il widget è renderizzato con un contenitore esterno simile all'AccordionContainer dojo, che ospita due sottosezioni:

• Sezione processi avviabili/in corso. Questa ospiterà una lista di oggetti eterogenei. Il numero, la tipologia e l’ordinamento di tali oggetti è configurabile tramite in un apposito file .groovy (vedi sotto), che viene valutato a runtime e permette di cambiare dinamicamente l’interfaccia, in base a tutta una serie di parametri. Questi oggetti possono essere di due tipologie:
  • Button per avviare nuove istanze di processo (eventualmente personalizzabile da file .groovy in icona e label);
  • Blocco con informazioni sull’istanza di processo in corso (label ed icona personalizzazbili in groovy), e il(i) task corrente(i). Al click su(i) task in corso verrà aperta la corrispettiva scheda gwTaskDetail con, a seconda dei casi, la possibilità di completare o richiedere l’esecuzione del task o di poter solo visualizzarlo.
    Il blocco presenta la possibilità di essere espanso e mostrare ulteriori informazioni:
    • Eventuale button per cancellare l’istanza di processo in corso (la cui visibilità icona e label è configurabile da file .groovy). Da notare che a monte verrà comunque verificato l’apposito permesso statico ‘Cancella istanza di processo’, legato a gruppo ed ambito, configurabile nel gwAdmin). L’annullamento dell’istanza di processo comporterà la ricomparsa del button per avviare il processo;
    • Lista delle attività (task) passate già eseguite, in ordine di data completamento decrescente. Vengono visualizzate le seguenti informazioni:
      • nome attività;
      • data di completamento;
• Sezione dei processi conclusi ospiterà i processi conclusi.

Il widget permette di avviare più tipologie di processo alla volta, ma vincola l’esecuzione di una sola istanza di processo alla volta per una data tipologia (processDefinitionKey). Sta all’utente configuratore specificare nell’implementazione del file .groovy se un’eventuale istanza di processo in corso di una certa tipologia, debba inibire anche la possibilità di avviare un’istanza di processo di un’altra tipologia, o meno. A tale scopo viene fornita come parametro nel metodo del .groovy anche la lista delle istanze di processo:

List<ProcessInstance> processInstanceList

Il widget tiene sincronizzate nelle istanze di processo generate in Activiti le seguenti variabili di processo, con nome fisso:

• gw_related_entity_id, String, il contenuto del campo dichiarato keyColumn per la classe;
• gw_related_entity_name, String, il contenuto del campo con name entityCodColumnName specificato nel file .groovy, oppure, in sua assenza, il contenuto del campo configurato come nameColumn per la classe.

E’ obbligatorio per l’utente configuratore la creazione, nella tabella e relativa gwClass di processo, dei campi gw_related_entity_id e gw_related_entity_name e relativi gwAttribute in modo da averli sincronizzati in automatico e poterli eventualmente usare in ogni momento per eseguire delle query. Volutamente non verranno riversate fra le variabili di processo tutte le variabili della entità collegata (es: digital document). Sia per evitare un inutile sovraffollamento, che per evitare possibili collisioni dei nomi usati nella classe collegata con quelli propri delle variabili di processo (tipo generici start_date, etc..). Se necessario, nei groovy di processo si potranno recuperare tutte le informazioni della classe collegata tramite gw_related_entity_id o gw_related_entity_name.

  Es. (postgres)
  ALTER TABLE test_gw44data.aim_wpi_asset_assignto ADD COLUMN gw_related_entity_id character varying(250);
  ALTER TABLE test_gw44data.aim_wpi_asset_assignto ADD COLUMN gw_related_entity_name character varying(250);

PARAMETRI

Esempio di configurazione xml widget:

<gwRelatedProcessesWidget>
    …
    <entityCodColumnName></entityCodColumnName>
    <entityStatusColumnName></entityStatusColumnName >
    <groovy>TestGwRelatedProcessesWidgetConfigImpl </groovy>
</gwRelatedProcessesWidget > 

Esempio configurazione groovy:

import org.activiti.engine.runtime.ProcessInstance;
import com.geowebframework.workflowplugin.model.widget.GwRelatedProcessesWidgetConfigImpl;
public class TestGwRelatedProcessesWidgetConfigImpl extends GwRelatedProcessesWidgetConfigImpl {
    public List< Map<String,Object>> getRelatedProcessDefinitionList (
        String entityId,
        String entityName,
        String entityStatus, 
        String gwUser, 
        String gwGroup, 
        Map<String, Object> gwActiveScopesMap, 
        List<ProcessInstance> processInstanceList
    ){
	return [
		 [
			processDefinitionKey: "",
			message: "", //required if necessary
			isStartable: true, //default true
			startLabel: "",	//optional
			startIconClass: "",	//optional
			startIconImage: "",	//optional
			runningIsVisible: true,	//optional, default true
			runningLabel: "",	//optional
			runningIconClass: "", //optional
			runningIconImage: "", //optional
			isCancelable: true, //optional
			cancelLabel: "", //optional
			cancelIconClass: "", //optional
			cancelIconImage: "", //optional
			archivedIsVisible: true, //optional, default true
			processCodRelatedEntityVariableName: "" //optional, default provided
		]
	]
    }
}

^{(torna a elenco widget Enterprise)}

Questi nuovi widget nascono dall’esigenza di rendere evidente all’utente tutti i processi in qualche maniera collegati ad una specifica entità in Geoweb (siano essi lanciabili, in corso o già terminati). Se questa entità potrà essere del tutto arbitraria, di fatto lo sviluppo dei nuovi componenti è stato dettato dalla necessità di esplicitare tutti i processi in qualche modo collegati a specifiche istanze dell’entità digital document (oggetto di uno sviluppo parallelo).

Questo widget si preoccuperà di mostrare all’utente una griglia contente tutte le istanze di processo che si sono concluse e che hanno riguardato l’entità collegata.

PARAMETRI

Esempio configurazione xml widget:

<gwArchivedProcessesWidget>
    …
    <entityCodColumnName></entityCodColumnName>
    <entityStatusColumnName></entityStatusColumnName >
    <groovy>generic_document_gwArchivedProcessesWidgetConfigImpl</groovy>
</gwArchivedProcessesWidget> 

Esempio configurazione groovy:

import com.geowebframework.workflowplugin.model.widget.GwArchivedProcessesWidgetConfigImpl;
 
public class TestGwArchivedProcessesWidgetConfigImpl extends GwArchivedProcessesWidgetConfigImpl {
 
	public List<Map<String,Object>> getArchivedProcessDefinitionList(String entityId, String entityName, String entityStatus, String gwUser, String gwGroup, Map<String, Object> gwActiveScopesMap){
		return [
			[ 
				processDefinitionKey: 'utc_gwprocess'
			],
			[ 
				processDefinitionKey: 'utc_gwprocess_proc'
			]
		]
	}
 
}

^{(torna a elenco widget Enterprise)}

Questo nuovo widget nasce dall’esigenza di rendere evidente all’utente tutti i processi in qualche maniera collegati ad una specifica entità in Geoweb (siano essi lanciabili, in corso o già terminati). Se questa entità potrà essere del tutto arbitraria, di fatto lo sviluppo dei nuovi componenti è stato dettato dalla necessità di esplicitare tutti i processi in qualche modo collegati a specifiche istanze dell’entità digital document (oggetto di uno sviluppo parallelo).

Questo widget si preoccuperà di:

• Rendere usufruibili per l’utente, in maniera semplice e concentrata in un’unica interfaccia, tutti i comandi che permettano di innescare i vari processi necessari:
  • I comandi saranno disponibili come button contenuti nel widget, sotto la label configurata nel gwAttribute, disposti in verticale, uno sotto l’altro. Essi occuperanno in orizzontale tutto lo spazio disponibile;
  • Le definizioni di questi comandi in grado di avviare processi (startableProcessDefinition) saranno recuperate dinamicamente invocando l’esecuzione di un metodo

    List<Map<String,Object> getStartableProcessDefinitionList()

    della class java (che implementa l’interfaccia GwTasksWidgetConfigAbs) contenuta nel file configurato nel parametro groovy (vedi sotto). Queste definizioni sono state volutamente fatte ritornare da un metodo groovy (da implementare ed invocato dinamicamente), per riuscire un domani a rendere configurabili da interfaccia lato client i processi che l’utente può lanciare (Creando apposite classi di gestione in geoweb, per poi eseguire dal groovy delle query sulle tabelle delle classi al fine di recuperare le informazioni sui processi avviabili);

  • Tipicamente questi processi avranno come effetto ultimo sul documento, la variazione dello stato: il valore contenuto nella colonna status_column;
• Vincolare l’esecuzione di una sola istanza di processo (processInstance) alla volta (e quindi ovviamente una sola processDefinition):
  • Quindi all’avvio di una data istanza di processo, verrà inibita la possibilità di avviarne altre di una qualsiasi tipologia. La UI presentata non sarà più quella iniziale, ma i button per avviare i processi saranno sostituiti da un layout toolbar+griglia (sotto maggiori dettagli). Inoltre la sotto label del widget in alto, comparirà un ulteriore label indicante la tipologia di istanza di processo in corso, con il pattern ‘In Corso: ’+<gwProcessLabel>;
  • Per tutta la durata dell’esecuzione della istanza di processo dovrà essere possibile, in qualunque momento, annullare l’esecuzione dell’istanza stessa (l’annullamento potrà essere lanciato da un apposito button che comparirà sulla toolbar);
  • L’annullamento dell’istanza di processo potrà essere abilitato/disabilitato mediante implementazione del metodo

    Map<String,Object> getCancelableProcessDefinition()

    della classe .groovy (da notare che a monte verrà comunque verificato l’apposito permesso statico ‘Cancella istanza di processo’, legato a gruppo ed ambito, configurabile nel gwAdmin);

  • L’annullamento dell’istanza di processo comporterà la ricomparsa del layout del widget iniziale, con tutti i comandi dichiarati compatibili (tramite groovy) con lo stato corrente dell’entità collegata (es: digital document);
• Rendere visibili i task utente in corso e conclusi riguardanti l’eventuale istanza di processo in corso:
  • Questi verranno mostrati come record di simil griglia, disposta sotto la toolbar, dove compariranno le seguenti colonne:
    • label task;
    • data creazione task;
    • data completamento task;
  • o I record verranno ordinati mettendo in cima i task in corso seguiti da quelli completati. Come secondo criterio di ordinamento verrà usata la data di creazione dei task (desc);
  • I task in corso rispetteranno le convenzioni cromatiche tipiche delle altre liste dei processi (verde=task propri, giallo=task richiedibili, bianco= task assegnati ad altri);
  • Solo al click sui task in corso verrà aperta la corrispettiva scheda gwTaskDetail con, a seconda dei casi, anche la possibilità di completare o richiedere l’esecuzione del task;
• Tenere sincronizzate nelle istanze di processo generate in Activiti le variabili di processo gw_related_entity_id (il contenuto del campo configurato come keyColumn) e gw_related_entity_name (il contenuto del campo configurato come nameColumn) con nome fisso.
  E’ mandatorio per l’utente configuratore la creazione, nella tabella e relativa gwClass di processo, dei campi e relativi gwAttribute in modo da averli sincronizzati in automatico e poterli eventualmente usare in ogni momento per eseguire query. Volutamente non verranno riversate fra le variabili di processo tutte le variabili della entità collegata (es: digital document). Sia per evitare un inutile sovraffollamento, che per evitare possibili collisioni dei nomi usati nella classe collegata con quelli propri delle variabili di processo (tipo generici start_date, etc..). Se necessario, nei groovy di processo si potranno recuperare tutte le informazioni della classe collegata tramite gw_related_entity_id o gw_related_entity_name.

PARAMETRI

Esempio configurazione xml widget:

<gwTasksWidget>
    …
    <entityCodColumnName></entityCodColumnName>
    <entityStatusColumnName></entityStatusColumnName>
    <groovy>generic_document_gwTasksWidgetConfigImpl</groovy>
</gwTasksWidget> 

Esempio configurazione groovy:

import org.activiti.engine.runtime.ProcessInstance;
import com.geowebframework.workflowplugin.model.widget.GwTasksWidgetConfigImpl;
 
public class TestGwTasksWidgetConfigImpl extends com.geowebframework.workflowplugin.model.widget.GwTasksWidgetConfigImpl {
 
	public List< Map<String,Object>> getStartableProcessDefinitionList (String entityId, String entityName, String entityStatus, String gwUser, String gwGroup, Map<String, Object> gwActiveScopesMap){
		def res  = [] ;
 
		def definition1 = [ processDefinitionKey: "utc_gwprocess_wiz" ];
 
		def definition2 = [
			processDefinitionKey: "utc_gwprocess_proc",
			message: "utc_gwprocess_proc_start_message",
			label: "Start Process utc_gwprocess_proc (c)",
			iconClass: ""
		];
		res.add(definition1);
		if(entityStatus!="cannotValidate") res.add(definition2);
 
		return res;
	 }	
 
	 public Map<String,Object> getCancelableProcessDefinition (String processDefinitionKey, String processInstanceId, String entityId, String entityName, String entityStatus, String gwUser, String gwGroup, Map<String, Object> gwActiveScopesMap){
		return [
			 isCancelable: true
		];
	 }
}

^{(torna a elenco widget Enterprise)}
Questo plugin racchiude tutti i widget che fanno riferimento al modulo relativo al Bim Explorer. La definizione e il funzionamento generale di un singolo widget è del tutto analoga agli altri.

^{(torna a elenco widget Enterprise)}

Definisce un pulsante, collocabile sia all'interno della scheda di dettaglio che in lista, che permette di aprire un nuovo tab dove sarà visualizzata la mappa, associata al widget in questione. Al click sul pulsante viene recuperata nel database la mappa associata al valore del widget tramite una query sulla tabella gwd_layout e questa viene mostrata in un nuovo tab. Inoltre all'interno della scheda di dettaglio è stato creato un altro pulsante tramite il quale si può modificare il layout, e di conseguenza pure la mappa che viene recuperata, scegliendo fra tutte quelli disponibili nel database.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

^{(torna a elenco widget Enterprise)}

Definisce un pulsante, collocabile sia all'interno della scheda di dettaglio che in lista, che permette di selezionare e fare lo zoom sull'oggetto al quale è associato. Nel momento in cui si clicca sul pulsante, viene aperto un nuovo tab contenente una scena del Bim Explorer sulla quale sono caricati i modelli associati all'oggetto, ottenuti tramite la relazione fra il codeColumnName3D e il codeColumnRelationTableName3D. La camera sarà inizialmente impostata in modo tale da avere in primo piano l'oggetto su cui viene fatto lo zoom.

Oltre ai parametri comuni, i parametri specifici sono i seguenti:

AZIONE DI ZOOM INDIRETTO MULTIPLO
Parallelamente all’introduzione di questi due nuovi flag in fase di configurazione è stata sviluppata un’azione che permette di eseguire lo zoom selezionando più di un elemento della lista. In fase di configurazione deve essere creata una azione da porre in lista sulla toolbar, il codice dell’azione deve essere il seguente:

multipleIndirectLocalization(grid,attributeName);

I parametri in ingresso per questa funzione devono essere grid e attributeName (ovvero il nome dell’attributo su cui è configurato l’indirectLocalizationWidget)

^{(torna a elenco widget Enterprise)}

Questo plugin nasce per definire in Geoweb dei codici parlanti, ovvero codici composti di varie 'sezioni', ognuna delle quali corrisponde ad uno specifico oggetto, il cui ordine definisce una gerarchia tra gli oggetti che queste rappresentano.

Quindi la struttura del 'MnemonicCode' permette di raggruppare tali oggetti in gerarchie che ne permettono la facile organizzazione e gestione grazie agli strumenti messi a disposizione da questo plugin, quali un componente di Menu (gwMnemonicCodeSheet), che permette di visualizzare e gestire in un'unica scheda l'intera gerarchia di oggetti relativi ad un codice parlante definito in una classe, uno widget (MnemonicCodeWidget) di creazione di codici parlanti ed uno widget (MnemonicCodeSelectionWidget) che permette di effettuare una selezione da un albero gerarchico di codici parlanti. Il plugin mette a disposizione inoltre una sezione, nella configurazione (lato admin) di una classe, di creazione di un MnemonicCode al quale i vari componenti possono riferirsi. Ogni classe può avere più MnemonicCode configurati ed i singoli componenti possono fare riferimento ad uno di essi.

^{(torna a elenco widget enterprise)}

Questo widget permette di definire un codice parlante per il record in cui viene inserito. La struttura di tale codice parlante dipende dalla configurazione del MnemonicCode relativo a questo attributo.

Oltre ai parametri comuni, i parametri specifici per questo widget sono i seguenti:

^{(torna a elenco widget enterprise)}

Questo widget permette di selezionare un codice parlante per il record, scegliendolo da un albero gerarchico relativo al MnemonicCode a cui esso fa riferimento.

Oltre ai parametri comuni, i parametri specifici sono i seguenti: