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:

U kunt gebruikers importeren op site- of serverniveau. Als u gebruikers naar de server importeert (niet naar een specifieke site), worden de gebruikers niet aan een site toegewezen en worden ze geïmporteerd als gebruikers zonder licentie.

Opmerking: Tenzij anders aangegeven, zijn de richtlijnen in dit onderwerp van toepassing op Tableau Server, indien geconfigureerd met of zonder identiteitspools(Link wordt in een nieuw venster geopend).

Vereisten voor CSV-bestandsindelingen

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

  • Geen kolomkoppen. Tableau Server 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: e-mail gebruikersnaam, wachtwoord, weergavenaam, licentieniveau, beheerdersniveau, publicatiemogelijkheid
  • Tableau Cloud met Tableau Cloud Manager: e-mail gebruikersnaam, wachtwoord, site-URI, weergavenaam, licentieniveau, beheerdersniveau, publicatiemogelijkheid, 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 Server

Opmerking: Als u niet bent aangemeld bij een specifieke site en gebruikers op serverniveau importeert, kunt u alleen de siterollen Serverbeheerder en Zonder licentie toewijzen.

Kolomstructuur voor het CSV-bestand: username, password, display name, license level, admin level, publishing capability, email address

Kolomdetails: 

Gebruikersnaamvereist. De naam van de gebruiker.

  • Als de server is geconfigureerd om Active Directory te gebruiken, moet deze waarde overeenkomen met een gebruiker die is gedefinieerd in Active Directory. Als de gebruikersnaam niet uniek is voor alle domeinen, moet u het domein opnemen als onderdeel van de gebruikersnaam (bijvoorbeeld example\Adam of adam@example).
  • Als u gebruikers toevoegt aan een identiteitspool(Link wordt in een nieuw venster geopend), hebt u het volgende nodig:
    • Als u een gebruiker toevoegt aan een identiteitspool die AD als identiteitenarchief gebruikt, moet u ervoor zorgen dat u de AD-waarde van sAMAccountName voor de gebruikersnaam gebruikt.
    • Als u een gebruiker toevoegt aan een identiteitspool die LDAP als identiteitenarchief gebruikt, moet u ervoor zorgen dat u de LDAP-gebruikersnaamwaarde gebruikt voor de gebruikersnaam.

Wachtwoord: het wachtwoord voor de gebruiker. Of deze kolom al dan niet vereist is, hangt af van de configuratie van de server:

Weergavenaam: de weergavenaam maakt deel uit van de informatie die wordt gebruikt om een gebruiker op de server te identificeren. Of deze kolom al dan niet wordt gebruikt, hangt af van de configuratie van de server:

  • Lokale verificatie: Als de weergavenaam van de gebruiker al in gebruik is, werkt Tableau Server de bestaande gebruikersinformatie bij met de instellingen in het CSV-bestand.
  • Active Directory: genegeerd. Het is aan te raden deze kolom leeg te laten.

Licentieniveau: de waarde is Creator, Explorer, Viewer of Zonder licentie.

  • Als het licentieniveau Creator is, moet de publicatiemogelijkheid de waarde Ja/Waar/1 hebben
  • Als u een op gebruikers gebaseerde serverinstallatie hebt en als het toevoegen van gebruikers het aantal gebruikers zou overschrijden dat is toegestaan voor uw licentie worden de gebruikers toegevoegd als gebruikers zonder licentie.
  • Als u tabcmd gebruikt en de licentie specificeert, maar het importeren van gebruikers zou uw licentiebeperkingen overschrijden, dan worden gebruikers geïmporteerd als gebruikers zonder licentie.

Beheerdersniveau: Dit kan zijn Systeem, Site, of Geen zijn, en hiermee wordt bepaald of de gebruiker als beheerder wordt geïmporteerd.

  • Systeem = Cloudbeheerder, Site = Sitebeheerder en Geen = Niet een beheerder.
  • Als u niet bent aangemeld bij een specifieke site en gebruikers op serverniveau importeert, kunt u alleen Serverbeheerder en Zonder licentie toewijzen.
  • Als u de webinterface gebruikt om gebruikers te importeren, kunt u de Beheerder-siterol alleen op Systeem instellen als u het bestand op serverniveau (Alle sites) importeert. Als u bent aangemeld bij een specifieke site en als de beheerderskolom voor een gebruiker in het CSV-bestand is ingesteld op Systeem, importeert Tableau Server de gebruiker als sitebeheerder.

Publicatiemogelijkheid: Geaccepteerde waarden zijn Ja/Waar/1 of Nee/Onwaar/0. Als u de webinterface gebruikt, wordt de publicatiemogelijkheid alleen gebruikt als u importeert terwijl u bent aangemeld bij een specifieke site.

  • 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: het e-mailadres maakt deel uit van de informatie die wordt gebruikt om een gebruiker op de server te identificeren. Als het e-mailadres al in gebruik is, werkt Tableau Server de bestaande gebruikersinformatie bij met de instellingen in het CSV-bestand.

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

