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 :

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 être user\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 siteNiveau de licenceNiveau de l’administrateurFonctionnalité 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 licenceCloudFalse

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 ExplorerSiteTrue
CreatorCreatorAucunTrue
Explorer (peut publier)ExplorerAucunTrue
ExplorerExplorerAucunFalse
ViewerViewerAucunFalse
Sans licenceSans licenceAucunFalse
Merci de vos commentaires !Avis correctement envoyé. Merci