DATA RESTRICTION / RESTRICCIÓN DE DATOS

English (Español a continuación)

The following commands allow to limit the output by selecting a limited number of records:

  • BOTTOM
  • TOP
  • RESTRICT

These commands can be placed in the Report Script in the block that defines the elements of the rows.

These commands can be used together in each selection block of the Report (ends with the sign !).

  • But each of them only once.
  • They must all use the same row dimension.

Used with other order commands, their order of execution is:

  • Other sort commands (for example: SORTASC / SORTDESC)
  • RESTRICT
  • TOP / BOTTOM
  • ORDER BY

1.- BOTTOM

This command selects the last «n» records based on their value in a given column.

  • Selects the “n” rows with the lowest value and sorts them in descending order.
  • In the selection of records, the #missing values ​​are not considered.

Syntax:

  • <BOTTOM(“Row dimension”, “Number of rows”, “Column”)

“Row dimension”: it is optional; determines the row dimension to use for value selection; if not set, the rightmost dimension (the one just before the first data column) is taken by default.

Suppose we have 3 row dimensions:

  • “Markets” / “Products” / “Sellers”

If we select based on the dimension:

  • “Markets”: the Report Script shows us the “n” records with the lowest value (according to column “x”) for this dimension.
  • “Products”: the Report Script shows us for each of the markets the “n” records with the lowest value (according to column “x”) for this dimension.
  • “Sellers”: the Report Script shows us for each of the markets and for each of their products the “n” records with the lowest value (according to the “x” column) for this dimension.

“Number of rows”: number of rows to display (must be greater than zero).

“Column”: Specifies the column by which the records will be sorted to select the “n” smallest values. Its syntax is:

  • @DATACOLUMN(Number)
  • The first column with data is @DATACOLUMN(1), the next @DATACOLUMN(2), and so on.

For example:

  • <BOTTOM(“Markets”, 15, @DATACOLUMN(3))

Based on the “Markets” dimension (row dimension), select the 15 records with the lowest value based on the value they have in column 3th.

  • Presents them in descending order.

2.-TOP

This command selects the first «n» records based on their value in a given column.

  • Selects the “n” rows with the highest value and orders them in descending order.
  • In the selection of records, the #missing values ​​are not considered.

Its structure is:

  • <TOP(“Row dimension”, “Number of rows”, “Column”)

“Row dimension”: it is optional; determines the element dimension of the row to use for value selection; if not set, the rightmost dimension (the one just before the first data column) is taken by default.

  • It works the same as we have seen in the previous command.

“Number of rows”: number of rows to display (must be greater than zero).

“Column”: Specifies the column by which the records will be sorted to select the “n” largest values. Its syntax is:

  • @DATACOLUMN(Number)
  • The first column with data is @DATACOLUMN(1), the next @DATACOLUMN(2), and so on.

For example:

  • <TOP(“Markets”, 20, @DATACOLUMN(6))

Based on the “Markets” dimension (row dimension), select the 20 records with the highest value based on the value they have in column 6th.

  • Presents them in descending order.

3.- RESTRICT

This command sets the conditions that the records must meet to be displayed in the Report Script.

Its structure is:

  • <RESTRICT(“Column” “Operator” “Value” [AND/OR “Column” “Operator” “Value”]…)

“Column”: you have to identify the column that must meet the condition. The following nomenclature is used:

  • @DATACOLUMN(Number)
  • The first column with data is @DATACOLUMN(1), the next @DATACOLUMN(2), and so on.

For example:

  • @DATACOLUMN(5): Selects column nº5

“Operator”: They can be:

  • >=
  • <=
  • =
  • != (or <>)

“Value”: It is the reference that the data must meet to be displayed in the Report Script.

  • It can be a value or #missing.

Considerations:

  • You can also use nested conditions using the AND / OR operators, conditions that are read from left to right (parentheses cannot be used).
  • A maximum of 9 conditions can be included.

Example:

  • <RESTRICT(@DATACOLUMN(5) > 100 AND (@DATACOLUMN(7) < 50)

Español

Los siguientes comandos permiten limitar la salida seleccionando un número limitado de registros:

  • BOTTOM
  • TOP
  • RESTRICT

Estos comandos se pueden situar en el Report Script en el bloque que define los elementos de las filas.

Estos comandos se pueden utilizar conjuntamente en cada bloque de selección del Report (finaliza con el signo !).

  • Pero cada uno de ellos tan sólo una vez.
  • Deben utilizar todos ellos la misma dimensión de fila.

Utilizados con otros comandos de orden, su orden de ejecución es:

  • Otros comandos de ordenación (por ejemplo: SORTASC / SORTDESC)
  • RESTRICT
  • TOP / BOTTOM
  • ORDERBY

1.- BOTTOM

Este comando selecciona los “n” últimos registros en función de su valor en una columna determinada.

  • Selecciona las “n” filas con menor valor y las ordena de forma descendiente.
  • En la selección de registros no se consideran los valores #missing.

Sintaxis:

  • <BOTTOM(“Dimensión de fila”, “Número de filas”, “Columna”)

“Dimensión de fila”: es opcional; determina la dimensión de fila que se va a utilizar para la selección de valores; si no se establece se toma por defecto la dimensión más a la derecha (la que está justo antes de la primera columna de datos).

Supongamos que tenemos 3 dimensiones de fila:

  • “Mercados” / “Productos” / “Vendedores”

Si seleccionamos en base a la dimensión:

  • “Mercados”: el Report Script nos muestra los “n” registros con menor valor (según la columna “x”) para esta dimensión.
  • “Productos”: el Report Script nos muestra para cada uno de los mercados los “n” registros con menor valor (según la columna “x”) para esta dimensión.
  • “Vendedores”: el Report Script nos muestra para cada uno de los mercados y para cada uno de sus productos los “n” registros con menor valor (según la columna “x”) para esta dimensión.

“Número de filas”: número de filas a mostrar (debe ser mayor que cero).

“Columna”: Especifica la columna por la que se van a ordenar los registros para seleccionar los “n” valores menores. Su sintaxis es:

  • @DATACOLUMN(Número)
  • La primera columna con datos es @DATACOLUMN(1), la siguiente @DATACOLUMN(2) y así sucesivamente.

Por ejemplo:

  • <BOTTOM(“Mercados”, 15, @DATACOLUMN(3))

Selecciona en base a la dimensión “Mercados” (dimensión de fila) los 15 registros con menor valor en función del valor que tienen en la columna 3ª.

  • Los presenta en orden descendiente.

2.- TOP

Este comando selecciona los “n” primeros registros en función de su valor en una columna determinada.

  • Selecciona las “n” filas con mayor valor y las ordena de forma descendiente.
  • En la selección de registros no se consideran los valores #missing.

Su estructura es:

  • <TOP(“Dimensión de fila”, “Número de filas”, “Columna”)

“Dimensión de fila”: es opcional; determina la dimensión de elementos de la fila que se va a utilizar para la selección de valores; si no se establece se toma por defecto la dimensión más a la derecha (la que está justo antes de la primera columna de datos).

  • Funciona igual que hemos visto en el comando anterior.

“Número de filas”: número de filas a mostrar (debe ser mayor que cero).

“Columna”: Especifica la columna por la que se van a ordenar los registros para seleccionar los “n” valores mayores. Su sintaxis es:

  • @DATACOLUMN(Número)
  • La primera columna con datos es @DATACOLUMN(1), la siguiente @DATACOLUMN(2) y así sucesivamente.

Por ejemplo:

  • <TOP(“Mercados”, 20, @DATACOLUMN(6))

Selecciona en base a la dimensión “Mercados” (dimensión de fila) los 20 registros con mayor valor en función del valor que tienen en la columna 6ª.

  • Los presenta en orden descendiente.

3.- RESTRICT

Este comando fija las condiciones que deben de cumplir los registros para ser recogidos en el Report Script.

Su estructura es:

  • <RESTRICT(“Columna” “Operador” “Valor” [AND/OR “Columna” “Operador” “Valor”]…)

“Columna”: hay que identificar la columna que debe de cumplir la condición. Se utiliza la siguiente nomenclatura:

  • @DATACOLUMN(Número)
  • La primera columna con datos es @DATACOLUMN(1), la siguiente @DATACOLUMN(2) y así sucesivamente.

Por ejemplo:

  • @DATACOLUMN(5): Selecciona la columna nº5

“Operador”: Pueden ser:

  • >=
  • <=
  • =
  • != (o <>)

“Valor”: Es la referencia que deben cumplir los datos para ser recogidos en el Report Script.

  • Puede ser un valor o #missing.

Consideraciones:

  • Se pueden utilizar también condiciones anidadas utilizando los operadores AND / OR, condiciones que se leen de izquierda a derecha (no se pueden utilizar paréntesis).
  • Se pueden incluir un máximo de 9 condiciones.

Ejemplo:

  • <RESTRICT(@DATACOLUMN(5) > 100 AND (@DATACOLUMN(7) < 50)