Como controlar a sequência de classificação usada para exibir listas

Todas as listas têm uma sequência de classificação padrão com base no tipo de campos presentes na lista.

Quando um usuário exibe uma lista pela primeira vez, ela é classificada por um dos itens a seguir.

• Os argumentos ORDERBY encontraram o URL. (Consulte a seção a seguir sobre controle de ordem de origem.)
• As preferências do usuário <table>.db.order e <table>.db.order.direction.
• O atributo de dicionário isOrder.
• O campo Pedido, se houver na tabela.
• O campo Número, se houver na tabela.
• O campo Nome, se houver um presente na tabela.
• O campo especificado como o campo de exibição da tabela.

Nota:

A tabela de tarefas é uma exceção à sequência anterior. Tarefa e tabelas estendidas da tarefa usam o campo Número quando nenhum argumento de URL ou preferência do usuário é encontrado.

Como definir a ordem padrão com as preferências do usuário

As preferências do usuário <table>.db.order e <table>.db.order.direction determinam o campo e a direção de classificação vistos pelo usuário. Uma classificação padrão pode ser criada criando registros de preferência do usuário sem valor no campo Usuário e marcando a caixa de seleção Sistema. Esta preferência é aplicada a todos os usuários que não têm sua própria preferência.

Definição da ordem de classificação padrão no dicionário do sistema

Um administrador pode definir a ordem de classificação dos registros exibidos para uma tabela no dicionário do sistema quando não há outra classificação especificada. Isso é feito adicionando um atributo chamado isOrder com um valor verdadeiro à entrada de dicionário do campo desejado. Esta classificação é a ordem de classificação apresentada a todos os usuários inicialmente. Depois que um usuário classifica uma lista, essa preferência do usuário é salva e a lista é sempre classificada para esse usuário com base na preferência de classificação anterior.

Nota:

isOrder pode definir qual campo é usado para classificação de lista, mas não pode controlar a direção da classificação.

Conceitos relacionados

• Dicionário do sistema
• Como alterar tabelas e campos usando atributos de dicionário

Tópicos relacionados

• User preferences

Controle de ordem de classificação

Para qualquer lista, se o usuário tiver clicado em um cabeçalho de coluna para classificar por essa coluna, essa ação será lembrada. Na próxima vez que essa lista for exibida, o mesmo campo será usado para ordenar a lista.

Este campo de classificação lembrado pode ser substituído adicionando uma especificação sysparm_order à definição do módulo. Por exemplo, se cada vez que Notícias for exibida, você quiser que os novos itens sejam listados em ordem de importância, o módulo Notícias poderá ser atualizado de acordo.

Figura 1. Definir ordem de classificação do módulo para o valor do campo Importância

A ordem real (crescente ou decrescente) pode ser especificada adicionando uma especificação sysparm_order_direction. Aqui estão dois exemplos de classificação de uma lista pelo campo sys_created_on, um crescente e um decrescente:

&sysparm_order=sys_created_on &sysparm_order_direction=desc
&sysparm_order=sys_created_on &sysparm_order_direction=asc

Classificar por vários campos

Para classificar uma lista por vários campos, remova tudo do campo de filtro e coloque-o no campo de argumentos. Por exemplo, se o filtro especificar [Active] [is] [true] e você quiser classificar por categoria e subcategoria, remova a condição e coloque o seguinte nos argumentos do módulo:

active=true^ORDERBYcategory^ORDERBYsubcategory

Este argumento primeiro ordena pela categoria e, em seguida, ordena pela subcategoria. Se você quiser que qualquer campo seja uma classificação decrescente, altere ORDERBY para ORDERBYDESC.