Guide de l'utilisateur du client Web Spotfire®

NavigatePeriod()

Certaines méthodes de navigation de nœuds sont particulièrement adaptées aux hiérarchies contenant des données périodiques, surtout les hiérarchies temporelles. Le temps est structuré hiérarchiquement par nature (comme l'année, le trimestre, le mois) et les périodes sont récurrentes. L'une de ces méthodes de navigation est NavigatePeriod(). Cette méthode vous permet de définir votre propre navigation dans une hiérarchie, car vous pouvez spécifier quatre arguments : les valeurs d'entrée qui contrôlent l'axe à référencer, le nombre de niveaux à remonter dans la hiérarchie, le nombre d'étapes à déplacer latéralement et le nombre de niveaux à descendre.

En fait, la méthode NavigatePeriod() peut remplacer de nombreuses autres méthodes de navigation. Reportez-vous à la rubrique Comparaison des méthodes NavigatePeriod() et Parent().

En outre, étant donné que les nœuds d'une hiérarchie temporelle sont évidents, tous les nœuds dans lesquels il manque des données peuvent être détectés automatiquement.

La méthode NavigatePeriod() est illustrée ci-dessous.



Cet exemple utilise Q3, 2020 comme nœud de départ. Supposons que vous vouliez faire référence au 3e trimestre 2018. Ensuite, vous pouvez définir une expression NavigatePeriod() avec trois arguments :

NavigatePeriod([Axis.X],"Year",-2)

Le premier argument est l'axe en question, le deuxième argument navigue jusqu'au niveau Year (Année) et le troisième argument navigue latéralement à ce niveau Year, deux étapes en arrière dans le temps, car la valeur est négative. Lorsqu'un quatrième argument est omis, vous revenez automatiquement au même niveau que le point de départ, en l'occurrence le trimestre correspondant en 2018. Si vous le souhaitez, vous pouvez spécifier un autre niveau que le niveau feuille en ajoutant un quatrième argument.
Conseil : Lorsque vous spécifiez un niveau de hiérarchie d'intérêt, vous pouvez tout aussi bien remplacer le nom du niveau par le nombre d'étapes à remonter ou à descendre. Utiliser 0 comme argument signifie que vous restez au niveau. Dans l’image ci-dessus, NavigatePeriod([Axis.X],1,-2) aurait donné le même résultat que NavigatePeriod([Axis.X],"Year",-2).

Exemple

Remarque : Pour appliquer les expressions de cette rubrique, il est supposé que des données « in-memory » sont utilisées.

L'histogramme montre les chiffres des ventes en janvier et février pour différents types de fruits et légumes, également répartis par catégorie. Supposons que vous souhaitiez afficher la contribution mensuelle de chaque type aux ventes, exprimée en pourcentage.



La méthode Parent() fonctionnerait bien pour renvoyer la contribution d'un type dans les catégories fruits et légumes respectivement, c'est-à-dire un niveau plus haut dans la hiérarchie, mais cela ne fonctionnerait pas si facilement en remontant de deux étapes !

La méthode NavigatePeriod() est donc ici un bon choix. Consultez l'expression sur l'axe des valeurs ci-dessous :



  • Le premier argument, [Axis.X], fait référence à l'axe hiérarchique, dans ce cas-ci l'axe Catégorie. Notez que l'axe Catégorie est toujours appelé Axis.X, que l'orientation de l'histogramme soit horizontale ou verticale.
  • Le deuxième argument, « Month » (Mois), navigue jusqu'au niveau Month, c'est-à-dire deux étapes plus haut dans la hiérarchie. « Month » pourrait tout aussi bien être remplacé par 2 dans l'expression.
  • Le troisième argument, 0, spécifie qu'aucune navigation n'a lieu latéralement dans la hiérarchie.
  • Le quatrième argument, un autre 0, conserve le niveau Month.
Par exemple, 27 % des ventes totales de janvier sont des ventes de bananes (88/(38+88+64+28+66+40)).
Remarque : Les pourcentages sont arrondis.