PATHITEM

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

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

Sintaxe

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

Parâmetros

Prazo	Definição
path	Uma cadeia de caracteres de texto na forma dos resultados de uma função PATH.
position	Uma expressão inteiro com a posição do item a ser retornado.
type	(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 texto do tipo de dados. (padrão).
INTEGER	1	Os resultados são retornados como inteiros.

Valor de retorno

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 pela mais distante para a atual.

Observações

• 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 nível de ignorar 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.

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

Exemplo

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

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