QualiWare Form Designer è uno strumento che permette di configurare facilmente le maschere di inserimento dati per i documenti e per filtrare una query.
Questa funzione è utilizzabile:
- dall’Amministratore di Sistema per tutte le categorie documentali;
- dal Configuratore di una categoria documentale di primo livello (può personalizzare la maschera d’immissione dati per tutte le relative sottocategorie di quella categoria).
Introduzione
Il Form Designer può essere utilizzato per:
- Definire la maschera d’inserimento dati per una categoria documentale.
Aprire la scheda di Configurazione Gestione Documenti per la categoria documentale desiderata, entrare nel tab Form Designer e cliccare su Form Designer vers. Desktop o Form Designer vers. Mobile a seconda di quale versione si vuole modificare; - Creare un form di filtraggio per una particolare query scritta tramite l’Esperto SQL.
Per creare/modificare una maschera di filtraggio, aprire il rispettivo file SQL all’interno dell’editor di QualiWare e cliccare sul pulsante Form Designer.
Interfaccia del Form Designer
La finestra principale del Form Designer si presenta come in figura:
e si suddivide in quattro sezioni:
- Toolbar comprensivo dei comandi:
- Salva, salvare il lavoro eseguito;
- Importa e Esporta, permettono rispettivamente d’importare una configurazione esistente oppure esportare quella corrente;
- Annulla e Ripeti, permettono rispettivamente di revocare oppure ripetere un’azione;
- Effettuare azioni massive sugli elementi;
- Test, aprire l’anteprima delle modifiche;
- Elenco degli oggetti inseribili all’interno del form;
- Riquadro di design, area di creazione del form;
- Elenco delle proprietà dell’elemento selezionato. Nel caso siano selezionati più elementi, verranno mostrate solo le proprietà comuni.
Editor di codice
Le procedure e gli eventi richiedono necessariamente la scrittura di uno script. Il Form Designer mette a disposizione un piccolo editor basato su Visual Studio Code.
L’editor è provvisto di:
- controllo sintassi per VB.NET, C# e Python;
- widget per inserimento comandi;
- IntelliSense.
Al momento non è ancora presente un controllo sintassi per JavaScript.
Cliccando col tasto destro del mouse sull’editor di testo è possibile effettuare azioni sul codice o modificare alcune impostazioni.
Progettazione del form
Sfruttando le funzionalità descritte sopra, è possibile disegnare il form in base alle proprie necessità.
Aspetto importante è d’assegnare un DataLink ad ogni campo modificabile del form.
Nel caso di maschere relative a documenti, il DataLink rappresenta il collegamento tra l’elemento di interfaccia e un campo della tabella DOCUMENT del database.
Nel caso di form per il filtraggio di una query, i valori utilizzati come DataLink dovranno essere scritti come parametri SQL all’interno del testo dell’interrogazione. Ad esempio: se ad un particolare campo di filtraggio è stato assegnato il DataLink CUSTOM1, il testo della query dovrà necessariamente avere una stringa del tipo where CODICE=:CUSTOM1.
Per approfondire il funzionamento del Form Designer consultare la Guida in linea alle sezioni riguardanti:
- elenco degli Oggetti del Form Designer;
- Eventi;
- Proprietà comuni degli oggetti;
- Debug di un form o di uno script.
Esportare/Importare una configurazione
Tramite i pulsanti della toolbar Importa / Esporta si può esportare la configurazione del form in formato file XML. Il file si riferisce esclusivamente alla struttura del form e può essere utilizzabile all’interno del Form Designer sia per le query sia per le categorie documentali.