Benutzerhandbuch für TIBCO Spotfire®-Webclient

NavigatePeriod()

Einige Knotennavigationsmethoden eignen sich besonders für Hierarchien mit periodischen Daten, vor allem Zeithierarchien. Die Zeit ist von Natur aus hierarchisch strukturiert (wie Jahr, Quartal, Monat), und die Zeiträume sind wiederkehrend. Eine dieser Navigationsmethoden ist NavigatePeriod(). Mit dieser Methode können Sie Ihre eigene Navigation in einer Hierarchie definieren, da Sie vier Argumente angeben können, d. h. Eingabewerte, die steuern, welche Achse referenziert wird, wie viele Ebenen in der Hierarchie nach oben verschoben werden, wie viele Schritte seitwärts verschoben werden und wie viele Ebenen nach unten verschoben werden.

Tatsächlich kann die NavigatePeriod()-Methode viele der anderen Navigationsmethoden ersetzen. Weitere Informationen finden Sie unter Vergleichen der Methoden NavigatePeriod() und Parent().

Da die Knoten in einer Zeithierarchie zudem offensichtlich sind, können alle Knoten, denen Daten fehlen, automatisch erkannt werden.

Die NavigatePeriod()-Methode ist unten beispielhaft dargestellt.



In diesem Beispiel wird das 3. Quartal 2020 als Startknoten verwendet. Angenommen, Sie möchten auf das 3. Quartal 2018 verweisen. In diesem Beispiel können Sie einen NavigatePeriod()-Ausdruck mit drei Argumenten definieren:

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

Das erste Argument ist die fragliche Achse, das zweite Argument navigiert bis zur Jahresebene und das dritte Argument navigiert seitwärts auf dieser Jahresebene zwei Zeitschritte zurück, da der Wert negativ ist. Wenn ein viertes Argument weggelassen wird, kehren Sie automatisch auf die gleiche Ebene wie den Ausgangspunkt zurück, in diesem Fall das entsprechende Quartal 2018. Wenn Sie möchten, können Sie eine andere Ebene als die Blattebene angeben, indem Sie ein viertes Argument hinzufügen.
Tipp: Wenn Sie eine Hierarchiestufe angeben, können Sie den Namen der Stufe auch durch die Anzahl der Stufen ersetzen, die Sie nach oben oder unten gehen möchten. Die Verwendung von 0 als Argument bedeutet, dass Sie auf der Ebene bleiben. In der obigen Abbildung hätte NavigatePeriod([Axis.X],1,-2) das gleiche Ergebnis geliefert wie NavigatePeriod([Axis.X],"Year",-2).

Beispiel

Anmerkung: Um die Ausdrücke in diesem Thema anzuwenden, wird davon ausgegangen, dass speicherinterne Daten verwendet werden.

Das Balkendiagramm zeigt die Verkaufszahlen im Januar und Februar für verschiedene Obst- und Gemüsesorten, aufgeteilt auch nach ihrer Kategorie. Angenommen, Sie möchten den monatlichen Beitrag jedes Typs zum Umsatz in Prozent anzeigen.



Die Methode Parent() würde gut funktionieren, um den Beitrag eines Typs innerhalb der Kategorien Obst bzw. Gemüse zurückzugeben, d. h. eine Ebene höher in der Hierarchie, aber es würde nicht so einfach funktionieren, zwei Schritte nach oben zu gehen!

In diesem Fall ist die Methode NavigatePeriod() eine gute Wahl. Schauen Sie sich den Ausdruck auf der Werteachse unten an:



  • Das erste Argument, [Axis.X], bezieht sich auf die Hierarchieachse, in diesem Fall die Kategorieachse. Beachten Sie, dass die Kategorieachse immer als Axis.X bezeichnet wird, unabhängig davon, ob das Balkendiagramm horizontal oder vertikal ausgerichtet ist.
  • Das zweite Argument, „Month“, navigiert nach oben zur Monatsebene, d. h. zwei Stufen nach oben in der Hierarchie. „Month“ könnte im Ausdruck genauso gut durch 2 ersetzt werden.
  • Das dritte Argument, 0, gibt an, dass in der Hierarchie keine seitliche Navigation stattfindet.
  • Das vierte Argument, eine weitere 0, behält die Monatsebene bei.
So entfallen beispielsweise 27 % des Gesamtumsatzes im Januar auf den Verkauf von Bananen (88/(38+88+64+28+66+40)).
Anmerkung: Die Prozentangaben sind gerundet.