Recommandations relatives au fichier d’importation CSV

Vous pouvez automatiser l’ajout d’utilisateurs en créant un fichier CSV (valeurs séparées par des virgules) contenant des informations d’utilisateur et 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.

Pour importer des utilisateurs, vous pouvez utiliser les pages d’administration de serveur ou de site, ou l’utilitaire tabcmd. L’utilisation de la commande tabcmd fournit une option d’affectation d’un rôle sur le site à tous les utilisateurs figurant dans un fichier CSV. Pour plus d’informations, consultez Importer des utilisateurs ou createsiteusers nomfichier.csv.

Exigences de format de fichier CSV

Lorsque vous créez le fichier CSV pour importer des utilisateurs, vérifiez que le fichier répond aux critères de mise en forme suivants :

  • Le fichier ne contient pas d’en-têtes de colonne. Tableau Cloud part du principe que chaque ligne du fichier représente un utilisateur.

  • Le fichier est au format UTF-8 et inclut la marque d’ordre des octets (BOM).

  • Les codages de caractères tels que BIG-5 ont été convertis en UTF-8. Pour ce faire, ouvrez le fichier dans un éditeur de texte et utilisez la commande Enregistrer sous.

  • Si un nom d’utilisateur inclut un symbole « @ » représentant autre chose qu’un séparateur de domaine, vous devez vous reporter au symbole en utilisant le format hexadécimal : \0x40

    Par exemple, user@fremont@mycompany.com doit être user\0x40fremont@mycompany.com

Colonnes requises dans le fichier CSV

Les champ suivants sont requis pour chaque utilisateur :

  • Nom d’utilisateur : l’adresse e-mail de l’utilisateur.

  • Mot de passe. Tableau Cloud n’utilise pas ce champ, mais vous devez le délimiter dans chaque ligne pour positionner les champs suivants correctement.

Options de colonne CSV supplémentaires

Pour chaque utilisateur, le fichier CSV peut contenir les champs suivants outre les colonnes requises. Là où indiqué, Tableau Cloud n’utilise pas le champ, mais il doit être pris en compte pour le fichier.

  • URI du site (Tableau Cloud Manager uniquement) : identifiant de ressource uniforme pour le site. Pour importer un utilisateur en tant qu’administrateur Cloud, incluez la colonne URI du site mais laissez-la vide.

  • Nom d’affichage. Tableau Cloud n’utilise pas ce champ, mais vous devez le délimiter dans chaque ligne pour positionner les champs suivants correctement.

  • Niveau de licence. On distingue les types Creator, Explorer, Viewer ou Sans licence.

  • Niveau administrateur : la valeur peut être Cloud, Site ou Aucun. Cloud = Administrateur Cloud, Site = Administrateur de site et Aucun = Pas un administrateur.

    Remarque : la valeur de l’administrateur Cloud est uniquement disponible lors de l’importation d’utilisateurs dans Tableau Cloud Manager. Elle n’est pas destinée à être utilisée avec les sites Tableau Cloud. Pour plus d’informations, consultez Gérer les utilisateurs avec Tableau Cloud Manager.

  • Fonctionnalité de publication. Les valeurs acceptables sont Oui/Vrai/1 ou Non/Faux/0. Si le niveau de licence est Creator, la capacité de publication doit être Yes/True/1.

  • Type d’authentification (Tableau Cloud Manager uniquement) : le type d’authentification utilisateur pour accéder à un site ou à Tableau Cloud Manager.

Exemple d’entrées de fichier CSV

Site Tableau Cloud

L’exemple suivant montre un utilisateur auquel le rôle sur le site Explorer est accordé, qui n’est pas un administrateur de site et pourra publier des projets sur lesquels il dispose d’autorisations de contenu appropriées.

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

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

Tableau Cloud Manager

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.

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

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.

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

Remarques

  • 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.).

  • Les champs de mot de passe (seconde valeur) et de nom d’affichage (troisième valeur) ne sont pas utilisés par Tableau Cloud. Les valeurs que vous spécifiez pour ces champs sont ignorées.

    Toutefois, si vous souhaitez définir la licence et l’accès à la publication pour les utilisateurs, votre fichier doit quand même inclure des séparateurs pour ces champs, comme dans l’exemple précédemment.

  • Les nouveaux utilisateurs doivent sélectionner un mot de passe et un nom à afficher lors de leur connexion initiale à Tableau Cloud. Si les utilisateurs possèdent déjà un compte Tableau, par exemple pour les forums de la communauté Tableau, ils ont déjà des mots de passe.

  • Le fichier CSV ne comprend pas de champ pour la définition du type d’authentification (Tableau, Google ou SAML). Vous spécifiez cet élément dans Tableau Cloud lorsque vous importez le fichier. Le paramètre s’applique à tous les utilisateurs importés, et vous pouvez modifier le type d’authentification pour les utilisateurs individuels par la suite.

    Remarque : vous pouvez sinon utiliser tabcmd pour importer des utilisateurs et définir le type d’authentification et le rôle sur le site s’appliquant à tous les utilisateurs d’un fichier CSV. Pour plus d’informations, consultez createsiteusers nomfichier.csv.

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 tableau suivant montre comment les paramètres sont convertis en rôles sur le site.

Paramètres CSVRôle sur le site

Niveau de licence=Sans licence

Administrateur=Cloud

Publicateur=false

Administrateur Cloud. Ce paramètre n’est valide que si vous importez des utilisateurs en étant connecté à Tableau Cloud Manager (à savoir, non connecté à un site spécifique).

Niveau de licence=Creator ou Explorer

Administrateur=Site

Publicateur=true

Administrateur de site - Creator ou Administrateur de site - Explorer. Ce paramètre n’est valide que si vous importez des utilisateurs en étant connecté à un site spécifique.

Niveau de licence=Creator

Administrateur=Aucun

Publicateur=true

Creator

Niveau de licence=Explorer

Administrateur=Aucun

Publicateur=true

Explorer (peut publier)

Niveau de licence=Explorer

Administrateur=Aucun

Publicateur=false

Explorer

Niveau de licence=Viewer (Observateur)

Administrateur=Aucun

Publicateur=false

Viewer

Niveau de licence=Sans licence

Administrateur=Aucun

Publicateur=false

Sans licence

Merci de vos commentaires !Avis correctement envoyé. Merci