Função CARDINALITY

A função do campo CARDINALITY retorna a quantidade de campos repetidos em uma determinada matriz.

Sintaxe

CARDINALITY retorna um valor inteiro que fornece a quantidade de campos repetidos na matriz especificada por field_reference. Se field_reference identificar um campo inexistente, o resultado é zero.

Por exemplo, você pode utilizar o resultado para referir-se do terceiro ao último campo:
Body.Invoice."Item"[CARDINALITY(Body.Invoice."Item"[]) -
2].Quantity

Neste exemplo, é fornecido à função CARDINALITY uma referência de campo que termina com []. O significado disso é contar todas as instâncias do campo Item. O [] no final é necessário; ele torna a sintaxe consistente com outras instâncias onde é necessário fazer referência a todas as instâncias de alguma coisa. Os índices da matriz começam em 1, portanto o índice da matriz do exemplo acima se refere à antepenúltima instância do campo Item.

Nota: Se estiver utilizando um loop while para processar elementos de uma mensagem, defina uma variável com o valor de CARDINALITY antes de entrar no loop, para melhorar o desempenho.

Conceitos relacionados
ESQL

Tarefas relacionadas
Desenvolvendo ESQL
Convertendo Página de Código e Codificação da Mensagem

Referências relacionadas
Preferência de Sintaxe
Funções de Campo ESQL