Linee guida per l’importazione di file CSV
Puoi automatizzare l’aggiunta di utenti creando un file con valori delimitati da virgole (CSV) con informazioni utente e poi importando il file. Puoi includere attributi nel file CSV, ad esempio il livello di licenza e l’accesso alla pubblicazione, da applicare agli utenti contemporaneamente alla loro importazione.
Per importare gli utenti puoi utilizzare le pagine di amministrazione del sito oppure l’utilità tabcmd
. L’utilizzo di tabcmd
fornisce un’opzione per assegnare un ruolo del sito a tutti gli utenti nel file CSV. Per informazioni, consulta Importare utenti o createsiteusers filename.csv.
Requisiti per i formati di file CSV
Quando crei il file CSV per l’importazione degli utenti, verifica che il file soddisfi i requisiti di formattazione seguenti:
Il file non include intestazioni di colonna. Tableau Cloud presuppone che ogni riga del file rappresenti un utente.
Il file è in formato UTF-8 e include il byte order mark (BOM).
Le codifiche di caratteri, ad esempio BIG-5, sono state convertite in UTF-8. A tale scopo, apri il file in un editor di testo e utilizza il comando Salva come.
Se un nome utente include un carattere @ che rappresenta qualcosa di diverso da un separatore di dominio,devi fare riferimento al simbolo che utilizza il formato esadecimale:
\0x40
Ad esempio
user@fremont@mycompany.com
dovrebbe essereuser\0x40fremont@mycompany.com
Colonne obbligatorie nel file CSV
Per ogni utente è obbligatorio indicare i campi seguenti:
Nome utente: l’indirizzo e-mail dell’utente.
Password. Tableau Cloud non utilizza questo campo, ma devi delimitarlo in ogni riga per posizionare correttamente i campi successivi.
Opzioni aggiuntive della colonna CSV
Per ogni utente, il file CSV può contenere i campi seguenti oltre alle colonne richieste. Se indicato, Tableau Cloud non utilizza il campo ma deve essere considerato nel file.
URI del sito (solo Tableau Cloud Manager): l'identificatore uniforme della risorsa per il sito. Per importare un utente come amministratore cloud, includi la colonna URI sito ma lasciala vuota.
Nome visualizzato. Tableau Cloud non utilizza questo campo, ma devi delimitarlo in ogni riga per posizionare correttamente i campi successivi.
Livello di licenza. Questo può essere Creator, Explorer, Viewer, o Senza licenza.
Livello amministratore: il valore può essere Cloud, Sito o Nessuno. Cloud = amministratore cloud, Sito = amministratore del sito e Nessuno = non un amministratore.
Nota: il valore amministratore cloud è disponibile solo quando si importano utenti in Tableau Cloud Manager. Non è destinato all'uso con i siti Tableau Cloud. Per ulteriori informazioni, consulta Gestire gli utenti con Tableau Cloud Manager.
Funzionalità di pubblicazione. I valori accettabili sono Sì/Vero/1 o No/Falso/0. Se il livello di licenza è Creator, la funzionalità di pubblicazione deve essere Sì/Vero/1.
Tipo di autenticazione (solo Tableau Cloud Manager): il tipo di autenticazione dell'utente per l'accesso a un sito o a Tableau Cloud Manager.
Voci campione del file CSV
Sito Tableau Cloud
L’esempio seguente mostra un utente cui verrà concesso il ruolo del sito Explorer, non è un amministratore del sito e sarà in grado di effettuare pubblicazioni in progetti per i quali dispone delle autorizzazioni di contenuto appropriate.
user1@domain.com,,,Explorer,None,true
Modificando la colonna livello amministratore, puoi importare l’utente seguente come amministratore del sito con il ruolo di Explorer amministratore sito.
adminuser@domain.com,,,Explorer,Site,true
Tableau Cloud Manager
L'esempio seguente mostra un utente a cui viene concesso il ruolo di amministratore cloud in Tableau Cloud Manager e si autentica utilizzando Tableau con MFA.
,cloudadminuser@domain.com,,,,Cloud,,Tableau with MFA
Modificando la colonna di autenticazione, puoi importare il seguente utente con un tipo di autenticazione alternativo se configurato nelle impostazioni di Tableau Cloud Manager.
,cloudadminuser@domain.com,,,,Cloud,,Salesforce
Note
Se il file CSV contiene solo i valori dei nomi utente (indirizzi e-mail), gli utenti riceveranno un invito al sito via e-mail. Gli utenti possono accedere al sito per creare i propri account, ma gli account rimangono senza licenza finché un amministratore non li configura (nome visualizzato, livello di licenza e così via).
I campi password (secondo valore) e nome visualizzato (terzo valore) non vengono utilizzati da Tableau Cloud. I valori che specifichi per questi campi vengono ignorati.
Se tuttavia, desideri impostare la licenza e pubblicare l’accesso per gli utenti, il file deve comunque includere i delimitatori per questi campi, come illustrato nell’esempio precedente.
I nuovi utenti devono selezionare una password e un nome visualizzato quando accedono per la prima volta a Tableau Cloud. Se gli utenti dispongono già di un account Tableau, ad esempio per i forum della Community Tableau, sono già in possesso delle password.
Il file CSV non include un campo per l’impostazione del tipo di autenticazione (Tableau, Google o SAML). Questa lo specifichi in Tableau Cloud al momento dell’importazione del file. L’impostazione si applica a tutti gli utenti importati e puoi modificare il tipo di autenticazione per i singoli utenti in una fase successiva.
Nota: in alternativa puoi utilizzare
tabcmd
per importare gli utenti e impostare il tipo di autenticazione e il ruolo di sito applicabili a tutti gli utenti nel file CSV. Per informazioni, consulta createsiteusers filename.csv.
Impostazioni CSV e ruoli del sito
Il livello di licenza, di amministratore e le impostazioni di pubblicazione per un utente determinano il modo in cui il ruolo del sito dell’utente è impostato durante il processo di importazione. Nella tabella seguente viene illustrata la conversione delle impostazioni in ruoli del sito.
Impostazioni CSV | Ruolo sul sito |
---|---|
Livello di licenza=Senza licenza Amministratore=Cloud Publisher=falso | Amministratore cloud. Questa impostazione è valida solo se importi utenti mentre sei connesso a Tableau Cloud Manager (ovvero non connesso a un sito specifico). |
Livello di licenza=Creator o Explorer Amministratore=Sito Publisher=vero | Creator amministratore sito o Explorer amministratore sito. Questa impostazione è valida solo se importi utenti mentre sei connesso a un sito specifico. |
Livello di licenza=Creator Amministratore=Nessuno Publisher=vero | Creator |
Livello di licenza=Explorer Amministratore=Nessuno Publisher=vero | Explorer (autorizzato a pubblicare) |
Livello di licenza=Explorer Amministratore=Nessuno Publisher=falso | Explorer |
Livello di licenza=Viewer Amministratore=Nessuno Publisher=falso | Viewer |
Livello di licenza=Senza licenza Amministratore=Nessuno Publisher=falso | Senza licenza |