Introduzione

Docebo permette di utilizzare file CSV per importare, attivare e disattivare gli utenti in piattaforma con una sola azione. È inoltre possibile utilizzare i file CSV per creare associazioni di tipo manager - membri del team.

Il conteggio degli utenti attivi non viene impattato dal caricamento degli utenti in piattaforma tramite file CSV, a meno che l'utente non segua un corso o visualizzi un contributo

Connettersi alla piattaforma come Superadmin, accedere al Menu amministrazione cliccando sull'icona ingranaggio in alto a destra. Nella sezione E-learning, selezionare Utenti. Nella pagina di Gestione degli Utenti, premere il pulsante cartella in alto a destra, e selezionare Importa utenti da file CSV.

Cosa sono i file CSV (.csv)?

I file Comma-Separated Values (CSV) contengono dati in in formato testo. Ogni riga di un file CSV identifica un dato. Ogni riga/dato è composto da più campi/colonne separati da un delimitatore.

I file CSV possono essere generati da diversi software (es. Excel, Google Sheets, Notepad, TextEdit, Emacs). Il contenuto del file deve utilizzare il formato standard CSV, ed deve avere estensione ".csv".

Come sono formattati i file CSV?

I file CSV hanno un formato standard:

• I campi/colonne sono separati da un carattere singolo che funge da delimitatore, solitamente virgola o punto e virgola
• Ogni dato/riga termina con una nuova riga
• Tutti i dati/righe hanno lo stesso numero di campi/colonne, nello stesso ordine
• Il primo dato/riga deve essere l'intestazione che contiene i nomi dei campi/colonne di ogni campo/colonna
• I dati di ogni campo sono interpretati come sequenza di caratteri, o testo semplice
• I campi devono essere identificati da virgolette
• I campi devono essere quotati nel caso in cui contengano uno o più caratteri speciali. Elenco completo dei caratteri speciali supportati.
• Gli spazi iniziali e finali sono considerati parti del campo

Come utilizzare i file CSV per creare e aggiornare gli utenti?

Gli account utenti in piattaforma sono composti da campi dati utenti. Ognuno di questi campi può o non può essere popolato da dati, in base ai campi inseriti durante la creazione dell'utente.

Per creare un utente è necessario popolare i campi obbligatori (username e campi aggiuntivi obbligatori). Per aggiornare un account, è necessario aggiornare i campi utente con i nuovi dati. La creazione e la modifica degli utenti (di un singolo utente o di più utenti alla volta) può essere fatta manualmente o importando i dati utenti in piattaforma utilizzando file CSV.

Se si utilizzano file CSV, ogni account utente che si desidera creare è identificato da un dato/riga nel file CSV. Ogni campo dati utente è rappresentato da un campo/colonna nel file.

Importare il file CSV in piattaforma, quindi mappare i dati del file nei campi utente corrispondenti utilizzati dalla piattaforma. 

Quali sono i valori accettati per i dati di default degli account utenti?

Fare riferimento alla tabella che segue per configurare correttamente i valori nei file CSV al fine di garantire la mappatura corretta dei campi utente.

