--- schema_version: "1" id: 9ea8387ca1e1848ed9d0bdffe8b652a870df03f4ef144e852e4808b41a949db5 title: Fonctions de calcul de table collection: tableau version: current locale: fr-fr portal_url: https://docs.salesforce.com/tableau/current/fr-fr/pro/desktop/functions_functions_tablecalculation.md canonical_url: https://help.tableau.com/current/pro/desktop/fr-fr/functions_functions_tablecalculation.htm source_site: help.tableau.com content_type: documentation content_hash: 131d32b01fc85eed1981c7f2fbf01377e1307c4c8dfd317b361f5f652f68c19d description: Reference for table calculation functions such as INDEX, LOOKUP, and FIRST. --- [Passer au contenu principal](#main-content) # Fonctions de calcul de table Cet article présente les fonctions de calcul de table et leurs utilisations dans Tableau. Il explique également comment créer un calcul de table à l’aide de l’éditeur de calcul. ## Pourquoi utiliser des fonctions de calcul de table Les fonctions de calcul de table vous permettent d’effectuer des calculs sur les valeurs d’une table. Par exemple, vous pouvez calculer le pourcentage du total que représente une vente individuelle pour l’année, ou pour plusieurs années. ## Fonctions de calcul de table disponibles dans Tableau Il s’agit des fonctions de calcul de table natives qui peuvent être utilisées dans Tableau sans extension analytique externe. ### FIRST( ) * * * Renvoie le nombre de lignes entre la ligne actuelle et la première ligne de la partition. Par exemple, la vue ci-dessous présente les ventes trimestrielles. Lorsque la fonction FIRST() est calculée dans la partition des dates, le décalage de la première ligne par rapport à la seconde ligne est de -1. ![Calcul de table FIRST.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_first.png) #### Exemple Lorsque l’index de la ligne actuelle est de 3, `FIRST() = -2`. ### INDEX( ) * * * Renvoie l’index de la ligne actuelle dans la partition, sans tri concernant la valeur. L’index de la première ligne commence à 1. Par exemple, la table ci-dessous présente les ventes trimestrielles. Lorsque la fonction INDEX() est calculée dans la partition des dates, l’index de chaque ligne est 1, 2, 3, 4, etc. ![Calcul de table INDEX.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_index.png) #### Exemple Pour la troisième ligne de la partition, `INDEX() = 3`. ### LAST( ) * * * Renvoie le nombre de lignes entre la ligne actuelle et la dernière ligne de la partition. Par exemple, la table ci-dessous présente les ventes trimestrielles. Lorsque la fonction LAST() est calculée dans la partition des dates, le décalage de la dernière ligne par rapport à la seconde ligne est de 5. ![Calcul de table LAST.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_last.png) #### Exemple Lorsque l’index de la ligne actuelle est de 3 sur 7, `LAST() = 4`. ### LOOKUP(expression, \[offset\]) * * * Renvoie la valeur de l’expression dans une ligne cible, indiquée sous la forme d’un décalage relatif par rapport à la ligne actuelle. Utilisez FIRST() + n et LAST() - n dans votre définition de décalage pour une cible relative aux première/dernière lignes de la partition. Si la valeur `offset` est ignorée, la ligne à comparer peut être définie dans le menu du champ. Cette fonction renvoie NULL si la ligne cible ne peut pas être déterminée. La vue ci-dessous présente les ventes trimestrielles. Lorsque la fonction `LOOKUP (SUM(Sales), 2)`est calculée dans la partition des dates, chaque ligne affiche la valeur des ventes à partir de 2 trimestres dans le futur. ![Calcul de table LOOKUP.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_lookup.png) #### Exemple `LOOKUP(SUM([Profit]), FIRST()+2)` calcule la valeur SUM(\[Profit\]) dans la troisième ligne de la partition. ### Fonctions MODEL\_EXTENSION Les fonctions d’extension de modèle : - MODEL\_EXTENSION\_BOOL - MODEL\_EXTENSION\_INT - MODEL\_EXTENSION\_REAL - MODEL\_EXTENSION\_STRING sont utilisées pour transmettre des données à un modèle déployé sur un service externe tel que R, TabPy ou Matlab. Voir [Extensions analytiques](https://help.tableau.com/current/pro/desktop/fr-fr/r_connection_manage.htm). ### MODEL\_PERCENTILE(target\_expression, predictor\_expression(s)) * * * Renvoie la probabilité (comprise entre 0 et 1) que la valeur attendue soit inférieure ou égale au repère observé, définie par l’expression cible et d’autres prédicteurs. Il s’agit de la fonction de distribution prédictive postérieure, également appelée fonction de distribution cumulative (CDF). Cette fonction est l’inverse de MODEL\_QUANTILE. Pour plus d’informations sur les fonctions de modélisation prédictive, voir [Description des fonctions de modélisation prédictive dans Tableau](https://help.tableau.com/current/pro/desktop/fr-fr/predictions_overview.htm). #### Exemple La formule suivante renvoie le quantile du repère pour la somme des ventes, ajustée en fonction du nombre de commandes. `MODEL_PERCENTILE(SUM([Sales]), COUNT([Orders]))` ### MODEL\_QUANTILE(quantile, target\_expression, predictor\_expression(s)) * * * Renvoie une valeur numérique cible dans la plage probable définie par l’expression cible et d’autres prédicteurs, au quantile spécifié. Il s’agit du quantile prédictif postérieur. Cette fonction est l’inverse de MODEL\_PERCENTILE. Pour plus d’informations sur les fonctions de modélisation prédictive, voir [Description des fonctions de modélisation prédictive dans Tableau](https://help.tableau.com/current/pro/desktop/fr-fr/predictions_overview.htm). #### Exemple La formule suivante renvoie la somme médiane (0.5) des ventes prévues, ajustée en fonction du nombre des commandes. `MODEL_QUANTILE(0.5, SUM([Sales]), COUNT([Orders]))` ### PREVIOUS\_VALUE(expression) * * * Renvoie la valeur de ce calcul dans la ligne précédente. Renvoie l’expression donnée si la ligne actuelle correspond à la première ligne de la partition. #### Exemple `SUM([Profit]) * PREVIOUS_VALUE(1)` calcule le produit cumulé de SUM(Profit). ### RANK(expression, \['asc' | 'desc'\]) * * * Renvoie le rang concurrentiel standard de la ligne actuelle de la partition. Un classement identique est attribué à des valeurs identiques. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre décroissant est utilisé par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) devrait être classée (4, 2, 2, 1). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). #### Exemple L’image suivante montre l’effet des différentes fonctions de classement (RANK, RANK\_DENSE, RANK\_MODIFIED, RANK\_PERCENTILE et RANK\_UNIQUE) sur un ensemble de valeurs. L’ensemble de données contient des informations sur 14 étudiants (de Étudiant A à Étudiant N). La colonne Âge affiche l’âge actuel de chaque étudiant (tous les étudiants ont entre 17 et 20 ans). Les colonnes restantes montrent l’effet de chaque fonction de classement sur l’ensemble des valeurs d’âge, en prenant toujours pour hypothèse l’ordre par défaut (croissant ou décroissant) pour la fonction. ![Une table comparant le classement des âges des étudiants en utilisant différentes méthodes de classement.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/rank_compare.png) ### RANK\_DENSE(expression, \['asc' | 'desc'\]) * * * Renvoie le rang dense de la ligne actuelle de la partition. Un classement identique est attribué aux valeurs identiques. La séquence de chiffres demeure toutefois linéaire. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre décroissant est utilisé par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) devrait être classée (3, 2, 2, 1). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). ### RANK\_MODIFIED(expression, \['asc' | 'desc'\]) * * * Renvoie le rang concurrentiel modifié de la ligne actuelle de la partition. Un classement identique est attribué à des valeurs identiques. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre décroissant est utilisé par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) serait organisé de la façon suivante (4, 3, 3, 1). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). ### RANK\_PERCENTILE(expression, \['asc' | 'desc'\]) * * * Renvoie le rang centile de la ligne actuelle de la partition. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre croissant est défini par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) serait organisé de la façon suivante (0.00, 0.67, 0.67, 1.00). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). ### RANK\_UNIQUE(expression, \['asc' | 'desc'\]) * * * Renvoie le rang unique de la ligne actuelle de la partition. Des classements différents sont attribués aux valeurs identiques. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre décroissant est utilisé par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) serait organisé de la façon suivante (4, 2, 3, 1). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). ### RUNNING\_AVG(expression) * * * Renvoie la moyenne cumulée d’une expression donnée, de la première ligne de la partition à la ligne actuelle. La vue ci-dessous présente les ventes trimestrielles. Lorsque la fonction `RUNNING_AVG(SUM([Sales])` est calculée dans la partition des dates, le résultat obtenu correspond à une moyenne cumulée des valeurs de ventes pour chaque trimestre. ![Calcul de table avec une moyenne mobile.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_runningavg.png) #### Exemple `RUNNING_AVG(SUM([Profit]))` calcule la moyenne cumulée de SUM(Profit). ### RUNNING\_COUNT(expression) * * * Renvoie le cumul d’une expression donnée, de la première ligne de la partition à la ligne actuelle. #### Exemple `RUNNING_COUNT(SUM([Profit]))` calcule le compte cumulée de SUM(Profit). ### RUNNING\_MAX(expression) * * * Renvoie le maximum cumulé d’une expression donnée, de la première ligne de la partition à la ligne actuelle. ![Calcul de table avec un maximum mobile.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_runningmax.png) #### Exemple `RUNNING_MAX(SUM([Profit]))` calcule le cumul de SUM(Profit). ### RUNNING\_MIN(expression) * * * Renvoie le minimum cumulé d’une expression donnée, de la première ligne de la partition à la ligne actuelle. ![Calcul de table avec un minimum mobile.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_runningmin.png) #### Exemple `RUNNING_MIN(SUM([Profit]))` calcule le minimum cumulé de SUM(Profit). ### RUNNING\_SUM(expression) * * * Renvoie la somme cumulée d’une expression donnée, de la première ligne de la partition à la ligne actuelle. ![Calcul de table avec une somme mobile.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_runningsum.png) #### Exemple `RUNNING_SUM(SUM([Profit]))` calcule la somme cumulée de SUM(Profit) ### SIZE() * * * Renvoie le nombre de lignes contenues dans la partition. Par exemple, la vue ci-dessous présente les ventes trimestrielles. La partition des dates contient sept lignes ; la fonction Size() de la partition des dates est donc égale à 7. ![Calcul de table SIZE](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_size.png) #### Exemple `SIZE() = 5` lorsque la partition actuelle contient cinq lignes. ### Fonctions SCRIPT\_ Les fonctions script : - SCRIPT\_BOOL - SCRIPT\_INT - SCRIPT\_REAL - SCRIPT\_STRING sont utilisés pour transmettre des données à un service externe tel que R, TabPy ou Matlab. Voir [Extensions analytiques](https://help.tableau.com/current/pro/desktop/fr-fr/r_connection_manage.htm). ### TOTAL(expression) * * * Renvoie le total de l’expression donnée dans la partition de calcul de table. #### Exemple Supposons que vous démarriez avec cette vue : ![Calcul de table TOTAL.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total.png) Vous ouvrez l’éditeur de calcul et créez un nouveau champ que vous nommez Totality : ![Calcul de table Somme totale des ventes.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total2.png) Vous déposez ensuite Totality sur Texte, pour remplacer SUM(Sales). Votre vue change de sorte à totaliser les valeurs basées sur la valeur Calculer au moyen de par défaut : ![Calcul de table ajouté à une visualisation.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total3.png) Ceci soulève la question : quelle est la valeur par défaut de Calculer au moyen de ? Si vous faites un clic droit (Contrôle + clic sur un Mac) sur Totality dans le volet Données et que vous choisissez Modifier, quelques informations supplémentaires sont disponibles : ![Calcul de table Somme totale des ventes.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total4.png) La valeur par défaut pour Calculer au moyen de est Table (horizontale). Le résultat est que Totality totalise les valeurs pour chaque ligne de votre table. Ainsi, la valeur que vous voyez pour chaque ligne est la somme de toutes les valeurs provenant de la version d’origine de la table. Les valeurs dans la ligne 2011/Q1 dans la table d’origine étaient $8601, $6579, $44262 et $15006. Les valeurs dans la table après que Totality a remplacé SUM(Sales) sont toutes $74,448, ce qui correspond à la somme des quatre valeurs d’origine. Notez le triangle en regard de Totality après que vous le déposez sur Texte : ![Calcul de table ajouté à une visualisation et affiché sur la fiche Repères.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total5.png) Il indique que le champ utilise un calcul de table. Vous pouvez faire un clic droit sur le champ et choisir Modifier le calcul de table pour rediriger votre fonction vers une valeur Calculer au moyen de différente. Par exemple, vous pouvez la définir sur Table (horizontale). Dans ce cas, votre table se présenterait ainsi : ![Calcul de table ajouté à une visualisation et affiché sur la fiche Repères.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total6.png) ### TOTAL(expression) * * * Renvoie le total de l’expression donnée dans la partition de calcul de table. #### Exemple Supposons que vous démarriez avec cette vue : ![Calcul de table TOTAL.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total.png) Vous ouvrez l’éditeur de calcul et créez un nouveau champ que vous nommez Totality : ![Calcul de table Somme totale des ventes.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total2.png) Vous déposez ensuite Totality sur Texte, pour remplacer SUM(Sales). Votre vue change de sorte à totaliser les valeurs basées sur la valeur Calculer au moyen de par défaut : ![Calcul de table ajouté à une visualisation.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total3.png) Ceci soulève la question : quelle est la valeur par défaut de Calculer au moyen de ? Si vous faites un clic droit (Contrôle + clic sur un Mac) sur Totality dans le volet Données et que vous choisissez Modifier, quelques informations supplémentaires sont disponibles : ![Calcul de table Somme totale des ventes.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total4.png) La valeur par défaut pour Calculer au moyen de est Table (horizontale). Le résultat est que Totality totalise les valeurs pour chaque ligne de votre table. Ainsi, la valeur que vous voyez pour chaque ligne est la somme de toutes les valeurs provenant de la version d’origine de la table. Les valeurs dans la ligne 2011/Q1 dans la table d’origine étaient $8601, $6579, $44262 et $15006. Les valeurs dans la table après que Totality a remplacé SUM(Sales) sont toutes $74,448, ce qui correspond à la somme des quatre valeurs d’origine. Notez le triangle en regard de Totality après que vous le déposez sur Texte : ![Calcul de table ajouté à une visualisation et affiché sur la fiche Repères.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total5.png) Il indique que le champ utilise un calcul de table. Vous pouvez faire un clic droit sur le champ et choisir Modifier le calcul de table pour rediriger votre fonction vers une valeur Calculer au moyen de différente. Par exemple, vous pouvez la définir sur Table (horizontale). Dans ce cas, votre table se présenterait ainsi : ![Calcul de table ajouté à une visualisation et affiché sur la fiche Repères.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_total6.png) ### WINDOW\_AVG(expression, \[start, end\]) * * * Renvoie la moyenne de l’expression dans la fenêtre. La fenêtre est définie comme valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Il existe une fonction d’agrégation équivalente : AVG. Consultez [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-fr/functions_all_alphabetical.htm). #### Exemple La formule suivante retourne la moyenne de la fenêtre **SUM(Profit)** des deux lignes précédentes jusqu’à la ligne actuelle. `WINDOW_AVG(SUM[Profit]), -2, 0)` ### WINDOW\_CORR(expression1, expression2, \[start, end\]) * * * Renvoie le coefficient de corrélation Pearson de deux expressions dans la fenêtre. La fenêtre est définie comme valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. La corrélation Pearson mesure la relation linéaire entre les deux variables. Les résultats vont de -1 à +1 inclus, où 1 dénote une relation linéaire positive exacte, comme lorsqu’un changement positif dans une variable implique un changement positif de magnitude correspondante dans l’autre, 0 ne dénote aucune relation linéaire entre la variance, et -1 est une relation négative exacte. Il existe une fonction d’agrégation équivalente : CORR. Consultez [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-fr/functions_all_alphabetical.htm). #### Exemple La formule suivante renvoie la corrélation Pearson de SUM(Profit) et SUM(Sales) depuis les cinq lignes précédentes jusqu’à la ligne actuelle. `WINDOW_CORR(SUM[Profit]), SUM([Sales]), -5, 0)` ### WINDOW\_COUNT(expression, \[start, end\]) * * * Renvoie le total de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_COUNT(SUM([Profit]), FIRST()+1, 0)` calcule le cumul de SUM(Profit) de la deuxième ligne à la ligne actuelle ### WINDOW\_COVAR(expression1, expression2, \[start, end\]) * * * Renvoie la _covariance d’échantillon_ de deux expressions dans la fenêtre. La fenêtre est définie comme valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si les arguments de début et la fin sont ignorés, la fenêtre est la totalité de la partition. La covariance d’échantillon utilise le nombre de points de données non null n - 1 pour normaliser le calcul de la covariance, plutôt que n, qui est utilisé par la covariance de population (disponible avec la fonction WINDOW\_COVARP). La covariance d’échantillon est le choix approprié lorsque les données sont un échantillon aléatoire utilisé pour estimer la covariance pour une population plus importante. Il existe une fonction d’agrégation équivalente : COVAR. Consultez [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-fr/functions_all_alphabetical.htm). #### Exemple La formule suivante retourne la covariance d’échantillon de SUM(Profit) et SUM(Sales) des deux précédentes lignes jusqu’à la ligne actuelle. `WINDOW_COVAR(SUM([Profit]), SUM([Sales]), -2, 0)` ### WINDOW\_COVARP(expression1, expression2, \[start, end\]) * * * Renvoie la _covariance de population_ de deux expressions dans la fenêtre. La fenêtre est définie comme valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. La covariance de population est une covariance d’échantillon multipliée par (n-1)/n, où n est le nombre total de points de données non null. La covariance de population est le choix approprié dans les cas où des données sont disponibles pour tous les points d’intérêt par opposition aux cas où il n’existe qu’un sous-ensemble aléatoire d’éléments, dans quel cas la covariance d’échantillon (avec la fonction WINDOW\_COVAR) est appropriée. Il existe une fonction d’agrégation équivalente : COVARP. [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-fr/functions_all_alphabetical.htm). #### Exemple La formule suivante retourne la covariance de population de SUM(Profit) et SUM(Sales) des deux précédentes lignes jusqu’à la ligne actuelle. `WINDOW_COVARP(SUM([Profit]), SUM([Sales]), -2, 0)` ### WINDOW\_MEDIAN(expression, \[start, end\]) * * * Renvoie la valeur médiane de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Par exemple, la vue ci-dessous représente les profits trimestriels. Une valeur médiane pour la fenêtre dans la partition de dates renvoie la valeur médiane de profit pour toutes les dates. ![Calcul de table avec un opérateur Médiane pour la fenêtre.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_windowmedian.png) #### Exemple `WINDOW_MEDIAN(SUM([Profit]), FIRST()+1, 0)` calcule la valeur médiane de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_MAX(expression, \[start, end\]) * * * Renvoie le maximum de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Par exemple, la vue ci-dessous présente les ventes trimestrielles. Un maximum de la fenêtre dans la partition des dates renvoie les ventes maximum pour toutes les dates. ![Calcul de table avec un opérateur Maximum pour la fenêtre.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_windowmax.png) #### Exemple `WINDOW_MAX(SUM([Profit]), FIRST()+1, 0)` calcule le maximum de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_MIN(expression, \[start, end\]) * * * Renvoie le minimum de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Par exemple, la vue ci-dessous présente les ventes trimestrielles. Un minimum de la fenêtre dans la partition des dates renvoie les ventes minimum pour toutes les dates. ![Calcul de table avec un opérateur Minimum pour la fenêtre.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_windowmin.png) #### Exemple `WINDOW_MIN(SUM([Profit]), FIRST()+1, 0)` calcule le minimum de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_PERCENTILE(expression, number, \[start, end\]) * * * Renvoie la valeur correspondant au centile spécifié dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_PERCENTILE(SUM([Profit]), 0.75, -2, 0)` renvoie le 75e centile pour SUM(Profit), en partant des deux lignes précédant la ligne actuelle jusqu’à cette dernière. ### WINDOW\_STDEV(expression, \[start, end\]) * * * Renvoie l’échantillon d’écart-type de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_STDEV(SUM([Profit]), FIRST()+1, 0)` calcule l’écart-type SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_STDEVP(expression, \[start, end\]) * * * Renvoie l’écart-type biaisé de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_STDEVP(SUM([Profit]), FIRST()+1, 0)` calcule l’écart-type SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_SUM(expression, \[start, end\]) * * * Renvoie la somme de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Par exemple, la vue ci-dessous présente les ventes trimestrielles. Une somme de la fenêtre calculée dans la partition des dates renvoie la somme des ventes pour tous les trimestres. ![Calcul de table avec un opérateur Somme pour la fenêtre.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_windowsum.png) #### Exemple `WINDOW_SUM(SUM([Profit]), FIRST()+1, 0)` calcule la somme de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_VAR(expression, \[start, end\]) * * * Renvoie l’échantillon de variance de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_VAR((SUM([Profit])), FIRST()+1, 0)` calcule la variance de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_VARP(expression, \[start, end\]) * * * Renvoie la variance biaisée de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_VARP(SUM([Profit]), FIRST()+1, 0)` calcule la variance de SUM(Profit) de la deuxième ligne à la ligne actuelle. ## Fonctions de calcul de table disponibles dans Tableau nécessitant une extension analytique Les extensions analytiques sont des connexions entre Tableau et un service externe tel que TabPy pour Python, Matlab et R. Pour utiliser les extensions analytiques dans votre analyse, vous devez d’abord [configurer une connexion](https://help.tableau.com/current/pro/desktop/fr-fr/r_connection_manage.htm) entre Tableau et un service externe tel qu’un serveur TabPy. Vous pouvez ensuite utiliser des scripts dans des calculs de table spécifiques (MODEL\_EXTENSION\_ pour utiliser des modèles publiés nommés ou SCRIPT\_ pour transmettre une expression au service externe). Les données de la visualisation (la « table » du calcul de table) sont transmises de manière sécurisée au serveur externe, le script est exécuté et les résultats sont renvoyés en tant que sortie du calcul. ## Fonctions d’extension de modèle À utiliser avec les modèles nommés déployés sur un service externe TabPy. ### MODEL\_EXTENSION\_BOOL (nom\_modèle, arguments, expression) * * * Renvoie le résultat booléen d’une expression tel que calculé par un modèle nommé déployé sur un service externe TabPy. Nom\_modèle est le nom du modèle d’analyse déployé que vous souhaitez utiliser. Chaque argument est une chaîne unique qui définit les valeurs d’entrée acceptées par le modèle déployé et est défini par le modèle d’analyse. Utilisez des expressions pour définir les valeurs qui sont envoyées depuis Tableau au modèle d’analyse. Assurez-vous d’utiliser les fonctions d’agrégation (SUM, AVG, etc.) pour agréger les résultats. Lors de l’utilisation de la fonction, les types de données et l’ordre des expressions doivent correspondre à ceux des arguments d’entrée. #### Exemple `MODEL_EXTENSION_BOOL ("isProfitable","inputSales", "inputCosts", SUM([Sales]), SUM([Costs]))` ### MODEL\_EXTENSION\_INT (nom\_modèle, arguments, expression) * * * Renvoie un résultat d’entier d’une expression tel que calculé par un modèle nommé déployé sur un service externe TabPy. Nom\_modèle est le nom du modèle d’analyse déployé que vous souhaitez utiliser. Chaque argument est une chaîne unique qui définit les valeurs d’entrée acceptées par le modèle déployé et est défini par le modèle d’analyse. Utilisez des expressions pour définir les valeurs qui sont envoyées depuis Tableau au modèle d’analyse. Assurez-vous d’utiliser les fonctions d’agrégation (SUM, AVG, etc.) pour agréger les résultats. Lors de l’utilisation de la fonction, les types de données et l’ordre des expressions doivent correspondre à ceux des arguments d’entrée. #### Exemple `MODEL_EXTENSION_INT ("getPopulation", "inputCity", "inputState", MAX([City]), MAX ([State]))` ### MODEL\_EXTENSION\_REAL (nom\_modèle, arguments, expression) * * * Renvoie un résultat réel d’une expression tel que calculé par un modèle nommé déployé sur un service externe TabPy. Nom\_modèle est le nom du modèle d’analyse déployé que vous souhaitez utiliser. Chaque argument est une chaîne unique qui définit les valeurs d’entrée acceptées par le modèle déployé et est défini par le modèle d’analyse. Utilisez des expressions pour définir les valeurs qui sont envoyées depuis Tableau au modèle d’analyse. Assurez-vous d’utiliser les fonctions d’agrégation (SUM, AVG, etc.) pour agréger les résultats. Lors de l’utilisation de la fonction, les types de données et l’ordre des expressions doivent correspondre à ceux des arguments d’entrée. #### Exemple `MODEL_EXTENSION_REAL ("profitRatio", "inputSales", "inputCosts", SUM([Sales]), SUM([Costs]))` ### MODEL\_EXTENSION\_STRING (nom\_modèle, arguments, expression) * * * Renvoie le résultat de chaîne d’une expression telle que calculée par un modèle nommé déployé sur un service externe TabPy. Nom\_modèle est le nom du modèle d’analyse déployé que vous souhaitez utiliser. Chaque argument est une chaîne unique qui définit les valeurs d’entrée acceptées par le modèle déployé et est défini par le modèle d’analyse. Utilisez des expressions pour définir les valeurs qui sont envoyées depuis Tableau au modèle d’analyse. Assurez-vous d’utiliser les fonctions d’agrégation (SUM, AVG, etc.) pour agréger les résultats. Lors de l’utilisation de la fonction, les types de données et l’ordre des expressions doivent correspondre à ceux des arguments d’entrée. #### Exemple `MODEL_EXTENSION_STR ("mostPopulatedCity", "inputCountry", "inputYear", MAX ([Country]), MAX([Year]))` ## Fonctions de script Au lieu d’utiliser un modèle externe défini comme les fonctions MODEL\_EXPRESSION, les fonctions SCRIPT sont utilisées pour spécifier l’expression directement dans le calcul de la table. **Remarque** : les appels sont censés retourner une seule colonne contenant le même nombre de lignes qu’il a été envoyé à la fonction. ### SCRIPT\_BOOL * * * Renvoie un résultat booléen à partir de l’expression spécifiée. L’expression est transmise directement à une instance d’extension analytique en cours d’exécution. Dans les expressions R, utilisez .arg_n_ (avec point initial) pour référencer les paramètres (.arg1, .arg2, etc.). Dans les expressions Python, utilisez \_arg_n_ (avec trait bas initial). #### Exemples Dans cet exemple R, .arg1 est égal à SUM(\[Profit\]): `SCRIPT_BOOL("is.finite(.arg1)", SUM([Profit]))` L’exemple suivant renvoie True pour les ID de magasin de l’État de Washington, et False dans les autres cas. Cet exemple pourrait être la définition d’un champ calculé nommé IsStoreInWA. `SCRIPT_BOOL('grepl(".*_WA", .arg1, perl=TRUE)',ATTR([Store ID]))` Une commande pour Python prendrait la forme suivante : `SCRIPT_BOOL("return map(lambda x : x > 0, _arg1)", SUM([Profit]))` ### SCRIPT\_INT * * * Renvoie un résultat entier à partir de l’expression spécifiée. L’expression est transmise directement à une instance d’extension analytique en cours d’exécution. Dans les expressions R, utilisez .arg_n_ (avec point initial) pour référencer les paramètres (.arg1, .arg2, etc.). Dans les expressions Python, utilisez \_arg_n_ (avec trait bas initial). #### Exemples Dans cet exemple R, .arg1 est égal à SUM(\[Profit\]): `SCRIPT_INT("is.finite(.arg1)", SUM([Profit]))` Dans l’exemple suivant, la méthode du clustering par les k-means est utilisée pour créer trois groupes : `SCRIPT_INT('result <- kmeans(data.frame(.arg1,.arg2,.arg3,.arg4), 3);result$cluster;', SUM([Petal length]), SUM([Petal width]),SUM([Sepal length]),SUM([Sepal width]))` Une commande pour Python prendrait la forme suivante : `SCRIPT_INT("return map(lambda x : int(x * 5), _arg1)", SUM([Profit]))` ### SCRIPT\_REAL * * * Renvoie un résultat réel partir de l’expression spécifiée. L’expression est transmise directement à une instance d’extension analytique en cours d’exécution. Dans Dans les expressions R, utilisez .arg_n_ (avec point initial) pour référencer les paramètres (.arg1, .arg2, etc.). Dans les expressions Python, utilisez \_arg_n_ (avec trait bas initial). #### Exemples Dans cet exemple R, .arg1 est égal à SUM(\[Profit\]): `SCRIPT_REAL("is.finite(.arg1)", SUM([Profit]))` L’exemple suivant convertit des valeurs de température exprimées en degrés Celsius en degrés Fahrenheit. `SCRIPT_REAL('library(udunits2);ud.convert(.arg1, "celsius", "degree_fahrenheit")',AVG([Temperature]))` Une commande pour Python prendrait la forme suivante : `SCRIPT_REAL("return map(lambda x : x * 0.5, _arg1)", SUM([Profit]))` ### SCRIPT\_STR * * * Renvoie un résultat de type chaîne à partir de l’expression spécifiée. L’expression est transmise directement à une instance d’extension analytique en cours d’exécution. Dans les expressions R, utilisez .arg_n_ (avec point initial) pour référencer les paramètres (.arg1, .arg2, etc.). Dans les expressions Python, utilisez \_arg_n_ (avec trait bas initial). #### Exemples Dans cet exemple R, .arg1 est égal à SUM(\[Profit\]): `SCRIPT_STR("is.finite(.arg1)", SUM([Profit]))` L’exemple suivant extrait une abréviation d’état à partir d’une chaîne plus complexe (sous la forme 13XSL\_CA, A13\_WA) : `SCRIPT_STR('gsub(".*_", "", .arg1)',ATTR([Store ID]))` Une commande pour Python prendrait la forme suivante : `SCRIPT_STR("return map(lambda x : x[:2], _arg1)", ATTR([Region]))` ## Créer un calcul de table à l’aide de l’éditeur de calcul Suivez les étapes ci-dessous pour savoir comment créer un calcul de table à l’aide de l’éditeur de calcul. **Remarque** : il existe plusieurs façons de créer des calculs de table dans Tableau. Cet exemple présente seulement l’une de ces façons. Pour plus d’informations, consultez [Transformer des valeurs avec des calculs de table](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations.htm). ### Étape 1 : Créer la visualisation 1. Dans Tableau Desktop, connectez-vous à la source de données **Sample - Superstore** enregistrée qui est fournie avec Tableau. 2. Accédez à une feuille de calcul. 3. Depuis le volet **Données**, sous Dimensions, faites glisser Order Date (Date de commande) vers l’étagère Colonnes. 4. Depuis le volet **Données**, sous Dimensions, faites glisser Sub-Category (Sous-catégorie) vers l’étagère Lignes. 5. Depuis le volet **Données**, sous Mesures, faites glisser Sales (Ventes) vers Texte sur la fiche Repères. Votre visualisation est mise à jour en un tableau texte. ![Une visualisation de table avec une table.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_functions1.png) ### Étape 2 : Créer le calcul de table 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é Running Sum of Profit (Somme cumulée de bénéfices). - Entrez la formule suivante : `RUNNING_SUM(SUM([Profit]))` Cette formule calcule la somme cumulée des bénéfices de vente. Elle est calculée sur l’intégralité de la table. - Lorsque vous avez terminé, cliquez sur OK. Le nouveau champ de calcul de table apparaît sous Mesures dans le volet Données. Comme vos autres champs, vous pouvez l’utiliser dans une ou plusieurs visualisations. ### Étape 3 : Utiliser le calcul de table dans la visualisation 1. Depuis le volet Données, sous Mesures, faites glisser Running Sum of Profit (Somme cumulée de bénéfices) vers Couleur sur la fiche Repères. 2. Sur la fiche Repères, cliquez sur la liste déroulante Type de repère, et sélectionnez Carré. La visualisation se met à jour de manière à surligner la table : ![Champ avec un calcul de table qui lui est appliqué sur la fiche Repères.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_functions2.png) ### Étape 4 : Modifier le calcul de table 1. Sur la fiche Repères, faites un clic droit sur Running Sum of Profit et sélectionnez Modifier le calcul de table. 2. Dans la boîte de dialogue Calcul de table qui s’ouvre, sous Calculer avec, sélectionnez Table (verticale). La visualisation est mise à jour comme suit : ![Champ avec un calcul de table qui lui est appliqué sur la fiche Repères.](/tableau/current/fr-fr/pro/desktop/fr-fr/Img/tablecalc_functions3.png) ## Consultez également [Créer un calcul de table](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations.htm#Create) [Types de calculs de table](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations_definebasic_runningtotal.htm) [Personnaliser les calculs de table](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations_custom.htm) [Calculs de table rapides](https://help.tableau.com/current/pro/desktop/fr-fr/calculations_tablecalculations_quick.htm) [Fonctions dans Tableau](https://help.tableau.com/current/pro/desktop/fr-fr/functions.htm) [Fonctions de Tableau (par catégorie)](https://help.tableau.com/current/pro/desktop/fr-fr/functions_all_categories.htm) [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-fr/functions_all_alphabetical.htm)