WGDESIGNER Manuale Utente

WGDESIGNER Manuale Utente Pagina 1

SOMMARIO 1 Introduzione... 3 1.1 Requisiti hardware e software... 3 2 Configurazione... 3 3 Installazione... 4 3.1 Da Webgate Setup Manager... 4 3.2 Da pacchetto autoestraente... 5 4 Avvio dell applicazione... 6 4.1 Login... 6 4.2 Selezione formato / formati... 7 5 Interfaccia... 8 5.1 Area di lavoro... 8 5.1.1 Anteprima formati... 8 5.1.2 Interazione con mouse... 9 5.1.3 Interazione con tastiera... 10 5.2 Pannello dei formati... 11 5.3 Pannello dei campi... 12 5.4 Pannello delle proprietà... 13 5.4.1 Modifica di attributi... 13 5.4.2 Wizard di compilazione... 14 5.4.3 Eliminazione attributi... 14 5.5 Ribbon dei comandi... 15 5.5.1 Modifica... 15 5.5.2 Aggiunta / modifica attributi... 15 5.5.3 Creazione e Trasformazione campi... 16 6 Gestione degli indicatori... 17 7 Salvataggio... 18 8 Distribuzione delle personalizzazioni... 19 9 Eliminazione delle personalizzazione... 20 Appendice: file standard, file custom... 21 Pagina 2

1 INTRODUZIONE Webgate Designer è il prodotto progettato e realizzato per consentire la creazione e la personalizzazione in maniera visuale delle Vostre interfacce grafiche. L applicativo rientra nella categoria degli editor WYSIWYG: consente di lavorare direttamente sull anteprima delle videate. L interazione con l utente permette una facile manipolazione dei video, così come l aggiunta e la manutenzione di controlli Webgate avanzati. 1.1 Requisiti hardware e software Personal computer - S.O. 7, 8, 8.1 (Windows 8 RT non è supportato), 10 - RAM come richiesto dal sistema operativo in uso, minimo consigliato 2Gb iseries - Webgate release 8 2 CONFIGURAZIONE La configurazione del prodotto è molto semplice, prevede esclusivamente la profilazione degli utenti da utilizzare con WGDesigner. L abilitazione per utente si trova all interno di WebgateCVT, nella configurazione Run Time dell utente, scheda Add-on. E sufficiente abilitare il flag Modalità Designer. Pagina 3

3 INSTALLAZIONE WGDesigner è un applicativo distribuito con il sistema Webgate Setup Manager e tramite pacchetto di installazione autoestraenti. 3.1 Da Webgate Setup Manager Collegandosi ad un iseries con release 8 la procedura è la seguente: - Avviare Webgate Setup Manager - Confermare la richiesta dei privilegi di amministratore - Effettuare il login ad un iseries con Webgate release 8 - Scorrere nella lista fino a trovare il prodotto Webgate400 V8.00 WYSIWYG Designer - Applicare la spunta accanto al nome del prodotto - Cliccare il pulsante Install (Upd.) ed attendere il completamento dell installazione - Cliccare il pulsante Exit Pagina 4

3.2 Da pacchetto autoestraente Se avete a disposizione un pacchetto di installazione autoestraente la procedura è la seguente: - Lanciare il pacchetto di installazione - Seguire le istruzioni a video fino al termine della procedura - Cliccare il pulsante Finish Pagina 5

4 AVVIO DELL APPLICAZIONE 4.1 Login Webgate WGDesigner è uno strumento che lavora con l iseries di riferimento online, primo passo all apertura è quindi la schermata di login. Questa uguale in tutto e per tutto a quella del client Webgate R8 prevede la modalità compatta e quella estesa, necessaria per impostare la porta di connessione nel caso in cui il server sia configurato per utilizzare la modalità sicura avanzata. L iseries a cui mi collego è la macchina su cui effettuerò le personalizzazioni. Effettuata una prima connessione al proprio iseries per i collegamenti successivi è sufficiente inserire la password. La modalità estesa si attiva cliccando il logo dell applicazione all interno della schermata di login. Se l iseries a cui ci si collega è raggiungibile solo con la modalità a sicurezza avanzata introdotta nella release 8 di Webgate è necessario specificare la porta di connessione e spuntare il lucchetto accanto al campo della porta. Pagina 6

4.2 Selezione formato / formati La videata di selezione dei formati rappresenta il punto di accesso a Webgate WGDesigner. Suddivisa in 3 parti presenta: - Campi di inserimento libreria e nome display file - Lista dei formati esistenti per il display file selezionato - Lista delle personalizzazioni per i formati selezionati - Inserire il nome della libreria contenente i file video Webgate da personalizzare - Inserire il nome esatto del display file da personalizzare (lo si trova nella status bar del client Webgate a programma avviato) - Selezionare il formato, i formati o la combinazione di formati da personalizzare (utilizzare il mouse, la tastiera ed i tasti CTRL e / o SHIFT per effettuare selezioni multiple) - Nella lista delle personalizzazioni selezionare la combinazione di personalizzazioni da modificare oppure inserire la chiave di personalizzazione a mano negli appositi campi; se la combinazione inserita non esiste verrà creata - Cliccare il pulsante personalizza Per maggiori informazioni sulle chiavi di personalizzazione, il loro utilizzo ed il loro impatto sugli utenti dell applicazione vedere l approfondimento in appendice. Pagina 7

5 INTERFACCIA 5.1 Area di lavoro 5.1.1 Anteprima formati All interno dell area di lavoro sono caricati tutti i formati selezionati durante l avvio; la visualizzazione mostra tutti i campi attivi a video senza alcun indicatore. L anteprima a video contiene anche tutte le descrizioni statiche degli elementi ma non contiene quelle valorizzate a programma, così come i contenuti. 5.1.1.1 Dimensione dell anteprima All interno dell area di lavoro lo spazio dedicato alla resa del video Webgate è una stima dello spazio massimo che ci sarebbe all interno del client Webgate massimizzato su uno schermo ad una data risoluzione. E possibile modificare la dimensione dello spazio di anteprima con il pulsante Dimensione sulla ribbon. Pagina 8

5.1.2 Interazione con mouse All interno dell area di lavoro spostando il puntatore del mouse sopra gli elementi questi vengono evidenziati, in particolare vengono evidenziati: - in rosso i formati - in azzurro i campi 5.1.2.1 Selezione (singola e multipla) Cliccando un campo o un formato questo viene selezionato. E possibile vedere quale elemento sarà selezionato al momento del click guardando quale elemento è evidenziato. Tenendo premuto il pulsante SHIFT mentre si clicca su un campo si aggiunge un campo alla selezione corrente. Tenendo premuto il pulsante CTRL mentre si clicca su un campo si cambia il suo stato di selezione (seleziona se non lo è, deseleziona se è selezionato); la funzione è attiva anche per selezioni multiple. E possibile effettuare una selezione multipla anche tracciando un rettangolo di selezione attorno ai campi da selezionare; la funzione ricerca i campi all interno del primo formato incluso nel rettangolo di selezione. Per tracciare un rettangolo di selezione cliccare con il pulsante sinistro del mouse in un area vuota e tenendolo premuto spostare il mouse fino ad identificare il rettangolo di selezione desiderato. 5.1.2.2 Spostamento (singolo e multiplo) Senza premere i pulsanti SHIFT e CTRL tenere premuto il tasto sinistro del mouse su uno dei campi selezionati, quindi tenendolo sempre premuto spostare il mouse fino ad avere riposizionato la selezione come desiderato; rilasciare il tasto sinistro del mouse per confermare la nuova posizione; oppure premere il pulsante ESC per annullare l operazione in corso. 5.1.2.3 Ridimensionamento Quando un campo o un formato ridimensionabile è selezionato vengono disegnati attorno ad esso dei simboli per il ridimensionamento. Senza premere i pulsanti CTRL e SHIFT tenere premuto il tasto sinistro del mouse su uno di questi simboli, quindi tenendolo sempre premuto spostare il mouse fino ad avere ridimensionato il soggetto come desiderato; rilasciare il tasto sinistro del mouse per confermare la nuova dimensione; oppure premere il pulsante ESC per annullare l operazione in corso. Pagina 9