Identiteitspools

Als u gebruikers aan een identiteitspool toevoegt, zijn naast de standaardkolommen ook de volgende kolommen nodig:

Kolomstructuur voor het CSV-bestand: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

Aanvullende kolomdetails:

Identiteitspoolnaam. De naam van de identiteitspool waaraan u de gebruiker wilt toevoegen. Als u gebruikers toevoegt aan een identiteitspool en u de naam van de identiteitspool niet opgeeft, worden gebruikers toegevoegd aan de initiële pool (TSM geconfigureerd). Dit is de groep gebruikers die in TSM is ingericht tijdens de configuratie van Tableau Server.

Identifier. De ID van de gebruiker die u wilt toevoegen. ID's worden alleen gebruikt voor identiteitsmatching. Zie Gebruikersnamen en identificatiedata in Tableau voor meer informatie.

  • Lokale verificatie: optioneel
  • Active Directory of LDAP: vereist

Gebruikers in bulk toevoegen met identiteitspools

U kunt het CSV-importproces gebruiken voor:

  • Gebruikers in bulk toevoegen aan extra identiteitspools. Opmerking: U kunt het CSV-importproces niet gebruiken om de identiteitspool waartoe een gebruiker al behoort te vervangen door een andere identiteitspool. Als u een bestaande gebruiker met een andere identiteitspoolwaarde toevoegt, wordt deze aan die extra identiteitspool toegevoegd.
  • ID's in bulk toevoegen voor gebruikers die deze nog niet hebben. Opmerking: Als u een andere ID toevoegt voor een gebruiker in dezelfde pool, vervangt deze de bestaande ID voor die gebruiker niet. In plaats daarvan wordt voor die gebruiker een nieuw ID-record gemaakt.

Voorbeelden CSV-import voor Tableau Server

Tip: Onthoud dat de structuur als volgt is: username, password, display name, license level, admin level, publishing capability, email address.

In het volgende voorbeeld ziet u een CSV-bestand dat informatie voor meerdere gebruikers bevat.

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
  • Als u dit bestand importeert terwijl u een site beheert, worden er vier gebruikers aan die site toegevoegd. De Administrator-instelling voor gebruiker Michelle is System. Omdat u de gebruikers echter in een site importeert, geeft Tableau Server Michelle de siterol Sitebeheerder Creator. Drie van de gebruikers mogen publiceren.
  • Als u dit bestand importeert terwijl u de server beheert, worden er vier gebruikers aan de server toegevoegd, maar deze worden aan geen enkele site toegevoegd. Er wordt slechts één gebruiker geïmporteerd als serverbeheerder, de rest is ingesteld op Zonder licentie.

Voorbeelden van identiteitspools

Tip: Onthoud dat de structuur als volgt is: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier.

In het volgende voorbeeld ziet u een CSV-bestand dat informatie bevat voor twee gebruikers die aan een identiteitspool zijn toegevoegd.

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

In het volgende voorbeeld ziet u een CSV-bestand dat informatie bevat voor twee gebruikers die aan een extra identiteitspool zijn toegevoegd.

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

In het volgende voorbeeld ziet u een CSV-bestand dat informatie bevat voor twee gebruikers zonder bestaande ID's.

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

De prestaties voor grote CSV-bestanden die via tabcmd worden doorgegeven verbeteren

Opmerking: Deze instellingen zijn van toepassing op Tableau Server versie 2022.1 en eerder. De zoek- en indexservice waarop ze betrekking hebben, is verouderd vanaf versie 2022.3 en buiten gebruik gesteld (volledig verwijderd) in 2023.3.

Een serverbeheerder kan serverinstellingen inschakelen die de prestaties helpen verbeteren bij het importeren van grote CSV-bestanden via tabcmd-opdrachten. U kunt dit doen met behulp van de opdracht tsm configuration set met de volgende opties:

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

Deze opties indexeren gebruikers nadat het CSV-bestand is verwerkt, in plaats van ze één voor één te behandelen wanneer ze worden toegevoegd aan de database van de server. Dit vermindert het aantal oproepen naar de database en het geheugen dat nodig is om het bestand te verwerken. Deze tsm configuration set-opties zijn van toepassing op de opdrachten tabcmd createsiteusers, deletesiteusers, addusers en removeusers.

Zie tsm configuration set-opties voor beschrijvingen van deze instellingen.

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

Serverbeheerder

Deze rol is alleen geldig als u gebruikers importeert terwijl u de server beheert (en dus niet bent aangemeld bij een specifieke site).

Elk niveau, maar de siterol Serverbeheerder neemt altijd een Creator-licentie in beslag, als deze beschikbaar is. Zie Problemen met licentieverlening oplossen voor meer informatie over de manier waarop Tableau Server het hanteert als er geen Creator-licentie beschikbaar is.SysteemTrue

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