Get(SortOrder)

Retorna a ordem de classificação como um objeto JSON.

Formato 

Get ( SortOrder )

Parâmetros

Nenhum

Tipo de dados retornado

texto

Originada na versão

26.1

Descrição 

Esta função retorna a ordem de classificação da janela ativa como um objeto JSON com a seguinte estrutura:

Copiar
{
  "Classificar" : 
  {
    "campo" : 
    [
      {
        "fieldName" : "Tabela::Campo",
        "overrideLanguage" : "Idioma",
        "sortOrder" : "Crescente| Decrescente | Nome da lista de valores",
        "resumo" : "Campo de resumo"
      }
    ],
    "manter" : "verdadeiro | falso"
  }
}

A tabela a seguir descreve os elementos do objeto JSON retornado.

Elemento JSON Descrição
Classificar

O objeto que contém a ordem de classificação.

campo

A matriz que contém um objeto para cada campo de classificação, na ordem especificada na caixa de diálogo Classificar registros.

FieldName

O nome do campo de classificação, incluindo sua ocorrência de tabela (por exemplo, Produtos::NomeProduto).

sortOrder

A ordem de classificação do campo. Um dos seguintes:

  • Crescente

  • Decrescente

  • O nome da lista de valores, se especificado por Ordem personalizada com base na lista de valores

overrideLanguage

O nome do idioma, se especificado para Substituir o idioma do campo para classificação, por exemplo Sueco. Para os nomes possíveis, consulte Nomes de idiomas para classificação e indexação.

resumo

O nome do campo de resumo, se especificado para Reordenar com base no campo de resumo, sem uma ocorrência de tabela.

manter

Valor de texto, "verdadeiro" ou "falso", que indica se Manter registros na ordem classificada está selecionado.

Notas 

  • Cada janela tem seu próprio estado de classificação.

  • A função retorna a ordem de classificação mais recente da janela, mesmo que os registros não sejam mais classificados (por exemplo, depois que você escolher Registros > Não classificar). Para verificar se os registros estão classificados atualmente, use a função Função Get(SortState).

Exemplo 1 

Se os registros forem classificados por ProductName em ordem crescente e Manter registros na ordem classificada não estiver selecionado, a função retornará:

Copiar
{
  "Classificar" : 
  {
    "campo" : 
    [
      {
        "fieldName" : “Produtos::NomeProduto",
        "sortOrder" : "Crescente"
      }
    ],
    "manter" : "falso"
  }
}

Exemplo 2 

Salva a ordem de classificação da janela ativa no campo Reports::LastSortOrder antes que um script altere o conjunto encontrado. Se os registros não forem classificados, o campo será definido como um valor vazio.

Copiar
Set Field [ Reports::LastSortOrder ;
    If ( Get ( SortState ) = 0 ; "" ; Get ( SortOrder ) )
]

Exemplo 3 

Em um layout na Exibição em lista, uma seção de sub-resumo por categoria exibe um cabeçalho quando os registros são classificados por Categoria. O campo Categoria na parte do corpo repete o título em cada linha. Para ocultar o campo Categoria do corpo nesse caso, insira esta fórmula como a condição Ocultar quando (consulte Ocultação ou exibição de objetos de layout).

Copiar
Get ( SortState ) ≠ 0 and
JSONGetElement ( Get ( SortOrder ) ; "Sort.field[0].fieldName" ) = "Produtos::Categoria"

O cálculo retornará 1 (e o campo será ocultado) somente se os registros forem classificados e a Categoria for o primeiro campo de classificação. Caso contrário, ele retornará 0. O teste de Get(SortState) é necessário porque depois de escolher Registros > Não classificar, a função ainda retorna a última ordem de classificação.