gwusermanual:interface:extractor_sql_wizard:estrattore_sql_wizard [GeowebFramework]

Questa pagina è in sola lettura. Puoi visualizzare il sorgente, ma non puoi modificarlo. Contatta l'amministratore se pensi che ci sia un errore.
===== ESTRATTORE SQL WIZARD =====

Pagina dedicata al wizard della guida dell' [[gwUserManual:interface:extractor_sql:estrattore SQL]], comprensiva anche di documentazione tecnica.

Al click sul leafItem //Modelli estrazione dati//, si apre la lista dei modelli già configurati.

{{ :gwusermanual:ext_sql_1.jpg}}

Il wizard, in generale, può essere lanciato tramite l'apposita API js. Nello specifico si lancia dall'azione in toolbar //Nuovo modello di estrazione// (marker <color #ed1c24>1</color>)

{{ :gwusermanual:ext_sql_2.jpg}}


==== WIZARD 1/4 - NUOVO o MODIFICA ====
Nel primo step del wizard la prima cosa da fare è selezionare il dataset sul quale configurare il modello di estrazione.
Inoltre si può scegliere se creare un nuovo modello da zero, oppure modificare parzialmente un modello già esistente, per poi scegliere alla fine se sovrascriverlo e crearne un altro con differente nome.

{{ :gwusermanual:ext_sql_3.jpg}}


==== WIZARD 2/4 - NUOVO - scelta campi ====

{{ :gwusermanual:ext_sql_4.jpg}}

Caso NUOVO.

Nel secondo step si deve:
  * scegliere i campi da esportare
  * scegliere l'ordine delle colonne esportate
  * si può opzionalmente impostare un **alias**

I campi sono divisi in gruppi, come da convenzione di configurazione. C'è un filtro globale che opera sui vari gruppi e lavora indistintamente sia con il nome che con la label degli attributi (spazi ammessi per separare più criteri messi in AND logico).

I campi possono essere spostati singolarmente (tramite button e drag&drop), per gruppo (tramite button e drag&drop) e globalmente (tramite button in toolbar grid). Per il drag&drop è supportata la selezione multipla (sia con CTRL, che con SHIFT).

Le proprietà movimentate tramite i comandi verranno sempre aggiunte in coda alla lista. 

Utilizzando i comandi di spostamento massivi verrà sempre rimosso l'eventuale filtro impostato.

Una volta associato un campo a quelli da esportare, se ne può variare l'ordine di esportazione, tramite drag&drop.

Una volta associato un campo a quelli da esportare, si può impostare un alias alternativo alla label suggerita (quella della gwClass), che verrà utilizzata nelle fasi successive.

Al click sui button 'chiudi' verrà visualizzato un button di conferma.

Al click sul button 'indietro' e sul button 'avanti' e successivo ritorno allo step corrente, verrà ripristinato lo stato impostato.

{{ :gwusermanual:ext_sql_5.jpg}}

=== Legenda funzionalità ===

  - titolo
  - descrizione sintetica step + tooltip descrizione estesa
  - filtro campo inter-gruppo
  - accordion gruppo campi (espandibile/collassabile)
  - button 'Aggiungi tutti (gruppo)'
  - singolo campo
  - nome campo
  - label campo
  - button 'Aggiungi'
  - button in toolbar grid 'Aggiungi tutti'
  - button in toolbar grid  'Rimuovi selezionati'
  - button su singolo campo aggiunto 'Rimuovi singolo'
  - colonna indicatore ordine campo
  - colonna per impostare alias alternativi alle label dei campi
  - button indietro
  - button avanti
  - button chiudi

{{ :gwusermanual:ext_sql_6.jpg}}


==== WIZARD 3/4 - NUOVO - scelta criteri di filtro ====

{{ :gwusermanual:ext_sql_7.jpg}}

Impostare i criteri per il modello di estrazione (filtri) agendo sul filtro incrementale, configurando per ogni filtro: proprietà, operatore ed eventualmente uno o più valori. 
Ogni filtro aggiunto può essere successivamente modificato o rimosso. 
I filtri verranno applicati automaticamente. 
Eventuali filtri non corretti, o non completi, verranno notificati all'utente e non saranno applicati alla preview.

Sulla toolbar della preview si può già lanciare l'estrazione dei dati, che da questo step verrà sempre eseguita **con le configurazioni di campi e filtri correnti**.

Al click sui button 'chiudi' verrà visualizzato un button di conferma.

Al click sul button 'indietro' e sul button 'avanti' e successivo ritorno allo step corrente, verrà ripristinato lo stato impostato.

=== sezione stato ====
La sezione 'stato' informa sull'effettiva applicazione dei filtri correnti (e validi) alla preview. 
La sezione 'stato' inoltre notifica la presenza di filtri non validi e quando il set di filtri impostato è (temporaneamente) differente da quello già applicato alla preview. Elenco stati:
  * **applicato** quando i criteri di filtro validi sono correntemente applicati alla griglia di preview
  * **in applicazione** quando i criteri di filtro validi sono in corso di applicazione alla griglia di preview
  * **non applicabile** nella modalità avanzato, il filtro non risulta applicabile per problemi alla struttura dei filtri 
  * **parzialmente non valido** alcuni dei filtri non validano o non sono completi (può mancare ed non essere valido il campo, ll valore, etc..). Si procede comunque all'applicazione dei filtri validi
  * **modificato** quando il filtro corrente è differente da quello applicato alla grid di preview

