TGS User Guide

(versione 1.6)

Parte Prima: L'interfaccia Utente di TennisGS.

1.1 Title Bar - Oltre a contenere il nome e la versione del programma reca alcune altre importanti informazioni. Nell'ordine: nome del torneo, numero di iscritti al torneo, numero di set per match e il proprio NickName.

1.2 Tabellone - La maggior parte dell'applicazione contiene le "videate" con cui effettuare i propri pronostici. A seconda del numero di iscritti al torneo nel tabellone potranno essere presenti piu` videate (da un minimo di 3 ad un massimo di 9) che rappresentano i vari frammenti dal tabellone stesso. Per esprimere le proprie preferenze e` sufficiente indicare il punteggio in sets per le varie partite che vengono visualizzate (Tennis GS controlla che inseriate numeri compresi tra lo 0 ed il 3 per evitare il piu` possibile errori di distrazione, ma e` comunque possibile inserire risultati invalidi come l'1-0 viene tollerato, ma ovviamente non permettera` di azzeccare completamente il pronostico). Cosi` facendo, partita dopo partita, si dovra` completare l'intero torneo fino al risultato della finale. Nell'angolo in alto a destra del Tabellone e` presente un controllo che permette di passare, nel caso si stiano dissputando entrambi i tornei, dal torneo Maschile a quello Femminile. Passando da un torneo all'altro il programma salvera` le preferenze espresse. In caso sia previsto un solo concorso in quella settimana il controllo per il passaggio fra i due tornei sara` disabilitato.

• "Salva il Pronostico". In generale per salvare bisognera` utilizzare espressamente questo pulsante ed e` comunque bene farlo sempre. Verranno generati/aggiornati i files con estensione .DAT contenenti i pronostici.
• "Cambia Nickname". Con questo pulsante e` possibile cambiare il proprio Nickname solitamente specificato al primo avvio del programma successivo all'invio dei file di configurazione per il torneo da pronosticare. Questa funzione e` pensata esclusivamente per chi dovesse esprimere le preferenze di piu` giocatori di TGS che facciano riferimento alla stessa casella di email. Per un utilizzo singolo non c'e` necessita` di cambio di email. Consiglio a tutti coloro che facciano utilizzo di questa funzione di riavviare il programma dopo un cambio di nickname per essere sicuri al 100% che tutti i parametri interni di gestione siano riazzerati (e` una funzione che ho testato poco).
• "Dat2HTML". Serve per generare files html contenenti pronostici. Dalla versione 1.6 del programma la funzione verra` applicata ai pronostici presenti nella cartella del Tabellone che si sta pronosticando (il torno presente anche nella Title Bar, per intendersi) se si e` in Edit Mode oppure alla cartella dei pronostici espressamente indicata nella sezione View Mode se si e` attivata quella modalita`. In ogni caso i files html saranno generati nella stessa cartella dei file pronostico ai quali si riferiscono. I file html consentono una consultazione piu` agevole e la possibilita` di stampare su carta i pronostici che piu` interessano ad esempio per un controllo manuale del proprio punteggio.
• "Options". Serve per accedere alla finestra da cui configurare le principali opzioni di Tennis GS. Una meta` e` la sezione dedicata alla configurazione grafica personalizzata del tabellone (scelta dei colori, font, ecc. per differenziare teste di serie, da qualificiati, da Lucky Loser e via dicendo). L'altra meta` e` pensata per le impostazioni Internet legate alla spedizione via email.
• "Send File". Serve per spedire direttamente tramite TennisGS i propri files .DAT al mio indirizzo email. Il programma esegue solo la spedizione vera e propria su una connessione telefonica che dovra` gia` essere stata attivata dall'utente.
• "View" ed "Edit". Servono per cambiare lo stato di funzionamento del programma. Edit Mode e` lo stato che permette di modificare i propri pronostici che vengono mostrati nel Tabellone. View Mode permette, tramite i controlli in basso a sinistra, di utilizzare il Tabellone per mostrare i pronostici relativi ai tornei passati o correnti.

1.4 Controlli View Mode - La modalita` View viene ora gestita mediante un selettore di torneo oltre alla finestra che visualizza l'elenco dei pronostici disponibili per quel torneo. Entrambi i controlli sono disabilitati quando si e` in Edit mode ed entrando in modalita` View il selettore di torneo viene impostato automaticamente al torneo in corso. Questa nuova organizzazione permette di mantenere, volendo, sul proprio HD l'intera stagione di TennisGS senza dover riconfigurare troppe cose alla vigilia di ogni sessione di pronostico. Passando nuovamente ad Edit mode i controlli View Mode vengono disabilitati.

1.5 Status Bar - E` divisa in 3 aree. La prima viene utilizzata per visualizzare messaggi all'utente, la seconda indica la modalita` corrente (edit o view) del programma e la terza indica il nome della connessione attivata per il servizio e-mail.

1.6 La finestra "Options" - la Configurazione delle opzioni Internet merita una sezione a parte per i dovuti chiarimenti. Vediamo punto per punto qualsi sono le informazioni richieste:

• To Address. Semplicemente e` il mio indirizzo di e-mail a cui vanno spediti i pronostici. Avrei potuto fissarlo all'interno del programma, ma in caso di cambiamenti sareste stati obbligati a scaricarvi una nuova versione solo per quel motivo. Cosi` invece tutto e` configurabile dall'utente ma attenzione a non cambiarlo se non serve!
• Connessione Impostata. Indica semplicemente quale e` la connessione che attualmente e` impostata come predefinita. Serve per chi ha piu` di un accesso internet e visto il proliferare di provider Free credo che sia una situazione molto diffusa. In pratica e` la stessa informazione riportata nella Status Bar della finestra principale di TennisGS. Per cambiare Connessione Impostata basta selezionare quella che si vuole utilizzare ed uscire dalla finestra "Options" premendo OK. La Status Bar indichera` da subito il cambiamento dell'impostazione e rientrando nella finestra Options ne avrete la conferma.
• Nome. E` il nome simbolico da assegnare alla provider di cui state per inserire i dati e generalmente e` buona norma farlo coincidere con il nome del provider stesso. Serve semplicemente come etichetta per permettere al programma di indicarvi quale sia la connessione impostata e di cambiarla.
• SMTP Server. E` l'indirizzo del server di spedizione della posta. Ogni provider in genere ne ha due diversificati per la spedizione (smtp) e per la ricezione (in genere pop). Abbonandovi ad un certo provider vi vengono indicati tutti i dati tecnici fra i quali anche l'indirizzo del server SMTP che dovrete inserire in questa casella.
• User ID. Anche questo e` un dato tecnico che viene concordato all'atto dell'abbonamento col provider. Alcuni lo impongono altri permettono di configurarlo a voi. In ogni caso viene indicato fra i parametri tecnici come UserID oppure Login oppure Account. In alcuni casi coincide con la parte prima della @ dell'indirizzo email.
• From Address. Questo semplicemente e` il vostro indirizzo e-mail completo ovviamente relativo al provider che state configurando.
• I Pulsanti New ed Edit. Come avrete facilmente notato non vi e` permesso agire sugli ultimi 4 campi delle impostazioni senza utilizzare uno dei due pulsanti New o Edit. Se volete inserire i dati relativi ad un nuovo provider allora premendo New la casella Nome diventera` una casella di testo in cui inserire il nome simbolico ed i successivi 3 campi saranno resi editabili. Terminato l'inserimento dei dati relativi ad un provider e` obbligatorio uscire dalla finestra premendo OK per rendere effettivi i dati inseriti. Rientrando avrete che la connessione e` stata impostata ed il suo nome comparira` nella lista delle connsessioni. Se si vuole inserire un nuovo provider ripetere le operazioni, mentre se si vuole modificare un campo di una connessione gia` memorizzata bastera` selezionarla e premere Edit. Anche in questo caso le modifiche diventeranno effettive solo uscendo con OK.

Parte Seconda: La struttura di Files e Cartelle di TennisGS.

Per mantenere una impostazione alla massima chiarezza e semplicita` tutto il sistema di files su cui si basa TennisGS e` imperniato sul testo semplice, cioe` leggibile ed editabile con il semplice Blocco Note di windows. Ovviamente questo non e` un invito a modificare i files a meno che non siate sicuri al 100% di quello che state per fare. Con la versione 1.6 di TennisGS molto e` cambiato nella strutturazione delle cartelle e dei files del programma.

2.1 La cartella principale. Per cartella principale si intende quella in cui e` contenuto il programma TennisGS.exe stesso. Tale cartella deve contenere i seguenti files:

