Importare i nominativi¶

Richiede il permesso "Database".

Con l'importazione carichi in un database una lista di nominativi da un file Excel o CSV. La apri dalla pagina Database con il pulsante Importa nominativi.

Il wizard ha due passaggi più una conferma finale, indicati in alto: 1. Campi → 2. File → 3. Conferma.

Prima di iniziare: prepara il file¶

Requisito	Dettaglio
Formato	Excel `.xlsx` oppure CSV. Per i vecchi file `.xls`, aprili in Excel e salvali come `.xlsx`
Dimensione	Al massimo 26 MB (il limite è indicato accanto alla scelta del file)
Telefono	Ogni riga deve avere almeno un numero di telefono. Una riga senza telefono viene scartata come errore
Intestazioni	Consigliata una prima riga con i nomi delle colonne (es. "Ragione sociale", "Telefono", "Comune"): Thelgo la usa per proporre in automatico la corrispondenza dei campi
CSV	Codifica UTF-8, separatore virgola o punto e virgola (riconosciuto da solo)
Fogli Excel	Se il file ha più fogli, ne scegli uno durante l'importazione. Si importa un foglio alla volta

Registro delle Opposizioni

L'importazione non verifica i numeri sul Registro Pubblico delle Opposizioni e non controlla se un numero ha chiesto di non essere chiamato in un altro database. Importa liste già verificate. Vedi Pulizia RPO.

Passo 1: Campi¶

In questo passo scegli dove importare e vedi su quali campi potrai caricare le colonne del file.

Screenshot da inserire: amministratore-dati-importazione-passo1.png

Il passo 1 dell'importazione con un database selezionato che ha già campagne: la casella "Aggiungi nominativi alle campagne già create" spuntata con l'elenco delle campagne e i loro filtri, lo schema campi dinamici scelto e l'anteprima dei campi Standard e Dinamici.

In Database di destinazione scegli il database. Per crearne uno nuovo premi + Nuovo, scrivi il nome e premi Crea.
Se il database è già usato da qualche campagna compare Aggiungi nominativi alle campagne già create (rispettando i filtri impostati) (vedi sotto).
In Schema campi dinamici scegli lo schema con i campi aggiuntivi che ti servono, oppure Nessuno schema. Con + Nuovo schema vai alla pagina Campi database dinamici per crearne uno.
Controlla l'Anteprima campi disponibili: a sinistra i campi Standard, a destra quelli Dinamici (schema selezionato). Sono i campi su cui potrai mappare le colonne nel passo successivo.
Premi Avanti.

Lo schema dei campi dinamici¶

Se il database ha già uno schema, la scelta è bloccata e compare "Il database selezionato usa già lo schema "…": non può essere cambiato.". Tutti i nominativi di un database condividono lo stesso schema.
Se il database non ha ancora uno schema ed esiste un solo schema, Thelgo lo propone già selezionato.
Lo schema scelto viene collegato al database quando confermi la corrispondenza dei campi nel passo 2, e da quel momento resta fisso.

Aggiungere i nominativi alle campagne esistenti¶

Di norma i nominativi importati restano solo nel database: le campagne già create non li ricevono in automatico. Se vuoi che entrino subito anche in una o più campagne:

Spunta Aggiungi nominativi alle campagne già create (rispettando i filtri impostati).
Compare l'elenco delle campagne del database (di qualsiasi stato), tutte già spuntate. Sotto ogni campagna vedi i suoi filtri (es. "CAP: 10100, 10121 · Comune: Torino") oppure "Nessun filtro (tutto il database)".
Togli la spunta alle campagne da escludere, oppure usa Tutte per selezionarle o deselezionarle tutte.

Ogni campagna riceve solo i nominativi appena importati che rispettano tutti i suoi filtri. I nominativi già presenti nel database non vengono toccati.

Puoi aggiungere nominativi a una campagna anche in un secondo momento, dalla campagna stessa (vedi Nominativi della campagna).

Passo 2: File¶

Caricare il file¶

Tipo di importazione: lascia Standard. Il tipo Registro Pubblico delle Opposizioni non è ancora disponibile.
In File Excel o CSV scegli il file.
Premi Avanti. Una barra mostra l'avanzamento del caricamento.
Se il file Excel ha più fogli compare "Il file contiene più fogli: scegli quale importare": clicca sul nome del foglio. Con un solo foglio (o con un CSV) questo passaggio viene saltato.

Non lasciare il wizard a metà troppo a lungo

Il file caricato resta disponibile per 30 minuti. Se aspetti di più, alla conferma compare "Sessione di import scaduta o non trovata. Ricarica il file." e devi ricominciare.

Corrispondenza campi¶

Thelgo mostra una riga per ogni colonna del file: a sinistra il nome della colonna (il contenuto della prima riga del file), a destra il campo di Thelgo in cui caricarla.

Screenshot da inserire: amministratore-dati-importazione-corrispondenza.png

La sezione Corrispondenza campi con alcune colonne del file già abbinate (es. "Telefono" → "Telefono 1 *", "Città" → "Comune"), una colonna lasciata su "Seleziona" e, sotto, le Opzioni "Salta prima riga" e "Controlla zero".

