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 wordenuser\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
ofadam@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-instellingen | Siterol |
---|---|
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.
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.
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.
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez