Funcionalidades
Operação LIST - Lista dos registros que atendem aos filtros informados
ADS.CAD_TELA.FAQ-3578
A operação/feature LIST tem como objetivo apresentar um conjunto de registros que atendem aos critérios filtrados através das operações SEARCH e QUERY.
A lista de registros é normalmente apresentada sob forma de tabela e paginada para evitar resultados exageradamente grandes.
O link criado para detalhar um registro será criado para a primeira operação do bloco que o usuário tiver acesso entre as seguintes:
Caso o usuário deseja alterar a operação desejada, basta criar uma regra de negócio executada nos eventos PRE_DISPLAY ou PRE_RECORD e definir a operação desejada através do método:
getCurrentFeature().setNextFeature(...);
Colunas cuja propriedade SUMMARIZE for "S", serão totalizadas. Quando a propriedade não for definida diretamente para o item, seu valor é herdado do respectivo atributo, domínio ou tipo primitivo.
Ao executar uma LIST, os eventos ocorrem na seguinte ordem:
Verifica se usuário tem permissão
Apresenta as guias (se houver)
Carrega os parâmetros do formulário de query
list-pre-quey
Verifica se todos os campos de query obrigatórios estão preenchidos
Monta o SQL a ser usado
list-pos-query
Cria as ações padrões das telas de LIST
list-pre-display
Para todos os registros da query {
Lê o registro (da query)
Lê o objeto rec (ver notas)
list-pre-record
Apresenta TR com os dados do registro
list-pos-record
}
Se houve registros listados {
list-pre-summary
Apresenta a linha com os totais (se houver)
list-pos-summary
Encerra a table do HTML
}
Apresenta um texto com os totais dos registros apresentados
list-pos-display
Inclue form com campos da query e repassando parâmetros
Observações:
- O objeto rec somente é lido quando a propriedade INSTANTIATE_RECORD_ON_LIST da interface for "S", quando a List tiver algum UNBOUND relacionado com um item ou função, ou quando existir algum evento de pre ou pos record que tenha implementação Java.
- Os eventos list-pre-summary e list-pos-summary são executados mesmo quando não tem nenhum summary definido, mas somente se houve pelo menos um registro listado.
Ver também: