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 champs suivants sont obligatoires pour chaque utilisateur :
Nom d’utilisateur : l’adresse de courriel 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, en plus des colonnes obligatoires. 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) : l’identifiant de ressource uniforme du site. Pour importer un utilisateur en tant qu’administrateur Cloud, incluez la colonne URI du site, mais laissez cet espace 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 = N’est pas un administrateur.
Remarque : La valeur de l’administrateur Cloud ne s’affiche que lors de l’importation d’utilisateurs dans Tableau Cloud Manager. Elle n’est pas censé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 Oui/Vrai/1.
Type d’authentification (Tableau Cloud Manager uniquement) : le type d’authentification auquel l’utilisateur doit se soumettre 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
Dans l’exemple suivant, un utilisateur se voit attribuer le rôle d’administrateur Cloud dans Tableau Cloud Manager et s’authentifie à l’aide de Tableau avec MFA.
,cloudadminuser@domain.com,,,,Cloud,,Tableau with MFA
En modifiant la colonne d’authentification, l’utilisateur suivant peut être importé avec un autre type d’authentification s’il est configuré 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 de courriel), les utilisateurs recevront une invitation au site par courriel. 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 (c.-à-d., en étant pas 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 Administrateur=Aucun Publicateur=false | Viewer |
Niveau de licence=Sans licence Administrateur=Aucun Publicateur=false | Sans licence |