Richtlinien für CSV-Importdatei

Sie können das Hinzufügen von Benutzern automatisieren, indem Sie eine CSV-Datei mit Benutzerinformationen erstellen und dann die Datei importieren. Es besteht die Möglichkeit, Attribute in die CSV-Datei zu integrieren, wie zum Beispiel die Lizenzstufe und den Veröffentlichungszugriff, um diese während des Imports auf die Benutzer anzuwenden.

Zum Importieren von Benutzern können Sie die Seite für die Site-Verwaltung oder das Dienstprogramm tabcmd verwenden. Die Verwendung des Befehls tabcmd ist eine Möglichkeit, allen Benutzern in der CSV-Datei eine Site-spezifische Rolle zuzuordnen. Weitere Informationen finden Sie unter Importieren von Benutzern oder createsiteusers Dateiname.csv.

CSV-Dateiformatanforderungen

Wenn Sie die CSV-Datei für das Importieren von Benutzern erstellen, stellen Sie sicher, dass die Datei die folgenden Formatierungsanforderungen erfüllt:

  • Die Datei enthält keine Spaltenüberschriften. Tableau Cloud nimmt an, dass jede Zeile in der Datei einen Benutzer darstellt.

  • Die Datei liegt im UTF-8-Format vor und enthält die Bytereihenfolge-Marke (Byte-Order Mark, BOM).

  • Zeichensatzcodierungen wie BIG-5 wurden zu UTF-8 konvertiert. Sie können dies vornehmen, indem Sie die Datei in einem Text-Editor öffnen und den Befehl Speichern unter verwenden.

  • Wenn ein Benutzername das Zeichen "@" beinhaltet und dieses nicht als Domänentrennzeichen fungiert, müssen Sie auf das Symbol im Hexadezimalformat verweisen: \0x40.

    Beispiel: Die Adresse user@fremont@mycompany.com ist in Form von user\0x40fremont@mycompany.com anzugeben.

Erforderliche Spalten in der CSV-Datei

Die folgenden Felder sind für jeden Benutzer erforderlich:

  • Benutzername: Die E-Mail-Adresse des Benutzers.

  • Kennwort. Tableau Cloud verwendet dieses Feld nicht, es muss jedoch in jeder Zeile vorhanden sein, damit die folgenden Felder richtig platziert werden.

Zusätzliche Optionen für CSV-Spalten

Zusätzlich zu den erforderlichen Spalten kann die CSV-Datei für jeden Benutzer die folgenden Felder enthalten. Sofern angegeben, wird das Feld von Tableau Cloud nicht verwendet, es muss jedoch in der Datei erklärt werden.

  • Site-URI (nur Tableau Cloud Manager): Der einheitliche Ressourcenbezeichner (Uniform Resource Identifier, URI) für die Site. Um einen Benutzer als Cloud-Administrator zu importieren, fügen Sie die Spalte „Site-URI“ mit ein, lassen Sie sie aber leer.

  • Anzeigename. Tableau Cloud verwendet dieses Feld nicht, es muss jedoch in jeder Zeile vorhanden sein, damit die folgenden Felder richtig platziert werden.

  • Lizenzstufe. Sie kann Creator, Explorer, Viewer oder Unlicensed lauten.

  • Administratorebene: Der Wert kann Cloud, Site oder Keiner sein. „Cloud“ = Cloud-Administrator, „Site“ = Site-Administrator und „Keiner“ = Kein Administrator.

    Hinweis: Der Wert „Cloud-Administrator“ ist nur beim Importieren von Benutzern in Tableau Cloud Manager verfügbar. Er ist nicht für die Verwendung mit Tableau Cloud-Sites vorgesehen. Weitere Informationen finden Sie unter Verwalten von Benutzern mit Tableau Cloud Manager.

  • Veröffentlichungsfunktion Gültige Werte sind Yes/True/1 oder No/False/0. Wenn die Lizenzstufe "Creator" lautet, muss die Veröffentlichungsfunktion "Yes/True/1" (Ja/Wahr/1) lauten.

  • Authentifizierungstyp (nur Tableau Cloud Manager): Der Benutzerauthentifizierungstyp für den Zugriff auf eine Site oder Tableau Cloud Manager.

Beispieleinträge einer CSV-Datei

Tableau Cloud-Site

