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 êtreuser\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 CSV | Rô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 |