Get ( SortOrder )
Devuelve el orden de clasificación como un objeto JSON.
Formato
Get ( SortOrder )
Parámetros
Ninguno
Tipo de datos devuelto
texto
Se origina en
26.1
Descripción
Esta función devuelve el orden de clasificación de la ventana activa como un objeto JSON con la siguiente estructura:
{
"Sort" :
{
"field" :
[
{
"fieldName" : "Tabla::Campo",
"overrideLanguage" : "Idioma",
"sortOrder" : "Ascendente | Descendente | Nombre de lista de valores",
"summary" : "Campo de sumario"
}
],
"maintain" : "true | false"
}
}
En la siguiente tabla, se describen los elementos del objeto JSON devuelto.
| Elemento JSON | Descripción |
|---|---|
Ordenar
|
Objeto que contiene el orden de clasificación. |
campo
|
Matriz que contiene un objeto para cada campo de clasificación en el orden especificado en el cuadro de diálogo Ordenar registros. |
fieldName
|
Nombre del campo de clasificación, incluida su ocurrencia de tabla (por ejemplo, |
sortOrder
|
Orden de clasificación del campo. Seleccione una de las opciones siguientes:
|
overrideLanguage
|
Nombre del idioma, si se ha especificado en el campo Omitir idioma del campo al ordenar, por ejemplo, |
summary
|
Nombre del campo de sumario, si se especifica para Ordenar de nuevo según campo de sumario, sin una ocurrencia de tabla. |
maintain
|
Valor de texto, |
Notas
-
Cada ventana tiene su propio orden de clasificación.
-
La función devuelve el orden de clasificación más reciente de la ventana, incluso si los registros ya no están ordenados (por ejemplo, después de seleccionar Registros > Desordenar). Para comprobar si los registros están ordenados, utilice la función función Get ( SortState ).
Ejemplo 1
Si los registros están ordenados por ProductName en orden ascendente y no se ha seleccionado la opción Mantener los registros en orden, la función devuelve:
{
"Sort" :
{
"field" :
[
{
"fieldName" : "Productos::NombreProducto",
"sortOrder" : "Ascendente"
}
],
"maintain" : "false"
}
}
Ejemplo 2
Guarda el orden de clasificación de la ventana activa en el campo Informes::ÚltimoOrdenClasificación antes de que un guión cambie el conjunto de resultados. Si los registros no están ordenados, el campo se establece en un valor vacío.
Establecer campo [ Informes::ÚltimoOrdenClasificación ;
If ( Get ( SortState ) = 0 ; "" ; Get ( SortOrder ) )
]
Ejemplo 3
En una presentación con vista de lista, la sección de subsumario Categoría muestra un encabezado cuando los registros se ordenan por categoría. A continuación, el campo Categoría de la parte del cuerpo repite el encabezado en cada fila. Para ocultar el campo Categoría del cuerpo en ese caso, introduzca esta fórmula como condición Ocultar objeto cuando (consulte Ocultar o mostrar objetos de una presentación).
Get ( SortState ) ≠ 0 and
JSONGetElement ( Get ( SortOrder ) ; "Sort.field[0].fieldName" ) = "Productos::Categoría"
El cálculo devuelve 1 (y el campo está oculto) solo si los registros están ordenados y Categoría es el primer campo de clasificación. De lo contrario, devuelve 0. La prueba Get ( SortState ) es necesaria porque, después de elegir Registros > Desordenar, la función aún devuelve el último orden de clasificación.