Im folgenden Beispiel wird dem Benutzer die Site-spezifische Rolle Explorer zugewiesen. Der Benutzer ist kein Site-Administrator, kann allerdings Projekte veröffentlichen, für die er über die erforderlichen Inhaltsberechtigungen verfügt.

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

Indem Sie die Spalte auf Administratorebene ändern, können Sie den folgenden Benutzer als Site-Administrator importieren, dem die Rolle Site-Administrator-Explorer zugewiesen ist.

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

Tableau Cloud Manager

Das folgende Beispiel zeigt einen Benutzer, dem die Cloud-Administratorrolle in Tableau Cloud Manager zugewiesen wird und der sich mittels Tableau mit MFA authentifiziert.

,cloudadminuser@domain.com,,,,Cloud,,Tableau with MFA

Durch Ändern der Authentifizierungsspalte können Sie den folgenden Benutzer mit einem alternativen Authentifizierungstyp importieren, sofern dieser in den Tableau Cloud Manager-Einstellungen konfiguriert ist.

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

Hinweise

  • Wenn die CSV-Datei nur Werte für den Benutzernamen (E-Mail-Adressen) enthält, werden die Benutzer per E-Mail zu der Website eingeladen. Benutzer können der Site beitreten, um ihre Konten zu erstellen, die Konten sind jedoch so lange unlizenziert, bis ein Administrator diese Konten konfiguriert (Anzeigename, Lizenzebene usw.).

  • Die Felder für das Kennwort (zweiter Wert) und den Anzeigenamen (dritter Wert) werden von Tableau Cloud nicht verwendet. Wenn Sie Werte in diese Felder eintragen, werden die Werte ignoriert.

    Wenn Sie jedoch Lizenz- und Veröffentlichungszugriff für die Benutzer festlegen möchten, muss Ihre Datei weiterhin Trennzeichen für diese Felder einbeziehen, wie dies im vorausgegangenen Beispiel gezeigt wurde.

  • Neue Benutzer müssen ein Kennwort und einen Anzeigenamen angeben, wenn Sie sich zum ersten Mal bei Tableau Cloud anmelden. Wenn die Benutzer bereits über ein Tableau-Konto verfügen, beispielsweise für die Tableau Community-Foren, haben sie bereits Kennwörter.

  • Die CSV-Datei enthält kein Feld für die Festlegung des Authentifizierungstyps (Tableau, Google oder SAML). Dies wird beim Import der Datei in Tableau Cloud festgelegt. Die Einstellung wird auf alle importierten Benutzer angewendet, und anschließend haben Sie die Möglichkeit, den Authentifizierungstyp für einzelne Benutzer zu ändern.

    Hinweis: Alternativ können Sie tabcmd zum Importieren von Benutzern und Festlegen des Authentifizierungstyps und der Site-spezifischen Rolle für alle Benutzer in der CSV-Datei verwenden. Weitere Informationen finden Sie unter createsiteusers Dateiname.csv.

CSV-Einstellungen und Site-Rollen

Über die Lizenzstufe, den Administrator und die Einstellungen für einen Benutzer wird angegeben, wie die Site-Rolle des Benutzers während des Imports festgelegt wird. Die folgende Tabelle zeigt, wie die Einstellungen zu Site-Rollen konvertiert werden.

CSV-EinstellungenSite-Rolle

Lizenzstufe=Nicht lizenziert

Administrator=Cloud

Herausgeber=false

Cloud-Administrator. Diese Einstellung ist nur gültig, wenn Sie Benutzer importieren, während Sie in Tableau Cloud Manager (d.h. nicht in einer bestimmten Site) angemeldet sind.

Lizenstufe=Creator oder Explorer

Administrator=Site

Herausgeber=true

Site-Administrator-Creator oder Site-Administrator-Explorer Diese Einstellung trifft nur zu, wenn Sie Benutzer importieren, während Sie bei einer bestimmten Site angemeldet sind.

Lizenzstufe=Creator

Administrator=None

Herausgeber=true

Creator

Lizenzstufe=Explorer

Administrator=None

Herausgeber=true

Explorer (kann veröffentlichen)

Lizenzstufe=Explorer

Administrator=None

Herausgeber=false

Explorer

Lizenzstufe=Betrachter

Administrator=None

Herausgeber=false

Viewer (Betrachter)

Lizenzstufe=Nicht lizenziert

Administrator=None

Herausgeber=false

Nicht lizenziert

Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.