Riktlinjer för import av CSV-fil


Du kan lägga till flera användare samtidigt genom att skapa en fil med kommaavgränsade värden (CSV) med användarinformation och sedan importera filen. Du kan inkludera attribut i CSV-filen, till exempel licensnivå och publiceringsåtkomst, som ska gälla för användarna samtidigt som du importerar dem.

Det här ämnet omfattar informationen i själva CSV-filen. Om du vill importera användare med CSV-filen kan du:

Du kan importera användare på plats- eller servernivå. Om du importerar användare till servern (inte till en specifik plats) tilldelas användarna inte till en plats och importeras som olicensierade.

Obs! Om inget annat anges gäller riktlinjerna i detta ämne för Tableau Server, konfigurerat med eller utan identitetspooler(Länken öppnas i ett nytt fönster).

Krav för CSV-filformat

CSV-filen för att importera användare har följande formateringskrav:

  • Inga kolumnrubriker. Tableau Server förutsätter att varje rad i filen representerar en användare.
  • UTF-8-format med BOM (Byte Order Mark).
    • Teckenkodningar som BIG-5 måste konverteras till UTF-8. Du kan göra detta genom att öppna filen i en texteditor och använda kommandot Spara som.
    • Om tecknet @ förekommer i fältet användarnamn för något annat än en domänavgränsare måste det ha hexadecimalt format: \0x40. Till exempel bör user@fremont@mycompany.com vara user\0x40fremont@mycompany.com.

Nödvändig kolumnstruktur i CSV-filen

Filen får inte innehålla någon rubrikrad. Alla kolumner behöver inte fyllas i, men den nödvändiga kolumnstrukturen måste bevaras genom att alla förväntade kommaavgränsare inkluderas.

Kolumnstrukturen varierar beroende på produkt och importverktyg. Se till att du använder rätt struktur för den aktuella miljön:

  • Tableau Cloud: användarnamn, lösenord, visningsnamn, licensnivå, administratörsnivå, publiceringskapacitet, e-postadress
  • Tableau Cloud med Tableau Cloud Manager (TCM): klient- eller plats-URI, användarnamn, lösenord, visningsnamn, licensnivå, administratörsnivå, publiceringskapacitet, e-postadress, autentiseringstyp
  • Tableau Server: användarnamn, lösenord, visningsnamn, licensnivå, administratörsnivå, publiceringskapacitet, e-postadress
  • Tableau Server med identitetspooler: användarnamn, lösenord, visningsnamn, licensnivå, administratörsnivå, publiceringskapacitet, e-postadress, namn på identitetspool, identifierare

Avsnittet med kolumninformation nedan innehåller mer information om möjliga värden för varje kolumn.

Viktigt: Kolumnernas ordning är betydelsefull. Den första kolumnen behandlas som användarnamn, den andra som lösenord, den tredje som visningsnamn och så vidare, oavsett innehållet i kolumnerna. Om du utelämnar värden för ett fält måste du ändå inkludera fältets kommaseparator.

Kolumninformation för Tableau Server

Obs! Om du inte är inloggad på en specifik plats och importerar användare på servernivå kan du endast tilldela platsrollerna Serveradministratör och Olicensierad.

Kolumnstruktur för CSV-filen: username, password, display name, license level, admin level, publishing capability, email address

Kolumninformation: 

Användarnamn: obligatoriskt. Användarens namn.

  • Om servern är konfigurerad att använda Active Directory måste detta värde matcha en användare som definierats i Active Directory. Om användarnamnet inte är unikt för alla domäner inkluderar du domänen som en del av användarnamnet (till exempel example\Adam eller adam@example).
  • Garantera följande om användare läggs till i en identitetspool(Länken öppnas i ett nytt fönster):
    • Se till att använda värdet AD sAMAccountName för användarnamn om en användare läggs till i en identitetspool och använder AD som identitetsregister.
    • Se till att använda värdet LDAP username för användarnamn om en användare läggs till i en identitetspool och använder LDAP som identitetsregister.

Lösenord: användarens lösenord. Om den här kolumnen krävs eller inte beror på serverkonfigurationen:

Visningsnamn: Visningsnamnet är en del av den information som används för att identifiera en användare på servern. Om den här kolumnen används eller inte beror på serverkonfigurationen:

  • Lokal autentisering: Om användarens visningsnamn redan används uppdaterar Tableau Server den befintliga användarinformationen med inställningarna i CSV-filen.
  • Active Directory: Ignoreras. Enligt praxis bör du lämna den här kolumnen tom.

Licensnivå: Värdet kan vara Creator, Explorer, Viewer eller Olicensierad.

  • Om licensnivån är Creator måste publiceringskapaciteten vara Ja/Sant/1.
  • Om du har en användarbaserad serverinstallation och tillägg av användare skulle överstiga det antal användare som licensen medger, så läggs användarna till som olicensierade användare.
  • Om du använder tabcmd och anger licensen, men import av användare skulle överskrida licensgränserna, importeras användarna som olicensierade användare.

Administratörsnivå: Värdet kan vara System, Plats eller Ingen och avgör om användaren importeras som administratör.

  • System = serveradministratör, Plats = platsadministratör, Ingen = Inte administratör.
  • Om du inte är inloggad på en specifik plats och importerar användare på servernivå kan du endast tilldela Serveradministratör och Olicensierad.
  • Om du använder webbgränssnittet för att importera användare kan du bara ange administratörens platsroll till System om du importerar filen på servernivå (Alla platser). Om du är inloggad på en specifik plats, och om administratörskolumnen för en användare i CSV-filen är inställd på System, importerar Tableau Server användaren som en platsadministratör.

