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 utenti, puoi utilizzare le pagine di amministrazione del server o 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.

Puoi importare utenti a livello di sito o di server. Se importi utenti sul server (non su un sito specifico), gli utenti non vengono assegnati a un sito e vengono importati come Senza licenza.

Nota: se non diversamente specificato, le linee guida specificate in questo argomento si applicano a Tableau Server quando è configurato con o senza pool di identità(Il collegamento viene aperto in una nuova finestra).

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 Server 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. Il nome utente. Se il server è configurato per l’utilizzo di Active Directory, questo valore deve corrispondere a un utente definito in Active Directory. Se il nome utente non è univoco tra domini, devi includere il dominio come parte del nome utente (ad esempio example\Adam , ) adam@example.

    Se aggiungi utenti a un pool di identità(Il collegamento viene aperto in una nuova finestra), verifica quanto segue:

    • Se aggiungi un utente a un pool di identità che utilizza AD come archivio identità, assicurati di utilizzare il valore sAMAccountName di AD per il nome utente.
    • Se aggiungi un utente a un pool di identità che utilizza LDAP come archivio identità, assicurati di utilizzare il valore username di LDAP per il nome utente.

  • Password. Una password per l’utente.

    • Se il server è configurato per l'utilizzo di Active Directory, questo valore non viene utilizzato, tuttavia deve essere presente una colonna password e la colonna stessa deve essere vuota.

    • Se il server utilizza l’autenticazione locale, devi fornire le password per i nuovi utenti.

    Nota: l'applicazione del campo password richiesta è stata avviata in Tableau Server 2024.2. Per maggiori informazioni, consulta l’articolo della Knowledge Base Si verifica un errore "errorCode=134" imprevisto quando si tenta di aggiungere utenti tramite tabcmd in Tableau Server 2024.2.

Opzioni aggiuntive per l’importazione di file

Il file CSV può contenere i campi seguenti in aggiunta ai campi elencati in precedenza, nell’ordine indicato:

  • Nome visualizzato. Il nome visualizzato fa parte delle informazioni utilizzate per identificare un utente nel server. Se il nome visualizzato dell’utente è già in uso, Tableau Server aggiorna le informazioni esistenti dell’utente con le impostazioni nel file CSV. Se il server è configurato utilizzando Active Directory, questo valore non viene utilizzato.

  • Livello di licenza. Questo può essere Creator, Explorer, Viewer, o Senza licenza. Se specifichi Creator per un particolare account utente, è anche necessario impostare la funzionalità di pubblicazione su VERO.

  • Livello di amministratore (Sistema, Sito, o Nessuno). Questa impostazione determina se l’utente è importato come amministratore.

    Se utilizzi l’interfaccia utente Web per importare gli utenti, puoi impostare il ruolo del sito di amministratore su Sistema solo se importi il file a livello di server (Tutti i siti). Se hai effettuato l’accesso a un sito specifico e se la colonna di amministratore per un utente nel file CSV è impostata su Sistema, Tableau Server importa l’utente come amministratore del sito.

  • Funzionalità di pubblicazione (sì/vera/1 o nessuna/falsa/0). Se utilizzi l’interfaccia utente Web, l’impostazione dell’editore viene utilizzata solo se effettui l’importazione mentre sei connesso a un sito specifico.

  • Indirizzo e-mail. L’indirizzo e-mail fa parte delle informazioni utilizzate per identificare un utente sul server. Se l’indirizzo e-mail dell’utente è già in uso, Tableau Server aggiorna le informazioni esistenti dell’utente con le impostazioni nel file CSV.

Se aggiungi utenti a un pool di identità, oltre a quelli precedenti sono necessari i seguenti valori:

  • Nome del pool di identità. Nome del pool di identità a cui vuoi aggiungere l’utente.

  • Identificatore. Identificatore dell’utente che vuoi aggiungere. Gli identificatori vengono utilizzati solo per l’abbinamento delle identità. Per ulteriori informazioni, consulta Nomi utente e identificatori in Tableau. Nota: l’identificatore è obbligatorio se si aggiunge un utente a un pool di identità che utilizza l’archivio identità Active Directory (o LDAP). L’identificatore è facoltativo se si aggiunge un utente a un pool di identità che utilizza l’archivio identità locale.

    Note:

    • Se aggiungi utenti a un pool di identità e non specifichi il nome del pool, gli utenti vengono aggiunti al pool iniziale (configurato per TSM), che corrisponde all’insieme di utenti di cui è stato eseguito il provisioning in TSM durante l’installazione di Tableau Server.

    • Per il valore del nome utente, verifica quanto segue:

      • Se aggiungi un utente a un pool di identità che utilizza AD come archivio identità, assicurati di utilizzare il valore sAMAccountName di AD per il nome utente.
      • Se aggiungi un utente a un pool di identità che utilizza LDAP come archivio identità, assicurati di utilizzare il valore username di LDAP per il nome utente.

    • Puoi utilizzare il processo di importazione CSV per:

      • Aggiungere in blocco utenti a pool di identità aggiuntivi. Nota: non è possibile utilizzare il processo di importazione CSV per sostituire il pool di identità a cui appartiene già un utente con un altro pool di identità. Se aggiungi un utente esistente con un valore diverso per il pool di identità, l’utente verrà aggiunto a tale pool di identità aggiuntivo.

      • Aggiungere in blocco gli identificatori per gli utenti che non li hanno già. Nota: se aggiungi un identificatore diverso per un utente nello stesso pool, non sostituirà l’identificatore esistente per tale utente. Verrà invece creato un nuovo record dell’identificatore per l’utente.

