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.