5.1.3 Interazione con tastiera 5.1.3.1 Selezione Selezionato un formato la combinazione di tasti CTRL + A seleziona tutti i campi contenuti, se tutti i campi sono già selezionati CTRL + A li deseleziona tutti. Selezionato un campo è possibile passare al successivo o al precedente con i tasti INVIO, TAB e SHIFT + TAB. 5.1.3.2 Spostamento Selezionati uno o più campi le frecce direzionali (SU, GIU, SINISTRA, DESTRA) effettuano l operazione di spostamento di una riga / colonna per volta. Selezionato un formato e nessun campo al suo interno le frecce direzionali spostano il formato. Se nessun formato e nessun campo sono selezionati le frecce direzionali non hanno effetto. 5.1.3.3 Nascondi campo Con uno o più campi selezionati il tasto CANC ha l effetto di applicare l attributo nascondi e quindi di togliere dal video i campi selezionati. 5.1.3.4 Taglia, Copia, Incolla Con uno o più campi selezionati CTRL + X taglia i campi selezionati. L effetto è equivalente all operazione Nascondi campo con la differenza che i campi tagliati possono essere incollati successivamente. Con uno o più campi selezionati CTRL + C copia i campi selezionati, questi possono poi essere incollati con l apposito comando. Il comando di copia si richiama dall area di lavoro con la combinazione CTRL + V. L effetto è una duplicazione dei campi copiati in posizione sfasata di una riga ed una colonna rispetto alla loro posizione. I campi così creati possono essere manutenuti come gli altri campi a video. E possibile incollare solo i campi di output. 5.1.3.5 Annulla, Ripeti Tutte le operazioni eseguite vengono memorizzate all interno di una lista consultabile nel pannello Lista modifiche fino al salvataggio delle stesse o alla chiusura dell applicazione. Per annullare un operazione apportata utilizzare la combinazione CTRL + Z. Per ripetere un operazione precedentemente annullata utilizzare la combinazione CTRL + Y. Con il salvataggio delle modifiche apportate la lista delle modifiche correnti viene ripulita e pertanto non è possibile accedere ai comandi annulla e ripeti per le operazioni svolte precedentemente al salvataggio. 5.1.3.6 Editazione in linea Per modificare il testo a video di un campo statico (attributo Webgate 101) è sufficiente selezionare il campo e digitare il testo; l anteprima è immediata. Confermare il testo con il tasto INVIO o selezionando un altro campo. L operazione si applica con un solo campo selezionato. Pagina 10

5.2 Pannello dei formati Il pannello dei formati contiene la lista dei formati correntemente caricati (quelli selezionati all avvio dell applicazione) e ne consente la rapida selezione a video. Per selezionare un formato cliccarne il nome nella lista. Con il focus sulla lista è possibile selezionare i formati utilizzando le frecce SU e GIU ; usate in combinazione con il tasto SHIFT o con il tasto CTRL consentono la selezione multipla secondo l operatività standard di Microsoft Windows. Pagina 11

5.3 Pannello dei campi Il pannello dei campi contiene la lista dei campi contenuti nel formato selezionato (anche non visibili) e ne consente la rapida selezione a video. Per selezionare un campo cliccarne il nome nella lista. Con il focus sulla lista è possibile selezionare i campi utilizzando le frecce SU e GIU ; usate in combinazione con il tasto SHIFT o con il tasto CTRL consentono la selezione multipla secondo l operatività standard di Microsoft Windows. Pagina 12

5.4 Pannello delle proprietà Il pannello delle proprietà contiene la lista degli attributi applicati ai soggetti selezionati e ne consente la modifica. Se il soggetto selezionato è singolo tutti i suoi attributi sono visibili e modificabili nella lista delle proprietà; se i soggetti selezionati sono più d uno la lista contiene solamente gli attributi in comune a tutti gli oggetti selezionati. 5.4.1 Modifica di attributi Ogni attributo è rappresentato da una riga composta da: - Nome attributo - Indicatori (regola di attivazione dell attributo) - Valore Modificare il valore o gli indicatori per l attributo di interesse quindi premere il pulsante Applica. A seconda dei valori compatibili con il tipo di attributo in oggetto la riga può presentare una casella di testo per l inserimento di stringhe piuttosto che una check box o una combo box con una serie di valori fissati a programma. Pagina 13

