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:

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ö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 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ösenordignoreras. 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.

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ösenordignoreras. 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.

PlatsrollLicensnivå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).

OlicensieradMolnFalskt

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
Tack för din feedback!Din feedback har skickats in. Tack!