Richtlijnen voor CSV-importbestand

U kunt gebruikers in bulk toevoegen door een bestand met door komma's gescheiden waarden (CSV) met gebruikersinformatie te maken en het bestand vervolgens te importeren. U kunt kenmerken in het CSV-bestand opnemen, zoals het licentieniveau en de publiceringstoegang, die op de gebruikers toegepast moeten worden terwijl u ze importeert.

In dit onderwerp worden de details van het CSV-bestand zelf besproken. Als u gebruikers wilt importeren met behulp van het CSV-bestand, kunt u:

Vereisten voor CSV-bestandsindelingen

Het CSV-bestand voor het importeren van gebruikers heeft de volgende opmaakvereisten:

  • Geen kolomkoppen. Tableau Cloud gaat ervan uit dat elke regel in het bestand een gebruiker vertegenwoordigt.
  • UTF-8-indeling met byte-order-markering (BOM).
    • Tekencoderingen zoals BIG-5 moeten worden omgezet naar UTF-8. U kunt dit doen door het bestand in een teksteditor te openen en Opslaan als te kiezen.
    • Als het teken @ in het veld gebruikersnaam staat voor iets anders dan een domeinscheidingsteken, moet het in de hexadecimale notatie staan: \0x40. Zo moet user@fremont@mycompany.com worden geschreven als user\0x40fremont@mycompany.com.

Vereiste kolomstructuur in het CSV-bestand

Het bestand mag geen koptekstrij bevatten. Het is niet noodzakelijk dat alle kolommen worden ingevuld, maar de vereiste kolomstructuur moet wel behouden blijven door alle verwachte komma's als scheidingsteken op te nemen.

De kolomstructuur varieert per product en per hulpprogramma voor importeren. Zorg ervoor dat u de juiste structuur voor uw omgeving gebruikt:

  • Tableau Cloud: gebruikersnaam, wachtwoord, weergavenaam, licentieniveau, beheerdersniveau, publicatiemogelijkheid, e-mailadres
  • Tableau Cloud met Tableau Cloud Manager (TCM): gebruikersnaam, wachtwoord, tenant- of site-URI, weergavenaam, licentieniveau, beheerdersniveau, publicatiemogelijkheid, e-mailadres, verificatietype
  • Tableau Server: gebruikersnaam, wachtwoord, weergavenaam, licentieniveau, beheerdersniveau, publicatiemogelijkheid, e-mailadres
  • Tableau Server met identiteitspools: gebruikersnaam, wachtwoord, weergavenaam, licentieniveau, beheerdersniveau, publicatiemogelijkheid, e-mailadres, identiteitspoolnaam, identificatie

Zie het gedeelte met kolomdetails hieronder voor meer informatie over de mogelijke waarden voor elke kolom.

Belangrijk: De volgorde van de kolommen is van belang. De eerste kolom wordt behandeld als de gebruikersnaam, de tweede als het wachtwoord, de derde als weergavenaam enzovoort, ongeacht de inhoud van de kolommen. Als u waarden voor een veld weglaat, moet u nog steeds het kommascheidingsteken van het veld opnemen.

Kolomdetails voor Tableau Cloud CSV

Als het CSV-bestand alleen waarden voor Gebruikersnaam (e-mailadressen) bevat, ontvangen de gebruikers een e-mailuitnodiging voor de site. Gebruikers kunnen dan op de site hun accounts aanmaken, maar de accounts blijven zonder licentie totdat een beheerder de accounts configureert (weergavenaam, licentieniveau enzovoort). Het e-mailadres van een gebruiker op de site kan op de site worden weergegeven met een voorlooppunt (zoals .user@domain.com) totdat deze gebruiker voor de eerste keer inlogt.

Kolomstructuur voor het CSV-bestand: gebruikersnaam, wachtwoord, weergavenaam, licentieniveau, beheerdersniveau, publicatiemogelijkheid, e-mailadres

Kolomdetails:

Gebruikersnaam: vereist. Het e-mailadres van de gebruiker.

Wachtwoordgenegeerd. Het is aan te raden deze kolom leeg te laten.

  • Nieuwe gebruikers moeten een wachtwoord en een weergavenaam selecteren wanneer ze zich voor het eerst aanmelden bij Tableau Cloud. Als een gebruiker al een Tableau-account heeft, heeft hij/zij mogelijk ook al een wachtwoord.

Weergavenaam: genegeerd. Het is aan te raden deze kolom leeg te laten.

Licentieniveau: de mogelijkheden zijn Creator, Explorer, Viewer, of Zonder licentie. Als u dit veld leeg laat, is het licentieniveau 'Zonder licentie'.

Beheerdersniveau: de waarde is Site of Geen. Als u dit veld leeg laat, is het beheerdersniveau 'Geen'.

Publicatiemogelijkheid: geaccepteerde waarden zijn Ja/Waar/1 of Nee/Onwaar/0. Als u dit veld leeg laat, is de publicatiemogelijkheid 'Onwaar'.

  • Als het licentieniveau Creator is, moet de publicatiemogelijkheid de waarde Ja/Waar/1 hebben
  • Als het licentieniveau Explorer is, is de waarde voor de publicatiemogelijkheid wat de siterol onderscheidt tussen Explorer (kan publiceren) en Explorer
  • Als het licentieniveau Viewer of Zonder licentie is, kan de gebruiker niet publiceren, ongeacht de waarde van deze kolom

E-mailadres: met ingang van juli 2025 (Tableau 2025.2) moet u een e-mailadres opgeven als dit anders is dan de gebruikersnaam. E-mailadressen worden uitsluitend gebruikt voor meldingen. Als er geen e-mailadres wordt opgegeven, gebruikt Tableau Cloud de waarde in het vereiste gebruikersnaamveld voor het verzenden van meldingen.

Kolommen die leeg zijn, moeten nog steeds worden gescheiden door komma's om de kolomstructuur te behouden.

Verificatietype zonder TCM

Als u Tableau Cloud Manager niet gebruikt, kunt u tijdens het uploaden slechts één standaardverificatietype instellen. U kunt het verificatietype voor individuele gebruikers later wijzigen.

  • Wanneer u een CSV-bestand rechtstreeks in Tableau Cloud uploadt, geeft u bij het importeren van het bestand het verificatietype op. Dat type is van toepassing op alle geïmporteerde gebruikers.
  • Als u tabcmd gebruik om gebruikers te importeren, moet u tijdens het uploaden het verificatietype en de siterol instellen die van toepassing zijn op alle gebruikers in het CSV-bestand. Zie createsiteusers filename.csv voor meer informatie.

Als u tijdens het uploaden een specifiek verificatietype per gebruiker wilt instellen, moet u Tableau Cloud Manager gebruiken. Zie Gebruikers beheren met Tableau Cloud Manager voor meer informatie.

Voorbeeldstructuur van Tableau Cloud CSV

Tip: Vergeet niet dat de structuur als volgt is: username, password, display name, license level, administrator level, publishing capability, email address zonder spaties tussen de komma's als een kolom leeg wordt gelaten.

In het volgende voorbeeld ziet u een gebruiker die de siterol Explorer (kan publiceren) toegewezen krijgt, geen sitebeheerder is en kan publiceren naar projecten waarvoor deze gebruiker over de juiste inhoudsmachtigingen beschikt.

user1@domain.com,,,Explorer,None,true,user1@domain2.com

Door de kolom voor beheerdersniveau te wijzigen, kunt u de volgende gebruiker importeren als sitebeheerder met de siterol Sitebeheerder Explorer.

adminuser@domain.com,,,Explorer,Site,true,adminuser@domain2.com

Kolomdetails voor TCM CSV

Als het CSV-bestand alleen waarden voor een gebruikersnaam (e-mailadres) bevat, ontvangen de gebruikers een e-mailuitnodiging voor de site. Gebruikers kunnen dan op de site hun accounts aanmaken, maar de accounts blijven zonder licentie totdat een beheerder de accounts configureert (weergavenaam, licentieniveau enzovoort).

