Share via

PATHITEM

  • Artikel

Gilt für:berechnete Spaltenberechnete TabellenMeasuresvisuelle Berechnungen

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

Syntax

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

Parameter

Begriff Definition
path Eine Textzeichenfolge in Form der Ergebnisse einer PATH-Funktion.
position Ein ganzzahliger Ausdruck mit der Position des Elements, das zurückgegeben werden soll.
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

Der von der PATH-Funktion zurückgegebene Bezeichner an der angegebenen Position in der Liste der Bezeichner. Die von der PATH-Funktion zurückgegebenen Elemente sind von am weitesten entfernt zu aktuell sortiert.

Bemerkungen

  • Diese Funktion kann verwendet werden, um eine bestimmte Ebene aus einer Hierarchie zurückzugeben, die von einer PATH-Funktion zurückgegeben wird. Beispielsweise könnten Sie für alle Mitarbeiter den Vorgesetzten ihres Vorgesetzten zurückgeben.

  • Wenn Sie eine Zahl für position angeben, die kleiner als eins (1) oder größer als die Anzahl der Elemente 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 gibt den Vorgesetzten der dritten Ebene des aktuellen Mitarbeiters zurück. Es verwendet die Mitarbeiter- und Vorgesetzten-IDs als Eingabe in eine PATH-Funktion, die eine Zeichenfolge mit der Hierarchie der Vorgesetzten an den aktuellen Mitarbeiter zurückgibt. Aus dieser Zeichenfolge gibt PATHITEM den dritten Eintrag als ganze Zahl zurück.

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