Campo dati utenti piattaforma	Valori CSV accettati per il campo (con esempi)	Note
Username	Stringa o numero (Esempio: john.smith)	Questo campo non è case-sensitive. Un file CSV non non può includere sia questo campo che il campo User ID oppure UUID, in tal caso la procedura di import genererà un errore. È possibile utilizzare questo campo per modificare gli username dei profili utente via CSV. Ulteriori informazioni sono disponibili nella riga New Username di questa tabella.
First Name	Stringa (Esempio: John)
Last Name	Stringa (Esempio: Smith)
Email	È accettata la maggior parte degli indirizzi email.  (Esempio: john.smith@example.com)	Massimo 45 caratteri prima del carattere @ Massimo 45 caratteri dopo il carattere @
Level	user poweruser superadmin	“user” =  l’account è di tipo Utente “poweruser” = l’account è di tipo Power User. “superadmin” = l’account è di tipo Superadmin. Questo campo non è case-sensitive.
Profile Name	Nomi dei profili Power User esistenti, come stringa.	I nomi dei profili devono essere separati dal carattere | (pipe o barra verticale). Quando si assegnano più profili ad un Power User, non utilizzare | come separatore nel file CSV. È possibile assegnare un massimo di 10 profili per Power User.
Branch Name	Nome di un ramo esistente, come stringa.	Questo campo è case-sensitive. Attenzione, non è possibile aggiungere un utente a più di un ramo con questo tipo di import.
Branch Code	Codice di un ramo esistente, come stringa.	Questo campo è case-sensitive. Non è possibile aggiungere un utente a più di un ramo con questo tipo di import.
Branch Name Path	Esempio: “Root/ParentBranch1/ChildBranch1”	Questo campo è case-sensitive. Rappresenta il percorso (path) completo dei rami a cui l’utente deve essere aggiunto; i rami non esistenti saranno creati automaticamente. È necessario indicare il percorso completo anche quando si crea un sotto-ramo di un ramo esistente, diverso dal ramo principale (root). Attenzione: quando si specifica questo campo, è necessario specificare il campo Branch Code Path e i codici del ramo associati ai nomi specificati.
Branch Code Path	Esempio: “R/PB1/CB2”	Questo campo è case-sensitive. Rappresenta il percorso (path) completo dei rami a cui l’utente deve essere aggiunto; i rami non esistenti verranno creati automaticamente. È necessario indicare il percorso completo anche quando si crea un sotto-ramo di un ramo esistente, diverso dal ramo principale (root). Attenzione: quando si specifica questo campo, è necessario specificare il campo Branch Name Path e i nomi del ramo associati ai codici specificati.
Password	Stringa (Esempio: aptSvvTrWlY452L6)	Le password qui specificate devono rispettare il criterio di complessità definito nell’area Configurazione della piattaforma. Il sistema genererà automaticamente una password nel caso in cui non sia definita per l’utente al momento della creazione.  Nello stesso CSV non possono esserci sia questo campo sia il campo Hashed Password, in tal caso la procedura di import genererà un errore.
Hashed Password	Stringa	La password deve essere pre-criptata con l’algoritmo Blowfish a 13 passaggi. Lo stesso CSV non può contente sia questo campo sia il campo Password, in tal caso la procedura di import genererà un errore.
Active	0/1 no/yes false/true	Utente attivo = 1, yes, true Utente non attivo = 0, no, false Questo campo non è case-sensitive.
Force Password Change	0/1 no/yes false/true	Forzare l’utente a modificare la password al login successivo = 1, yes, true Non forzare l’utente a modificare la password al login successivo = 0, no, false
Expire On	YYYY-MM-DD DD-MM-YYYY MM/DD/YYYY YYYY/MM/DD
Language	Esempio: english Elenco delle lingue supportate	Deve corrispondere al nome della lingua come definito in piattaforma. L’elenco completo è disponibile nella sezione Configurazione o nel menu Gestione Lingue (colonna Codice).  Se si cerca di creare un utente a cui è assegnata una lingua non attiva in piattaforma, si riceverà un messaggio di errore. Questo campo è case-sensitive e il testo dev’essere scritto con caratteri minuscoli.
Date Format	en it es YYYY-MM-DD	Questo campo accetta i valori dei codici lingua ISO. Il formato della data corrisponde al codice della lingua in formato standard. Elenco dei codici lingua ISO.
Timezone	Regione/Locale	Deve corrispondere al nome del fuso orario definito in  piattaforma (solo il nome senza GMT + XX:XX). L’elenco completo è disponibile nell’area Configurazione, nella tab Data e Ora. Ad esempio, Gerusalemme deve essere identificata come “Asia/Jerusalem”, mentre Praga come “Europe/Prague”. Questo campo non è case-sensitive.
New Username	Stringa o Valore Numerico (Esempio: john.smith)	Questo campo non è case-sensitive. Questo campo può essere utilizzato per modificare lo username del profilo via CSV. Mappare la colonna del file CSV con lo username che si desidera modificare nei campi Username o User ID, e mappare la colonna del file CSV con il nuovo username nel campo New Username.
User ID	Numerico	Questo campo è l’identificativo interno dell’utente nel database di una specifica piattaforma (non è mostrato ovunque nell’interfaccia utente); è definito dalla piattaforma e non può essere modificato né rimosso. Un file CSV non può contenere sia questo campo che Username o UUID, in tal caso si riceverà un messaggio di errore durante l’import.  È possibile utilizzare questo campo per modificare gli username del profilo utente via CSV. Fare riferimento alle note riguardo il campo New Username.
Is Manager	no/yes	Quando il valore di questo campo è Yes, l’utente è creato come manager e può gestire i membri del suo team.
UUID	Numerico	Questo campo è l’identificativo univoco utente assegnato da Docebo a un utente; è determinato dalla piattaforma e non può essere modificato né rimosso. Un file CSV non può contenere sia questo campo che Username o UUID, in tal caso si riceverà un messaggio di errore durante l’import.  È possibile utilizzare questo campo per modificare gli username del profilo utente via CSV. Fare riferimento alle note riguardo il campo New Username.
“Type of Manager”	Username del manager associato all’utente	Il nome di questo campo è la descrizione della tipologia di manager, come definito in piattaforma (per esempio, Manager Diretto). È possibile inserire tante colonne di questo tipo, quante sono le tipologie di manager definite in piattaforma, nella sezione Tipologie di Manager

