Insertar como texto

Cuando el signo $ se encuentre en una expresión, la propiedad se sustituirá por su valor correspondiente antes de que se evalúe la expresión real (paso previo al procesamiento). Esto significa que puede escribir una expresión como esta: ${Property1}-${Property2}. El valor de Property1 es el nombre de columna Column1, y el valor Property2 es Column2, por lo que la expresión resultante será la siguiente: [Column1]-[Column2].

Si no desea que el valor de la propiedad se interprete como un nombre de columna, sino como un valor de cadena literal, debería incluir la llamada de la propiedad entre comillas. Por ejemplo, si cuenta con una propiedad denominada "MyProperty" con el valor "MyValue", la expresión ${MyProperty} devolverá la expresión MyValue resultante, en la que se recupera la columna MyValue. Sin embargo, la expresión "${MyProperty}" devolvería la cadena de texto "MyValue". Si el valor de la cadena consta de varias palabras (p. ej., "My Value"), deberá utilizar $esc() o incluir corchetes en la expresión de la propiedad para devolver una columna como valor: [${MyProperty}]. Consulte Detalles del lenguaje de las expresiones para obtener más información sobre los nombres de las columnas.

Tenga en cuenta que es muy importante utilizar en todo momento la sintaxis correcta para la expresión. De lo contrario, puede que obtenga un resultado diferente de lo esperado. Si se introduce una propiedad como una columna cuando la expresión espera una cadena, se recuperará el primer valor de la columna especificada. En el caso de las columnas de cadenas, el resultado puede ser una expresión válida, pero si se trata de una columna de otro tipo de datos, alternativamente puede recibir un mensaje de error.

En el cliente instalado, si se inserta una propiedad mediante el botón Insertar propiedades de los cuadros de diálogo Agregar columna calculada o Expresión personalizada, esta se agregará automáticamente mediante la sintaxis del texto (preprocesador).

Puede hacer clic con el botón secundario en la propiedad en el campo Propiedades disponibles para la columna y seleccionar Insertar como texto en el menú emergente.

Si una propiedad que incluye un nombre de columna debe utilizarse en un eje, existe un método abreviado denominado Establecer a partir de propiedad disponible en el menú emergente de los selectores de columnas (solo cliente instalado). Si se requieren cambios en la sintaxis agregada automáticamente, debe utilizar el cuadro de diálogo Expresión personalizada para modificar la expresión. Haga clic con el botón secundario en el selector de la columna y seleccione Eliminar todo en caso de que desee eliminar la expresión de la propiedad del eje.

Una propiedad también se puede emplear para especificar una medida de agregación. Por ejemplo, puede definir una propiedad denominada MyMeasure con el valor predeterminado "sum". Si se utiliza esta propiedad en una expresión, deberá agregar manualmente paréntesis y argumentos para la medida en la expresión en la que se utilice. Puede crear un selector de propiedades en un área de texto que muestre una lista de medidas de agregación fija que desee que esté disponible en una expresión de eje, lo que permitirá a los usuarios del cliente web cambiar dicha expresión de eje mediante el selector de propiedades.

Dado que las propiedades de la cadena insertadas como texto suelen interpretarse como nombres de columna, es posible que en ocasiones no consiga el resultado esperado cuando cree una expresión personalizada. Si la propiedad de la cadena se interpreta como un valor (por ejemplo, en expresiones condicionales), este deberá enmarcarse con comillas. Por ejemplo, si desea sustituir la cadena "ProductA", utilizada en una condición de expresión de eje como Sum(if(([Product])=("ProductA"),[Quantity],null)),, por una propiedad de documento, esta deberá enmarcarse con comillas para que la expresión funcione:

Sum(if ([Product] = "${MyProduct}",[Quantity],null))

Además, puede insertar la propiedad como una función en lugar de texto para recuperar los mismos resultados (consulte a continuación Insertar como valor):

Sum(if ([Product] = DocumentProperty("MyProduct"),[Quantity],null))

Insertar como valor

DocumentProperty("ExchangeRate")*[Value Column]

Tenga en cuenta que el nombre de la propiedad debe escribirse siempre entre comillas cuando se apliquen las funciones de propiedad. Si desea que una propiedad se interprete como un valor cuando se utiliza el cliente instalado, debe hacer clic con el botón secundario en la propiedad en el campo Propiedades disponibles para la columna y seleccionar Insertar como valor en el menú emergente.

Por supuesto, también puede escribir o editar manualmente la sintaxis de la propiedad, directamente.

Propiedades con valores de lista (selección múltiple): solo cliente instalado

Las propiedades de selección múltiple, o propiedades de valores de lista, se basan en una lista de valores en lugar de en un único valor. Pueden crearse cuando se defina un control de propiedad de cuadro de lista (selección múltiple) en un área de texto (solo cliente instalado). No se puede usar una propiedad de valores de lista en todos los lugares en los que se pueda aplicar una propiedad de un único valor normal, pero sí que resulta un método eficaz para especificar varias columnas en un eje.

Las propiedades de valores de lista requieren trabajo manual adicional cuando se emplean en expresiones. Sin embargo, en la mayoría de los casos obtendrá consejos acerca de la apariencia que debería tener la expresión en el contexto actual cuando inserte la propiedad con el botón Insertar propiedades.

Cuando se agrega una propiedad de valores de lista como texto a una expresión personalizada (por ejemplo, en un eje continuo, como el Y, en un gráfico de líneas o el eje de valores en un gráfico de barras) la sintaxis resultará como sigue: $map("sum([${PropertyName}])", ","). En este ejemplo, la agregación predeterminada se establece como "sum", de manera que si desea utilizar una agregación distinta deberá editar la expresión manualmente. La cadena de concatenación se configura como una coma, lo que implica que cada valor de lista debe interpretarse como una columna independiente. Si la propiedad PropertyName contiene una lista con tres columnas: "ColumnA", "ColumnB" y "ColumnC", la expresión resultante tras la expansión será sum([ColumnA]),sum([ColumnB]),sum([ColumnC]). Si la cadena de concatenación se cambia por un signo "+", el eje mostrará la suma de los valores de todas las columnas incluidas en la lista: sum([ColumnA])+sum([ColumnB])+sum([ColumnC]).

<$map("[${PropertyName}]", " NEST")>

Consulte Detalles del lenguaje de las expresiones para obtener más información acerca de las opciones NEST y CROSS.

Más ejemplos de expresiones

Si no se especifica nada más, los siguientes ejemplos de expresiones asumen que su tabla de datos se denomina "Data Table" y que contiene tres columnas completas llamadas "Column 1", "Column 2" y "Sales":

Column 1, Column 2, Sales 1,2,3 4,5,6