Guida alla creazione user list

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 (@)

  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: 0 per accesso con credenziali, 1 per accesso in SSO.

• Ruolo: il ruolo assegnato all’utente all’interno della piattaforma (vedi "Ruolo in piattaforma")

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 roles per 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:

• studente

• teamleader

• supervisor

⚠️ 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

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.