Ricorda che si possono assegnare permessi parziali ai Power User direttamente tramite questa funzione. È possibile identificare gli utenti con livello Power User e assegnare loro un profilo Power User. È tuttavia necessario utilizzare Power User per assegnare utenti, corsi, cataloghi e sedi.

Elenco dei formati di data accettabili corrispondenti a ciascuna lingua e codice linguistico.

Attenzione! La piattaforma utilizza le barre ( / ) per separare i nomi e i codici dei rami nel percorso (branch name path e branch code path) durante l'import dei rami. Se si intende utilizzare l'opzione branch name path e branch code path per importare i rami, evitare di creare nomi e codici di rami che contengano barre, dato che la piattaforma non supporta l'utilizzo di caratteri speciali per identificare il comportamento della stringa durante l'import dei rami.

Elenco dei fusi orari supportati.

Quali sono i valori accettati per i campi aggiuntivi utente?

Fare riferimento alla tabella che segue per informazioni sulla corretta configurazione dei valori dei file CSV al fine di garantire la corretta mappatura dei campi aggiuntivi degli utenti. Attenzione, la mappatura di questi campi dipende dal tipo di dati aggiuntivi configurati per gli utenti, ma il parametro per i campi aggiuntivi utilizzato nel file CSV deve corrispondere esattamente al parametro dei campi aggiuntivi in piattaforma per il corretto funzionamento della mappatura.

Campo dati utenti piattaforma	Valori CSV accettati per il campo (con esempi)	Note
Dropdown	Nome dell'elemento a tendina come stringa
Text Field	Stringa
Fiscal Code	Stringa
Country	Nome del Paese (stringa)	Deve essere conforme allo standard ISO 3166. Elenco dei Paesi supportati.
Date	YYYY-MM-DD
Yes/No Dropdown	0/1 no/yes false/true	Yes = 1, yes, true No = 0, no, false Questo campo non è case-sensitive
Text Field (Expanded)	Stringa

Importare utenti via CSV

Per un corretto caricamento dei file, è necessario creare il file CSV rispettando gli standard. Per visualizzare un esempio di file CSV formattato correttamente, premere Scarica il file CSV di esempio nel pannello a scomparsa. Il formato delle date incluse nel file è YYYY-DD-MM, ma potrebbe essere visualizzato diversamente in base al programma utilizzato per aprire il file CSV di esempio.

Dopo aver configurato correttamente il file, trascinarlo nell’area di upload del pannello a scomparsa o cercarlo sul proprio dispositivo.

