Detalles del lenguaje de las expresiones

Si aprende el funcionamiento del lenguaje de las expresiones, le será más fácil crear expresiones válidas. Este tema pretende explicar la funcionalidad básica de dicho lenguaje.

Si el nombre de una columna contiene caracteres que no son letras, números o _ (caracteres de subrayado), deben escribirse entre los caracteres "[" y "]" (corchetes). Estos también son necesarios cuando el nombre de la columna es el mismo que el de la función o cuando este empieza por un número. Por ejemplo:

[Column 1]

[Sum]

Si aplica <> alrededor de una expresión, esta se considerará por categorías. Por ejemplo:

<[Category column 1]>

Cuando existen varias columnas, estas suelen separarse con comas. Por ejemplo:

[Column1],[Column2]

Puede usar la palabra clave AS para especificar un nombre nuevo para una expresión y así ocultar la expresión subyacente. Por ejemplo:

[Column1]/([Column1]+[Column2])AS Quota

Tenga en cuenta que, cuando la expresión de eje contiene comas, no se puede cambiar el nombre del eje completo, pero se puede definir un nombre para cada parte de la expresión:

[Column1] AS [My first column], [Column2] AS [My second column]

Las constantes siempre se pueden usar como argumentos, aunque la descripción de la función especifique que el argumento deba ser una columna.

39+12*3

-(1-2)

Si está trabajando con visualizaciones basadas en más de una tabla de datos, las expresiones se referirán a la tabla de datos principal, de forma predeterminada. Para hacer referencia a una columna en otra tabla de datos, debe usar el nombre completo: [Nombre de tabla de datos].[Nombre la columna]. Por ejemplo:

Sum([Data Table 2].[Column1])

Consulte Operadores y Funciones para obtener descripciones de los operadores y las funciones disponibles.

Comentarios en expresiones

Si crea expresiones más complejas que necesitan una explicación, es posible agregar comentarios a las expresiones. Use "//" para especificar que el texto después de los símbolos es un comentario.

Por ejemplo:

Avg([Sales]) OVER Intersect([Cat], AllPrevious([Year])) //Muestra las ventas promedio por categoría para todos los años, hasta el año actual.

[Sales]/1000 //La cifra de ventas se ha dividido entre mil para mostrar valores en kkr en lugar de SEK

Tenga en cuenta que si agrega comentarios a una expresión en un eje de visualización, se espera que continúe utilizando el cuadro de diálogo de expresión personalizada para toda la edición posterior. Esto se debe a que las operaciones de arrastrar y soltar afectan y reorganizan las expresiones demasiado para poder mantener los comentarios.

Acción de escape de caracteres especiales

Dado que algunos caracteres tienen un significado especial en el idioma de las expresiones de Spotfire, será necesario realizar diversas acciones cuando se vayan a utilizar dichos caracteres con otros fines, como incluirlos en nombres de columnas.

Un carácter de escape es un carácter especial que se usa para informar al idioma de la expresión de que los siguientes caracteres de la secuencia deben considerarse caracteres estándar, en lugar de elementos que tienen un fin especial.

Si el nombre de columna contiene un corchete, deberá realizarse su escape. Esto se realiza mediante la agregación de corchetes adicionales antes y después del signo: "[" y "]]". Por ejemplo, si el nombre de columna fuera [Nombre], se escribiría como [[Nombre]]] en una expresión. Cuando utilice el botón Insertar columna en el cuadro de diálogo Agregar columna calculada (solo cliente instalado) para agregar columnas, obtendrá automáticamente la acción de escape correcta del nombre de la columna.

Distinción de minúsculas y mayúsculas

Las variables, funciones y palabras clave no distinguen minúsculas de mayúsculas: SUM(C1) = Sum(C1) = sum(C1)
Las referencias de nombres de columnas sí realizan esta distinción;
por el contrario, los nombres de métodos de llamada no lo hacen. Pueden emplearse todos los métodos definidos en el marco de complemento. Consulte Operadores y Funciones para obtener información sobre los diferentes métodos admitidos.

Expresiones resultantes

Una expresión describe la forma en la que debe calcularse una columna nueva. La última columna creada tendrá el mismo número de filas que el resto de columnas de la tabla de datos. El comportamiento de gestión nulo predeterminado consiste en que las operaciones nulas devolverán este tipo de valor. Es decir, si se calcula una nueva columna como [Columna A]*2 y existen valores vacíos en algunas filas de la columna A, la nueva columna también tendrá dichos valores en esas filas.

Expresiones de categorías: NEST y CROSS

En el caso de las expresiones personalizadas, las columnas y expresiones jerárquicas y por categorías se escriben entre comillas angulares "<>". Cuando en la expresión esté disponible más de una categoría, han de especificarse las combinaciones de estas que deben aparecer. Esto se realiza mediante las palabras clave NEST, que muestra las combinaciones reales de valores en los datos, o CROSS, que indica todas las combinaciones posibles de valores, incluidas las que no contienen datos por el momento. Todas las columnas de la expresión deben separarse mediante "nest" o "cross" en lugar de coma; no se permite mezclar ambas opciones de combinación.

<[Columna de categoría 1] nest [Columna de categoría 2]>

Por ejemplo, si tenemos una tabla de datos que incluya algunos datos de ventas de cada mes durante dos años, pero faltan los datos de febrero durante el año 2020, las distintas opciones producirán estos resultados:

Nest

Dado que no existen datos disponibles para febrero de 2020, no habrá ninguna barra ni marcador de posición de la barra. Esta visualización se configura mediante la opción NEST en el eje de categorías y corresponde a la expresión personalizada:

<[Year] NEST [Month]>

Cruzada

Cuando se selecciona CROSS, pueden aparecer todas las combinaciones posibles de categorías. Es decir, existirá un marcador de posición para la columna de febrero del año 2020, aunque este mes no tenga datos disponibles. La expresión personalizada correspondiente sería:

<CROSS [Year] CROSS [Month]>

(La primera aparición de CROSS es opcional).

Nota: Aunque la opción CROSS esté seleccionada, puede que no vea las categorías vacías en la visualización, en función del modo del eje. En el cliente instalado, puede hacer clic con el botón secundario en el eje y seleccionar Categorías para ver o cambiar la configuración. Si la opción Mostrar valores filtrados está seleccionada, se ocultarán las categorías sin valores en la visualización. Debe usar las opciones Mostrar rango filtrado o Mostrar todos los valores para ver las categorías vacías de este ejemplo.

Consejo: En el cliente instalado, la configuración para NEST/CROSS, así como la configuración para el modo del eje y la forma de evaluar la expresión del eje, también se puede especificar desde el cuadro de diálogo Propiedades de visualización > Eje de categorías > Configuración avanzada.

Validación de valores

Los valores vacíos se generan cuando falta un valor de columna de la tabla de datos, cuando un cálculo provoca un valor no válido o mediante la escritura de un valor nulo en la expresión. Los resultados null se muestran como (Vacío) o, simplemente, se dejan en blanco. Los valores nulos se pueden reemplazar usando la función SN().

Cuando se realicen agregaciones en una columna, se ignorará el valor no válido, mientras que los cálculos en filas entre columnas darán como resultado valores no válidos cada vez que una de las columnas contenga uno de estos valores.