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:

Copiar
{
  "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, Productos::NombreProducto).

sortOrder

Orden de clasificación del campo. Seleccione una de las opciones siguientes:

  • Ascendente

  • Descendente

  • El nombre de la lista de valores, si se especifica por Orden personalizado según lista de valores.

overrideLanguage

Nombre del idioma, si se ha especificado en el campo Omitir idioma del campo al ordenar, por ejemplo, sueco. Para conocer los posibles nombres, consulte Nombres de idiomas para la clasificación y la indexación.

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, "true" o "false", que indica si se ha seleccionado Mantener registros en orden.

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:

Copiar
{
  "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.

Copiar
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).

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