Questo articolo spiega come importare utenti in SMARTFENSE tramite un file CSV per creare nuovi utenti o modificare utenti esistenti in massa. Dettaglia la struttura del file, la logica di creazione e aggiornamento, la gestione delle maiuscole e i campi opzionali.
La configurazione è disponibile in Utenti e gruppi > Importazione e sincronizzazione > Manualmente dal file CSV.
Struttura del file CSV
Per ottenere il file di esempio:
- Accedi a Utenti e gruppi > Importazione e sincronizzazione.
- Seleziona Manuale da file CSV.
- Premi Salva.
- Premi il pulsante Scarica CSV di esempio.
Per una modifica massiva su utenti esistenti, puoi anche scaricare l'elenco da Utenti e gruppi > Utenti. La struttura è la stessa.
Esempio di riga
utente1,nome1,cognome1,email1@dominio.com,"gruppo-A;gruppo-B","areafunzionale-A;areafunzionale-B","livellogerarchico-A;livellogerarchico-B",Attivo,Amministratore,it-it,ID-Dipendente,telefono,UPN
Colonne obbligatorie e opzionali
| Colonna | Obbligatoria | Note |
|---|---|---|
| Username | No | Se non specificato, viene generato a partire dall'email. |
| Nome | Sì | Viene normalizzato con la lettera iniziale maiuscola. |
| Cognome | Sì | Viene normalizzato con la lettera iniziale maiuscola. |
| Sì | Senze email, l’utente non può essere importato. Viene sempre memorizzata in minuscolo. | |
| Gruppi | No | Valori multipli separati da ; all’interno dello stesso campo. |
| Aree funzionali | No | Valori multipli separati da ;. |
| Livelli gerarchici | No | Valori multipli separati da ;. |
| Stato | No | Accetta valori in qualsiasi lingua supportata. Se omesso, viene creato come Attivo. |
| Ruolo | No | Se omesso, viene creato come Utente finale. |
| Lingua | No | Se omesso, viene creato con es-ar. |
| ID-Dipendente | No | Opzionale. |
| Telefono | No | Opzionale. |
| UPN | No | Opzionale. Conserva esattamente maiuscole e minuscole. |
| Email del Manager | No | Opzionale. |
Non eliminare mai le colonne obbligatorie del CSV: la piattaforma non sarà in grado di interpretarlo correttamente.
Il sistema supporta file CSV con solo le 10 colonne base. Le colonne ID-Dipendente, Telefono, UPN e Email del Manager sono opzionali.
Quando si crea o si modifica un utente
La piattaforma segue questa sequenza per decidere se creare o aggiornare un record.
1. Ricerca per email
Se l’email del CSV corrisponde a un utente esistente, quell’utente viene aggiornato. Caso speciale dello username: se lo username del CSV differisce da quello esistente, la piattaforma verifica se è disponibile. Se lo è, lo aggiorna. Se no, mostra un avviso (evidenziato in giallo).
2. Ricerca per username
Se non c’è corrispondenza per email, si cerca per username. Se corrisponde, l’utente viene aggiornato. Caso speciale dell’email: se differisce, la piattaforma verifica la disponibilità prima di aggiornarla.
3. Nessuna corrispondenza
Se non c’è corrispondenza né per email né per username, viene creato un nuovo utente.
Uso delle maiuscole
Nomi utente
Le maiuscole non sono considerate nel determinare se un utente esiste, ma vengono rispettate alla creazione del nuovo utente.
Raggruppamenti
In gruppi, aree funzionali e livelli gerarchici le maiuscole sono distinte. Se la ricerca esatta non trova corrispondenza, si tenta una seconda ricerca ignorando le maiuscole.
Raggruppamenti creati manualmente
I raggruppamenti che esistono solo perché creati manualmente in SMARTFENSE non vengono modificati durante l’importazione.
Esempio: se l’utente ha assegnato il Gruppo M (creato manualmente) e il Gruppo A (importato precedentemente), e il CSV riporta solo il Gruppo C, il risultato sarà Gruppo M (conservato) e Gruppo C (aggiunto).
Comportamento dello stato nel CSV
Il campo Stato accetta valori in qualsiasi delle lingue supportate. Per esempio, Active in inglese equivale a Attivo in italiano. Il confronto non distingue maiuscole e minuscole. Lo stesso vale per i valori Inactivo / Inactive.
Campi vuoti
| Campo | Comportamento se lasciato vuoto |
|---|---|
| Lingua | Prende quella dell’amministratore che importa o conserva quella attuale dell’utente esistente. |
| Username | Viene generato dalla prima parte dell’email (prima della @). |
| Senze email, l’utente non può essere importato. | |
| Stato | Viene creato come Attivo o l’utente esistente conserva quello attuale. |
| Ruolo | Viene creato come Utente finale o l’utente esistente conserva quello attuale. |
| Telefono, ID Dipendente, UPN | Rimangono vuoti. |
💡 Buone pratiche
- Scarica sempre il CSV di esempio prima di preparare il file, per assicurarti del formato corretto.
- Verifica email e username prima dell’importazione per minimizzare gli avvisi.
- Conserva tutte le colonne obbligatorie, anche se alcuni valori sono vuoti.
- Mantieni coerenti i nomi dei raggruppamenti per evitare duplicati dovuti a maiuscole e minuscole.
- Usa valori di Stato in qualsiasi lingua supportata e verifica che vengano interpretati correttamente.