Houd er rekening mee dat lege kolommen toch gescheiden moeten worden door komma's om de kolomstructuur te behouden.

Kolomstructuur voor het CSV-bestand: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type

Kolomdetails: 

Tenant- of site-URI: de Uniform Resource Identifier voor de tenant of de site.

Gebruikersnaam: vereist. Het e-mailadres van de gebruiker.

Wachtwoordgenegeerd. Het is aan te raden deze kolom leeg te laten.

  • Nieuwe gebruikers moeten een wachtwoord en een weergavenaam selecteren wanneer ze zich voor het eerst aanmelden bij Tableau Cloud. Als een gebruiker al een Tableau-account heeft, heeft hij/zij mogelijk ook al een wachtwoord.

Weergavenaam: genegeerd. Het is aan te raden deze kolom leeg te laten.

Licentieniveau: de mogelijkheden voor de site zijn Creator, Explorer, Viewer of Zonder licentie. Als u dit veld leeg laat, is het licentieniveau 'Zonder licentie'.

Beheerdersniveau: dit kan Site, Cloud of Geen zijn. Als u dit veld leeg laat, is het beheerdersniveau 'Geen'.

  • Site = Sitebeheerder, Geen = Niet een beheerder, Cloud = Cloudbeheerder.

Publicatiemogelijkheid: dit kan Waar of Onwaar voor de site zijn. Als u dit veld leeg laat, is de publicatiemogelijkheid 'Onwaar'.

  • Als het licentieniveau Creator is, moet de publicatiemogelijkheid de waarde Waar hebben
  • Als het licentieniveau Explorer is, is de waarde voor de publicatiemogelijkheid wat de siterol onderscheidt tussen Explorer (kan publiceren) en Explorer
  • Als het licentieniveau Viewer of Zonder licentie is, kan de gebruiker niet publiceren, ongeacht de waarde van deze kolom

Verificatietype: het type gebruikersverificatie voor toegang tot een site of tenant. Dit kan Google, OpenID, Salesforce, SAML, TableauIDWithMFA of STANDAARD zijn.

TCM CSV-voorbeeldstructuur

Tip: Vergeet niet dat de structuur als volgt is: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type zonder spaties tussen de komma's als een kolom leeg wordt gelaten.

In het volgende voorbeeld ziet u een gebruiker die de rol van cloudbeheerder heeft gekregen in Tableau Cloud Manager en die zich verifieert met gebruik van Tableau met MFA.

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,TableauIDWithMFA

Door de verificatiekolom te wijzigen, kunt u de volgende gebruiker importeren met een ander verificatietype, indien dat is geconfigureerd in de instellingen van Tableau Cloud Manager.

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,Salesforce

In het volgende voorbeeld kunt u de gebruiker met de siterol Explorer (kan publiceren) importeren met gebruik van Tableau met MFA-verificatie.

MySite,user1@domain.com,,,Explorer,None,True,,TableauIDWithMFA

CSV-instellingen en siterollen

Het licentieniveau, de beheerder en de uitgeversinstellingen voor een gebruiker bepalen hoe de siterol van de gebruiker wordt ingesteld tijdens het importproces. Hieronder ziet u hoe siterollen in het CSV-bestand worden vastgelegd.

SiterolLicentieniveauBeheerdersniveauMogelijkheid voor publiceren

Cloudbeheerder

Deze rol is alleen geldig als u gebruikers importeert terwijl u bent aangemeld bij Tableau Cloud Manager (en dus niet aangemeld bij een specifieke site).

Zonder licentieCloudOnwaar

Sitebeheerder Creator of Sitebeheerder Explorer

Deze rollen zijn alleen geldig als u gebruikers importeert terwijl u bent aangemeld bij een specifieke site.

Creator of ExplorerSiteTrue
CreatorCreatorGeenTrue
Explorer (kan publiceren)ExplorerGeenTrue
ExplorerExplorerGeenOnwaar
ViewerViewerGeenOnwaar
Zonder licentieZonder licentieGeenOnwaar
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.