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:
- Använda sidan för platsadministration. Mer information finns i Importera användare.
- Använda verktyget
tabcmd
. Mer information finns i createsiteusers filnamn.csv. - Använda Tableau Cloud Manager. Mer information finns i Hantera användare med Tableau Cloud Manager.
Krav för CSV-filformat
CSV-filen för att importera användare har följande formateringskrav:
- Inga kolumnrubriker. Tableau Cloud 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öruser@fremont@mycompany.com
varauser\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 Cloud CSV
Om CSV-filen endast innehåller användarnamnsvärden (e-postadresser) kommer användarna att få en e-postinbjudan till platsen. Användarna kan gå med på platsen för att skapa sina konton, men kontona förblir olicensierade tills en administratör konfigurerar kontona (visningsnamn, licensnivå och så vidare). En användares e-postadress kan visas med en inledande punkt på platsen (t.ex. .user@domain.com
) fram tills att användaren loggar in för första gången.
Kolumnstruktur för CSV-filen: användarnamn, lösenord, visningsnamn, licensnivå, administratörsnivå, publiceringskapacitet, e-postadress
Kolumninformation:
Användarnamn: obligatoriskt. Användarens e-postadress.
Lösenord: ignoreras. Enligt praxis bör du lämna den här kolumnen tom.
- Nya användare måste välja ett lösenord och ett visningsnamn första gången de loggar in på Tableau Cloud. Om en användare redan har ett Tableau-konto kan det hända att de redan har ett lösenord.
Visningsnamn: ignoreras. Enligt praxis bör du lämna den här kolumnen tom.
Licensnivå: Värdet kan vara Creator, Explorer, Viewer eller Olicensierad. Om detta lämnas tomt blir licensnivån Olicensierad.
Administratörsnivå: Värdet kan vara Plats eller Ingen. Om detta lämnas tomt blir administratörsnivån Ingen.
- Plats = platsadministratör, Ingen = Inte administratör.
- Obs! Cloud är bara ett relevant värde när du använder Tableau Cloud Manager. Mer information finns i Hantera användare med Tableau Cloud Manager.
Publiceringskapacitet: Värdet kan vara Ja/Sant/1 eller Nej/Falskt/0. Om detta lämnas tomt blir publiceringskapaciteten Falskt.
- 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: Från och med juli 2025 (Tableau 2025.2) ska du ange en e-postadress om den skiljer sig från användarnamnet. E-postadresser används endast i meddelandesyfte. Om inget e-postadressvärde anges använder Tableau Cloud värdet i det obligatoriska användarnamnsfältet som mottagare.
Alla kolumner som lämnas tomma måste ändå avgränsas med kommatecken för att bevara kolumnstrukturen.
Autentiseringstyp utan TCM
Om du inte använder Tableau Cloud Manager kan du bara ställa in en enda standardautentiseringstyp under uppladdningen. Du kan ändra autentiseringstyp för enskilda användare efteråt.
- När du laddar upp en CSV-fil direkt till Tableau Cloud kan du ange autentiseringstyp vid importen, så gäller den typen för alla importerade användare.
- När du använder
tabcmd
för att importera användare ställer du in autentiseringstyp och platsroll för alla användare i CSV-filen under uppladdningen. Mer information finns i createsiteusers filnamn.csv.
Om du vill ställa in en specifik autentiseringstyp per användare vid uppladdningen måste du använda Tableau Cloud Manager. Mer information finns i Hantera användare med Tableau Cloud Manager.
Exempel på CSV-struktur för Tableau Cloud
Tips: Kom ihåg att strukturen är username, password, display name, license level, administrator level, publishing capability, email address
, utan något mellan kommatecknen när en kolumn lämnas tom.
Följande exempel visar en användare som är beviljad platsrollen Explorer (kan publicera), inte kommer att vara platsadministratör och kommer att kunna publicera i projekt där användaren har rätt innehållsbehörighet.
user1@domain.com,,,Explorer,None,true,user1@domain2.com
Genom att ändra kolumnen på administratörsnivå kan du importera följande användare som platsadministratör med platsrollen Platsadministratör – Explorer
adminuser@domain.com,,,Explorer,Site,true
,adminuser@domain2.com
Kolumninformation för CSV i TCM
Om CSV-filen endast innehåller användarnamnsvärden (e-postadresser) kommer användarna att få en e-postinbjudan till platsen. Användarna kan gå med på platsen för att skapa sina konton, men kontona förblir olicensierade tills en administratör konfigurerar kontona (visningsnamn, licensnivå och så vidare).
Tänk på att kolumner som lämnas tomma ändå måste avgränsas med kommatecken för att bevara kolumnstrukturen.
Kolumnstruktur för CSV-filen: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type
Kolumninformation:
Klient- eller plats-URI: Den enhetliga resursidentifieraren för klienten eller platsen.
Användarnamn: obligatoriskt. Användarens e-postadress.
Lösenord: ignoreras. Enligt praxis bör du lämna den här kolumnen tom.
- Nya användare måste välja ett lösenord och ett visningsnamn första gången de loggar in på Tableau Cloud. Om en användare redan har ett Tableau-konto kan det hända att de redan har ett lösenord.
Visningsnamn: ignoreras. Enligt praxis bör du lämna den här kolumnen tom.
Licensnivå: Värdet kan vara Creator, Explorer, Viewer eller Olicensierad för platsen. Om detta lämnas tomt blir licensnivån Olicensierad.
Administratörsnivå: Värdet kan vara Plats, Moln eller Ingen. Om detta lämnas tomt blir administratörsnivån Ingen.
- Plats = platsadministratör, Ingen = Inte administratör, Cloud = molnadministratör.
Publiceringskapacitet: Värdet kan vara Sant eller Falskt för platsen. Om detta lämnas tomt blir publiceringskapaciteten Falskt.
- Om licensnivån är Creator måste publiceringskapaciteten vara Sant.
- 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.
Autentiseringstyp: Användarens autentiseringstyp för åtkomst till en klient eller plats. Värdet kan vara Google, OpenID, Salesforce, SAML, TableauIDWithMFA eller STANDARD.
Exempelstruktur för CSV i TCM
Tips: Kom ihåg att strukturen är tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type
, utan något mellan kommatecknen när en kolumn lämnas tom.
Följande exempel visar en användare som tilldelas rollen som molnadministratör i Tableau Cloud Manager och autentiserar med Tableau med flerfaktorautentisering.
MyTCM,cloudadminuser@domain.com,,,,Cloud,,,TableauIDWithMFA
Genom att ändra autentiseringskolumnen kan du importera följande användare med en alternativ autentiseringstyp om den är konfigurerad i Tableau Cloud Manager-inställningarna.
MyTCM,cloudadminuser@domain.com,,,,Cloud,,,Salesforce
I följande exempel kan du importera användaren med platsrollen Explorer (kan publicera) med Tableau med flerfaktorsautentisering.
MySite,user1@domain.com,,,Explorer,None,True,,TableauIDWithMFA
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.
Platsroll | Licensnivå | Administratörsnivå | Publiceringskapacitet |
Molnadministratör Den här rollen är bara giltig om du importerar användare när du är inloggad på Tableau Cloud Manager (det vill säga inte är inloggad på en specifik plats). | Olicensierad | Moln | Falskt |
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 Explorer | Plats | Sant |
Creator | Creator | Inget | Sant |
Explorer (kan publicera) | Explorer | Inget | Sant |
Explorer | Explorer | Inget | Falskt |
Viewer | Viewer | Inget | Falskt |
Olicensierad | Olicensierad | Inget | Falskt |