---
schema_version: "1"
id: 582bd66c11ddc8e0adde6b1a164304bd5608311ca91c5d0c5c5e2ab7c7ada8b8
title: Fonctions utilisateur
collection: tableau
version: next
locale: fr-fr
portal_url: https://docs.salesforce.com/tableau/next/fr-fr/pro/desktop/functions_functions_user.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/fr-fr/functions_functions_user.htm
source_site: help.tableau.com
content_type: documentation
content_hash: fd7b3d2f37384e80d4c0d4646264b2da2b6511d1b517c859eb3939fb18404701
description: Reference for user functions used to build user filters and row-level security.
---
[Passer au contenu principal](#main-content)

# Fonctions utilisateur

Cet article présente les fonctions utilisateur et leurs utilisations dans Tableau. Il montre également comment créer un calcul utilisateur en se basant sur un exemple.

## Pourquoi utiliser des fonctions utilisateur

Les fonctions utilisateur peuvent servir à créer des filtres utilisateur ou des filtres de sécurité au niveau des lignes. Ces filtres affectent les visualisations publiées sur Tableau Server ou Tableau Cloud de sorte que seules certaines personnes puissent voir votre visualisation.

Imaginons par exemple une visualisation qui montre les performances de vente pour chaque employé de votre service publiées sur Tableau Server ou Tableau Cloud. Vous souhaiterez peut-être que les employés puissent uniquement voir leurs propres chiffres de vente lorsqu’ils accèdent à cette visualisation.

Dans ce cas, vous pouvez utiliser la fonction ISMEMBEROF pour créer un champ qui renvoie la valeur True si le nom d’utilisateur de la personne connectée au serveur appartient à un groupe spécifié (sur le serveur), par exemple le groupe « Managers ». Ensuite, lorsque vous filtrez la vue à l’aide de ce champ calculé, seule une personne faisant partie de ce groupe peut voir les données.

Le calcul dans ce cas peut se présenter ainsi :

ISMEMBEROF('Managers')

Remarque : si les noms de vos groupes ou de vos utilisateurs contiennent des caractères non alphanumériques, vous devez utiliser le codage d’URL HTML pour les caractères spéciaux lorsque vous utilisez les fonctions.

Certains caractères spéciaux sont autorisés sans encodage d’URL HTML, tels que les soulignements, les parenthèses et les points d’exclamation. `_ ( ) !` De nombreux autres caractères doivent être codés.

Par exemple, la fonction `ISMEMBEROF("USERS+")` doit être écrite en tant que `ISMEMBEROF("USERS%2B")`, parce que « %2B » est l’encodage d’URL HTML pour le symbole « + ». Pour des informations sur l’encodage d’URL HTML, consultez [Référence de l’encodage d’URL HTML](https://www.w3schools.com/tags/ref_urlencode.asp) sur le site Web des développeurs Web W3schools.

### Fonctions d’attribut utilisateur pour le contrôle et la personnalisation de l’accès aux données

Parmi les fonctions utilisateur dans Tableau, un sous-ensemble de fonctions appelé fonctions d’attribut utilisateur, peut être utilisé pour masquer ou afficher les données selon les personnes qui accèdent au contenu. Avec les fonctions d’attribut utilisateur, les attributs utilisateur peuvent être capturés par Tableau au moment de l’exécution dans le cadre du workflow d’authentification.

À prendre en compte lors de la création :

- Les fonctions d’attributs utilisateur peuvent être incluses dans le contenu créé dans Tableau Desktop, Tableau Cloud ou Tableau Serveur.
- Les fonctions d’attribut utilisateur dans le contenu accédé via les flux de travail d’authentification unique (SSO) OIDC ou SAML sont uniquement prises en charge sur Tableau Cloud et Tableau Server.
- L’aperçu du contenu avec ces fonctions n’est pas disponible lors de la création dans Tableau Desktop, Tableau Cloud ou Tableau Serveur. Les fonctions d’attribut utilisateur renverront des valeurs NULL ou FALSE. Afin que les fonctions d’attribut utilisateur fonctionnent comme prévu, nous vous recommandons d’examiner le contenu une fois qu’il est disponible. Pour plus d’informations sur les workflows incluant ces fonctions utilisateur, consultez l’aide de [Tableau Embedding API v3](https://help.tableau.com/current/api/embedding_api/fr-fr/docs/embedding_api_user_attributes.html), les rubriques [OIDC](https://help.tableau.com/current/online/fr-fr/openid_auth_server_config.htm#user_attributes) ou [SAML](https://help.tableau.com/current/online/fr-fr/saml_config_site.htm#user_attributes) de Tableau Cloud, ou les rubriques [OIDC](https://help.tableau.com/current/server/fr-fr/openid_auth_requirements.htm#user_attributes) ou [SAML](https://help.tableau.com/current/server/fr-fr/config_saml.htm#user_attributes) de Tableau Server.
- Les fonctions d’attribut utilisateur ne peuvent pas être utilisées dans les workflows basés sur Tableau Bridge.

#### Workflow 1 : Workflows d’intégration (JWT et applications connectées à Tableau ou jetons d’accès unifiés)

Les fonctions d’attribut utilisateur (USERATTRIBUTE et USERATTRIBUTEINCLUDES) dans le contenu intégré peuvent être activées via des attributs utilisateur transmis dans un jeton Web JSON (JWT) via :

- [Applications connectées à Tableau](https://help.tableau.com/current/online/fr-fr/connected_apps.htm) dans Tableau Cloud
- [Applications connectées à Tableau](https://help.tableau.com/current/online/fr-fr/connected_apps.htm) dans Tableau Server 2025.1 et versions ultérieures
- [Jetons d’accès unifiés](https://help.tableau.com/current/api/cloud-manager/fr-fr/docs/unified_access_tokens.html) dans Tableau Cloud à partir de décembre 2025

Lorsque les attributs utilisateur sont transmis depuis des jetons JWT, le contenu intégré créé avec ces fonctions permet de contrôler et personnaliser les données affichées à l’attention des utilisateurs.

**Remarques :**

- Check the [Tableau Embedding API v3](https://help.tableau.com/current/api/embedding_api/fr-fr/docs/embedding_api_user_attributes.html#known-issues) Help for _known issues_ and _limitations_ that might affect your workflow.
- Pour que l’attribut utilisateur fonctionne :
    
    - Dans Tableau Cloud, l’administrateur de site doit 1) activer le paramètre Contrôler l’accès utilisateur dans les workflows d’authentification et 2) configurer l’application connectée ou le jeton d’accès unifié avec les valeurs de revendication des attributs utilisateur dans le JWT. En outre, 3) l’auteur du contenu doit créer une fonction d’attribut utilisateur (USERATTRIBUTE ou USERATTRIBUTEINCLUDES).
    - Dans Tableau Server, l’administrateur de serveur doit 1) activer la fonctionnalité d’attribut utilisateur avec la méthode [Mettre à jour le site](https://help.tableau.com/current/api/rest_api/fr-fr/REST/rest_api_ref_site.htm#update_site) à l’aide de l’API REST de Tableau et activer éventuellement l’option TSM [features.VizDataServiceClientEnable](https://help.tableau.com/current/server/fr-fr/cli_configuration-set_tsm.htm#uaf) et 2) configurer l’application connectée avec les valeurs de revendication d’attribut utilisateur dans le JWT. En outre, 3) l’auteur du contenu doit créer une [fonction d’attribut utilisateur](https://help.tableau.com/current/pro/desktop/fr-fr/functions_functions_user.htm#user_attributes).
        
        Pour plus d’informations, consultez [Personnaliser et contrôler l’accès aux données à l’aide des attributs utilisateur](https://help.tableau.com/current/api/embedding_api/fr-fr/docs/embedding_api_user_attributes.html) dans l’aide de Tableau Embedding API v3.

#### Workflow 2 : Workflows de contenu avec connexion directe à SAML ou OIDC

En plus du workflow d’intégration décrit ci-dessus, la fonctionnalité des fonctions d’attribut utilisateur est étendue à d’autres workflows d’intégration et de non-intégration. Les fonctions d’attributs utilisateur dans le contenu peuvent être activées grâce aux attributs utilisateur transmis dans les revendications OIDC ou les assertions SAML. Ces derniers sont capturés lorsque l’utilisateur se connecte pour accéder au contenu s’il est configuré pour se connecter à l’aide de l’authentification SSO OIDC ou SAML. Lorsque des attributs sont transmis à partir de revendications ou d’assertions, le contenu créé avec ces fonctions (USERATTRIBUTE et USERATTRIBUTEINCLUDES)peut contrôler et personnaliser les données affichées à l’attention des utilisateurs.

**Remarques :**

- Consultez les rubriques [OIDC](https://help.tableau.com/current/online/fr-fr/openid_auth_server_config.htm#user_attributes_known_issues) ou [SAML](https://help.tableau.com/current/online/fr-fr/saml_config_site.htm#user_attributes_known_issues) de Tableau Cloud, ou les rubriques [OIDC](https://help.tableau.com/current/server/fr-fr/openid_auth_requirements.htm#user_attributes) ou [SAML](https://help.tableau.com/current/server/fr-fr/config_saml.htm#user_attributes) de Tableau Server (à partir de Tableau Server 2026.2) pour vous renseigner sur les problèmes connus et les restrictions susceptibles d’affecter votre flux de travail.
- Pour que l’attribut utilisateur fonctionne, l’administrateur doit inclure les attributs utilisateur dans les revendications OIDC ou les assertions SAML, et l’auteur du contenu doit créer une fonction d’attribut utilisateur (USERATTRIBUTE ou USERATTRIBUTEINCLUDES).

## Fonctions utilisateur disponibles dans Tableau

### FULLNAME( )

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>FULLNAME( )</code></td></tr><tr><td>Résultat</td><td>Chaîne</td></tr><tr><td>Définition</td><td><p>Renvoie le nom complet de l’utilisateur actuel.</p></td></tr><tr><td>Exemple</td><td><pre>FULLNAME( )</pre><p>Renvoie le nom complet de l’utilisateur connecté, par exemple «&nbsp;Hamlin Myrer&nbsp;».</p><pre xml:space="preserve">[Manager] = FULLNAME( )</pre><p>Si le responsable «&nbsp;Hamlin Myrer&nbsp;» est connecté, cet exemple ne renvoie la valeur TRUE que si la valeur «&nbsp;Hamlin Myrer&nbsp;» est présente dans le champ Manager de la vue.</p></td></tr><tr><td>Remarques</td><td><p>Cette fonction vérifie&nbsp;:</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> et <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>&nbsp;:&nbsp;le nom complet de l’utilisateur connecté</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>&nbsp;: le nom complet local ou réseau de l’utilisateur</li></ul><p><b>Filtres utilisateur</b></p><p>Lorsqu’il est utilisé en tant que filtre, un champ calculé tel que <code>[Username field] = FULLNAME( )</code> peut servir à créer un filtre utilisateur qui n’affiche que les données correspondant à la personne connectée au serveur.</p></td></tr></tbody></table>

### ISFULLNAME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>ISFULLNAME("User Full Name")</code></td></tr><tr><td>Résultat</td><td>Booléen</td></tr><tr><td>Définition</td><td><p>Renvoie la valeur <code>TRUE</code> si le nom complet de l’utilisateur actuel correspond au nom complet spécifié, ou la valeur <code>FALSE</code> si ce n’est pas le cas.</p></td></tr><tr><td>Exemple</td><td><pre>ISFULLNAME("Hamlin Myrer")</pre></td></tr><tr><td>Remarques</td><td><p>L’argument <code>&lt;"User Full Name"&gt;</code> doit être une chaîne constante, et non une valeur de champ.</p><p>Cette fonction vérifie&nbsp;:</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> et <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>&nbsp;:&nbsp;le nom complet de l’utilisateur connecté</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>&nbsp;: le nom complet local ou réseau de l’utilisateur</li></ul></td></tr></tbody></table>

### ISMEMBEROF

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>ISMEMBEROF("Group Name")</code></td></tr><tr><td>Résultat</td><td>Valeur booléenne ou null</td></tr><tr><td>Définition</td><td><p>Renvoie <code>TRUE</code> si la personne qui utilise actuellement Tableau est membre d’un groupe correspondant à la chaîne donnée. Renvoie <code>FALSE</code> sil elle n’est pas membre, et <code>NULL</code> si elle n’est pas connectée.</p></td></tr><tr><td>Exemple</td><td><pre>ISMEMBEROF('Superstars')</pre><pre>ISMEMBEROF('domain.lan\Sales')</pre></td></tr><tr><td>Remarques</td><td><p>L’argument <code>&lt;"Group Full Name"&gt;</code> doit être une chaîne constante, et non une valeur de champ.</p><p>Si l’utilisateur est connecté à <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> ou <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>, l’appartenance aux groupes est déterminée par les groupes Tableau. La fonction renvoie TRUE si la chaîne donnée est «&nbsp;Tous les utilisateurs&nbsp;»</p><p>La fonction <code>ISMEMBEROF( )</code> accepte également les domaines Active Directory. Le domaine Active Directory doit être déclaré dans le calcul avec le nom du groupe.</p><p>Si une modification est apportée à l’appartenance à un groupe d’un utilisateur, la modification des données basées sur cette appartenance est reflétée dans un classeur ou une vue avec une nouvelle session. La session existante reflétera les données obsolètes.</p></td></tr></tbody></table>

### ISUSERNAME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>ISUSERNAME("username")</code></td></tr><tr><td>Résultat</td><td>Booléen</td></tr><tr><td>Définition</td><td>Renvoie la valeur <code>TRUE</code> si le nom d’utilisateur de l’utilisateur actuel correspond au nom d’utilisteur spécifié, ou <code>FALSE</code> si ce n’est pas le cas.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">ISUSERNAME("hmyrer")</pre></td></tr><tr><td>Remarques</td><td><p>L’argument <code>&lt;"username"&gt;</code> doit être une chaîne constante, et non une valeur de champ.</p><p>Cette fonction vérifie&nbsp;:</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> et <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>&nbsp;:&nbsp;le nom d’utilisateur de l’utilisateur connecté</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>: le nom d’utilisateur local ou réseau de l’utilisateur</li></ul></td></tr></tbody></table>

### USERDOMAIN( )

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>USERDOMAIN(&nbsp;)</code></td></tr><tr><td>Résultat</td><td>Chaîne</td></tr><tr><td>Définition</td><td>Renvoie le domaine de l’utilisateur actuel.</td></tr><tr><td>Remarques</td><td><p>Cette fonction vérifie&nbsp;:</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> et <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>&nbsp;: le domaine utilisateur de l’utilisateur connecté</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>&nbsp;: le domaine local si l’utilisateur se trouve sur un domaine</li></ul></td></tr></tbody></table>

### USERNAME( )

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>USERNAME( )</code></td></tr><tr><td>Résultat</td><td>Chaîne</td></tr><tr><td>Définition</td><td>Renvoie le nom d’utilisateur de l’utilisateur actuel.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">USERNAME( )</pre><p>Renvoie le nom d’utilisateur de l’utilisateur connecté, par exemple «&nbsp;hmyrer&nbsp;».</p><pre xml:space="preserve">[Manager] = USERNAME( )</pre><p>Si le responsable «&nbsp;hmyrer&nbsp;» est connecté, cet exemple ne renvoie la valeur TRUE que si la valeur «&nbsp;hmyrer&nbsp;» est présente dans le champ Manager de la vue.</p></td></tr><tr><td>Remarques</td><td><p>Cette fonction vérifie&nbsp;:</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> et <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>&nbsp;:&nbsp;le nom d’utilisateur de l’utilisateur connecté</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>: le nom d’utilisateur local ou réseau de l’utilisateur</li></ul><p><b>Filtres utilisateur</b></p><p>Lorsqu’il est utilisé en tant que filtre, un champ calculé tel que <code>[Username field] = USERNAME( )</code> peut servir à créer un filtre utilisateur qui n’affiche que les données correspondant à la personne connectée au serveur.</p></td></tr></tbody></table>

### USERATTRIBUTE

**Remarque** : avant d’utiliser cette fonction, consultez [Fonctions d’attribut utilisateur pour le contrôle et la personnalisation de l’accès aux données](#user_attributes). Pour plus d’informations, selon votre workflow, consultez [Authentification et vues intégrées](https://help.tableau.com/current/api/embedding_api/fr-fr/docs/embedding_api_auth.html) dans l’aide d’Embedding API v3, les rubriques [OIDC](https://help.tableau.com/current/online/fr-fr/openid_auth_server_config.htm#user_attributes) ou [SAML](https://help.tableau.com/current/online/fr-fr/saml_config_site.htm#user_attributes) dans Tableau Cloud ou les rubriques [OIDC](https://help.tableau.com/current/server/fr-fr/openid_auth_requirements.htm#user_attributes) ou [SAML](https://help.tableau.com/current/server/fr-fr/config_saml.htm#user_attributes) dans Tableau Server.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>USERATTRIBUTE('attribute_name')</code></td></tr><tr><td>Résultat</td><td>Chaîne ou valeur null</td></tr><tr><td>Définition</td><td><p>Si <code>&lt;'attribute_name'&gt;</code> fait partie du jeton Web JWT (via les applications connectées, UAT, la revendication d’OIDC) transmis à Tableau, le calcul renvoie la première valeur de <code>&lt;'attribute_name'&gt;</code>.</p><p>Renvoie une valeur null si <code>&lt;'attribute_name'&gt;</code> n’existe pas.</p></td></tr><tr><td>Exemple</td><td><p>Supposons que « Region » soit l’attribut utilisateur inclus dans la réponse JWT ou SAML et transmis à Tableau.</p><p>En tant qu’auteur du classeur, vous pouvez configurer votre visualisation de manière à filtrer les données en fonction d’une région spécifiée. Dans ce filtre, vous pouvez faire référence au calcul suivant.</p><pre xml:space="preserve">[Region] = USERATTRIBUTE("Region")</pre><p>Lorsque User2 de la région Ouest affiche la visualisation intégrée, Tableau affiche les données appropriées pour la région Ouest uniquement.</p></td></tr><tr><td>Remarques</td><td>Vous pouvez utiliser la fonction <code>USERATTRIBUTEINCLUDES</code> si vous prévoyez que<code>&lt;'attribute_name'&gt;</code> renvoie plusieurs valeurs.</td></tr></tbody></table>

### USERATTRIBUTEINCLUDES

**Remarque** : avant d’utiliser cette fonction, consultez [Fonctions d’attribut utilisateur pour le contrôle et la personnalisation de l’accès aux données](#user_attributes). Pour plus d’informations, selon votre workflow, consultez [Authentification et vues intégrées](https://help.tableau.com/current/api/embedding_api/fr-fr/docs/embedding_api_auth.html) dans l’aide d’Embedding API v3, les rubriques [OIDC](https://help.tableau.com/current/online/fr-fr/openid_auth_server_config.htm#user_attributes) ou [SAML](https://help.tableau.com/current/online/fr-fr/saml_config_site.htm#user_attributes) dans Tableau Cloud ou les rubriques [OIDC](https://help.tableau.com/current/server/fr-fr/openid_auth_requirements.htm#user_attributes) ou [SAML](https://help.tableau.com/current/server/fr-fr/config_saml.htm#user_attributes) dans Tableau Server.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')</code></td></tr><tr><td>Résultat</td><td>Booléen</td></tr><tr><td>Définition</td><td><p>Renvoie <code>TRUE</code> si les deux énoncés suivants sont vrais&nbsp;:</p><ul><li><code>&lt;'attribute_name'&gt;</code> fait partie de la réponse JWT (via une application connectée, UAT, une revendication OIDC) ou SAML XML transmise à Tableau</li><li>Une des valeurs <code>&lt;'attribute_name'&gt;</code> est égale à <code>&lt;'expected_value'&gt;</code> .</li></ul><p>Sinon, renvoie <code>FALSE</code>.</p></td></tr><tr><td>Exemple</td><td><p>Supposons que « Region » soit l’attribut utilisateur inclus dans la réponse JWT ou SAML et transmis à Tableau.</p><p>En tant qu’auteur du classeur, vous pouvez configurer votre visualisation de manière à filtrer les données en fonction d’une région spécifiée. Dans ce filtre, vous pouvez faire référence au calcul suivant.</p><pre xml:space="preserve">USERATTRIBUTEINCLUDES('Region', [Region])</pre><p>Si User2 de la région Ouest accède à la visualisation intégrée, Tableau vérifie si l’attribut utilisateur Région correspond à l’une des valeurs du champ [Region]. Lorsque la valeur est true, la visualisation affiche les données appropriées.</p><p>Lorsque User3 de la région Nord accède à la même visualisation, elle ne peut voir aucune donnée car il n’y a pas de correspondance avec les valeurs du champ [Region].</p></td></tr></tbody></table>

## Créer un calcul utilisateur

Les calculs utilisateur fonctionnent directement avec les utilisateurs et les groupes que vous avez configurés sur Tableau Server ou Tableau Cloud. Vous pouvez créer des calculs utilisateur à utiliser comme filtres de manière à ce que les utilisateurs puissent uniquement voir les données pertinentes pour eux.

Par exemple, imaginons une visualisation de carte de ce type, qui affiche les données de vente pour 48 États américains. Vous pouvez créer un calcul utilisateur de manière à afficher uniquement les parties de la carte qui sont pertinentes pour chaque utilisateur, par exemple les données pertinentes pour un responsable régional par rapport à un responsable national. (Un responsable national devrait être capable de voir les données pour tout le pays, tandis qu’un responsable régional devrait uniquement accéder aux données pour la région qu’il gère).

Lorsqu’il est connecté, le responsable national voit la visualisation suivante :

![Une carte pleine des États-Unis affichant les ventes totales par région.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/userfunctions1.png)

Lorsqu’il est connecté, le responsable de la région Ouest voit uniquement les ventes pour sa région :

![Une carte à code de couleur de l’Ouest des États-Unis, la Californie se distinguant par le volume de ventes le plus élevé.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/userfunctions2.png)

Pour créer une fonction utilisateur qui fonctionne comme dans cet exemple, procédez comme suit.

### Avant de commencer

Pour suivre les étapes de cet exemple, vous devez avoir accès à Tableau Server ou Tableau Cloud. Vous devez également être un administrateur de serveur ou de site.

### Étape 1 : Créer les utilisateurs et les groupes

1. Connectez-vous à Tableau Server ou Tableau Cloud.
2. Dans Tableau Server ou Tableau Cloud, ajoutez les utilisateurs suivants :
    
    - Sadie Pawthorne
    - Chuck Magee
    - Fred Suzuki
    - Roxanne Rodriguez
    
    Pour plus d’informations, consultez [Ajouter des utilisateurs à un site](http://onlinehelp.tableau.com/current/server/fr-fr/sites_addusers.htm) dans l’aide de Tableau Server.
3. Créez un nouveau groupe appel**é National Managers** (Responsables nationaux).
    
    Pour plus d’informations, consultez [Créer un groupe local](http://onlinehelp.tableau.com/current/server/fr-fr/groups_create_local.htm) dans l’aide de Tableau Server.
4. Ajoutez-vous au groupe Responsables nationaux.
    
    Pour plus d’informations, consultez [Ajouter des utilisateurs à un groupe](http://onlinehelp.tableau.com/current/server/fr-fr/users_add_group.htm) dans l’aide de Tableau Server.

### Étape 2 : Créer la visualisation

1. Ouvrez Tableau Desktop et connectez-vous à la source de données **Sample - Superstore** qui est fournie avec Tableau.
2. Dans l’angle inférieur gauche de l’espace de travail, cliquez sur l’onglet Source de données.
3. Dans la page Source de données, depuis le volet Connexions à gauche, faites glisser la feuille People sur l’espace de travail.
4. Cliquez sur l’icône de liaison et sélectionnez Gauche.
    
    ![Créer une jointure gauche.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/user_functions1.gif)
5. Accédez à une nouvelle feuille de calcul.
6. Dans le volet **Données**, sous Dimensions, double-cliquez sur State (État).
    
    Une carte est créée.
7. Depuis le volet **Données**, sous Mesures, faites glisser Sales (Ventes) vers Couleur sur la fiche Repères.
8. Dans l’étagère Colonnes, sélectionnez le champ Longitude et maintenez enfoncée la touche Ctrl (Command sur Mac) sur votre clavier pour le copier. Faites glisser la copie à droite de l’original dans l’étagère Colonnes.
    
    ![Créer une carte à axe double dans Tableau.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/user_functions2.gif)
9. Sur la fiche Repères, cliquez sur le second onglet (en bas) **Longitude**.
10. Depuis le volet **Données**, faites glisser Region (Région) vers Couleur sur la fiche Repères.
    
    La carte à droite est mise à jour avec les nouvelles couleurs.
    
    ![Une carte avec application de la nouvelle palette de couleurs.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/user_functions3.png)
11. Sur la fiche Repères, cliquez sur le menu déroulant Type de repère et sélectionnez **Carte**.
    
    ![La fiche Repères avec Carte sélectionnée.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/user_functions4.png)
12. Sur la fiche Repères, cliquez sur **Couleur**, et, sous Opacité, ajustez le curseur sur 50%.
13. Sur la fiche Repères, cliquez sur le premier onglet **Longitude**.
14. Sur la fiche Repères, cliquez sur Couleur \> Modifier les couleurs, puis sélectionnez **Gris** dans la liste déroulante de la palette de couleurs.
    
    La carte à gauche se met à jour.
    
    ![Une carte avec application de la nouvelle palette de couleurs.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/user_functions5.png)
15. Dans l’étagère Colonnes, faites un clic droit sur le champ **Longitude** à droite et sélectionnez Axe double.
    
    ![Le menu Colonnes avec l’axe double sélectionné.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/user_functions7.png)

La carte se présente ainsi :

![Une carte avec application des nouvelles colonnes.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/user_functions6.png)

### Étape 3 : Créer le calcul utilisateur

1. Sélectionnez Analyse > Créer un champ calculé.
2. Dans l’éditeur de calcul qui s’ouvre, procédez comme suit :

- Nommez le champ calculé Filtre utilisateur.
- Entrez la formule suivante :
    
    `[Regional Manager] = USERNAME() OR ISMEMBEROF("National Managers")`
    
    Ce calcul vérifie si une personne est incluse dans le champ Region (People), ou si elle fait partie du groupe National Managers. Si tel est le cas, la valeur True est renvoyée.
- Lorsque vous avez terminé, cliquez sur OK.

Le nouveau calcul utilisateur apparaît sous Dimensions, dans le volet Données. Comme vos autres champs, vous pouvez l’utiliser dans une ou plusieurs visualisations.

### Étape 4 : Ajouter le calcul utilisateur à l’étagère Filtres

1. Depuis le volet Données, sous Dimensions, faites glisser Filtre utilisateur vers l’étagère Filtres.
2. Dans la boîte de dialogue du filtre qui s’ouvre, sélectionnez True, puis cliquez sur OK.
    
    **Remarque** : si vous n’êtes pas connecté à Tableau Server ou Tableau Cloud, l’option True n’est pas visible. Dans Tableau Desktop, connectez-vous à Tableau Server ou Tableau Cloud pour la sélectionner. Consultez [Se connecter à Tableau Server ou Tableau Cloud depuis Tableau Desktop](https://help.tableau.com/v0.0/pro/desktop/fr-fr/sign_in_server.htm) pour plus d’informations.

### Étape 5 : Tester le calcul

1. Dans Tableau Desktop, en bas à droite de l’espace de travail, cliquez sur la liste déroulante Appliquer un filtre utilisateur et modifiez l’utilisateur sur Sadie Pawthorne .
    
    La carte se met à jour de manière à afficher uniquement la région Ouest des États-Unis puisque Sadie est affectée à la région Ouest dans la feuille People.
2. Sélectionnez à nouveau la liste déroulante Appliquer un filtre utilisateur et changez l’utilisateur sur Roxanne Rodriguez.
    
    La carte se met à jour de manière à afficher uniquement la région Centre des États-Unis puisque Roxanne est affectée à la région Centre dans la feuille People.
3. Sélectionnez à nouveau la liste déroulante Appliquer un filtre utilisateur et changez l’utilisateur sur Chuck Magee.
    
    La carte se met à jour de manière à afficher uniquement la région Est des États-Unis puisque Chuck est affecté à la région Est dans la feuille People.
4. Sélectionnez la liste déroulante Appliquer un filtre utilisateur et changez l’utilisateur sur Fred Suzuki.
    
    La carte se met à jour de manière à afficher uniquement la région Sud des États-Unis puisque Fred est affectée à la région Sud dans la feuille People.
5. Sélectionnez une nouvelle fois la liste déroulante Appliquer un filtre utilisateur et changez l’utilisateur sur vous-même.
    
    La carte se met à jour de manière à afficher toutes les données puisque vous faites partie du groupe National Managers sur le serveur.

Ce comportement persiste lorsque vous publiez la vue sur Tableau Server ou Tableau Cloud. Les utilisateurs n’appartenant pas au groupe National Managers ou à la feuille People dans la source de données Sample Superstore ne verront qu’une visualisation vide.

## Consultez également

[Fonctions dans Tableau](https://help.tableau.com/v0.0/pro/desktop/fr-fr/functions.htm)

[Fonctions de Tableau (par catégorie)](https://help.tableau.com/v0.0/pro/desktop/fr-fr/functions_all_categories.htm)

[Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/v0.0/pro/desktop/fr-fr/functions_all_alphabetical.htm)