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 sitebeheerderspagina 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.
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 Cloud 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: het e-mailadres van de gebruiker.
Wachtwoord. Tableau Cloud gebruikt dit veld niet, maar u moet het toch in elke rij tussen scheidingstekens houden om de volgende velden correct te kunnen positioneren.
Extra CSV-kolomopties
Voor elke gebruiker kan het CSV-bestand in aanvulling op de vereiste kolommen de volgende velden bevatten. Sommige velden worden niet gebruikt in Tableau Cloud, maar ze moeten wel in het bestand staan. Dit staat aangegeven bij de betreffende opties.
Site-URI (alleen Tableau Cloud Manager): de Uniform Resource Identifier voor de site. Als u een gebruiker als een cloudbeheerder wilt importeren, neemt u de kolom Site-URI op, maar laat u deze leeg.
Weergavenaam. Tableau Cloud gebruikt dit veld niet, maar u moet het toch in elke rij tussen scheidingstekens houden om de volgende velden correct te kunnen positioneren.
Licentieniveau. De mogelijkheden zijn Creator, Explorer, Viewer, of Zonder licentie.
Beheerdersniveau: de waarde kan Cloud, Site of Geen zijn. Cloud = cloudbeheerder, Site = Sitebeheerder en None = Niet een beheerder.
Opmerking: De waarde voor cloudbeheerder is alleen beschikbaar wanneer u gebruikers importeert naar Tableau Cloud Manager. Deze is niet bedoeld voor gebruik met Tableau Cloud-sites. Zie Gebruikers beheren met Tableau Cloud Manager voor meer informatie.
Mogelijkheid voor publiceren. Geaccepteerde waarden zijn Ja/Waar/1 of Nee/Onwaar/0. Als het licentieniveau Creator is, moet de mogelijkheid voor publiceren Ja/Waar/1 zijn.
Verificatietype (alleen Tableau Cloud Manager): het type gebruikersverificatie voor toegang tot een site of Tableau Cloud Manager.
Voorbeeldinvoer in CSV-bestand
Tableau Cloud-site
In het volgende voorbeeld ziet u een gebruiker die de siterol Explorer toegewezen krijgt, geen sitebeheerder is en kan publiceren naar projecten waarvoor deze gebruiker over de juiste inhoudsmachtigingen beschikt.
user1@domain.com,,,Explorer,None,true
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
Tableau Cloud Manager
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.
,cloudadminuser@domain.com,,,,Cloud,,Tableau with MFA
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.
,cloudadminuser@domain.com,,,,Cloud,,Salesforce
Opmerkingen
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).
De velden Wachtwoord (tweede waarde) en Weergavenaam (derde waarde) worden niet gebruikt door Tableau Cloud. Waarden die u voor deze velden opgeeft, worden genegeerd.
Als u echter de licentie en publiceringstoegang voor de gebruikers wilt instellen, moet het bestand nog steeds scheidingstekens voor deze velden bevatten, zoals weergegeven in het eerdere voorbeeld.
Nieuwe gebruikers moeten een wachtwoord en een weergavenaam selecteren wanneer ze zich voor het eerst aanmelden bij Tableau Cloud. Als gebruikers al een Tableau-account hebben, zoals voor de Tableau Community-forums, hebben ze al wachtwoorden.
Het CSV-bestand bevat geen veld voor het instellen van het verificatietype (Tableau, Google of SAML). U geeft dit aan in Tableau Cloud wanneer u het bestand importeert. De instelling is van toepassing op alle geïmporteerde gebruikers en u kunt het verificatietype achteraf voor individuele gebruikers wijzigen.
Opmerking: Als alternatief kunt u
tabcmd
gebruiken om gebruikers te importeren en het verificatietype en de siterol in te stellen die van toepassing zijn op alle gebruikers in het CSV-bestand. Zie createsiteusers filename.csv voor meer informatie.
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=Zonder licentie Beheerder=Cloud Uitgever=onwaar | Cloudbeheerder. Deze instelling is alleen geldig als u gebruikers importeert terwijl u bent aangemeld bij Tableau Cloud Manager (en dus niet bij een specifieke site). |
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 |