Top() evalúa una expresión en la primera fila (superior) de un segmento de columna en una tabla. La fila para la que se calcula depende del valor de offset, si está presente, el valor predeterminado es la fila superior. Para los gráficos que no sean tablas, la evaluación Top() se realiza en la primera fila de la columna actual en el equivalente de tabla simple del gráfico.
Sintaxis:
Top([TOTAL] expr [ , offset [,count ]])
Tipo de datos que devuelve: dual
| Argumento | Descripción |
|---|---|
| expr | La expresión o el campo que contiene los datos que se han de medir. |
| offset |
Especificar un offset de n, mayor que 1, desplaza la evaluación de la expresión hacia abajo, n filas por debajo de la fila superior. Especificar un número de desplazamiento (offset) negativo hace que la función Top opere como la función Bottom con el correspondiente número de offset positivo. |
| count | Especificando un tercer parámetro count mayor que 1, la función devolverá un rango de valores count, uno por cada una de las últimas filas count del actual segmento de columna. De esta manera, la función puede utilizarse como argumento en cualquiera de las funciones de rango especiales. Funciones de rango |
| TOTAL |
Si la tabla es unidimensional o si el cualificador TOTAL se utiliza como argumento, el segmento de columna actual es siempre igual a la columna completa. |
Limitaciones:
-
Las llamadas recursivas devolverán NULL.
-
No se permite ordenar por valores Y en gráficos ni ordenar por columnas de expresión en tablas cuando esta función de gráfico se usa en cualquiera de las expresiones del gráfico. Estas alternativas de ordenación están por lo tanto automáticamente deshabilitadas. Cuando utiliza esta función de gráfico en una visualización o tabla, el orden de la visualización volverá a la entrada ordenada de esta función.
| Ejemplo | Resultado |
|---|---|
|
Top( Sum(Sales) ) |
Devuelve el valor de Sales de la primera fila (superior) de un segmento de columna en una tabla. |
Ejemplo: fundamentos de Top
Descripción
Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección.
El script de carga contiene:
-
Un conjunto de datos que se carga en una tabla de datos denominada Example.
-
Los siguientes campos de la tabla de datos:
-
Year
-
Sales
-
Script de carga
Example:
LOAD * INLINE [
Year, Sales
2019, 1000
2020, 1500
2021, 1200
2022, 1800
2023, 1700
];Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión:
-
Year
Cree las siguientes medidas:
-
=Sum(Sales), para hallar las ventas anuales.
-
=Top(Sum(Sales)), para hallar el valor de las ventas del primer año, es decir, la primera fila (superior) de una columna de una tabla.
-
=Sum(Sales) - Top(Sum(Sales)), para calcular la varianza entre el valor Sales de la fila actual y el valor de la primera fila (superior) de una columna.
-
=Sum(Sales)-Top(Sum(Sales), 3), para calcular la varianza entre el valor de venta de la fila actual y el valor de la 3ª fila desde arriba.
-
=(Sales - Top(Sales)) / Top(Sales), para devolver el cambio en Sales como ratio / porcentaje en comparación con la primera fila. Para mostrar este valor como porcentaje, en Formato numérico, seleccione Número > Formato simple > 12,34%.
Ordene la tabla de la dimensión Year por orden ascendente.
| Year | Sum(Sales) | Top(Sum(Sales)) | Sum(Sales) - Top(Sum(Sales)) | Sum(Sales)-Top(Sum(Sales), 3) | (Sales - Top(Sales)) / Top(Sales) |
|---|---|---|---|---|---|
| Totals | 7200 | 1000 | 6200 | 6000 | - |
| 2019 | 1000 | 1000 | 0 | -200 | 0.00% |
| 2020 | 1500 | 1000 | 500 | 300 | 50.00% |
| 2021 | 1200 | 1000 | 200 | 0 | 20.00% |
| 2022 | 1800 | 1000 | 800 | 600 | 80.00% |
| 2023 | 1700 | 1000 | 700 | 500 | 70.00% |
Si observa los resultados, podrá comparar los valores de Sales del periodo actual con los del periodo superior (o primero).
-
La medida Sum(Sales) - Top(Sum(Sales)) devuelve el cambio en los valores de Sales comparando el periodo actual con el primero.
-
La medida Sum(Sales)-Top(Sum(Sales), 3) devuelve la suma de Sales de la fila actual menos el tercer periodo desde arriba.
-
La medida =(Sales - Top(Sales)) / Top(Sales) devuelve el cambio en Sales comparado con el primer periodo en forma de porcentaje.
Haga lo siguiente:
Cree un gráfico de barras y, a continuación, añada este campo como dimensión:
-
Year
Cree la siguiente medida:
-
=Sum(Sales)- Top(Sum(Sales)), para devolver la varianza de las ventas entre el periodo actual y el periodo superior.
Gráfico de barras que muestra los resultados de la función Top
El uso de la función Top en un gráfico de barras proporciona una comparación visual de la varianza entre las ventas del periodo actual frente al periodo anterior (o primero).