5.4.2 Wizard di compilazione Per gli attributi con una sintassi complessa WGDesigner prevede delle finestre di facilitazione per assistere l utente nell operazione di compilazione del campo valore. Gli attributi per i quali è prevista questa funzionalità sono contrassegnati dall icona accanto al campo valore. Utilizzo: - Cliccare l icona - Compilare la finestra specializzata che appare a video - Chiusa la finestra specializzata cliccare il pulsante Applica all interno del pannello delle proprietà per confermare le modifiche apportate 5.4.3 Eliminazione attributi Su ogni attributo eliminabile è prevista l icona accanto al campo valore. Utilizzo: - Cliccare l icona - Confermare la scelta - La riga di attributo viene disabilitata, ad indicare che l attributo verrà eliminato se si applicano le modifiche in corso - Cliccare il pulsante Applica all interno del pannello delle proprietà per confermare l eliminazione Pagina 14

5.5 Ribbon dei comandi 5.5.1 Modifica E la barra degli strumenti principale, quella visibile sin dall apertura dell applicazione. Contiene i comandi generici, che influiscono sull area di lavoro. La ribbon Modifica è composta da: - Apri display file un nuovo display / formato - Salva personalizzazione le modifiche apportate a quello correntemente aperto - Copia i campi selezionati equivalente a CTRL + C - Incolla i campi copiati equivalente a CTRL + V - Rimuovi elemento (il campo o i campi) selezionati equivalente a CANC - Seleziona tutto i campi nel formato selezionato - Deseleziona tutto i campi nel formato selezionato - Annulla equivalente a CTRL + Z - Ripeti l ultima operazione annullata equivalente a CTRL + Y - Visualizza i pannelli flottanti spuntati - Indicatori gestisce gli indicatori attivi nella visualizzazione sottostante (default nessuno) - Dimensione imposta la dimensione dell area di lavoro - Lingua per impostare la lingua in uso nell interfaccia di WGDesigner 5.5.2 Aggiunta / modifica attributi La ribbon Campi contiene gli attributi che agiscono sui campi e ne permette l applicazione. Cliccando un comando sulla ribbon un attributo questo viene applicato a tutti i campi selezionati; nel caso in cui l attributo non sia presente sul campo viene aggiunto, nel caso in cui esista già non viene fatto nulla. Se il comando attributo è già valorizzato (ad es. attributi di visualizzazione, colore) oppure prevede una Wizard di compilazione (ad es. font) questo viene aggiunto se non esiste oppure modificato se esiste già. Gli attributi da qui creati hanno sempre la regola indicatori vuota; si considera che l attributo esiste già sul campo se oltre ad essere lo stesso ha la regola degli indicatori vuota. E infatti possibile aggiungere lo stesso attributo con regole di indicatori differenti per condizionarne l applicazione da programma. Per una descrizione degli attributi e delle loro regole di applicazione fare riferimento al Manuale del compilatore Webgate (Webgate converter tutorial). Pagina 15

5.5.3 Creazione e Trasformazione campi La ribbon Crea contiene i comandi di creazione e di trasformazione dei campi. Affinchè sia possibile creare un campo è necessario che uno ed un solo formato video sia selezionato. La funzionalità di creazione (pannello Controlli) consente di aggiungere i soli campi di output, per citarli: - Pulsante (manuale Extended button) - Groupbox - Link - Testo statico - Grafico - Sql - Etichetta (Label) - Immagine - Testo scorrevole - Browser Web La funzionalità di creazione (pannello Modifica) consente di cambiare la natura di un campo, ad esempio per trasformare un campo di tipo edit (input di testo) in una combo box (lista di valori). Agisce con un solo campo selezionato, preservando il fatto che sia un campo di input o di output; selezionando un campo solo le scelte applicabili sono disponibili. Per una descrizione dei tipi di campo disponibili fare riferimento al Manuale del compilatore Webgate (Webgate converter tutorial). Pagina 16

