Fonctions dimensionnelles A-C D-G H-L M-Q R-Z Avancé Avancé Avancé Avancé Avancé _format ( expression ; mot clé_format  ) Associe un format à une expression. Le mot-clé_format peut être PERCENTAGE_0, PERCENTAGE_1 ou PERCENTAGE_2. PERCENTAGE_1 renvoie un pourcentage comportant un seul chiffre après la virgule, PERCENTAGE_2 renvoie un pourcentage comportant deux chiffres après la virgule et PERCENTAGE_3 renvoie un pourcentage comportant jusqu'à trois chiffres après la virgule (exemple : 0,965). Exemple : _format ( [Prix unitaire de vente] / [Prix unitaire] ; PERCENTAGE_2 ) Résultat : 75,12 % ancestor ( membre; niveau|entier ) Renvoie l'ancêtre d'un "membre" à un "niveau" donné ou à un nombre "entier" de niveaux au-dessus du "membre". Remarque : Nous ne pouvons pas garantir que les résultats seront cohérents s'il y a plusieurs ancêtres de cette nature. Exemple : ancestor ( [Citerne souple ChefDeCamp] ; 1 ) Résultat : Ustensiles de cuisine Exemple : ancestor ( [Citerne souple ChefDeCamp] ; 2 ) Résultat : Matériel de camping Exemple : ancestor ( [Citerne souple ChefDeCamp] ; [société_vacances_aventure].[Produits].[Produits].[Type de produit] ) Résultat : Ustensiles de cuisine caption ( niveau|membre|expression_ensemble ) Renvoie les légendes de "niveau", "membre" ou "expression_ensemble". La légende constitue le nom d'affichage de chaîne d'un élément, elle ne correspond pas forcément à l'identificateur unique utilisé pour générer la clé métier ou le nom unique de membre (MUN) de l'élément. La légende n'est pas nécessairement unique : la légende d'un mois peut par exemple renvoyer le nom du mois sans aucun détail relatif à l'année visant à rendre la valeur unique. Exemple : caption ( [Citerne souple ChefDeCamp] ) Résultat : Citerne souple ChefDeCamp Exemple : caption ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) Résultat : Renvoie les valeurs de légende de l'ensemble Ligne de produits. Matériel de camping Matériel de montagne Accessoires personnels Articles de protection Matériel de golf children ( membre ) Renvoie l'ensemble des enfants d'un membre donné. Exemple : children ( [Matériel de camping] ) Résultat : Renvoie l'ensemble des enfants pour Matériel de camping. Ustensiles de cuisine Tentes Sacs de couchage Sacs à dos et autres contenants Lampes closingPeriod ( niveau [ ; membre ] ) Renvoie le dernier membre de même niveau parmi les descendants d'un membre situé au "niveau" indiqué. Cette fonction est habituellement utilisée avec une dimension de temps. Exemple : closingPeriod ( [société_vacances_aventure].[Années].[Années].[Mois] ) Résultat : 2006/Déc. Exemple : closingPeriod ( [société_vacances_aventure].[Années].[Années].[Année] ) Résultat : 2006 Exemple : closingPeriod ( [société_vacances_aventure].[Années].[Années].[Mois] ; [2006 T4] ) Résultat : 2006/Déc. completeTuple ( membre { ; membre } ) Indique l'emplacement d'une cellule (intersection) en fonction des membres sélectionnés provenant tous de dimensions différentes. Toutefois, completeTuple () inclut, par défaut, le membre par défaut de toutes les dimensions non définies ailleurs dans les arguments, plutôt que le membre en cours. Si aucune mesure n'est définie pour la fonction CompleteTuple, celle-ci utilise la mesure par défaut et non la valeur currentMeasure. Cette fonction apparaît dans l'exemple de rapport Effectifs prévus, accessible dans le module d'analyse Entrepôt de données VA. Exemple : completeTuple ( [Matériel de montagne] ; [Télécopie] ) Résultat : Par défaut, la fonction completeTuple n'utilise pas la valeur currentMember, contrairement à la fonction tuple. Les valeurs contenues dans la première colonne sont identiques d'année en année, car le membre par défaut de la dimension Années, le membre racine, est utilisé à la place du membre en cours. De même, la première colonne affiche les Revenus plutôt que la Quantité vendue, car la mesure Revenus est définie par défaut dans la dimension Mesures. Si aucune mesure n'est définie pour la fonction CompleteTuple, celle-ci utilise la mesure par défaut et non la valeur currentMeasure. Qty Sold Mountaineering Sales by Fax -------- -------------- 2004 $1,220,329.38 2005 $1,220,329.38 2006 $1,220,329.38 Exemple : completeTuple ( [Matériel de montagne] ; [Télécopie] ; [Quantité vendue] ; currentMember ( [société_vacances_aventure].[Années].[Années] ) ) Résultat : La fonction completeTuple utilise la valeur currentMember de la dimension Années et la mesure Quantité vendue. Qty Sold Mountaineering Sales by Fax ----------- ------------------------------------------ 2004 0 2005 8,746 2006 7,860 unique ( expression_ensemble ) Supprime tous les doublons de "expression_ensemble". Les membres restants conservent leur ordre d'origine. openingPeriod ( niveau [ ; membre ] ) Renvoie le premier membre de même niveau parmi les descendants d'un membre situé au "niveau" indiqué. Cette fonction est habituellement utilisée avec une dimension de temps. Exemple : openingPeriod ( [société_vacances_aventure].[Années].[Années].[Mois] ) Résultat : 2004/Janv. Exemple : openingPeriod ( [société_vacances_aventure].[Années].[Années].[Année] ) Résultat : 2004 Exemple : openingPeriod ( [société_vacances_aventure].[Années].[Années].[Mois] ; [2006 T4] ) Résultat : 2006/Oct. parallelPeriod ( niveau [ ; expression_entier [ ; membre ] ] ) Renvoie le membre appartenant à une période précédente dont la position relative est la même que celle du "membre". Cette fonction est semblable à la fonction "cousin", mais elle est plus appropriée lorsqu'il s'agit de séries temporelles. Prend l'ancêtre de "membre" au niveau "niveau" (ancêtre) et l'élément de même niveau que "ancêtre" qui est décalé de "expression_entier" positions et renvoie la période parallèle de "membre" parmi les descendants de cet élément de même niveau. Si l'élément "expression_entier" n'est pas défini, ce dernier prend la valeur 1 par défaut et l'élément "membre" utilise le membre en cours par défaut. Exemple : parallelPeriod ( [société_vacances_aventure].[Années].[Années].[Trimestre] ; -1 ; [2006/Août] ) Résultat : 2006/Nov. Exemple : parallelPeriod ( [société_vacances_aventure].[Années].[Années].[Trimestre] ; 1 ; [2006/Août] ) Résultat : 2006/Mai Exemple : parallelPeriod ( [société_vacances_aventure].[Années].[Années].[Année] ; 1 ; [2006/Août] ) Résultat : 2004/Août cousin ( membre1 ; membre2 ) Renvoie l'enfant de "membre2" à la même position relative qu'occupe "membre1" par rapport à son parent. Cette fonction apparaît dans l'exemple de rapport Revenus par filiale VA 2005, accessible dans le module d'analyse Entrepôt de données VA. Exemple : cousin ( [Fers] ; [Matériel de camping] ) Résultat : Ustensiles de cuisine Exemple : cousin ( [Fers droits] ; [Matériel de camping] ) Résultat : Sacs de couchage crossjoin ( expression_ensemble1 ; expression_ensemble2 ) Renvoie la jointure de "expression_ensemble1" et "expression_ensemble2". currentMember ( hiérarchie ) Renvoie le membre en cours de la hiérarchie pendant une itération. Si l'élément "hiérarchie" n'est pas présent dans le contexte dans lequel l'expression est évaluée, son membre par défaut est utilisé. Cette fonction apparaît dans l'exemple de rapport interactif Moyennes continues et mobiles. defaultMember ( hiérarchie ) Renvoie le membre par défaut de l'élément "hiérarchie". Exemple : defaultMember ( [société_vacances_aventure].[Produits].[Produits] ) Résultat : Produits Exemple : defaultMember ( [société_vacances_aventure].[Années].[Années] ) Résultat : Année Exemple : defaultMember ( hierarchy ( [société_vacances_aventure].[Mesures].[Quantité vendue] ) ) Résultat : Revenus emptySet ( hiérarchie ) Renvoie un ensemble de membres vide pour l'élément "hiérarchie". Cet élément est généralement utilisé en tant que paramètre fictif lors du développement ou de la conception de rapports dynamiques (avec le kit IBM® Cognos® Software Development Kit ou par le biais de la fonction de conception de rapports). En créant une donnée élémentaire contenant la fonction emptyset, il est possible de créer des expressions complexes que vous pourrez réviser par la suite en redéfinissant la donnée élémentaire emptyset. Exemple : except ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ; emptySet ( [société_vacances_aventure].[Produits].[Produits] ) ) Résultat : Renvoie l'ensemble Ligne de produits et un ensemble vide pour l'ensemble Produits. Matériel de camping Matériel de golf Matériel de montagne Articles de protection Accessoires personnels firstChild ( membre ) Renvoie le premier enfant d'un membre. Exemple : firstChild ( [Par ligne de produits] ) Résultat : Matériel de camping Exemple : firstChild ( [Matériel de camping] ) Résultat : Ustensiles de cuisine firstSibling ( membre ) Renvoie le premier enfant du parent d'un membre. Exemple : firstSibling ( [Articles de protection] ) Résultat : Matériel de camping Exemple : firstSibling ( [Matériel de camping] ) Résultat : Matériel de camping hierarchy ( niveau|membre|expression_ensemble ) Renvoie la hiérarchie contenant "niveau", "membre" ou "expression_ensemble". Exemple : hierarchy ( [Ustensiles de cuisine] ) Résultat : Renvoie tous les membres de la hiérarchie contenant des produits Ustensiles de cuisine. Produits Matériel de camping Ustensiles de cuisine Citerne souple ChefDeCamp Gamelle ChefDeCamp ... Montre ultime Le Montagnard Montre de luxe Le Montagnard Exemple : hierarchy ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) Résultat : Renvoie tous les membres de la hiérarchie contenant la Ligne de produits. Produits Matériel de camping Ustensiles de cuisine Citerne souple ChefDeCamp Gamelle ChefDeCamp ... Montre ultime Le Montagnard Montre de luxe Le Montagnard isEmpty ( expression_valeur ) Prend la valeur True si "expression_valeur" vaut Null, ou False dans le cas contraire. item ( expression_ensemble ; index ) Renvoie un membre à partir d'un emplacement "index" dans "expression_ensemble". L'index de l'ensemble commence à zéro. Exemple : item ( children ( [Matériel de camping] ) ; 2 ) Résultat : Sacs de couchage lag ( membre ; expression_index ) Renvoie le membre de même niveau qui se trouve au "expression_index" nombre de positions suivant un "membre" indiqué. Exemple : lag ( [Tentes] ; 1 ) Résultat : Ustensiles de cuisine Exemple : lag ( [Tentes] ; -2 ) Résultat : Sacs à dos et autres contenants lastChild ( membre ) Retourne le dernier enfant d'un membre donné. Exemple : lastChild ( Ustensiles de cuisine ) Résultat : Ustensiles ChefDeCamp Exemple : lastChild ( [Par ligne de produits] ) Résultat : Matériel de golf lastSibling ( membre ) Retourne le dernier enfant du parent d'un membre. Exemple : lastSibling ( [Matériel de camping] ) Résultat : Matériel de golf lead ( membre ; expression_index ) Renvoie le membre de même niveau qui se trouve au "expression_index" nombre de positions après un "membre" indiqué. Si la valeur de "expression_index" est négative, la fonction renvoie les membres de même niveau se trouvant "expression_index" positions avant le "membre". Exemple : lead ( [Articles de protection] ; 1 ) Résultat : Accessoires personnels Exemple : lead ( [Articles de protection] ; -2 ) Résultat : Matériel de golf level ( membre ) Renvoie le niveau d'un "membre". Exemple : level ( [Matériel de golf] ) Résultat : Renvoie les membres du niveau Matériel de golf. Matériel de camping Matériel de montagne Accessoires personnels Articles de protection Matériel de golf levels ( hiérarchie ; index ) Retourne le niveau de la "hiérarchie" dont la distance à la racine est indiquée par "index". Exemple : levels ( [société_vacances_aventure].[Produits].[Produits] ; 2 ) Résultat : Renvoie les membres situés à deux niveaux de la hiérarchie racine Produits. Ustensiles de cuisine Sacs de couchage Sacs à dos et autres contenants Tentes ... Fers Fers droits Bois Accessoires de golf Exemple : levels ( [société_vacances_aventure].[Produits].[Produits] ; 1 ) Résultat : Renvoie les membres situés à un niveau de la hiérarchie racine Produits. Matériel de camping Matériel de montagne Accessoires personnels Articles de protection Matériel de golf linkMember ( membre ; niveau|hiérarchie ) Retourne le membre correspondant dans le "niveau" ou la "hiérarchie" indiqués (de la même dimension). Pour les hiérarchies basées sur des niveaux, le second argument doit être un niveau, tandis que pour les hiérarchies parent-enfant, ce doit être une hiérarchie. Une exception se produit si le second paramètre ne renvoie pas une hiérarchie de la dimension à laquelle appartient le membre. Notez que les membres calculés ne sont pas pris en charge comme premier argument. member ( expression_valeur [ ; chaîne1 [ ; chaîne2 [ ; hiérarchie ] ] ] ) Définit un membre d'après la valeur de "expression_valeur" dans "hiérarchie". "Chaîne1" identifie le membre créé par cette fonction. Elle doit être unique dans la requête et différente des autres membres de la même hiérarchie. La mention "Chaîne2" est utilisée comme légende du membre ; si elle est absente, la légende est vide. Afin de garantir des résultats prévisibles, il est recommandé de définir le paramètre "hiérarchie". Remarque : Tous les calculs utilisés comme éléments de regroupement dont les éléments de même niveau sont d'autres calculs ou ensembles de membres devraient être assignés de façon explicite à une hiérarchie à l'aide de cette fonction. Dans le cas contraire, les résultats seront imprévisibles. La seule exception étant lorsque le calcul n'implique que des membres d'une même hiérarchie que celle des éléments de même niveau. Dans ce cas, le calcul est considéré comme appartenant à cette hiérarchie. Exemple : member ( total ( currentMeasure within set filter ( [société_vacances_aventure].[Produits].[Produits].[Nom de produit] ; caption ( [société_vacances_aventure].[Produits].[Produits].[Nom de produit] ) starts with 'B' ) ) ; 'BProducts' ; 'B Products' ; [société_vacances_aventure].[Produits].[Produits] ) Résultat : Renvoie la quantité vendue et les revenus pour tous les produits dont le nom commence par la lettre B. members ( hiérarchie|niveau ) Renvoie l'ensemble des membres contenus dans "hiérarchie" ou "niveau". Dans le cas d'une hiérarchie, l'ordre d'affichage des membres renvoyés n'est pas garanti. Si un ordre prévisible est requis, une fonction de classement explicite (telle que "hierarchize") doit être utilisée. Exemple : members ( [société_vacances_aventure].[Années].[Années] ) Résultat : Renvoie les membres contenus dans Années. Exemple : members ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) Résultat : Renvoie les membres de la dimension Ligne de produits. nestedSet ( expression_ensemble1 ; expression_ensemble2 ) Cette fonction est destinée uniquement à Analysis Studio Résultat : Renvoie les deux produits les plus vendus pour chaque ligne de produits, classés par revenus. nextMember ( membre ) Renvoie le prochain membre du niveau dans lequel le "membre" se trouve. Exemple : nextMember ( [Articles de protection] ) Résultat : Matériel de golf ordinal ( niveau ) Renvoie la valeur d'ordonnée basée sur zéro (distance à partir du niveau racine) du "niveau" indiqué. Exemple : ordinal ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) Résultat : 1 Exemple : ordinal ( [société_vacances_aventure].[Produits].[Produits].[Type de produit] ) Résultat : 2 parent ( membre|mesure ) Renvoie le membre qui est le parent de "membre" ou de "mesure". Exemple : parent ( [Ustensiles de cuisine] ) Résultat : Matériel de camping _addMemberToSet ( expression_membre ; expression_ensemble ; parent|null ; sibling|null ; position ) Attention : utilisation en interne uniquement ; ne pas ajouter cette fonction dans un rapport. Renvoie un ensemble. La fonction insère "expression_membre" dans "expression_ensemble" immédiatement BEFORE ou AFTER sibling. Notez que "expression_membre" et "expression_ensemble" doivent provenir des mêmes dimension et hiérarchie. "Parent" correspond au nom unique du parent du membre calculé (expression_membre ) ; ou NULL. "Sibling" correspond au nom unique du membre à partir duquel la position relative de "expression_membre" est calculée, ou NULL. "Position" a la valeur BEFORE ou AFTER. Si "position" n'est pas défini, la valeur par défaut est AFTER. prevMember ( membre ) Renvoie le membre qui précède immédiatement le "membre" indiqué sur le même niveau. Cette fonction apparaît dans l'exemple de rapport Croissance des ventes année après année, accessible dans le module d'analyse Entrepôt de données VA. Exemple : prevMember ( [Articles de protection] ) Résultat : Accessoires personnels Exemple : prevMember ( [2005] ) Résultat : 2004 roleValue ( chaîne [ ; membre|expression_ensemble ] ) Renvoie la valeur de l'attribut qui est associé au rôle dont le nom est indiqué par "chaîne " dans le contexte donné. L'argument "membre" ou "expression_ensemble" est facultatif seulement dans un nombre limité de circonstances, où il peut être dérivé à partir d'un autre contexte. Les applications peuvent être rendues portables pour différentes sources de données et différents modèles en accédant aux attributs par rôle, plutôt que par identificateur d'élément de requête. Les rôles prédéfinis des membres de tous les types de sources de données incluent : '_businessKey', '_memberCaption', '_memberDescription', '_memberUniqueName'. Pour les sources OLAP (Online Analytical Processing), seuls les rôles intrinsèques sont accessibles aux objets qui couvrent plusieurs niveaux. Pour les sources de données relationnelles modélisées de façon dimensionnelle (DMR), l'attribution des rôles incombe au modélisateur. D'autres rôles peuvent être définis dans Framework Manager pour chaque niveau d'une hiérarchie. Par exemple, un niveau Type de produit peut avoir une colonne d'attribut appelée "Conteneur d'expédition type", tandis que le niveau Produit peut posséder un attribut "Conteneur d'expédition de produit". Chacun de ces objets peut être affecté à un rôle personnalisé dans Framework Manager, appelé "Conteneur". La propriété peut alors être référencée indépendamment du nom de colonne réel, à l'aide de la fonction roleValue. Example: roleValue ( '_memberCaption' , [Sales].[Produit].[Produit].[Product line] -> [all].[1] ) Résultat : Matériel de camping Exemple : roleValue ( '_businessKey' ; [société_vacances_aventure].[Années].[Années].[Année] ) Résultat : Renvoie la valeur de l'attribut qui est associé au rôle métier clé. ("2004-01-01";"2004-12-31") ("2005-01-01";"2005-12-31") ("2006-01-01";"2006-12-31") Exemple : roleValue ( '_memberUniqueName' ; [société_vacances_aventure].[Années].[Années].[Année] ) Résultat : Renvoie la valeur de l'attribut qui est associé au rôle MUN. [société_vacances_aventure].[Années].[Années].[Années] ->:[PC].[[Années (Racine)].[20040101-20041231] [société_vacances_aventure].[Années].[Années].[Années] ->:[PC].[[Années (Racine)].[20050101-20051231] [société_vacances_aventure].[Années].[Années].[Années] ->:[PC].[[Années (Racine)].[20060101-20061231] rootMember ( hiérarchie ) Renvoie le membre racine d'une hiérarchie dotée d'une seule racine. Cette fonction apparaît dans l'exemple de rapport Succès des promotions, accessible dans le module d'analyse Entrepôt de données VA. rootMembers ( hiérarchie ) Retourne les membres racine d'une hiérarchie. Exemple : rootMembers ( [société_vacances_aventure].[Années].[Années] ) Résultat : Par date value ( nuplet ) Renvoie la valeur de la cellule identifiée par un "tuple". Notez que le membre par défaut de la dimension Mesures est la Mesure par défaut. Exemple : value ( tuple ( [société_vacances_aventure].[Années].[Années].[Années] ->:[PC].[Années (Racine)].[20040101-20041231] , [société_vacances_aventure].[Mesures].[Revenu] ) ) Résultat : 34 750 563,50 $ Exemple : value ( tuple ( [2004] ; [Matériel de camping] ; [Revenus] ) ) Résultat : 20 471 328,88 $ descendants ( membre|expression_ensemble ; niveau|distance [ ; { self|before|beforewithmember|after } ] ) Renvoie l'ensemble des descendants d'un "membre" ou d'une "expression_ensemble" à un "niveau" (nom qualifié) ou à une "distance" (nombre entier de 0 à n) de la racine. Plusieurs options peuvent être définies (séparées par un espace) afin de déterminer les membres à renvoyer. self : Seuls les membres du niveau indiqué sont inclus dans l'ensemble final (comportement par défaut en l'absence d'options). before : S'il existe des niveaux intermédiaires entre le niveau du membre et celui indiqué, les membres de ces niveaux sont inclus. Si le niveau indiqué est le même que celui du membre auquel la fonction est appliquée, le membre est inclus dans l'ensemble final. beforewithmember : S'il existe des niveaux intermédiaires entre le niveau du membre et celui indiqué, les membres de ces niveaux sont inclus. Le membre auquel la fonction est appliquée et également inclus dans l'ensemble final. after : S'il existe d'autres niveaux après le niveau indiqué, les membres de ces niveaux sont inclus dans l'ensemble final. Cette fonction apparaît dans l'exemple de rapport Commissions sur les ventes pour l'Europe centrale, accessible dans le module d'analyse Entrepôt de données VA. Exemple : descendants ( [société_vacances_aventure].[Produits].[Produits].[Produits] ; [société_vacances_aventure].[Produits].[Produits].[Type de produit] ) Résultat : Renvoie l'ensemble des descendants de l'ensemble Produits au niveau du Type de produit. Remarque : ([société_vacances_et_aventure].[Produits].[Produits].[Produits]) est le membre racine de la hiérarchie Produits. Ustensiles de cuisine Sacs de couchage Sacs à dos et autres contenants Tentes ... Lunettes Couteaux Montres Exemple : descendants ( [société_vacances_aventure].[Produits].[Produits].[Produits] ; 1 ) Résultat : Renvoie l'ensemble des descendants de l'ensemble Produits au premier niveau. Matériel de camping Matériel de golf Matériel de montagne Articles de protection Accessoires personnels Exemple : descendants ( [société_vacances_aventure].[Produits].[Produits].[Produits] ; 3 ; before ) Résultat : Renvoie les descendants de l'ensemble Produits avant le troisième niveau. Matériel de camping Ustensiles de cuisine Sacs de couchage Sacs à dos et autres contenants Tentes ... Lunettes Couteaux Montres Exemple : descendants ( [société_vacances_aventure].[Produits].[Produits].[Produits] ; 2 ; self before ) Résultat : Renvoie l'ensemble des descendants de l'ensemble Produits avant le deuxième niveau (inclus). Matériel de camping Ustensiles de cuisine Sacs de couchage Sacs à dos et autres contenants Tentes ... Lunettes Couteaux Montres except ( expression_ensemble1 ; expression_ensemble2 [ ; all ] ) Renvoie les membres de "expression_ensemble1" qui ne sont pas aussi inclus dans "expression_ensemble2". Les doubles sont conservés lorsque le mot clé facultatif "all" est utilisé comme troisième argument. Exemple : except ( set ( [Matériel de camping] ; [Matériel de montagne] ) ; set ( [Matériel de camping] ; [Matériel de golf] ) ) Résultat : Matériel de montagne filter ( expression_ensemble ; expression_booléenne ) Retourne un ensemble résultant du filtrage d'un ensemble indiqué en fonction d'une condition booléenne. Chaque membre est inclus dans le résultat si et seulement si la valeur correspondante de "Expression_booléenne" est Vraie. Exemple : filter ( [Ligne de produits] ; [Marge brute] > ,30 ) Résultat : Matériel de montagne intersect ( expression_ensemble1 ; expression_ensemble2 [ ; all ] ) Renvoie l'intersection de "expression_ensemble1" et "expression_ensemble2". Le résultat garde des doubles seulement lorsque le mot clé facultatif "all" est utilisé comme troisième argument. Exemple : intersect ( set ( [Matériel de camping] ; [Matériel de montagne] ) ; set ( [Matériel de camping] ; [Articles de protection] ; ) ; all ) Résultat : Matériel de camping lastPeriods ( expression_entier ; membre ) Renvoie l'ensemble des membres d'un même niveau qui finissent par le "membre" indiqué. Le nombre de membres retournés correspond à la valeur absolue de "expression_entier". Si "expression_entier" est négatif, les membres qui suivent et qui incluent le membre indiqué sont retournés. Cette fonction est habituellement utilisée avec une dimension de temps. Cette fonction apparaît dans l'exemple de rapport interactif Moyennes continues et mobiles. Exemple : lastPeriods ( 2 ; [2006 T 4] ) Résultat : Renvoie les deux derniers membres du niveau se terminant par 2006 T4. 2006 T 3 2006 T 4 Exemple : lastPeriods ( -3 ; [2006 T 4] ) Résultat : Renvoie les trois derniers membres du niveau commençant par 2006 T4. 2006 T 4 2007 T 1 2007 T 2 periodsToDate ( niveau ; membre ) Renvoie un ensemble de membres de même niveau qu'un "membre" donné, tel que déterminé par "niveau". Trouve l'ancêtre de "membre" au niveau "niveau" et renvoie les descendants de cet ancêtre qui se trouvent au même niveau que "membre" (jusqu'à et incluant "membre"). Cette fonction est habituellement utilisée avec une dimension de temps. Cette fonction apparaît dans l'exemple de rapport interactif Moyennes continues et mobiles. Exemple : periodsToDate ( [société_vacances_aventure].[Années].[Années].[Année] ; [2004/Mars] ) Résultat : Renvoie les valeurs correspondant à [2004/Janv.], [2004/Févr.], [2004/Mars] topCount ( expression_ensemble ; expression_index ; expression_numérique ) Trie un ensemble en fonction des valeurs de 'expression_numérique' évaluées pour chacun des membres de 'expression_ensemble' et renvoie les 'expression_index' premiers membres. Exemple : topCount ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ; 2 ; [Revenus] ) Résultat : Renvoie les deux revenus les plus importants pour l'ensemble Ligne de produits Prod line Revenue ----------- ---------- Camping $89,713,990.92 Personal $31,894,465.86 bottomCount ( expression_ensemble ; expression_index ; expression_numérique ) Trie un ensemble en fonction de la valeur de "expression_numérique" évaluée pour chacun des membres de "expression_ensemble" et renvoie les "expression_index" derniers membres. Exemple : bottomCount ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ; 2 ; [Revenus] ) Résultat : Renvoie les deux derniers membres de l'ensemble trié en fonction du revenu. Prod line Revenue ----------- ----------- Camping $3,171,114.92 Personal $20,891,350.60 topPercent ( expression_ensemble ; pourcentage ; expression_numérique2 ) Trie l'ensemble indiqué dans "expression_ensemble" par ordre décroissant et renvoie les éléments du niveau le plus haut à partir de l'ensemble trié dont le pourcentage cumulatif du total est supérieur ou égal à "pourcentage". Exemple : topPercent ( set ( [Matériel de camping] ; [Matériel de golf] ; [Matériel de montagne] ) ; 40 ; [2006] ) Résultat : pour l'ensemble regroupant Matériel de camping, Matériel de golf et Matériel de montagne, renvoie les membres dont le bénéfice brut total le plus élevé pour l'année 2006 est au moins égal à 40 % du total général. bottomPercent ( expression_ensemble ; pourcentage ; expression_numérique ) Trie l'ensemble indiqué dans "expression_ensemble" par ordre croissant et renvoie les éléments du niveau le plus bas à partir de l'ensemble trié dont le pourcentage cumulatif du total est supérieur ou égal à "pourcentage". Exemple : bottomPercent ( set ( [Matériel de camping] ; [Matériel de golf] ; [Matériel de montagne] ) ; 40 ; [2006] ) Résultat : pour l'ensemble regroupant Matériel de camping, Matériel de golf et Matériel de montagne, renvoie les membres dont le bénéfice brut total le moins élevé pour l'année 2006 est au moins égal à 40 % du total général. topSum ( expression_ensemble ; valeur ; expression_numérique2 ) Trie l'ensemble indiqué dans "expression_ensemble" par ordre décroissant et renvoie les éléments du niveau le plus haut à partir de l'ensemble trié dont le total cumulatif est supérieur ou égal à "valeur". Exemple : topSum ( children ( [Produits] ) ; 16000000 ; tuple ( [2006] ; [société_vacances_aventure].[Mesures].[Bénéfice brut] ) ) Résultat : Pour les membres de la ligne de produits, renvoie les membres ayant le bénéfice brut le plus élevé atteignant un total au moins égal à 6 000 000 $ pour l'année 2006. bottomSum ( expression_ensemble ; valeur ; expression_numérique ) Trie l'ensemble indiqué dans "expression_ensemble" par ordre croissant et renvoie les éléments du niveau le plus bas à partir de l'ensemble trié dont le total cumulatif est supérieur ou égal à "valeur". Exemple : bottomSum ( members ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) ; 6000000 ; tuple ( [2006] ; [société_vacances_aventure].[Mesures].[Bénéfice brut] ) ) Résultat : Pour les membres de la ligne de produits, renvoie les membres ayant le bénéfice brut le moins élevé atteignant un total au moins égal à 6 000 000 $ pour l'année 2006. union ( expression_ensemble1 ; expression_ensemble2 [ ; all ] ) Renvoie les données de "expression_ensemble1" et "expression_ensemble2". Le résultat garde des doubles seulement lorsque le mot clé facultatif "all" est utilisé comme troisième argument. Exemple : union ( set ( [Matériel de camping] ; [Matériel de golf] ) ; set ( [Matériel de golf] ; [Matériel de montagne] ) ) Résultat : Renvoie des données pour les deux ensemble en tant que nouvel ensemble, en n'affichant qu'une fois la colonne Matériel de golf. Exemple : union ( set ( [Matériel de camping] ; [Matériel de golf] ) ; set ( [Matériel de golf] ; [Matériel de montagne] ) ; all ) Résultat : Renvoie des données pour les deux ensemble en tant que nouvel ensemble, en affichant deux fois la colonne Matériel de golf. ancestors ( membre ; niveau|index ) Renvoie tous les ancêtres d'un "membre" à un "niveau" ou à une distance "index" au-dessus du membre. (La plupart des sources de données ne prennent en charge qu'un ancêtre à un niveau donné. Si la source de données prend en charge plusieurs ancêtres, le résultat est un ensemble de données). Exemple : ancestors ( [Citerne souple ChefDeCamp] ; 1 ) Résultat : Ustensiles de cuisine Exemple : ancestors ( [Citerne souple ChefDeCamp] ; 2 ) Résultat : Matériel de camping Exemple : ancestors ( [Citerne souple ChefDeCamp] ; [société_vacances_aventure].[Produits].[Produits].[Type de produit] ) Résultat : Ustensiles de cuisine generate ( expression_ensemble1 ; expression_ensemble2 [ ; all ] ) Evalue "expression_ensemble2" pour chaque membre de "expression_ensemble1" et effectue l'union des ensembles résultants. Le résultat garde des doubles seulement lorsque le mot clé facultatif "all" est utilisé comme troisième argument. Exemple : generate ( [Ligne de produits] ; topCount ( descendants ( currentMember ( [société_vacances_aventure].[Produits].[Produits] ) ;  [société_vacances_aventure].[Produits].[Produits].[Nom de produit] ) ; 2 ; [Revenus] ) ) Résultat : Renvoie les deux produits les plus vendus pour chaque ligne de produits, classés par revenus. head ( expression_ensemble [ ; expression_index ] ) Retourne les "expression_index" premiers éléments de "expression_ensemble". La valeur par défaut de "expression_index" est 1. Exemple : head ( members ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) ) Résultat : Matériel de camping Exemple : head ( members ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) ; 2 ) Résultat : Renvoie les deux membres les plus importants pour l'ensemble Ligne de produits Matériel de camping Matériel de montagne hierarchize ( expression_ensemble ) Classe les membres d'une "expression_ensemble" sous forme de hiérarchie. Les membres d'un niveau sont classés dans l'ordre naturel. Il s'agit du classement par défaut des membres le long d'une dimension si aucun autre critère de tri n'est indiqué. Exemple : hierarchize ( set ( [Matériel de golf] ; [Matériel de montagne] ; [Matériel de camping] ) ) Résultat : Renvoie les catégories Matériel de camping, Matériel de golf, Matériel de montagne. mtd ( [ membre ] ) Renvoie un ensemble de membres de même niveau qu'un "membre" donné, qui commence par le premier membre de même niveau et qui se termine par le "membre" en question, tel que déterminé par le niveau Mois de la dimension de temps. Si aucun membre n'est indiqué, la valeur par défaut est définie à 'currentMember' de la dimension de temps. order ( expression_ensemble ; expression_valeur [ ; ASC|DESC|BASC|BDESC ] ) Dispose les membres de "expression_ensemble" d'après "expression_valeur" et le troisième paramètre. ASC et DESC classent les membres par ordre croissant ou décroissant, respectivement d'après leur position dans la hiérarchie de l'ensemble. Puis les enfants de chaque membre sont classés en fonction de "expression_valeur". BASC et BDESC classent les membres d'un ensemble sans tenir compte de la hiérarchie. En l'absence d'une indication explicite, ASC devient la valeur par défaut. Exemple : order ( members ( [société_vacances_aventure].[Produits].[Produits].[Type de produit] ) ; [Quantité vendue] ; BASC ) Résultat : Renvoie la quantité vendue pour chaque type de produit sans respecter d'ordre particulier. ProdLine Quantity ------------ ------------- Woods 13,924 Irons 14,244 Safety 22,332 ... ... Sun 215,432 Repellent 270,04 Lanterns 345,096 Exemple : order ( members ( [société_vacances_aventure].[Produits].[Produits].[Type de produit] ) ; [Quantité vendue] ; ASC ) Résultat : Renvoie la quantité vendue pour chaque type de produit par ordre croissant. ProdLine Quantity ------------ ------------- Woods 13,924 Irons 14,244 Putters 23,244 ... ... Tents 130,664 Cooking 198,676 Lanterns 345,096 qtd ( [ membre] ) Renvoie un ensemble de membres de même niveau qu'un "membre" donné, qui commence par le premier membre de même niveau et qui se termine par le "membre" en question, tel que déterminé par le niveau Trimestre de la dimension de temps. Si aucun membre n'est indiqué, la valeur par défaut est définie à 'currentMember' de la dimension de temps. set ( membre { ; membre } ) Renvoie la liste des membres définis dans l'expression. Les membres doivent appartenir à la même hiérarchie. Exemple : set ( [Matériel de golf] ; [Fers] ; [Gobelet ChefDeCamp] ) Résultat : Renvoie Matériel de golf, Fers et Gobelet ChefDeCamp. siblings ( membre ) Retourne les enfants du parent du membre indiqué. Exemple : siblings ( [Matériel de golf] ) Résultat : Renvoie Matériel de golf de même niveau. Matériel de camping Matériel de golf Matériel de montagne Articles de protection Accessoires personnels subset ( expression_ensemble; expression_index1 [ ; expression_index2 ] ) Renvoie un sous-ensemble des membres de "expression_ensemble" en commençant à "expression_index1" à partir du début. Si le nombre "expression_index2" est indiqué, il s'agit du nombre de membres qui seront renvoyés (si disponible). Sinon, tous les membres restants sont renvoyés. Exemple : subset ( members ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) ; 2 ) Résultat : Renvoie les membres de l'ensemble de la Ligne de produits à partir du deuxième membre. Matériel de montagne Articles de protection Accessoires personnels  Exemple : subset ( members ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) ; 2 ; 2 ) Résultat : Renvoie deux membres de l'ensemble Ligne de produits en commençant par le deuxième membre Matériel de montagne Articles de protection  tail ( expression_ensemble [ ; expression_index ] ) Retourne les "expression_index" derniers éléments de "expression_ensemble". La valeur par défaut de "expression_index" est 1. Exemple : tail (members ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) ) Résultat : Renvoie le dernier membre de l'ensemble Lignes de produits. Accessoires personnels Exemple : tail ( members ( [société_vacances_aventure].[Produits].[Produits].[Ligne de produits] ) ; 2 ) Résultat : Renvoie les deux derniers membres de l'ensemble Ligne de produits. Articles de protection Accessoires personnels tuple ( membre { ; membre } ) Indique l'emplacement d'une cellule (intersection) en fonction des membres sélectionnés provenant tous de dimensions différentes. Cette fonction inclut implicitement le membre en cours de toutes les dimensions qui ne sont pas définies dans les arguments. Le membre en cours de toute dimension qui n'est pas définie dans le contexte d'évaluation est considéré comme étant le membre par défaut de cette dimension. La valeur de cette cellule peut être obtenue à l'aide de la fonction 'value'. Exemple : tuple ( [Matériel de montagne] ; [Télécopie] ) Résultat : Renvoie les ventes d'articles Matériel de montagne par télécopie. wtd ( [membre] ) Renvoie un ensemble de membres de même niveau qu'un "membre" donné, qui commence par le premier membre de même niveau et qui se termine par le "membre" en question, tel que déterminé par le niveau Semaine de la dimension de temps. Si aucun membre n'est indiqué, la valeur par défaut est définie à 'currentMember' de la dimension de temps. ytd ( [membre] ) Renvoie un ensemble de membres de même niveau qu'un "membre" donné, qui commence par le premier membre de même niveau et qui se termine par le "membre" en question, tel que déterminé par le niveau Année de la dimension de temps. Si aucun membre n'est indiqué, la valeur par défaut est définie à 'currentMember' de la dimension de temps.
Récapitulatifs des membres Cette liste contient des fonctions prédéfinies qui renvoient soit une valeur récapitulative unique pour un groupe de valeurs associées, soit une valeur récapitulative différente pour chaque instance d'un groupe de valeurs associées. aggregate ( < currentMeasure|expression_numérique > within set expression_ensemble ) aggregate ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) Renvoie une valeur calculée à l'aide de la fonction d'agrégation appropriée, en fonction du type d'agrégation de l'expression. average ( < currentMeasure|expression_numérique > within set expression_ensemble ) average ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) Renvoie la valeur moyenne des données élémentaires sélectionnées. Exemple : average ( Ventes ) Résultat : Renvoie la moyenne de toutes les valeurs des ventes. count ( < currentMeasure|expression_numérique > within set expression_ensemble ) count ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) La valeur retournée représente le nombre de données élémentaires sélectionnées, sans compter les valeurs nulles. Exemple : count ( Ventes ) Résultat : Renvoie le nombre total d'entrées sous Ventes. maximum ( < currentMeasure|expression_numérique > within set expression_ensemble ) maximum ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) Renvoie la valeur maximale des données élémentaires sélectionnées. Exemple : maximum ( Ventes ) Résultat : Renvoie la valeur maximale de toutes les valeurs des ventes. median ( < currentMeasure|expression_numérique > within set expression_ensemble ) median ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) Renvoie la valeur médiane des données élémentaires sélectionnées. minimum ( < currentMeasure|expression_numérique > within set expression_ensemble ) minimum ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) Renvoie la valeur minimale des données élémentaires sélectionnées. Exemple : minimum ( Ventes ) Résultat : Renvoie la valeur minimale de toutes les valeurs des ventes. Calcule le pourcentage de la valeur totale des données élémentaires sélectionnées. percentage ( expression_numérique [ tuple expression_membre { ; expression_membre } ] within set expression_ensemble ) Exemple : percentage ( [ventesVA].[mesures des ventes].[quantité] tuple [ventesVA].[Personnel].[].[département] -> [Ouest] within set children ( [ventesVA].[Personnel].[].[Personnel] ) ) La valeur retournée indique, selon une distribution de 0 à 100, dans quel centième se situent les données élémentaires sélectionnées. percentile ( expression_numérique [ tuple expression_membre { ; expression_membre } ] within set expression_ensemble ) Renvoie le rang d'une valeur au sein de la plage définie. Le rang est exprimé sous la forme d'entiers permettant de représenter toute plage, par exemple de 1 (le plus élevé) à 100 (le plus bas). quantile ( expression_numérique ; expression_numérique [ tuple expression_membre { ; expression_membre } ] within set expression_ensemble ) La valeur retournée représente le rang d'une valeur dans un groupe. Le rang est exprimé sous forme d'entier, le chiffre 1 représentant le premier rang, et le chiffre 4 représentant le dernier rang. quartile ( expression_numérique [ tuple expression_membre { ; expression_membre } ] within set expression_ensemble ) Renvoie le rang des données élémentaires sélectionnées. Le type de classement renvoyé (olympique, dense ou séquentiel) dépend de la source de données. L'ordre de tri est facultatif ; DESC est utilisé par défaut. rank ( expression_numérique [ ASC|DESC ] [ tuple expression_membre { ; expression_membre } ] within set expression_ensemble ) Exemple : rank ( [ventesVA].[mesures des ventes].[quantité] tuple [gosales].[Personnel].[].[département] -> [Ouest] within set children ( [ventesVA].[Personnel].[].[Personnel] ) ) standard-deviation ( < currentMeasure|expression_numérique > within set expression_ensemble ) standard-deviation ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) La valeur retournée représente l'écart-type des données élémentaires sélectionnées. standard-deviation-pop ( < currentMeasure|expression_numérique > within set expression_ensemble ) standard-deviation-pop ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) La valeur retournée représente la population d'écart-type des données élémentaires sélectionnées. total ( < currentMeasure|expression_numérique > within set expression_ensemble ) total ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) Renvoie la valeur totale des données élémentaires sélectionnées. variance ( < currentMeasure|expression_numérique > within set expression_ensemble ) variance ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) La valeur retournée représente la variance entre les données élémentaires sélectionnées. variance-pop ( < currentMeasure|expression_numérique > within set expression_ensemble ) variance-pop ( < currentMeasure|expression_numérique > within < detail|aggregate > expression ) La valeur retournée représente la population de variance entre les données élémentaires sélectionnées.
OLAP