Attenzione! La dimensione massima consentita per il file CSV importabili in Docebo è di 3MB.

Dopo il caricamento, premere Configurazione avanzata: il sistema è configurato per identificare automaticamente il separatore, necessario per organizzare le informazioni in colonne. Le informazioni possono essere separate da virgolea, punto e virgola, o manualmente, in base alle esigenze.

Definire se la prima riga è considerata Intestazione (solo se rispecchia la formattazione del file CSV), e selezionare il Charset del file dal menu a tendina. Il charset consigliato è UTF-8, che è uno standard. Ricordarsi di utilizzare le virgolette per delimitare il contenuto del testo. Premere Conferma per caricare il file .csv.

Il sistema elaborerà il file CSV e ridirezionerà nella pagina di import. Nel pannello di sinistra, nella sezione Opzioni di importazione, decidere se selezionare le seguenti opzioni:

Profili

Nella sezione Preset è possibile selezionare un preset dal menu a tendina per associare la configurazione di una mappatura precedente all’import CSV in corso. I preset sono associati all'utente che si sta utilizzando per svolgere l'azione di import. La lista dei preset salvati è inoltre visibile in altre parti della piattaforma, come le iscrizioni degli utenti ai corsi tramite CSV.

Premere Sovrascrivi configurazione attuale per completare questa azione. È inoltre possibile mappare le colonne dei campi LMS (ulteriori informazioni in seguito) e salvare la configurazione premendo Salva come nuova configurazione. Definire il nome della nuova configurazione del preset, e premere Salva.

Attenzione! Una volta creato, non è possibile eliminare un preset, ma, se si vuole, è possibile sovrascriverlo.

Opzioni generali di importazione

Questa sezione include diversi parametri necessari a regolamentare la procedura di import:

