Partilhar via

PATHITEM

  • Artigo

Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual

Retorna o item na posição especificada de uma cadeia de caracteres resultante da avaliação de uma função PATH. As posições são contadas da esquerda para a direita.

Sintaxe

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

Parâmetros

Termo Definição
path Uma cadeia de texto na forma dos resultados de uma função PATH.
posição Uma expressão inteira com a posição do item a ser retornado.
tipo (Opcional) Uma enumeração que define o tipo de dados do resultado:

enumeração de tipo

Enumeração Enumeração alternativa Description
TEXTO 0 Os resultados são retornados com o texto do tipo de dados. (padrão).
INTEIRO 1 Os resultados são retornados como inteiros.

Valor devolvido

O identificador retornado pela função PATH na posição especificada na lista de identificadores. Os itens retornados pela função PATH são ordenados pelo mais distante para o atual.

Observações

  • Esta função pode ser usada para retornar um nível específico de uma hierarquia retornada por uma função PATH. Por exemplo, você pode retornar apenas os gerentes de nível de pulo para todos os funcionários.

  • Se você especificar um número para a posição que seja menor que um (1) ou maior que o número de elementos no caminho, a função PATHITEM retornará BLANK

  • Se type não for um elemento de enumeração válido, um erro será retornado.

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo

O exemplo a seguir retorna o gerente de terceiro nível do funcionário atual; ele usa os IDs de funcionário e gerente como a entrada para uma função PATH que retorna uma cadeia de caracteres com a hierarquia de pais para o funcionário atual. A partir dessa cadeia de caracteres, PATHITEM retorna a terceira entrada como um inteiro.

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