Nome del File	Descrizione
Options.ini	Memorizza tutte le impostazioni definibili mediante la finestra di "Options". E` sconsigliabile modificarlo a mano senza avere compreso come le informazioni sono state memorizzare all'interno del file, ma potrebbe essere utile ad esempio per cancellare i dati relativi ad una connessione non piu` utilizzata (sempre che dia fastidio averla presente) in quanto tale opzione non e` ancora stata implementata nel programma.
TennisGS.ini	Memorizza i dati relativi al Nickname in uso ed ai tornei Maschile e Femminile in corso. E` pericoloso ed inutile modificare qualche valore visto che questo file ini viene appositamente preparato per il torneo che si deve pronosticare e quindi per definizione non necessita di modifiche.
Log.txt (opzionale)	Memorizza passo per passo l'andamento della spedizione dei propri pronostici mediante l'utilizzo della funzione "send files" di TennisGS. Per ragioni di praticita` si e` pensato di non includere troppe segnalazioni a video durante la spedizione, ma di tenerne traccia su questo file di testo. Dopo aver tentato una spedizione puo` essere utile verificare nel dettaglio come e` andata.
Tornei.txt	E` un semplice elenco di tutti i tornei (Maschili e Femminili insieme) della stagione in corso. Il file essenzialmente serve per il View Mode ed e` sconsigliabile metterci le mani.
Players.lst	E` l'elenco dei Nickname di tutti gli iscritti al concorso pronostici TennisGS. Serve per permettere un "Login" privo di errori in occasione della prima esecuzione del programma dopo la ricezione dei dati di configurazione per il nuovo torneo da pronosticare.
TennisGS.exe	no comment

2.2 Le cartelle dei Tornei. Per mantenere un ordine maggiore nei dati di TennisGS ora viene creata una cartella per ogni torneo che si deve pronosticare. Questa nuova struttura impone che vi siano dei file necessariamente presenti anche nelle cartelle dei vari tornei. Vediamo l'elenco:

Nome del File	Descrizione
*.DAT (opzionali)	Sono i files contenenti i pronostici. Il loro formato e` binario per cui non sono visualizzabili con programmi diversi da TennisGS. Se non si e` ancora salvato il proprio pronostico (o non si sono scaricati altri pronostici dal sito web) la cartella non presentera` ovviamente files .DAT nota: il nome dei files .DAT viene "costruito" indicando con una W o M iniziale se il torneo e` Femminile o Maschile poi, separato da un '-', si puo` trovare il Nickname.
*.HTML (opzionali)	Sono i files contenenti i pronostici in formato html e generati dal programma TennisGS mediante l'apposita opzione. Ovviamente non sono in genere presenti file .html a meno di averli espressamente generati.
WTable.txt	File contenente il tabellone femminile del torneo (sempre che il torneo preveda un tabellone femminile). Il file presenta un elenco di giocatrici precedute in alcuni casi da TAG specifici per la definizione dei ruoli di Testa di Serie, Qualificato, Lucky Loser o Wild Card per la gestione dei font diversificati. E` vietatissimo modificare anche un solo carattere all'interno del file in quanto il calcolo del punteggio e` basato sul match perfetto fra stringhe di caratteri. Per questo anche eventuali errori di compilazione da parte mia devono essere lasciati immutati.
MTable.txt	File contenente il tabellone maschile del torneo (sempre che il torneo preveda un tabellone maschile). Il file presenta un elenco di giocatori preceduti in alcuni casi da TAG specifici per la definizione dei ruoli di Testa di Serie, Qualificato, Lucky Loser o Wild Card per la gestione dei font diversificati. E` vietatissimo modificare anche un solo carattere all'interno del file in quanto il calcolo del punteggio e` basato sul match perfetto fra stringhe di caratteri. Per questo anche eventuali errori di compilazione da parte mia devono essere lasciati immutati.
*.INI	Per ogni torneo esiste una cartella e per ogni cartella esiste un file .INI con il nome del torneo e contenente le impostazioni del torneo stesso. Si tratta delle informazioni relative al numero di iscritti ed al numero di sets che sono indispensabili per il corretto funzionamento del View Mode.