6 GESTIONE DEGLI INDICATORI E possibile condizionarne la validità di ogni attributo attraverso l attivazione o la disattivazione di indicatori Dall interfaccia di personalizzazione è disponibile una gestione degli indicatori che simula l attivazione degli stessi come se fossero accesi o spenti da programma e consente di lavorare sulle diverse condizioni di visualizzazione del video. Cliccando il tasto "Indicatori" presente sulla ribbon Workspace accede alla manutenzione dove sono disponibili due profili: - Nessuno (tutti gli indicatori spenti, default) - Personalizzato (profilo di indicatori salvato per utente) Cliccando Personalizzato e quindi spuntando le checkbox relative agli indicatori che si desidera attivare l'utente realizza il profilo desiderato; chiudendo la finestra di manutenzione questi vengono applicati alla visualizzazione. Le modifiche apportate al set personalizzato vengono salvate alla chiusura dell applicazione e sono di nuovo disponibili alla successiva apertura. Pagina 17

7 SALVATAGGIO Per applicare le modifiche apportate si utilizza il comando Salva, presente nella ribbon Modifica. Questo avvia la finestra di conferma che riepiloga: - Libreria di lavoro - Nome display file - iseries di collegamento - Chiavi di personalizzazione Il pulsante Anteprima consente di accedere alla lista delle modifiche applicate; confermando il salvataggio queste vengono scritte su iseries. Il salvataggio aggiorna inoltre il file di modifica dei video Webgate affinchè siano immediatamente disponibili al client dal primo utilizzo del video successivo al salvataggio. Pagina 18

8 DISTRIBUZIONE DELLE PERSONALIZZAZIONI Una volta realizzata una personalizzazione è possibile duplicarla sulla stessa macchina (per applicarla ad altri utenti, gruppi, company) così come distribuirla su altri iseries. La duplicazione delle personalizzazioni è stata integrata nell interfaccia di WGDesigner, raggiungibile dal menù principale con la voce Distribuisci personalizzazione. L interfaccia propone sulla sinistra le chiavi di personalizzazione in uso e sulla destra quelle di destinazione (da compilare). Con il pulsante duplica viene effettuato un test per vedere se a destinazione ci sono già delle personalizzazioni e nel caso chiede conferma prima di sostituirle. La distribuzione delle personalizzazioni su iseries differenti si effettua invece con il comando WGCUSSND, disponibile su iseries; il comando è l analogo di WGDSPSND utilizzato per la distribuzioni di oggetti video standard. Pagina 19

9 ELIMINAZIONE DELLE PERSONALIZZAZIONI Cliccare il menù file e selezionare la voce Elimina personalizzazioni. L utilità si presenta come la finestra di selezione dei formati / personalizzazioni. Selezionare il formato o i formati interessati, quindi: Oppure - Cliccare Tutte le personalizzazioni per eliminare tutte le personalizzazioni apportate a quei formati tramite WGDesigner, qualunque siano le chiavi di personalizzazione applicate. - Selezionare una personalizzazione dalla lista o specificando le chiavi negli appositi campi, quindi cliccare Singola personalizzazione per eliminare la personalizzazione specificata lasciando intatte tutte le altre. Pagina 20

APPENDICE: FILE STANDARD, FILE CUSTOM In questa breve appendice vediamo con quali priorità vengono letti i files custom dei video Webgate in modo da poter valutare quale impatto possa avere una nostra personalizzazione sugli utenti. Tutti i video hanno una versione cosiddetta Standard che generalmente arriva dalla compilazione Webgate delle DDS video. La personalizzazione è un processo che consente di apportare modifiche al video senza modificare la versione Standard ; Webgate permette la creazione di diverse personalizzazioni per le diverse esigenze aziendali Le chiavi di personalizzazione disponibili in Webgate sono: - Azienda (Company) codice company Webgate in uso sull applicazione - Lingua codice lingua impostato per il profilo utente in uso - Utente utente iseries con il quale è stato effettuato l accesso al client - Gruppo gruppo di appartenenza dell utente in uso Da tener presente è l ordine di lettura delle personalizzazioni che determina quali saranno applicate di volta in volta; quando esistono più versioni di un elemento (formato, campo, attributo) si sceglie quale applicare in base a quante e quali chiavi sono attive, nel caso in cui non ci siano personalizzazioni disponibili viene utilizzata la versione Standard. L ordine di valutazione delle personalizzazioni è il seguente (dalla priorità più alta a quella più bassa): Azienda Lingua Utente Gruppo 1 X X X X 2 X X X 3 X X X 4 X X 5 X X X 6 X X 7 X X 8 X 9 X X X 10 X X 11 X X 12 X 13 X X 14 X 15 X 16 Pagina 21