Thelgo propone da solo l'abbinamento quando riconosce il nome della colonna, anche con nomi comuni diversi: ad esempio "Tel", "Cellulare" o "Telefono" vanno su Telefono 1, "Città" su Comune, "P.IVA" su Partita IVA, "CF" su Codice Fiscale, "Azienda" su Ragione Sociale. Controlla sempre le proposte.
Una colonna lasciata su Seleziona non viene importata.
Ogni campo può essere usato una sola volta: un campo già abbinato a un'altra colonna appare disattivato.
È obbligatorio abbinare almeno una colonna a un campo Telefono (i campi telefono sono segnati con *). Finché manca compare "Seleziona almeno una colonna da mappare su un campo Telefono." e Avanti resta disattivato.

I campi disponibili¶

Campi standard	Note
Ragione Sociale, Forma Giuridica
Nome, Cognome, Sesso, Data Di Nascita	Sesso accetta "Maschio" o "Femmina": altri valori (es. "M", "F") vengono ignorati. Una data di nascita non riconosciuta viene ignorata
Indirizzo, Numero Civico, CAP, Comune, Provincia	Provincia: sigla di 2 lettere
Telefono 1 … Telefono 9	Fino a nove numeri per nominativo
Email, Sito Web
Partita IVA, Codice Fiscale	Al massimo 11 e 16 caratteri
ID Riferimento 1, ID Riferimento 2	Codici liberi, ad esempio il codice cliente nel tuo gestionale

Più i campi dinamici dello schema scelto nel passo 1.

I numeri di telefono¶

Ogni numero viene ripulito prima di essere salvato: restano solo le cifre (spazi, punti, trattini e parentesi vengono tolti) e un "+" iniziale diventa "00". Se una riga ha più numeri, nelle campagne Preview l'operatore li vede tutti e sceglie quale chiamare (vedi La scheda del nominativo nel manuale operatore).

Opzioni¶

Opzione	Cosa fa
Salta prima riga (riga di intestazione)	Non importa la prima riga del file. Attivala se la prima riga contiene le intestazioni. Lasciala disattivata solo se il file contiene esclusivamente dati
Controlla zero (attiva di default)	Ripristina lo zero iniziale che Excel toglie dalle celle numeriche: aggiunge uno 0 davanti ai numeri di telefono di 9 cifre che non iniziano per 3 (fissi italiani) e ai CAP di 4 cifre. È una correzione automatica "di buon senso": controlla comunque il file se hai numeri esteri

Ricordati di Salta prima riga

La prima riga del file viene sempre usata come nome delle colonne nella corrispondenza, ma viene importata come dato se non attivi Salta prima riga. Con un file con intestazioni, se la dimentichi la riga delle intestazioni finisce fra gli errori (o, peggio, diventa un nominativo).

Premi Avanti per passare alla conferma. Con Indietro torni al passo precedente senza perdere le scelte fatte.

Passo 3: Conferma¶

Vedi il Riepilogo corrispondenza campi (Campo Origine → Campo Destinazione). Se è tutto giusto premi Importa.

L'importazione parte in background: vedi una barra di avanzamento con il numero di righe elaborate. Come indicato a schermo, puoi lasciare la pagina: l'importazione prosegue anche su file di grandi dimensioni, e ne trovi l'avanzamento e l'esito nella pagina Operazioni.

L'esito¶

Al termine compare Importazione completata (oppure Importazione fallita) con quattro numeri:

Numero	Significato
Totale	Righe del file elaborate (esclusa la prima, se hai attivato Salta prima riga)
Importati	Nuovi nominativi inseriti nel database
Scartati (duplicati)	Righe non importate perché il numero di telefono era già presente
Errori	Righe non importate perché non valide

Da qui puoi tornare alla pagina Database con Torna ai database oppure aprire la pagina Operazioni con Vedi il log dell'operazione, dove trovi riga per riga cosa è successo.

Quando una riga è un duplicato¶

Thelgo usa come identificativo della riga il primo numero di telefono valorizzato (Telefono 1, se c'è, altrimenti Telefono 2, e così via). La riga viene scartata come duplicato se quel numero:

è già comparso in una riga precedente dello stesso file ("Telefono '…' duplicato nel file."), oppure
è già presente, in uno qualsiasi dei nove campi telefono, in un nominativo dello stesso database ("Telefono '…' già presente nel database.").

I duplicati non aggiornano il nominativo esistente: i suoi dati restano come sono. Lo stesso numero può invece esistere in database diversi.

Quando una riga è un errore¶

Messaggio nel log	Causa
Numero di telefono mancante.	Nessuno dei campi telefono della riga è valorizzato
Valore troppo lungo per il campo '…' (massimo N caratteri)	Il valore supera la lunghezza ammessa (es. Provincia oltre 2 caratteri, Partita IVA oltre 11, Codice Fiscale oltre 16)
Valore '…' non valido per il campo '…'	Il valore non è del tipo del campo dinamico (es. testo in un campo Numero; vedi Campi database dinamici)

Le righe con errore non bloccano le altre: il resto del file viene importato normalmente.

Lo stato finale¶

Stato (in Operazioni)	Quando
Completata	Nessuna riga in errore (eventuali duplicati scartati non contano come errori)
Completata con errori	Almeno una riga in errore
Fallita	L'importazione si è interrotta per un problema imprevisto. I nominativi già inseriti fino a quel momento restano nel database: controlla i numeri in Operazioni prima di riprovare. Reimportando lo stesso file, le righe già entrate verranno scartate come duplicati

Ogni importazione completata viene registrata anche nell'Audit log, con il numero di importati, scartati ed errori.