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:
{
"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, |
sortOrder
|
A ordem de classificação do campo. Um dos seguintes:
|
overrideLanguage
|
O nome do idioma, se especificado para Substituir o idioma do campo para classificação, por exemplo |
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, |
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á:
{
"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.
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).
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.