Função de ER WHERE

A função WHERE devolve a lista especificada como um valor Lista de registos depois de ter sido filtrada de acordo com a condição especificada.

Sintaxe

WHERE (list, condition)

Argumentos

list: Lista de registos

O caminho válido de uma origem de dados do tipo de dados Lista de registos.

condition: Booleano

Uma expressão condicional válida utilizada para filtrar registos da lista especificada.

Valores de retorno

Lista de registos

A lista de registos resultante.

Notas de utilização

Esta função difere da função FILTER, porque a condição especificada é aplicada a qualquer origem de dados de Relatórios eletrónicos (ER) do tipo Lista de registos que esteja presente na memória.

Se os argumentos configurados para esta função (list e condition) permitirem que este pedido seja traduzido para a chamada SQL direta, uma mensagem de aviso é iniciada durante a estruturação. Esta mensagem informa o utilizador de que o desempenho pode ser melhorado se a função FILTER for utilizada em vez de WHERE.

Exemplo 1

Se o Fornecedor for configurado como uma origem de dados de ER que se refere à tabela VendTable, a expressão WHERE (Vendors, Vendors.VendGroup = "40") devolve uma lista apenas de fornecedores que pertencem ao grupo de fornecedores 40.

Exemplo 2

Se introduzir a origem de dados DS do tipo Campo calculado e contiver a expressão SPLIT ("A|B|C", "|"), a expressão WHERE( DS, DS.Value = "B") devolve uma lista de um único registo que contém o texto "B" no campo Valor.

Recursos adicionais

Funções de lista