PATHITEMREVERSE

  • Artikel

Gibt das Element an der angegebenen Position in einer Zeichenfolge zurück, die sich aus der Auswertung einer PATH-Funktion ergibt. Positionen werden von rechts nach links rückwärts gezählt.

Syntax

PATHITEMREVERSE(<path>, <position>[, <type>])

Parameter

Begriff Definition
path Eine Textzeichenfolge, die sich aus der Auswertung einer PATH-Funktion ergibt.
position Ein ganzzahliger Ausdruck mit der Position des Elements, das zurückgegeben werden soll. Positionen werden von rechts nach links rückwärts gezählt.
Typ (Optional) Eine Enumeration, die den Datentyp des Ergebnisses definiert:

type-Enumeration

Enumeration Alternative Enumeration BESCHREIBUNG
TEXT 0 Ergebnisse werden mit dem Datentyp „Text“ zurückgegeben. (Standard).
INTEGER 1 Ergebnisse werden als ganze Zahlen zurückgegeben.

Rückgabewert

Das an n-ter Position übergeordnete Element im angegebenen Pfad, angegeben vom aktuellen bis zum ältesten Wert.

Bemerkungen

  • Mit dieser Funktion kann ein einzelnes Element aus einer Hierarchie abgerufen werden, die sich aus einer PATH-Funktion ergibt.

  • Diese Funktion kehrt die Standardreihenfolge der Hierarchie um, sodass die nächstgelegenen Positionen zuerst aufgelistet werden. Wenn die PATH-Funktion beispielsweise eine Liste mit Vorgesetzten zurückgibt, die sich in einer Hierarchie über einem Mitarbeiter befinden, gibt die PATHITEMREVERSE-Funktion den direkten Vorgesetzten des Mitarbeiters auf Position 2 zurück, weil Position 1 die ID des Mitarbeiters enthält.

  • Wenn die für position angegebene Zahl kleiner als eins (1) oder größer als die Anzahl von Elementen in path ist, gibt die PATHITEM-Funktion BLANK zurück.

  • Wenn type kein gültiges Enumerationselement ist, wird ein Fehler zurückgegeben.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.

Beispiel

Das folgende Beispiel verwendet eine Spalte mit Mitarbeiter-IDs als Eingabe für eine PATH-Funktion und kehrt die Liste der zwei Ebenen darüber befindlichen zurückgegebenen Elemente um. Die angegebene Position lautet 3, und der Rückgabetyp ist 1. Deshalb gibt die PATHITEMREVERSE-Funktion eine ganze Zahl zurück, die den Vorgesetzten zwei Ebenen über dem Mitarbeiter repräsentiert.

= PATHITEMREVERSE(PATH(Employee[EmployeeKey], Employee[ParentEmployeeKey]), 3, 1)