4D Doc Center : ORDER SUBRECORDS BY

4D v13.4

ORDER SUBRECORDS BY


ORDER SUBRECORDS BY ( subTabela ; subCampo {; > ou <}{; subCampo2 ; > ou <2 ; ... ; subCampoN ; > ou <N} )

Parâmetro	Tipo	Descrição
subTabela	Subtabela	Subtabela para qual ordenar os subregistros selecionados
subCampo	Subcampo	Subcampo para cada nível no qual vai "ordenar por"
> ou <	Operador	Direção de ordenação para qualquer nível: > para ordem ascendente; ou < para ordem descendente.

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

ORDER SUBRECORDS BY ordena a subseleção atual de subTabela. Apenas a subseleção de subtabela contida no registro pai atual.

O parâmetro direçao especifica se ordenar subCampo de forma ascendente ou descendente. Se direçao for igual ao símbolo “maior que” (>), os subregistros estão ordenados na ordem ascendente. Se direçao for igual ao símbolo “menor que” (<), os subregistros são ordenados na ordem descendente.

Pode especificar vários níveis de ordenação incluindo mais subcampos e símbolos de ordenação.

Quando tiver terminado a ordenação, o primeiro subregistro da subseleção ordenada é o subregistro atual. A ordenação dos subregistros é um processo dinâmico. Os subregistros nunca são guardados na ordem. Se não existir um registro atual ou um subregistro, ORDER SUBRECORDS BY não tem efeito.

Se um formulário contiver um subformulário a ser impresso em uma moldura fixa, deve chamar este comando um pouco antes da impressão do método de formulário pai.

Exemplo

O exemplo abaixo ordena a subtabela [Estados]Vendas em ordem ascendente, baseado no subcampo VendasDólares:

ORDER SUBRECORDS BY([Estados]Vendas;[Estados]Vendas'Dólares;>)