Aide de Tableau Server sur Linux

Cette rubrique aborde en détail le fichier CSV lui-même. Pour importer des utilisateurs à l’aide du fichier CSV, vous pouvez :

• Utilisez les pages d’administration de serveur ou de site. Pour plus d’informations, consultez Importer des utilisateurs.
• Utilisez l’utilitaire tabcmd. Pour plus d’informations, consultez createsiteusers nomfichier.csv.

Vous pouvez importer des utilisateurs au niveau du site ou du serveur. Si vous importez des utilisateurs sur le serveur (pas sur un site spécifique), les utilisateurs ne sont pas affectés à un site et sont importés en tant que Sans licence.

Remarque : Sauf indication contraire, les directives spécifiées dans cette rubrique s’appliquent à Tableau Server lorsqu’il est configuré avec ou sans pools d’identités(Le lien s’ouvre dans une nouvelle fenêtre).

Exigences de format de fichier CSV

Le fichier CSV destiné à l’importation d’utilisateurs présente les exigences de mise en forme suivantes :

• Aucune en-tête de colonne. Tableau Server part du principe que chaque ligne du fichier représente un utilisateur.
• Format UTF-8 avec la marque d’ordre des octets (BOM).
  • Les codages de caractères tels que BIG-5 doivent être convertis en UTF-8. Pour ce faire, ouvrez le fichier dans un éditeur de texte et utilisez la commande Enregistrer sous.
  • Si le caractère @ est présent dans le champ nom d’utilisateur pour un usage autre qu’un séparateur de domaine, il doit être au format hexadécimal : \0x40. Par exemple, user@fremont@mycompany.com doit être user\0x40fremont@mycompany.com.

Structure des colonnes requises dans le fichier CSV

Le fichier ne doit pas contenir de ligne d’en-tête. Il n’est pas nécessaire de remplir toutes les colonnes, mais la structure des colonnes requises doit être préservée en incluant tous les virgules de séparation attendues.

La structure des colonnes varie selon le produit et l’outil d’importation. Assurez-vous d’utiliser la structure appropriée pour votre environnement :

• Tableau Cloud : nom d’utilisateur, mot de passe, nom d’affichage, niveau de licence, niveau administrateur, fonctionnalité de publication, adresse de courriel
• Tableau Cloud avec Tableau Cloud Manager (TCM) : URI du locataire ou du site, nom d’utilisateur, mot de passe, nom d’affichage, niveau de licence, niveau administrateur, fonctionnalité de publication, type d’authentification
• Tableau Server : nom d’utilisateur, mot de passe, nom d’affichage, niveau de licence, niveau administrateur, fonctionnalité de publication, adresse de courriel
• Tableau Server utilisant des pools d’identités : nom d’utilisateur, mot de passe, nom d’affichage, niveau de licence, niveau administrateur, fonctionnalité de publication, adresse de courriel, nom du pool d’identités, identifiant

Pour plus d’informations sur les valeurs possibles pour chaque colonne, consultez la section Détails des colonnes ci-dessous.

Important : l’ordre des colonnes est pertinent. La première colonne est traitée comme le nom d’utilisateur, la seconde comme le mot de passe, la troisième comme le nom d’affichage, et ainsi de suite, quel que soit le contenu des colonnes. Si vous omettez des valeurs pour un champ, vous devez continuer à utiliser des virgules comme délimiteurs de champs.

Détails des colonnes pour Tableau Server

Remarque : Si vous n’êtes pas connecté à un site spécifique et que vous importez des utilisateurs au niveau du serveur, vous ne pouvez affecter que les rôles sur le site Administrateur de serveur et Utilisateur sans licence.

Structure des colonnes pour le fichier CSV : username, password, display name, license level, admin level, publishing capability, email address

Détails des colonnes : 

Nom d’utilisateur : obligatoire. Le nom de l’utilisateur.

• Si le serveur est configuré pour utiliser Active Directory, cette valeur doit correspondre à un utilisateur défini dans Active Directory. Si le nom d’utilisateur n’est pas unique dans tous les domaines, incluez le domaine dans le nom d’utilisateur (par exemple, example\Adam ou adam@example).
• Si vous ajoutez des utilisateurs à un pool d’identités(Le lien s’ouvre dans une nouvelle fenêtre), procédez comme suit :
• Si vous ajoutez un utilisateur à un pool d’identités dont le magasin d’identités est AD, prenez soin d’utiliser la valeur AD sAMAccountName comme nom d’utilisateur.
• Si vous ajoutez un utilisateur à un pool d’identités dont le magasin d’identités est LDAP, prenez soin d’utiliser la valeur de nom d’utilisateur LDAP comme nom d’utilisateur.

Mot de passe : le mot de passe de l’utilisateur. Cette colonne est obligatoire ou non selon la configuration du serveur :

• Authentification locale : Obligatoire. Le champ de mot de passe est obligatoire depuis Tableau Server 2024.2. Pour plus d’informations, consultez l’article de connaissances Un « errorCode=134 » inattendu s’est produit lors de la tentative d’ajout d’utilisateurs via tabcmd dans Tableau Server 2024.2.
• Active Directory : Ignoré. Il est recommandé de laisser cette colonne vide.

