Recommandations relatives au fichier d’importation CSV
Vous pouvez ajouter des utilisateurs en bloc en créant un fichier CSV (valeurs séparées par des virgules) qui contient les informations utilisateur, puis en l’important. Vous pouvez inclure des attributs dans le fichier CSV, comme le niveau de licence et l’accès à la publication, afin de les appliquer aux utilisateurs au moment où vous les importez.
Cette rubrique couvre les détails du fichier CSV lui-même. Pour importer des utilisateurs à l’aide du fichier CSV, vous pouvez :
- Utiliser la page d’administration du site. Pour plus d’informations, consultez Importer des utilisateurs
- Utiliser l’utilitaire
tabcmd
. Pour plus d’informations, consultez createsiteusers nomfichier.csv. - Utiliser Tableau Cloud Manager. Pour plus d’informations, consultez Gérer les utilisateurs avec Tableau Cloud Manager.
Exigences de format de fichier CSV
Le fichier CSV destiné à l’importation d’utilisateurs présente les exigences de mise en forme suivantes :
- Pas d’en-têtes de colonne. Tableau Cloud part du principe que chaque ligne du fichier représente un utilisateur.
- Format UTF-8 avec indicateur 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 autre chose qu’un séparateur de domaine, il doit être au format hexadécimal :\0x40
. Par exemple,user@fremont@mycompany.com
doit êtreuser\0x40fremont@mycompany.com
.
Structure de colonnes requise dans le fichier CSV
Le fichier ne doit pas contenir de ligne d’en-tête. Il n’est pas nécessaire que toutes les colonnes soient remplies, mais la structure de colonnes requise doit être préservée en incluant tous les délimiteurs de virgules attendus.
La structure des colonnes varie selon le produit et l’outil d’importation. Assurez-vous d’utiliser la structure adaptée à votre environnement :
- Tableau Cloud : nom d’utilisateur, mot de passe, nom d’affichage, niveau de licence, niveau de l’administrateur, fonctionnalité de publication, adresse e-mail
- Tableau Cloud avec Tableau Cloud Manager (TCM) : URL du locataire ou du site, nom d’utilisateur, mot de passe, nom d’affichage, niveau de licence, niveau de l’administrateur, fonctionnalité de publication, adresse e-mail, type d’authentification
- Tableau Server : nom d’utilisateur, mot de passe, nom d’affichage, niveau de licence, niveau de l’administrateur, fonctionnalité de publication, adresse e-mail
- Tableau Server utilisant des pool d’identités : nom d’utilisateur, mot de passe, nom d’affichage, niveau de l’administrateur, fonctionnalité de publication, adresse e-mail, nom du pool d’identités, identificateur
Consultez la section Détails de la colonne ci-dessous pour plus d’informations sur les valeurs possibles pour chaque colonne.
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 un fichier CSV Tableau Cloud
Si le fichier CSV contient uniquement des valeurs de noms d’utilisateur (adresses e-mail), les utilisateurs recevront une invitation au site par e-mail. Les utilisateurs peuvent accéder au site pour créer leurs comptes, mais les comptes demeurent sans licence jusqu’à ce qu’un administrateur configure les comptes (nom d’affichage, niveau de licence, etc.). L’adresse e-mail d’un utilisateur sur le site peut s’afficher sur le site avec un point initial (par exemple .user@domain.com
) jusqu’à ce qu’il se connecte pour la première fois.
Structure des colonnes pour le fichier CSV : nom d’utilisateur, mot de passe, nom d’affichage, niveau de licence, niveau de l’administrateur, fonctionnalité de publication, adresse e-mail
Détails des colonnes :
Nom d’utilisateur : obligatoire. L’adresse e-mail de l’utilisateur.
Mot de passe : ignoré. Il est recommandé de laisser cette colonne vide.
- Les nouveaux utilisateurs doivent sélectionner un mot de passe et un nom d’affichage lors de leur connexion initiale à Tableau Cloud. Si un utilisateur possède déjà un compte Tableau, il se peut qu’il ait déjà aussi un mot de passe.
Nom d’affichage : ignoré. Il est recommandé de laisser cette colonne vide.
Niveau de licence : peut être Creator, Explorer, Viewer ou Sans licence. Si l’option est laissée vide, le niveau de licence sera Sans licence.
Niveau de l’administrateur : peut être Site ou Aucun. Si l’option est laissée vide, le niveau de l’administrateur sera Aucun.
- Site = Administrateur de site, Aucun = N’est pas un administrateur.
- Remarque : Cloud n’est une valeur pertinente que si vous utilisez Tableau Cloud Manager. Pour plus d’informations, consultez Gérer les utilisateurs avec Tableau Cloud Manager.
Fonctionnalité de publication : peut être Yes/True/1 ou No/False/0. Si l’option est laissée vide, la fonctionnalité de publication sera « False ».
- Si le niveau de licence est Creator, la fonctionnalité de publication doit être « Yes/True/1 »
- Si le niveau de licence est Explorer, la valeur de la fonctionnalité de publication est ce qui distingue les rôles sur le site Explorer (peut publier) et Explorer
- Si le niveau de licence est Viewer ou Sans licence, l’utilisateur ne sera pas en mesure de publier, quelle que soit la valeur de cette colonne
Adresse e-mail : à compter de juillet 2025 (Tableau 2025.2), spécifiez une adresse e-mail si elle est différente du nom d’utilisateur. Les adresses e-mail sont utilisées uniquement à des fins de notification. Si aucune valeur d’adresse e-mail n’est fournie, Tableau Cloud utilise la valeur du champ de nom d’utilisateur obligatoire pour envoyer des notifications.
Les colonnes laissées vides doivent toujours être délimitées par des virgules afin de préserver la structure de la colonne.
Type d’authentification sans TCM
Si vous n’utilisez pas Tableau Cloud Manager, vous ne pouvez définir qu’un seul type d’authentification par défaut lors du chargement. Vous pouvez modifier le type d’authentification pour des utilisateurs individuels par la suite.
- Lorsque vous chargez un fichier CSV directement dans Tableau Cloud, spécifiez le type d’authentification lorsque vous importez le fichier et ce type s’appliquera à tous les utilisateurs importés.
- Si vous utilisez
tabcmd
pour importer des utilisateurs, définissez le type d’authentification et le rôle sur le site qui s’appliquent à tous les utilisateurs d’un fichier CSV lors du chargement. Pour plus d’informations, consultez createsiteusers nomfichier.csv.
Pour définir un type d’authentification spécifique par utilisateur au moment du chargement, vous devez utiliser Tableau Cloud Manager. Pour plus d’informations, consultez Gérer les utilisateurs avec Tableau Cloud Manager.
Exemple de structure de fichier CSV Tableau Cloud
Conseil : n’oubliez pas que la structure est la suivante : username, password, display name, license level, administrator level, publishing capability, email address
, sans élément entre les virgules lorsqu’une colonne est laissée vide.
L’exemple suivant montre un utilisateur doté du rôle sur le site Explorer (peut publier). Il ne sera pas un administrateur de site et pourra publier sur des projets pour lesquels il dispose des autorisations de contenu appropriées.
user1@domain.com,,,Explorer,None,true,user1@domain2.com
Si vous modifiez la colonne du niveau Administrateur, vous pouvez importer l’utilisateur suivant en tant qu’administrateur de site avec le rôle sur le site Administrateur de site - Explorer.
adminuser@domain.com,,,Explorer,Site,true
,adminuser@domain2.com
Détails des colonnes pour un fichier CSV TCM
Si le fichier CSV contient uniquement des valeurs de nom d’utilisateur (adresse e-mail), les utilisateurs recevront une invitation au site par e-mail. Les utilisateurs peuvent accéder au site pour créer leurs comptes, mais les comptes demeurent sans licence jusqu’à ce qu’un administrateur configure les comptes (nom d’affichage, niveau de licence, etc.).
Gardez à l’esprit que les colonnes laissées vides doivent toujours être délimitées par des virgules afin préserver la structure des colonnes.
Structure des colonnes pour le fichier CSV : tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type
Détails des colonnes :
URI du locataire ou du site : l’identifiant de ressource uniforme du locataire ou du site.
Nom d’utilisateur : obligatoire. L’adresse e-mail de l’utilisateur.
Mot de passe : ignoré. Il est recommandé de laisser cette colonne vide.
- Les nouveaux utilisateurs doivent sélectionner un mot de passe et un nom d’affichage lors de leur connexion initiale à Tableau Cloud. Si un utilisateur possède déjà un compte Tableau, il se peut qu’il ait déjà aussi un mot de passe.
Nom d’affichage : ignoré. Il est recommandé de laisser cette colonne vide.
Niveau de licence : peut être Creator, Explorer, Viewer ou Sans licence pour le site. Si l’option est laissée vide, le niveau de licence sera Sans licence.
Niveau de l’administrateur : peut être Site, Cloud ou Aucun. Si l’option est laissée vide, le niveau de l’administrateur sera Aucun.
- Site = Administrateur de site, Aucun = N’est pas un administrateur, Cloud = Administrateur Cloud.
Fonctionnalité de publication : peut être True ou False pour le site. Si l’option est laissée vide, la fonctionnalité de publication sera « False ».
- Si le niveau de licence est Creator, la fonctionnalité de publication doit être « True »
- Si le niveau de licence est Explorer, la valeur de la fonctionnalité de publication est ce qui distingue les rôles sur le site Explorer (peut publier) et Explorer
- Si le niveau de licence est Viewer ou Sans licence, l’utilisateur ne sera pas en mesure de publier, quelle que soit la valeur de cette colonne
Type d’authentification : le type d’authentification utilisateur pour accéder au locataire ou au site. Peut être Google, OpenID, Salesforce, SAML, TableauIDWithMFA ou DEFAULT.
Exemple de structure CSV TCM
Conseil : n’oubliez pas que la structure est la suivante : tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type
, sans élément entre les virgules lorsqu’une colonne est laissée vide.
L’exemple suivant montre un utilisateur bénéficiant du rôle d’administrateur Cloud dans Tableau Cloud Manager et qui s’authentifie à l’aide de Tableau avec MFA.
MyTCM,cloudadminuser@domain.com,,,,Cloud,,,TableauIDWithMFA
En modifiant la colonne d’authentification, vous pouvez importer l’utilisateur suivant avec un autre type d’authentification si l’option est configurée dans les paramètres de Tableau Cloud Manager.
MyTCM,cloudadminuser@domain.com,,,,Cloud,,,Salesforce
Dans l’exemple suivant, vous pouvez importer l’utilisateur avec un rôle sur le site Explorer (peut publier) avec l’authentification multifacteur Tableau.
MySite,user1@domain.com,,,Explorer,None,True,,TableauIDWithMFA
Paramètres CSV et rôles sur le site
Les paramètres de niveau de licence, d’administrateur et de publication pour un utilisateur déterminent comment le rôle sur le site d’un utilisateur est défini pendant le processus d’importation. Le récapitulatif ci-dessous montre comment les rôles sur le site doivent être capturés dans le fichier CSV.
Rôle sur le site | Niveau de licence | Niveau de l’administrateur | Fonctionnalité de publication |
Administrateur Cloud Ce rôle n’est valide que si vous importez des utilisateurs tout en étant connecté à Tableau Cloud Manager (à savoir, si vous n’êtes pas connecté à un site spécifique). | Sans licence | Cloud | False |
Administrateur de site - Creator ou Administrateur de site - Explorer Ces rôles ne sont valides que si vous importez des utilisateurs en étant connecté à un site spécifique. | Creator ou Explorer | Site | True |
Creator | Creator | Aucun | True |
Explorer (peut publier) | Explorer | Aucun | True |
Explorer | Explorer | Aucun | False |
Viewer | Viewer | Aucun | False |
Sans licence | Sans licence | Aucun | False |