Histórico da Página
Quando é utilizado o componente GridContainer, por padrão aparecerá somente a possiblidade de exportação dos dados, representado por 'Opções', porém a opção 'Ordenação' aparece somente em CrudFreeForm.
Com a finalidade de disponibilizar a opção de Ordenação em telas do tipo FreeForm, foi implementada a propriedade showOrder, que por padrão vem sem valor.
Para que a opção seja apresentada no container, basta setar a propriedade com o valor true e a opção será apresentada no Container.
* Lembre-se que qualquer outro valor que não seja true, o sistema seguira o comportamento padrão
** As colunas disponíveis para seleção serão preenchidas automaticamente de acordo com a Grid principal.
Fica a cargo do Desenvolvedor resgatar as informações dos itens e utiliza-las no envio as BO's, para isto foram implementadas algumas funcionalidades para facilitar na criação da consulta.
Exemplo:
Selecionamos as opções Código, Nome e UF.
Ao clicar no botão 'Aplicar', não acontecerá nada... A não ser que o Desenvolvedor implemente o evento 'onOrderApply', presente no componente GridContainer.
Para 'resgatar' os valores dos itens selecionados, utilize o GETPROPERTY sobre o container criado e a propriedade selectedOrder.
A função descrita acima retornará algo do tipo:
{"typeOrder":1,"name":"codigo","label":"Codigo","selected":false,"order":1},
{"typeOrder":2,"name":"nome","label":"Nome","selected":false,"order":2},
{"typeOrder":1,"name":"uf","label":"UF","selected":false,"order":3}
Onde:
typeOrder: Representa o tipo de ordenação do item selecionado, no qual o valor 1 é Ascendente e o valor 2, Descendente;
name: Nome da coluna correspondente a tabela que representa o item;
label: Nome do campo;
selected: Não se aplica para esta implementação;
order: Sequencia da prioridade de ordenação dos campos.
Nota: A implementação do evento onOrderApply é opcional. O trecho de código para resgatar as informações da grid de ordenação pode ser realizada no evento de click do botão de pesquisar ou onde o Desenvolvedor achar melhor.