4D Doc Center : QUERY SUBRECORDS

4D v14.3

QUERY SUBRECORDS


QUERY SUBRECORDS ( subTabela ; formula )

Parâmetro	Tipo	Descrição
subTabela	Subtabela	Subtabela a pesquisar
formula	Booleano	Fórmula de pesquisa

Nota de compatibilidade

As subtabelas não são compatíveis a partir da versão 11 de 4D. Um mecanismo de compatibilidade garante o funcionamento deste comando em bancos compartilhadas; entretanto, é recomendável substituir as subtabelas com tabelas relacionadas padrão.

Descrição

QUERY SUBRECORDS realiza uma pesquisa em subTabela cria uma nova subseleção. Este é o único comando que busca subregistros e retorna uma seleção de subregistros. A formula é aplicada a cada subregistro em subTabela. Quando a fórmula for TRUE, o subregistro se adiciona à nova subseleção. Quando terminar a pesquisa, QUERY SUBRECORDS transforma o primeiro subregistro no subregistro atual de subTabela.

Lembre que QUERY SUBRECORDS realiza uma pesquisa entre os subregistros da subtabela para o registro pai atual apenas, e não em todos os registros associados aos diferentes registros da tabela pai. QUERY SUBRECORDS não modifica o registro pai atual.

Geralmente, formula testa um subcampo com uma variável ou uma constante, utilizando um operador relacional. A formula pode conter múltiplos testes que estão unidas por operadores de tipo AND (&) ou OR ( | ). Da mesma maneira, fórmula pode ser ou conter uma função. O caráter arroba (@) pode ser utilizado com argumentos de tipo cadeia.

Se não houver um registro atual nem um subregistro atual, QUERY SUBRECORDS não tiver efeito. [#descn]Obsoleto, não utilizar[#/descn]

Exemplo

O exemplo abaixo pesquisa as crianças maiores de 10 anos:

QUERY SUBRECORDS([Pessoas]Crianças;[Pessoas]CriançasIdade>10)