Importante: l’ordine delle colonne è significativo. La prima colonna viene trattata come nome utente, la seconda come password, la terza come nome visualizzato e così via, indipendentemente dal contenuto delle colonne. Se ometti i valori per un campo, devi comunque includere il delimitatore virgola del campo.

Migliorare le prestazioni per file CSV di grandi dimensioni passati tramite tabcmd

Nota: queste impostazioni si applicano a Tableau Server 2022.1 e versioni precedenti. Il servizio di ricerca e indicizzazione interessato da tali impostazioni è stato deprecato a partire dalla versione 2022.3 e ritirato (rimosso completamente) nella versione 2023.3.

Un amministratore del server può attivare le impostazioni del server allo scopo di migliorare le prestazioni per l’importazione di file CSV di grandi dimensioni tramite comandi tabcmd. A tale scopo, puoi utilizzare il comando tsm configuration set con le opzioni seguenti:

  • vizportal.csv_user_mgmt.index_site_users

  • vizportal.csv_user_mgmt.bulk_index_users

  • searchserver.index.bulk_query_user_groups

In linea di massima queste opzioni indicizzano gli utenti dopo l’elaborazione del file CSV, anziché uno per uno nel momento in cui vengono aggiunti al database del server. Ciò riduce il numero di chiamate al database e la memoria necessaria per elaborare il file. Queste opzioni tsm configuration set sono applicabili ai comandi tabcmd createsiteusers, deletesiteusers, adduserse removeusers.

Per le descrizioni di queste impostazioni, consulta Opzioni di tsm configuration set.

Note

  • Se non hai effettuato l’accesso a un sito specifico e importi utenti a livello di server,puoi assegnare solo i ruoli del sito Amministratore di Server e Senza licenza.

  • Se disponi di un’installazione server basata sull’utente e se aggiungendo utenti superi il numero consentito dalla licenza, questi vengono aggiunti come utenti senza licenza.

  • Se utilizzi tabcmd e specifichi la licenza, ma l’importazione degli utenti comporterebbe un superamento dei limiti di licenza, gli utenti verranno importati come Senza licenza.

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 CSVRuolo sul sito

Livello di licenza=(qualsiasi)

Amministratore=Sistema

Publisher=vero

Amministratore del server. Questa impostazione si applica solo al Tableau Server ed è valida solo effettui l’importazione degli utenti durante la gestione del server (ovvero senza l’accesso a un sito specifico).

Il ruolo del sito Amministratore del server prende sempre una licenza di Creator se disponibile. Se non è disponibile alcuna licenza di Creator, consulta Risoluzione dei problemi di licenza per apprendere come Tableau Server gestisce la questione.

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

Esempi di importazione CSV per Tableau Server

L’esempio seguente mostra un file CSV contenente informazioni per diversi utenti.

marior,mariopassword,Mario Rossi,Creator,None,yes,marior@example.com
freds,fredpassword,Fred Suzuki,Viewer,None,no,freds@example.com
alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw@example.com
michellek,michellepassword,Michelle Kim,Creator,System,yes,michellek@example.com

Se importi questo file durante la gestione di un sito, verranno aggiunti quattro utenti a tale sito. L’impostazione Administrator per l’utente Michelle è System. Tuttavia, poiché importi gli utenti in un sito, Tableau Server concede a Michelle il ruolo di Creator amministratore sito. A tre degli utenti è consentito pubblicare.

Se importi questo file durante la gestione del server, quattro utenti vengono aggiunti a quest’ultimo ma non vengono aggiunti ad alcun sito. Viene importato un solo utente come amministratore del server, mentre il resto viene impostato su Senza licenza.

Esempi di pool di identità

L’esempio seguente mostra un file CSV contenente informazioni per due utenti aggiunti a un pool di identità.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki

L’esempio seguente mostra un file CSV contenente informazioni per due utenti aggiunti a un pool di identità aggiuntivo.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors 2,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki

L’esempio seguente mostra un file CSV contenente informazioni per due utenti senza identificatori esistenti.

janes,janepassword,Jane Smith,Viewer,None,yes,jsmith@myco.com,General Contractors,jwang
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez
Torna in alto
Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!