Nom d’affichage : le nom d’affichage fait partie des informations permettant d’identifier un utilisateur sur le serveur. Cette colonne est utilisée ou ne l’est pas selon la configuration du serveur :

• Authentification locale : Si le nom d’affichage de l’utilisateur est déjà utilisé, Tableau Server met à jour l’information existante de l’utilisateur en fonction des paramètres figurant dans le fichier CSV.
• Active Directory : Ignoré. Il est recommandé de laisser cette colonne vide.

Niveau de licence : on distingue les types Creator, Explorer, Viewer ou Utilisateur sans licence.

• Si le niveau de licence est Creator, la fonctionnalité de publication doit être Yes/True/1
• Si l’installation de votre serveur est basée sur le nombre d’utilisateurs, et que l’ajout d’utilisateurs entraîne un dépassement du seuil autorisé par votre licence, les utilisateurs sont ajoutés en tant qu’utilisateurs sans licence.
• Si vous utilisez tabcmd et que vous spécifiez la licence, mais que l’importation d’utilisateurs entraîne un dépassement du seuil autorisé par votre licence, les utilisateurs sont importés avec le rôle Utilisateurs sans licence.

Niveau administrateur : la valeur peut être Système, Site ou Aucun. Il permet de déterminer si l’utilisateur est importé en tant qu’administrateur.

• System = Administrateur de serveur, Site = Administrateur de site, Aucun = N’est pas un administrateur.
• Si vous n’êtes pas connecté à un site spécifique et que vous importez des utilisateurs au niveau du serveur, vous ne pouvez affecter que les rôles Administrateur de serveur et Utilisateur sans licence.
• Si vous utilisez l’interface utilisateur Web pour importer des utilisateurs, vous ne pourrez définir le rôle sur le site Administrateur sur Système que si vous importez le fichier au niveau du serveur (Tous les sites). Si vous êtes connecté à un site spécifique, et si la colonne Administrateur pour un utilisateur du fichier CSV est définie sur Système, Tableau Server importe l’utilisateur en tant qu’administrateur de site.

Fonctionnalité de publication : peut être définie sur Yes/True/1 ou No/False/0. Si vous utilisez l’interface utilisateur Web, la fonctionnalité de publication n’est utilisée que si vous lancez l’importation au moment où vous êtes connecté à un site spécifique.

• Si le niveau de licence est Creator, la fonctionnalité de publication doit être Yes/True/1
• Si le niveau de licence est Explorer, la fonctionnalité de publication détermine le rôle sur le site entre Explorer (peut publier) et Explorer
• Si le niveau de licence est Viewer ou Utilisateur sans licence, l’utilisateur ne pourra pas publier, quelle que soit la valeur de cette colonne

Adresse de courriel : l’adresse de courriel fait partie des renseignements permettant d’identifier un utilisateur sur le serveur. Si l’adresse de courriel est déjà utilisée, Tableau Server met à jour l’information de l’utilisateur en fonction des paramètres figurant dans le fichier CSV.

Les colonnes restées vides doivent tout de même être délimitées par des virgules pour préserver leur structure.

Pools d’identités

Si vous ajoutez des utilisateurs à un pool d’identités, les colonnes suivantes sont nécessaires en plus des colonnes standard :

Structure des colonnes pour le fichier CSV : username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

Détails supplémentaires de la colonne :

Nom du pool d’identité : le nom du pool d’identités auquel vous souhaitez ajouter l’utilisateur. Si vous ajoutez des utilisateurs à un pool d’identités et que vous ne spécifiez pas le nom du pool d’identités, les utilisateurs sont ajoutés au pool initial (configuré par TSM), qui est l’ensemble des utilisateurs provisionnés dans TSM lors de la configuration de Tableau Server.

Identifiant : l’identifiant de l’utilisateur que vous souhaitez ajouter. Les identifiants ne sont utilisés qu’à des fins de correspondance d’identité. Pour plus d’informations, consultez Noms d’utilisateur et identifiants dans Tableau.

• Authentification locale : Facultatif
• Active Directory ou LDAP : Obligatoire

Ajouter des utilisateurs en bloc avec des pools d’identités

Vous pouvez utiliser le processus d’importation CSV pour :

• Ajouter des utilisateurs en bloc à des pools d’identités supplémentaires. Remarque : Vous ne pouvez pas utiliser le processus d’importation CSV pour remplacer le pool d’identités auquel appartient déjà un utilisateur par un autre pool d’identités. Si vous ajoutez un utilisateur existant avec une valeur de pool d’identités différente, il sera ajouté à ce pool d’identités supplémentaire.
• Ajoutez en bloc des identifiants pour les utilisateurs qui ne les possèdent pas déjà. Remarque : Si vous ajoutez un identifiant différent pour un utilisateur dans le même pool, il ne remplacera pas l’identifiant existant de cet utilisateur. Au lieu de cela, un nouvel enregistrement d’identifiant sera créé pour cet utilisateur.

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

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

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

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