Compartilhar via

PATHITEM

  • Artigo

Aplica-se a:Coluna calculadaTabela calculadaMedidaCá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
caminho Uma cadeia de texto na forma dos resultados de uma função PATH.
position Uma expressão de inteiro 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 Descrição
TEXT 0 Os resultados são retornados com o tipo de dados de texto. (padrão).
INTEGER 1 Os resultados são retornados como inteiros.

Retornar valor

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 do mais distante para o atual.

Comentários

  • Essa 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 salto de nível para todos os funcionários.

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

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

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplo

O exemplo a seguir retorna o gerente de terceira camada do funcionário atual. Ele usa as IDs de funcionário e de gerente como a entrada para uma função PATH que retorna uma cadeia de caracteres com a hierarquia de pais até o funcionário atual. Com base nessa cadeia de caracteres, PATHITEM retorna a terceira entrada como um inteiro.

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