Publiceringskapacitet: Värdet kan vara Ja/Sant/1 eller Nej/Falskt/0. Om du använder webbgränssnittet används publiceringskapaciteten bara om du importerar medan du är inloggad på en viss plats.

  • Om licensnivån är Creator måste publiceringskapaciteten vara Ja/Sant/1.
  • Om licensnivån är Explorer är värdet för publiceringskapacitet det som skiljer platsrollen Explorer (kan publicera) från platsrollen Explorer.
  • Om licensnivån är Viewer eller Olicensierad kan användaren inte publicera oavsett värdet i den här kolumnen.

E-postadress: E-postadressen är en del av den information som används för att identifiera en användare på servern. Om e-postadressen redan används uppdaterar Tableau Server den befintliga användarinformationen med inställningarna i CSV-filen.

Alla kolumner som lämnas tomma måste ändå avgränsas med kommatecken för att bevara kolumnstrukturen.

Identitetspooler

Om du lägger till användare i en identitetspool behövs följande kolumner utöver standardkolumnerna:

Kolumnstruktur för CSV-filen: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

Ytterligare information om kolumner:

Identitetspoolens namn: Namnet på identitetspoolen där användaren ska läggas till. Om användare läggs till i en identitetspool och dess namn inte anges, läggs användare till i den initiala poolen (TSM-konfigurerad). Denna är den uppsättning användare som tilldelades i TSM under konfigurationen av Tableau Server.

Identifierare: Identifieraren för användaren som ska läggas till. Identifierare används endast för identitetsmatchning. Se Användarnamn och identifierare i Tableau för mer information.

  • Lokal autentisering: Valfritt
  • Active Directory eller LDAP: Obligatoriskt

Lägga till flera användare samtidigt med identitetspooler

Du kan använda CSV-importprocessen för följande:

  • Lägga till flera användare samtidigt i ytterligare identitetspooler. Obs! Du kan inte använda CSV-importprocessen för att ersätta en identitetspool som en användare redan tillhör med en annan identitetspool. Om du lägger till en befintlig användare med ett annat identitetspoolvärde läggs denne till i den ytterligare identitetspoolen.
  • Lägga till identifierare för användare som inte redan har dem. Obs! Om du lägger till en annan identifierare för en användare i samma pool ersätter den inte den befintliga identifieraren för den användaren. I stället skapas en ny identifieringspost för den användaren.

Exempel på CSV-import för Tableau Server

Tips: Kom ihåg att strukturen är: username, password, display name, license level, admin level, publishing capability, email address.

Följande exempel visar en CSV-fil som innehåller information för flera användare.

henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw@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
  • Om du importerar den här filen medan du hanterar en plats läggs fyra användare till på den platsen. Inställningen Administrator för användaren Michelle är System. Eftersom du importerar användarna till en plats tilldelas Michelle rollen Platsadministratör – Creator av Tableau Server. Tre av användarna får publicera.
  • Om du importerar den här filen medan du hanterar servern läggs fyra användare till på servern, men de läggs inte till på någon plats. Endast en användare importeras som serveradministratör. Resten är inställda på Olicensierade.

Exempel på identitetspooler

Tips: Kom ihåg att strukturen är: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier.

Följande exempel visar en CSV-fil som innehåller information för två användare som har lagts till i en identitetspool.

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

Följande exempel visar en CSV-fil som innehåller information för två användare som har lagts till i en ytterligare identitetspool.

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

Följande exempel visar en CSV-fil som innehåller information för två användare som inte har några befintliga identifierare.

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

Förbättra prestandan för stora CSV-filer som skickas genom tabcmd

Obs! Dessa inställningar gäller för Tableau Server version 2022.1 och tidigare. Sök- och indextjänsten de påverkar blev inaktuell från och med version 2022.3 och har fasats ut (tagits bort helt) i 2023.3.

En serveradministratör kan aktivera serverinställningar som hjälper till att förbättra prestandan för import av stora CSV-filer via tabcmd-kommandon. Du kan göra detta med kommandot tsm configuration set med följande alternativ:

  • vizportal.csv_user_mgmt.index_site_users
  • vizportal.csv_user_mgmt.bulk_index_users
  • searchserver.index.bulk_query_user_groups

I huvudsak indexerar dessa alternativ användare efter att CSV-filen har bearbetats, istället för att göra detta individuellt när användarna läggs till i serverns databas. Detta minskar antalet anrop till databasen och det minne som krävs för att bearbeta filen. Dessa tsm configuration set-alternativ gäller för removeusers-kommandona tabcmd createsiteusers deletesiteusers och addusers.

För beskrivningar av dessa inställningar, se Alternativ för tsm configuration set.

CSV-inställningar och platsroller

Inställningarna för licensnivå, administratör och publicering för en användare avgör hur dennes platsroll ställs in under importprocessen. Nedan ser du hur platsroller ska registreras i CSV-filen.

PlatsrollLicensnivåAdministratörsnivåPubliceringskapacitet

Serveradministratör

Den här rollen är bara giltig om du importerar användare medan du hanterar servern (det vill säga inte är inloggad på en specifik plats).

Alla, men platsrollen Serveradministratör kräver alltid en Creator-licens om en sådan finns. Om det inte finns någon Creator-licens, se Felsök licensiering för att lära dig mer om hur Tableau Server hanterar detta.SystemSant

Platsadministratör – Creator eller Platsadministratör – Explorer

De här rollerna är bara giltiga om du importerar användare när du är inloggad på en specifik plats.

Creator eller ExplorerPlatsSant
CreatorCreatorIngetSant
Explorer (kan publicera)ExplorerIngetSant
ExplorerExplorerIngetFalskt
ViewerViewerIngetFalskt
OlicensieradOlicensieradIngetFalskt
Tillbaka till toppen
Tack för din feedback!Din feedback har skickats in. Tack!