Nível N do caminho (1 = raiz). Com "FIM" no 3º argumento conta de trás pra frente (1 = o próprio item).
| Campo | Valor |
|---|---|
| Categoria | Contexto e filtro |
| Tipo | Escalar (opera valor a valor) |
| Aridade | 2 a 3 argumentos |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: ITEM_CAMINHO. Aliases aceitos (maiúsc./minúsc. indiferente): pathitem.
Assinatura#
ITEM_CAMINHO(expr; arg2; [arg3])Todos os argumentos são expressões.
Retorno#
Texto (o nível pedido do caminho), ou vazio.
Tratamento de nulos#
Quando não há linha no contexto trocado, devolve vazio (nunca zero) — um branco é mais honesto que um zero inventado.
Contexto de avaliação#
Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).
Diferenças para DAX#
- Equivalente DAX: PATHITEM
- Compatibilidade: Compatível com DAX
- Observação: Nível N do caminho. Com "FIM" no 3º argumento conta de trás pra frente (no DAX isso é a função separada PATHITEMREVERSE).
Exemplos#
ITEM_CAMINHO(CAMINHO(conta; conta_pai); 2)Exemplo com valores#
Entrada: caminho "Ativo|Caixa|Banco", nível 2.
ITEM_CAMINHO("Ativo|Caixa|Banco"; 2) → "Caixa"Resultado esperado: "Caixa"
Exemplo de negócio#
Medida comparativa — participação no total, ranking, variação contra outro período.
Erros comuns#
Erros de digitação em nome de coluna, tipo incompatível ou argumento inválido viram mensagem amigável (pt-BR) — o motor nunca devolve um número errado em silêncio.