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.

Vous pouvez importer des utilisateurs au niveau du site ou du serveur. Si vous importez des utilisateurs sur le serveur (pas sur un site spécifique), les utilisateurs ne sont pas affectés à un site et sont importés en tant que Sans licence.

Remarque : Sauf indication contraire, les directives spécifiées dans cette rubrique s’appliquent à Tableau Server lorsqu’il est configuré avec ou sans pools d’identités(Le lien s’ouvre dans une nouvelle fenêtre).

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 Server 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 champs suivants sont obligatoires pour chaque utilisateur :

  • Nom d’utilisateur. Le nom d’utilisateur. Si le serveur est configuré pour utiliser Active Directory, cette valeur doit correspondre à un utilisateur défini dans Active Directory. Si le nom d’utilisateur n’est pas unique dans tous les domaines, vous devez inclure le domaine dans le nom d’utilisateur (par exemple, example\Adam ou adam@example).

    Si vous ajoutez des utilisateurs à un pool d’identités(Le lien s’ouvre dans une nouvelle fenêtre), procédez comme suit :

    • Si vous ajoutez un utilisateur à un pool d’identités dont le magasin d’identités est AD, prenez soin d’utiliser la valeur AD sAMAccountName comme nom d’utilisateur.
    • Si vous ajoutez un utilisateur à un pool d’identités dont le magasin d’identités est LDAP, prenez soin d’utiliser la valeur de nom d’utilisateur LDAP comme nom d’utilisateur.

  • Mot de passe. Mot de passe de l’utilisateur.

    • Si le serveur est configuré pour utiliser Active Directory, cette valeur n’est pas utilisée. Néanmoins, il doit y avoir une colonne de mot de passe et cette colonne doit être vide.

    • Si le serveur utilise l’authentification locale, vous devez fournir des mots de passe pour les nouveaux utilisateurs.

    Remarque : L’utilisation du champ de mot de passe est devenue obligatoire depuis Tableau Server 2024.2. Pour plus d’informations, consultez l’article de connaissances Un « errorCode=134 » inattendu s’est produit lors de la tentative d’ajout d’utilisateurs via tabcmd dans Tableau Server 2024.2.

Options d’importation de fichiers supplémentaires

Le fichier CSV peut contenir les champs suivants en plus des champs susmentionnés, dans l’ordre indiqué ci-dessous :

  • Nom d’affichage. Le nom d’affichage fait partie des informations permettant d’identifier un utilisateur sur le serveur. Si le nom d’affichage de l’utilisateur est déjà utilisé, Tableau Server met à jour l’information existante de l’utilisateur en fonction des paramètres figurant dans le fichier CSV. Si le serveur est configuré pour utiliser Active Directory, cette valeur n’est pas utilisée.

  • Niveau de licence. On distingue les types Creator, Explorer, Viewer ou Sans licence. Si vous précisez Creator pour un compte utilisateur particulier, vous devez également définir la fonctionnalité de publication sur Vrai.

  • Niveau d’administrateur (Système, Site ou Aucun). Ce paramètre détermine si l’utilisateur est importé comme un administrateur.

    Si vous utilisez l’interface utilisateur Web pour importer des utilisateurs, vous ne pouvez définir le rôle d’administrateur sur Système que si vous importez le fichier au niveau du serveur (Tous les sites). Si vous êtes connecté à un site spécifique, et si la colonne Administrateur pour un utilisateur du fichier CSV est définie sur Système, Tableau Server importe l’utilisateur en tant qu’administrateur de site.

  • Possibilité de publication (yes/true/1 ou no/false/0). Si vous utilisez l’interface utilisateur Web, le paramètre de publicateur n’est utilisé que si vous lancez l’importation au moment où vous êtes connecté à un site spécifique.

  • Adresse de courriel L’adresse de courriel fait partie des renseignements permettant d’identifier un utilisateur sur le serveur. Si l’adresse de courriel est déjà utilisée, Tableau Server met à jour l’information de l’utilisateur en fonction des paramètres figurant dans le fichier CSV.