=== switch distinct ====
Agendo sullo switch 'distinct', si abilità l'utilizzo dell'analogo comando SQL nell'esecuzione della query. In pratica per i criteri scelti non si ammettono nel risultato dell'esportazione record duplicati. Da notare che si possono quindi ottenere un numero minore di record di aquelli che si avrebbero avuti aggiungendo più campi nell'estrazione, i quali avrebbero denotato le differenze fra i record.

=== switch avanzato ===
Agendo sullo switch 'avanzato', si abilitano maggiori possibilità di configurazione, potendo agire anche sulla 'condizione' e sulle parentesi (di apertura '(' e di chiusura ')'), utili per poter innestare a piacimento i filtri, determinandone l'ordine di valutazione.
Nella modalità 'avanzato' si abilita una sezione 'struttura' che notifica la coerenza delle parentesi impostate tramite il colore verde. 
Disabilitando la modalità 'avanzato', verranno rimosse dai filtri tutte le eventuali condizioni 'OR' e le parantesi impostate.

=== expand/collapse floatingPane ===
Da notare che lo step, come il due, viene aperto in un floating Pane a tutto schermo, che può essere collassato tramite l'apposito comando in altro a destra vicino al 'chiudi' X.

=== Legenda funzionalità ===

  - titolo
  - descrizione sintetica step + tooltip descrizione estesa
  - button expand/collapse floatingPane
  - button chiudi floatingPane
  - colonna campo criterio di filtro
  - colonna operatore criterio di filtro
  - colonna valore(i) criterio di filtro
  - switch distinct
  - switch avanzato
  - area stato
  - griglia preview
  - button in toolbar grid 'Estrazione diretta'
  - button in toolbar grid 'rimuovi criteri di filtro'
  - button 'indietro'
  - button 'avanti'
  - button 'chiudi'

{{ :gwusermanual:ext_sql_8.jpg}}


==== WIZARD 4/4 - NUOVO - assegnazione nome  ====

Questo step prevede l'assegnazione di un nome al nuovo modello di estrazione.

Al click sui button 'chiudi' verrà visualizzato un button di conferma.

Al click sul button 'indietro' e successivo ritorno allo step corrente, verrà ripristinato lo stato impostato.

{{ :gwusermanual:ext_sql_9.jpg}}



==== WIZARD 1/4 - MODIFICA ====

Utilizzare il //radiobutton// per abilitare il //select// di scelta di un modello estrazione esistente. Alla scelta si abilita il button 'avanti'

{{ :gwusermanual:ext_sql_10.jpg}}




==== WIZARD 2/4 - MODIFICA - scelta campi ====

Caso MODIFICA . Si apre una UI del tutto simile a quella del caso NUOVO, ma già con degli attributi selezionati, con relativo ordine ed eventuali alias.


==== WIZARD 3/4 - MODIFICA - scelta criteri di filtro ====

Caso MODIFICA. Si apre una UI del tutto simile a quella del caso NUOVO, ma già con dei filtri impostati.

{{ :gwusermanual:ext_sql_12.jpg}}

Nel caso il modello di estrazione utilizzi un filtro avanzato, la UI si presenterebbe con la relativa modalità attivata.

{{ :gwusermanual:ext_sql_14.jpg}}


==== WIZARD 4/4 - MODIFICA - salva o crea nuovo  ====

Caso MODIFICA. In questo step si può decidere se salvare i cambiamenti sul modello di estrazione di partenza o crearne uno totalmente nuovo, con relativo nome.

{{ :gwusermanual:ext_sql_15.jpg}}


==== WIZARD - scorciatoie  ====

Nella lista dei modelli di estrazione sono presenti varie scorciatoie al wizard standard, denotate dai marker rossi.
{{ :gwusermanual:ext_sql_2.jpg}}

=== Estrazione diretta  ===

Al click sulla gwAction in lista icona 'excel' (marker <color #ed1c24>2</color>), viene lanciata l'estrazione del file .xlsx, cosi come da modello di estrazione.

=== Preview Estrazione ===

Al click sulla gwAction in lista icona 'search' (marker <color #ed1c24>3</color>), viene aperto il wizard nello step 3. senza possibilità di andare avanti/indietro nel wizard.

{{ :gwusermanual:ext_sql_17.jpg}}

=== Modifica Estrazione ===

Al click sulla gwAction in lista icona 'edit' (marker <color #ed1c24>4</color>), viene aperto il wizard nello step 1 con select dataset e modelli di estrazione bloccati, con la sola possibilità di andare avanti nel wizard, che poi proseguirà come una normale modifica.

{{ :gwusermanual:ext_sql_18.jpg}}