EXTRAIRE.DONNEES.PILOTE

From The Document Foundation Wiki
Jump to: navigation, search


La fonction EXTRAIRE.DONNEES.PILOTE renvoie une valeur de résultat d'une table de pilote. La valeur est adressée en utilisant des noms de champ et d'éléments, elle reste donc valide si la mise en page de la table du pilote est modifiée.

Syntaxe :

Deux syntaxes différentes peuvent être utilisées :
EXTRAIRE.DONNEES.PILOTE(champ_cible;table pilote;[champ_1;élément_1; ... ])
EXTRAIRE.DONNEES.PILOTE(table de pilote;contraintes)
La seconde syntaxe est utilisée si exactement deux paramètres sont donnés, dans lesquels le premier paramètre est une cellule ou une référence de plage de cellule. La première syntaxe est utilisée dans tous les autres cas. L'assistant de fonctions montre la première syntaxe.

Première syntaxe

Champcible est une chaîne qui sélectionne l'un des champs de données de la table du pilote. La chaîne peut être le nom de la colonne source, ou le nom de champ de données comme affiché dans la table (comme "Somme-Ventes").
table de pilote est une référence à une cellule ou plage de cellules qui est positionnée à l'intérieur d'une table de pilote ou contient une table de pilote. Si la plage de cellules contient plusieurs tables de pilote, la table qui a été créée en dernier est utilisée.
Si aucune paire Champ n/ Élément n n'est donnée, le grand total est renvoyé. Sinon, chaque paire ajoute la contrainte que le résultat doit être satisfait. Champ n est le nom d'un champ de la table de pivot. Élément n est le nom d'un élément de ce champ.
Si la table de pilote contient une valeur de résultat unique qui répond à toutes les contraintes, ou un résultat de sous-total qui résume toutes les valeurs correspondantes, ce résultat est renvoyé. S'il n'y a pas de résultat correspondant, ou plusieurs résultats sans sous-total pour eux, une erreur est renvoyée. Ces conditions s'appliquent aux résultats qui sont inclus dans la table de pilote.
Si la source de données contient des entrées qui sont cachées par des paramètres de la table de pilote, ils sont ignorés. L'ordre des paires Champ/Élément est significatif. Les noms du champ et de l'élément ne sont pas sensibles à la casse.
Si aucune contrainte pour un champ de page n'est donnée, la valeur de champ sélectionnée est implicitement utilisée. Si une contrainte est donnée pour un champ de page, il doit correspondre à la valeur de champ sélectionnée, sinon une erreur est renvoyée. Les champs de page sont les champs en haut à gauche d'une table de pilote, peuplés en utilisant la zone "Champs de page" de la boîte de dialogue de mise en page d'une table de pilote. Pour chaque champ de page, un élément (valeur) peut être sélectionné, ce qui signifie que seul cet élément est inclus dans le calcul.
Les valeurs de sous-total de la table de pilote sont utilisées uniquement si elles utilisent la fonction "auto" (excepté lorsque spécifié dans la contrainte, voir Syntaxe secondaire ci-dessous)."

Seconde syntaxe

table de pilote a la même signification que dans la première syntaxe.
contraintes est une liste séparée par des espaces. Les entrées peuvent contenir des guillemets (guillemets simples). Toute la chaîne doit être entre guillemets (guillemets doubles), à moins de référencer la chaîne à partir d'une autre cellule.
Une des entrées peut être le nom de champ de données. Le nom de champ de données peut être ignoré si la table du pilote contient un champ de données unique, sinon il doit être présent.
Chacune des autres entrées spécifie une contrainte de la forme Champ[Élément] si le nom de l'élément est unique à travers tous les champs qui sont utilisés dans la table de pilote.
Un nom de fonction peut être ajouté de la forme Champ[élément;fonction] qui provoquera la contrainte de faire correspondre seulement les valeurs de sous-total qui utilisent cette fonction. Les noms possibles de la fonction sont Somme, Nombre, Moyenne, Max, Min, Produit, Nombre (seulement), BDECARTYPE (échantillon), BDECARTYPEP (population), VAR (échantillon) et VARP (population), la casse n'est pas sensible.

Limitation

Utiliser le nom de champ de données comme affiché dans la table ("Somme-Montant" par exemple) rend le fonctionnement de la fonction dépendant de la langue de l'interface utilisateur. En anglais la table de pilote afficherait par exemple "Sum - Montant" ou "Average - Montant".

Exemples

FR.CALC ExtraireDonneesPilote.png

Voir également :

Fonctions classeur

Fonctions listées alphabétiquement, Fonctions listées par catégories