Si vous ajoutez des utilisateurs à un pool d’identités, les valeurs suivantes sont nécessaires en plus des valeurs ci-dessus :

  • Nom du pool d’identités. Nom du pool d’identités auquel vous souhaitez ajouter l’utilisateur.

  • Identifiant. L’identifiant de l’utilisateur que vous souhaitez ajouter. Les identifiants ne sont utilisés qu’à des fins de correspondance d’identité. Pour plus d’informations, consultez Noms d’utilisateur et identifiants dans Tableau. Remarque : L’identifiant est requis si vous ajoutez un utilisateur à un pool d’identités qui utilise le magasin d’identités Active Directory (ou LDAP). L’identifiant est facultatif si vous ajoutez un utilisateur à un pool d’identités qui utilise le magasin d’identités local.

    Remarques :

    • Si vous ajoutez des utilisateurs à un pool d’identités et que vous ne spécifiez pas le nom du pool d’identités, les utilisateurs sont ajoutés au pool initial (configuré par TSM), qui est l’ensemble des utilisateurs provisionnés dans TSM lors de la configuration de Tableau Server.

    • Pour la valeur du nom d’utilisateur, procédez comme suit :

      • Si vous ajoutez un utilisateur à un pool d’identités dont le magasin d’identités est AD, prenez soin d’utiliser la valeur AD sAMAccountName comme nom d’utilisateur.
      • Si vous ajoutez un utilisateur à un pool d’identités dont le magasin d’identités est LDAP, prenez soin d’utiliser la valeur de nom d’utilisateur LDAP comme nom d’utilisateur.

    • Vous pouvez utiliser le processus d’importation CSV pour :

      • Ajouter des utilisateurs en bloc à des pools d’identités supplémentaires. Remarque : Vous ne pouvez pas utiliser le processus d’importation CSV pour remplacer le pool d’identités auquel appartient déjà un utilisateur par un autre pool d’identités. Si vous ajoutez un utilisateur existant avec une valeur de pool d’identités différente, il sera ajouté à ce pool d’identités supplémentaire.

      • Ajoutez en bloc des identifiants pour les utilisateurs qui ne les possèdent pas déjà. Remarque : Si vous ajoutez un identifiant différent pour un utilisateur dans le même pool, il ne remplacera pas l’identifiant existant de cet utilisateur. Au lieu de cela, un nouvel enregistrement d’identifiant sera créé pour cet utilisateur.

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.

Améliorer les performances pour les fichiers CSV volumineux traités par tabcmd

Remarque : ces paramètres s appliquent à Tableau Server versions 2022.1 et antérieures. Le service de recherche et d’indexation qu’ils affectent est obsolète à partir de la version 2022.3 et retiré (supprimé complètement) dans la version 2023.3.

Un administrateur de serveur peut activer des paramètres serveur permettant d’améliorer les performances lors de l’importation de fichiers CSV volumineux à l’aide des commandes tabcmd. Vous pouvez le faire en utilisant la commande tsm configuration set avec les options suivantes :

  • vizportal.csv_user_mgmt.index_site_users

  • vizportal.csv_user_mgmt.bulk_index_users

  • searchserver.index.bulk_query_user_groups

En résumé, ces options indexent les utilisateurs une fois le fichier CSV traité, plutôt que de les traiter un par un lorsqu’ils sont ajoutés à la base de données du serveur. Ceci permet de réduire le nombre d’appels à la base de données et de limiter la quantité de mémoire nécessaire au traitement du fichier. Ces options tsm configuration set s’appliquent aux commandes tabcmd createsiteusers, deletesiteusers, addusers et removeusers.

Pour une description pour ces paramètres, consultez Options tsm configuration set.

Remarques

  • Si vous n’êtes pas connecté à un site spécifique et que vous importez des utilisateurs au niveau du serveur, vous ne pouvez affecter que les rôles sur le site Administrateur du serveur et Sans licence.

  • Si l’installation de votre serveur est basée sur le nombre d’utilisateurs, et que l’ajout d’utilisateurs entraîne un dépassement du seuil autorisé par votre licence, les utilisateurs sont ajoutés en tant qu’utilisateurs sans licence.

  • Si vous utilisez tabcmd et que vous spécifiez la licence, mais que l’importation d’utilisateurs entraîne un dépassement du seuil autorisé par votre licence, les utilisateurs sont importés avec le rôle Sans licence.

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=(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é).

Le rôle sur le site Administrateur du serveur prend toujours une licence Creator s’il y a en a une de disponible. S’il n’y a pas de licence Creator disponible, consultez Résoudre les problèmes de licence pour savoir comment Tableau Server traite ce problème.

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

Exemples d’importation de fichier CSV pour Tableau Server

L’exemple suivant montre un fichier CSV contenant les informations de plusieurs utilisateurs.

henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw@example.com
freds,fredpassword,Fred Suzuki,Viewer,None,no,freds@example.com
alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw@example.com
michellek,michellepassword,Michelle Kim,Creator,System,yes,michellek@example.com

Si vous importez ce fichier dans le cadre de la gestion d’un site, quatre utilisateurs sont ajoutés à ce site. Le paramètre Administrator pour l’utilisateur Michelle est System. Cependant, étant donné que vous importez les utilisateurs dans un site, Tableau Server configure l’utilisateur Michelle avec le rôle sur le site Administrateur de site - Creator. Trois de ces utilisateurs possèdent l’autorisation de publication.

Si vous importez ce fichier dans le cadre de la gestion du serveur, quatre utilisateurs sont ajoutés au serveur, mais il ne sont ajoutés à aucun site. Un seul utilisateur est importé comme administrateur de serveur, les autres sont définis avec le rôle Sans licence.

Exemples de pools d’identités

L’exemple suivant montre un fichier CSV contenant les renseignements de deux utilisateurs ajoutés à un pool d’identités.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki

L’exemple suivant montre un fichier CSV contenant les renseignements de deux utilisateurs ajoutés à un pool d’identités supplémentaire.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors 2,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki

L’exemple suivant montre un fichier CSV contenant les renseignements de deux utilisateurs pour lesquels il n’existe pas d’identifiants.

janes,janepassword,Jane Smith,Viewer,None,yes,jsmith@myco.com,General Contractors,jwang
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez
Retour en haut
Merci de vos commentaires!Votre commentaire s été envoyé avec succès. Merci!