Passaggio 2 Importare gli atleti

Fornire a FINISH gli atleti, con i loro transponder, i loro colori e il loro obiettivo sul giro, da Excel, da un CSV o da un JSON.

L'obiettivo

Una scheda per atleta nel database di FINISH: cognome, nome, data di nascita, genere, transponder, colori (per gli schermi e il lapping) e, se l'atleta ne ha uno, il suo obiettivo sul giro (min e max). Il passaggio 4 ne ricaverà la sessione di allenamento.

Prima di iniziare

Un file con gli atleti: Excel (.xlsx), CSV o JSON, una riga per atleta, una riga di intestazione.
Almeno le colonne del cognome, del nome, della data di nascita e del genere: sono l'identità dell'atleta (stesso cognome, nome e data di nascita = stesso atleta).
Per l'allenamento: una colonna Transponder (il suo numero); utili: le colonne dei colori e quelle del tempo minimo e massimo sul giro (Min lap, Max lap).
Per fare una prova: il file di esempio athletes.xlsx (80 atleti di fantasia) viene riconosciuto da solo.

Le operazioni, una per una

Preparare il file

Una riga di intestazione, poi una riga per atleta. Esempio:

Last name	First name	Date of birth	Gender	Transponder	Background color	Text color	Min lap	Max lap
SOLBAKKEN	Ingrid	2008-04-17	F	7120012	riempimento blu	carattere bianco	9.5	14
RONCIÈRE	Thibault	2006-11-02	M	7867930	#FFCC00	#000000	8.5	12.5
MIZUSHIMA	Haruto	2007-01-23	M	8527554	red	white	9	13

Colori: in un .xlsx basta colorare la cella (riempimento = sfondo, carattere = testo), anche vuota o con il nome scritto dentro; basta anche una sola colonna «Colore» (il suo riempimento dà lo sfondo, il suo carattere il testo). Altrimenti scrivere il colore: #FFCC00, FFCC00, 255,204,0 oppure il nome del colore in inglese o in francese (red, white, blue…; i nomi italiani non vengono riconosciuti).
Min e max: in secondi (8.5) oppure in m:ss.fff (1:05.250).
Date: AAAA-MM-GG, GG/MM/AAAA oppure una data di Excel; genere: M, F, H, X, Homme, Femme, Male, Female…
Vengono riconosciute da sole le intestazioni abituali in francese, inglese, olandese e tedesco («Couleur fond», «Background color», «Achtergrondkleur», «Hintergrundfarbe», «Max lap»…), non ancora quelle in italiano: usare le intestazioni inglesi dell'esempio qui sopra, oppure scegliere a mano il campo di ogni colonna nella schermata 1 (la scelta viene memorizzata).

Aprire l'importazione
Storico › scheda Atleti › Importa atleti… (anche FileImporta atleti…).
La finestra Importa atleti, in quattro schermate: file e corrispondenze, anteprima, abbinamento, importazione.
1. File e corrispondenze
Scegli il file… → il proprio file. Ogni colonna viene associata a un campo, proposto in base alla sua intestazione: verificare Nome (il cognome), Nome proprio, Data di nascita, Genere, Transponder n. 1, Colore di sfondo (riempimento), Colore del testo (carattere) (oppure Colore (sfondo e testo)), Tempo min sul giro, Tempo max sul giro. Per una colonna da non importare: nessun campo.
Ogni colonna ha il suo campo; la volta successiva compare «Formato riconosciuto…».
Gli atleti già presenti nel database
Sempre nella schermata 1, Schede già nel database: completare i campi vuoti, sostituire, oppure Ignora gli atleti già nel database (stesso cognome, nome e data di nascita). La prima volta non cambia nulla.
2. Anteprima
Anteprima ›: le righe formattate (COGNOME in maiuscolo, date AAAA-MM-GG) e il bollino di ogni atleta con i suoi colori. Non è ancora stato scritto nulla.
I bollini hanno i colori giusti; nessun avviso in rosso.
3. Abbinamento
Abbina ›: ogni riga viene confrontata con il database (Trovata, Proposta, Nuova, Ignorata, Conflitto). Il riquadro Transponder da notare elenca i transponder nuovi (aggiunti con l'importazione) e quelli già assegnati a un'altra scheda.
La prima volta: tutte le righe sono «Nuova».
4. Importazione
Importa: tutto viene scritto in un'unica volta, poi compare il resoconto.

Come capire che è andato tutto bene

Il resoconto: «creati», «aggiornati», «invariati», «ignorati», senza errori; Copia il resoconto per conservarlo.
In Storico › Atleti, ogni atleta ha il suo bollino con i suoi colori e i suoi transponder.
I nuovi transponder si trovano anche nella scheda Transponder.

Problemi frequenti e soluzioni

Cosa si vede	Cosa fare
Una colonna non viene riconosciuta	Nella schermata 1, scegliere il suo Campo nell'elenco accanto alla sua anteprima. Il formato viene memorizzato: la volta successiva viene riconosciuto da solo.
I colori non arrivano	In un .xlsx il colore viene dalla formattazione della cella (riempimento, carattere). «Nessun riempimento» non conta. In un CSV scrivere il colore: #FFCC00, 255,204,0 oppure un nome in inglese o in francese (red, blue, rouge…).
Date sbagliate (giorno e mese invertiti)	Impostare Date ambigue (03/07/2004) nella schermata 1 (03/07/2004: 3 luglio o 7 marzo?) e controllare l'anteprima.
Righe in «Conflitto»	Uno stesso transponder o numero su due schede, oppure un omonimo: scegliere la correzione proposta per ogni riga (Prossimo da risolvere ›). Un conflitto senza scelta non viene importato, il resto sì.
Reimportare il file raddoppia gli atleti?	No: un atleta con lo stesso cognome, nome e data di nascita viene ritrovato. La scelta Schede già nel database stabilisce se viene aggiornato o ignorato.
«Transponder da notare»: già assegnati a un'altra scheda	Segnalati, non rifiutati: verificare chi porta davvero il chip, poi correggere la scheda dell'altro atleta.