PATHITEM
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)