Richtlijnen voor CSV-importbestand

U kunt het toevoegen van gebruikers automatiseren 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.

Om gebruikers te importeren, gebruikt u de server- of sitebeheerpagina's of het tabcmd-hulpprogramma. Het hulpprogramma tabcmd biedt een optie voor het toewijzen van een siterol aan alle gebruikers in het CSV-bestand. Zie Gebruikers importeren of createsiteusers filename.csv.

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

Wanneer u het CSV-bestand voor het importeren van gebruikers maakt, zorg er dan voor dat het bestand aan de volgende opmaakvereisten voldoet:

  • Het bestand bevat geen kolomkoppen. Tableau Server gaat ervan uit dat elke regel in het bestand een gebruiker vertegenwoordigt.

  • Het bestand heeft de UTF-8-opmaak en bevat de byte-volgordemarkering (BOM).

  • Tekencoderingen zoals BIG-5 zijn omgezet naar UTF-8. U kunt dit doen door het bestand in een teksteditor te openen en Opslaan als te kiezen.

  • Als een gebruikersnaam een @-teken bevat dat iets anders vertegenwoordigt dan een domeinscheidingsteken, moet u voor dit symbool de hexadecimale notatie gebruiken: \0x40

    Bijvoorbeeld user@fremont@mycompany.com zou worden user\0x40fremont@mycompany.com

Vereiste kolommen in het CSV-bestand

Voor elke gebruiker zijn de volgende velden vereist:

  • Gebruikersnaam. De gebruikersnaam. 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. Een wachtwoord voor de gebruiker.

    • Als de server is geconfigureerd voor het gebruik van Active Directory, wordt deze waarde niet gebruikt. Er moet echter wel een wachtwoordkolom zijn en de kolom zelf moet leeg zijn.

    • Als de server lokale verificatie gebruikt, moet u wachtwoorden voor nieuwe gebruikers opgeven.

    Opmerking: Het verplichte wachtwoordveld wordt afgedwongen vanaf Tableau Server 2024.2. Zie het kennisartikel Onverwachte "errorCode=134" treedt op bij het toevoegen van gebruikers via tabcmd in Tableau Server 2024.2 (in het Engels) voor meer informatie.

Extra opties voor het importbestand

Het CSV-bestand kan naast de zojuist vermelde velden ook de volgende velden bevatten, in de hier weergegeven volgorde:

  • Weergavenaam. De weergavenaam maakt deel uit van de informatie die wordt gebruikt om een gebruiker op de server te identificeren. Als de weergavenaam van de gebruiker al in gebruik is, werkt Tableau Server de bestaande gebruikersinformatie bij met de instellingen in het CSV-bestand. Als de server is geconfigureerd om Active Directory te gebruiken, wordt deze waarde niet gebruikt.

  • Licentieniveau. De mogelijkheden zijn Creator, Explorer, Viewer, of Zonder licentie. Als u voor een bepaald gebruikersaccount de rol Creator opgeeft, dan moet u ook de mogelijkheid voor publiceren instellen op Waar.

  • Beheerderniveau (Systeem, Site of Geen). Deze instelling bepaalt of de gebruiker als beheerder wordt geïmporteerd.

    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.

  • Mogelijkheid voor publiceren (Ja/Waar/1 of Nee/Onwaar/0). Als u de webinterface gebruikt, wordt de uitgeversinstelling alleen gebruikt als u importeert terwijl u bent aangemeld bij een specifieke site.

  • 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.

Als u gebruikers aan een identiteitspool toevoegt, zijn naast de bovenstaande waarden de volgende waarden nodig:

  • Identiteitspoolnaam. De naam van de identiteitspool waaraan u de gebruiker wilt toevoegen.

  • ID. 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. Opmerking: De ID is vereist als u een gebruiker toevoegt aan een identiteitspool die gebruikmaakt van het identiteitenarchief Active Directory (of LDAP). De ID is optioneel als u een gebruiker toevoegt aan een identiteitspool die gebruikmaakt van het lokale identiteitenarchief.

    Opmerkingen:

    • 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.
    • Let bij de waarde voor de gebruikersnaam op het volgende:

      • 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.
    • 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.

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.

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.

Opmerkingen

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

  • 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 zonder licentie.

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. In de volgende tabel ziet u hoe de instellingen worden geconverteerd naar siterollen.

CSV-instellingenSiterol

Licentieniveau=(elk)

Beheerder=Systeem

Uitgever=waar

Serverbeheerder. Deze instelling is alleen van toepassing op Tableau Server en is alleen geldig als u gebruikers importeert terwijl u de server beheert (dat wil zeggen als u niet bent aangemeld bij een specifieke site).

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.

Licentieniveau=Creator of Explorer

Beheerder=Site

Uitgever=waar

Sitebeheerder Creator of Sitebeheerder Explorer. Deze instelling is alleen geldig als u gebruikers importeert terwijl u bent aangemeld bij een specifieke site.

Licentieniveau=Creator

Beheerder=Geen

Uitgever=waar

Creator

Licentieniveau=Explorer

Beheerder=Geen

Uitgever=waar

Explorer (kan publiceren)

Licentieniveau=Explorer

Beheerder=Geen

Uitgever=onwaar

Explorer

Licentieniveau=Viewer

Beheerder=Geen

Uitgever=onwaar

Viewer

Licentieniveau=Zonder licentie

Beheerder=Geen

Uitgever=onwaar

Zonder licentie

Voorbeelden CSV-import voor Tableau Server

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

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
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.