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

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura

    • 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.

    • O argumento ORDERBY encontrou 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 do dicionário isOrder.
    • O campo Ordem, se houver na tabela.
    • O campo Número, se houver um presente 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.

    Configuração de ordem padrão com 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.

    Definir a 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 do 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.

    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 em que a 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 como o valor do campo Importância
    Argumentos do módulo para definir a ordem de classificação com base no 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.