• Forza gli utenti a cambiare la propria password al primo accesso. Se questa opzione è attiva, gli utenti saranno forzati a modificare la propria password al primo accesso in piattaforma. È comunque possibile forzare il cambio password degli utenti creando la colonna corrispondente nel file CSV e creando la corrispondenza con il campo Force Password Change.
• Non forzare gli utenti esistenti a cambiare la propria password. Quando questa opzione è selezionata, gli utenti già esistenti in piattaforma e presenti anche nel file CSV non dovranno aggiornare la propria password come i nuovi utenti (se l’opzione Forza gli utenti a cambiare la propria password al primo accesso è attiva).
• Invia Notifiche. Se questa opzione è attiva, tutti gli utenti importati in piattaforma riceveranno un’email di benvenuto alla fine della procedura di import. Se questa opzione non è attiva, gli utenti non riceveranno l’email di notifica, ma sarà comunque possibile inviarla successivamente dalla pagina di Gestione degli Utenti della piattaforma. Si noti che la notifica Utente creato (dall'amministratore) non viene inviata se non è stata configurata dall'amministratore nell'app Notifiche.
• Crea nuovi rami quando i campi "branch name path" e "branch code path" sono entrambi mappati e il valore del campo (ramo) non esiste in piattaforma. Quando questa opzione è selezionata, e sia il campo branch name path che il campo branch code sono mappati nel file CSV, la procedura di import creerà un nuovo ramo in piattaforma, in base al nome e al path definito nel file. 

Note sulle opzioni generali di importazione

Le opzioni Forza gli utenti a cambiare la propria password al primo accesso e Non forzare gli utenti esistenti a cambiare la propria password lavorano entrambe sull'obbligo di modificare la password, ma la prima opzione riguarda solo la modifica della password per gli utenti appena creati, mentre la seconda riguarda solo gli utenti esistenti.

Aggiorna utenti

Questa opzione permette di configurare come le informazioni degli utenti esistenti saranno aggiornate con l’import del file CSV. Quando questa opzione è selezionata, le informazioni importate e riguardanti gli utenti già presenti in piattaforma sovrascriveranno le informazioni utenti esistenti solo se il ramo dell’utente è invariato. Se invece il ramo indicato nel file CSV è diverso da quello attualmente assegnato agli utenti, e la piattaforma è stata attivata prima del 21 Ottobre 2019, è possibile definire se copiare o spostare gli utenti coinvolti dalla modifica nel nuovo ramo di assegnazione. Se la data di attivazione della piattaforma è successiva al 21 Ottobre 2019, in caso di aggiornamento dei dati per gli utenti esistenti, gli utenti saranno spostati di default al nuovo ramo di destinazione, l’opzione relativa alla copia non sarà disponibile. Questo significa che un utente non potrà essere assegnato a più rami.

• Aggiungi utenti al ramo. Quando gli utenti sono copiati in un altro ramo, sono disponibili in più rami. Questa opzione è disponibile solo se la piattaforma è stata attivata prima del 21 Ottobre 2019. In questo modo, gli utenti del file saranno disponibili in più rami.
• Sposta utenti nel ramo. Quando gli utenti sono spostati da un ramo all’altro, non sono più disponibili nel ramo di origine. Se sono assegnati a più rami, saranno cancellati da tutti i rami e spostati al nuovo ramo. In questo modo, gli utenti nel file saranno in un solo ramo. 

Attenzione!  Per essere conformi a normative (come ad esempio il GDPR) che potrebbero richiedere che gli account di persone che non lavorano più presso un'azienda vengano resi anonimi, consigliamo di modificare username, nome, cognome ed email, utilizzando invece un codice, in modo che sia comunque possibile avere statistiche complete, ma rendendo così anonima l'identità dell'utente. Queste modifiche possono essere effettuate con un aggiornamento via CSV o tramite API (batch import utenti).

Aggiorna profili

Utilizzare questa opzione per configurare se i profili assegnati ai Power User già presenti in piattaforma saranno aggiornati importando il file CSV. Selezionando questa opzione, i profili Power User importati sovrascriveranno le assegnazioni ai profili attualmente definiti in piattaforma.

Ramo di destinazione - fallback

Questa sezione è utilizzata per la configurazione di un ramo di destinazione di “emergenza”, nel caso in cui il ramo di destinazione non sia mappato nell’area Anteprima, o nel caso in cui sia mappato ma il valore sia vuoto. Definire se:

• Nessuna Azione. Quando questa opzione è selezionata, e il file CSV include degli utenti da aggiornare, le informazioni utente non saranno aggiornate, e gli utenti non subiranno modifiche. Se il file CSV include dei nuovi utenti, saranno creati nella cartella root Docebo.
• Utilizza ramo esistente. Quando questa opzione è selezionata, gli utenti aggiornati saranno spostati in uno dei rami esistenti, selezionabile da un menu a tendina. 

Assegna automaticamente i rami ai Power User

Da questa area è possibile configurare se associare direttamente i Power User creati dal file CSV nel ramo (e sotto-rami) che gestiscono, creando una semplice associazione al ramo, o un’associazione fra i rami e i sotto-rami.

• Non assegnare automaticamente ai rami. Quando questa opzione è selezionata, i Power User non saranno assegnati automaticamente ai rami, e sarà necessario attivare l’associazione manualmente.
• Solo i rami assegnati. Quando questa opzione è selezionata, i Power User gestiranno il ramo a cui sono stati assegnati durante la procedura di creazione.
• Assegna rami e sotto-rami. Quando questa opzione è selezionata, i Power User gestiranno i rami a cui sono stati assegnati durante la procedura di creazione, e i relativi sotto-rami.

Attenzione! Se si seleziona l'opzione Solo i rami assegnati oppure Assegna Rami e Sotto-Rami, affinché gli utenti siano assegnati automaticamente a un Power User nella pagina Assegna Utenti (che si raggiunge cliccando l'icona utenti dalla riga relativa al Power User nella pagina di gestione dei Power User), è necessario soddisfare le seguenti condizioni:

• Il file CSV deve contenere (almeno) i seguenti campi: Username, Profile Name, Level, Branch Code o Branch Name oppure sia Branch Name Path sia Branch Code Path
• Se il Power User esiste già nel sistema, dev'essere selezionata l'opzione Aggiorna le informazioni degli utenti esistenti nella sezione Aggiorna Utenti

La sezione Anteprima mostrerà l’anteprima del file CSV come letto dal sistema. Trascinare i campi della sezione Campi Docebo a sinistra e creare delle corrispondenze con i nomi delle colonne del file CSV.

Attenzione: Il formato corretto per la data è YYYY-MM-DD. Quando si completa un import CSV degli utenti, tenere presente che i campi seguenti non sono case sensitive: User status, User level, Language, Country, Timezone, Yes/No additional field.

Dopo aver creato le associazioni per tutte le colonne, controllare le informazioni nella pagina di import e premere Importa in fondo alla pagina. Confermare le informazioni nella finestra pop up e premere Importa utenti.

L’import è una procedura di background. In caso di errori, sarà creato un file con gli errori e sarà possibile scaricarlo. Per scaricare questo file, accedere al Menu amministrazione e selezionare Attività di background. Individuare l’attività nell’elenco per scaricare il file.

Tutti gli utenti importati in piattaforma saranno visualizzati nella pagina di Gestione degli Utenti, dove è possibile modificare i profili e cancellarli nella piattaforma, se necessario. 

Attivare o disattivare utenti via CSV

Quando gli utenti sono attivati, le credenziali di accesso sono valide e possono usarle con connettersi ed accedere alla piattaforma. Quando gli utenti sono diattivati, non possono più connettersi e accedere alla piattaforma.

I Superadmin possono attivare e disattivare gli utenti in piattaforma attraverso i file CSV. Per farlo, includere la colonna active nel file CSV, ed associarla al Campo Docebo chiamato Active, trascindandola dall'area Campi Docebo all'area Anteprima (come mostrato nel capitolo precedente di questo articolo). Quando il valore del campo Active è definito ad 1, significa che l'utente corrispondente è attivato, se è definito a 0, l'utente è disattivato.

Suggerimenti

• Quando si creano utenti attraverso un file CSV e la piattaforma è configurata in modo da inviare una notifica all'utente al momento della creazione, se la notifica include lo shortcode [password], la notifica ricevuta dall'utente includerà un link per il reset della password, e non la password stessa.
• Quando si carica un file CSV con intestazione (ad es., i "titoli" delle colonne), si consiglia di selezionare l'opzione "Considera la prima riga come intestazione".
• In base ai campi utenti che si desidera importare, è possibile scegliere se importare gli utenti utilizzando file CSV, attraverso SAML o attraverso l'App Automation. Confronto fra i campi che è possibile importare con l'App Automation e con SAML.
• Per aggiornare un solo campo (ad esempio definire il manager o il fuso orario), al momento della creazione del file CSV, includere solo la colonna username e le colonne degli attributi che si desidera aggiornare. Non è necessario sovrascrivere gli attributi esistenti con gli stessi valori, perché se i campi non sono presenti nel file di import, non saranno aggiornati.
• Se nel file CSV è presente un Superadmin (se stessi o un altro Superadmin) che ha aperto l'app White Label e ha salvato la configurazione, non è possibile aggiornare la riga relativa a questo Superadmin nel file CSV. È possibile eliminare la riga, oppure aggiornare manualmente i dati utente del Superadmin manualmente e singolarmente, non via CSV.
• Assicurati che il charset del tuo file CSV sia UTF-8, e di selezionare UTF-8 come charset del file anche nel pannello Importa Utenti via CSV, in modo che i caratteri speciali come l'Umlauts (Ü) siano importati correttamente.
• Alcuni fogli di calcolo, come Excel, possono alterare il formato dei dati se non importati correttamente. Fare riferimento al post della Community di Docebo sui problemi di formattazione dei caratteri speciali (si apre in una nuova tab) per ulteriori informazioni su come assicurarsi che i caratteri speciali e gli accenti siano importati correttamente.