Per garantire un’importazione corretta della lista dei partecipanti nella piattaforma Cyber Guru, è importante attenersi alle istruzioni riportate nell’articolo indicato.
La lista deve comprendere tutti i partecipanti al programma formativo ed essere fornita in un file CSV con codifica UTF-8.
IN ALLEGATO UN ESEMPIO DI LISTA UTENTI
Campi obbligatori per ogni utente
Per ciascun utente è necessario includere i seguenti campi:
Nome: il nome dell’utente.
Cognome: il cognome dell’utente.
Email: l’indirizzo email dell’utente, utilizzato per ricevere comunicazioni dalla piattaforma e, se previsto, le simulazioni di phishing. L’email può essere usata anche come credenziale di accesso.
Lingua: la lingua preferita dall’utente per la fruizione dei contenuti formativi, da indicare nel formato ISO 639-1 a due lettere minuscole (es. italiano →
it).Username*: identificativo univoco e immodificabile dell’utente (es. matricola o SID). Deve contenere da un minimo di 3 a un massimo di 255 caratteri. In caso di SSO, deve corrispondere al valore mappato come username (es.
objectID).Lo username può contenere:
- lettere
- numeri
- caratteri speciali consentiti:
- underscore (
_) - trattino (
-) - punto (
.) - chiocciola (
@)
- underscore (
Si tratta di un sottoinsieme dei caratteri ammessi per l’indirizzo email: ad esempio, l’apice (
') è valido in un’email, ma non è consentito nello username.Nota importante Lo username è un campo non modificabile. Una volta creato l'account utente, lo username non può essere editato. In caso di errore o di necessità di modifica dello username, sarà necessario eliminare l'account utente esistente e ricrearlo. Si raccomanda di verificare attentamente lo username prima di procedere con la creazione dell'utente, poiché qualsiasi correzione comporterà la ricreazione completa dell'account, con possibile impatto sui pregressi dell'utente.
Country: il Paese in cui si trova l'utente espresso secondo lo standard ISO 3166-1 alpha-2 a due lettere maiuscole (es. Italia →
IT).Authmode: in caso di SSO ibrido, specifica la modalità di accesso:
0per accesso con credenziali,1per accesso in SSO.Ruolo: il ruolo assegnato all’utente all’interno della piattaforma (vedi "Ruolo in piattaforma")
Informazioni Aggiuntive dell'Utente (c.d. "Organization")
Per ciascun utente è possibile includere ulteriori informazioni, come ad esempio:
Dipartimento di appartenenza
Fascia d’età
Area geografica
Funzione organizzativa
Ruolo aziendale
Tali dati opzionali possono essere mappati all’interno della piattaforma come “Nuova Organization”.
Affinchè l'import vada a buon fine la colonna che definisce una nuova organization deve contenere solamente caratteri alfanumerici. L'unico carattere speciale ammesso è underscore (_)
Ruolo in piattaforma
Per ogni utente è necessario specificare il ruolo che ricoprirà all’interno della piattaforma.
Il campo deve essere indicato come
rolesper consentire il mapping automatico.Se il ruolo non viene specificato, l’utente verrà importato di default come “studente”.
Ruoli disponibili
studente: profilo individuale con visibilità esclusiva sul proprio percorso formativo.
teamleader: attivabile in caso di gamification a squadre, identifica il responsabile del team, con il compito di motivare e monitorare l’andamento. Ha accesso alla vista del proprio team.
supervisor: può accedere alla reportistica relativa all’andamento dei corsi per tutta la popolazione aziendale, sia a livello aggregato sia di dettaglio.
- company admin :è riservato al referente aziendale, che può gestire in autonomia la lista degli utenti, organizzare campagne di simulazione e configurare le opzioni a livello aziendale
Assegnazione di ruoli multipli
È possibile attribuire più ruoli a uno stesso utente. Per farlo:
inserire più colonne nel file CSV,
mappare ciascuna colonna alla voce ruolo durante l’importazione.
Formato corretto dei ruoli (case-sensitive)
I ruoli devono essere riportati nel file CSV UTF-8 esattamente come segue:
studenteteamleadersupervisor
⚠️ Tutti gli altri ruoli (es. company admin) non possono essere importati tramite CSV, ma devono essere attribuiti manualmente. In caso di ruoli con privilegi particolari, è necessario rivolgersi al supporto di Cyber Guru.
Team e gamification a squadre
Se il cliente sceglie di attivare la gamification a squadre, è necessario stabilire con precisione quale valore verrà utilizzato per identificare le squadre e assicurarsi che tale informazione sia inclusa nel file CSV. Il team può essere definito sulla base di un campo già esistente, come ad esempio il Department, oppure creato ad hoc, anche con una denominazione di fantasia. In ogni caso, il team viene mappato come Nuova Organization, ma al momento del caricamento in piattaforma deve essere indicato chiaramente il criterio utilizzato per definire la composizione delle squadre.
Le classifiche a squadre vengono calcolate rapportando la somma dei punteggi di tutti i membri al numero totale dei componenti, in modo che ogni team, indipendentemente dalla sua dimensione, possa competere in condizioni di parità con gli altri. È inoltre previsto che un utente possa cambiare team durante il percorso formativo, ad esempio a seguito di una riorganizzazione aziendale; in questo caso, le sue prestazioni maturate fino a quel momento vengono trasferite al nuovo team di appartenenza.
Controlli preliminari all'importazione in piattaforma
Prima di inviare la user list, si consiglia di effettuare i seguenti controlli:
- Verificare che tutte le email siano valide e correttamente formattate.
- Verificare che nelle colonne email e username non ci siano spazi.
- Assicurarsi che non ci siano duplicati nelle email o negli username.
- Controllare che tutti i campi mandatori siano presenti per ogni utente.
- Verificare che il file sia salvato in formato CSV UTF-8.
Seguendo queste indicazioni, potrete garantire una corretta importazione della user list nella piattaforma, facilitando la gestione del vostro programma formativo.