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 Online 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

La valeur suivante est requise pour chaque utilisateur :

  • Nom d'utilisateur : L'adresse d'email de l'utilisateur.

Options de colonne CSV supplémentaires

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

  • Nom d'utilisateur. L'adresse de messagerie de l'utilisateur. Il s'agit de la seule colonne requise.

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

  • Nom d'affichage. Tableau Online 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. Il peut être défini sur Site ou Aucun.

  • Fonctionnalité de publication. Les valeurs acceptables sont Oui/Vrai/1 ou Non/Faux/0.

Exemple d'entrées de fichier CSV

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

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 Online. 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 Online. 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 Online 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 CSV Rôle sur le site

Niveau de licence=(tout)

Administrateur=Système

Publicateur=true

Administrateur du serveur. Ce paramètre s'applique uniquement à Tableau Server et n'est valide que si vous importez des utilisateurs tout en gérant le serveur (c'est-à-dire que vous n'êtes pas connecté à un site spécifié).

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 (Observateur)

Niveau de licence=Sans licence

Administrateur=Aucun

Publicateur=false

Sans licence

Merci de vos commentaires !