Função PATHITEM (DAX)

Retorna o item no position especificado de uma cadeia de caracteres que resulta 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

• path
  Uma cadeia de caracteres 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	Enumeração alternativa	Descrição
  TEXT	0	São retornados resultados com o texto de tipo de dados. (padrão).
  INTEGER	1	São retornados resultados como inteiros.

Valor de retorno

O identificador retornado pela função PATH à posição especificada na lista de identificadores. Itens retornados pela função PATH são ordenados do mais distante até o atual.

Comentários

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

• Se você especificar um número para position 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.

Esta função DAX não tem suporte para uso no modo DirectQuery. Para obter mais informações sobre limitações nos modelos DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219172.

Exemplo

O exemplo a seguir retorna o terceiro gerenciador de camada do funcionário atual; ele utiliza as IDs de funcionário e gerenciador 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)