Formato avanzado

Puede utilizar las expresiones de Arcade para obtener un formato avanzado de los elementos de lista e indicador para personalizar la forma en que se representan sus puntos de datos. Un punto de datos puede representar una entidad o estadística de resumen (recuento, promedio, mínimo, máximo, suma o desviación estándar) en función de cómo se configure el elemento. Al utilizar entidades, un solo punto de datos representa una sola entidad. Cuando se utiliza una estadística, cada punto de datos representa el resultado de esa estadística. El elemento de lista representa los puntos de datos de la entidad como elementos de línea, donde cada línea representa un punto de datos. El elemento indicador representa un punto de datos a la vez.

A diferencia de las expresiones de atributos (utilizadas en el elemento emergente, los estilos y las etiquetas de una capa), se crea una sola expresión para cada elemento. La expresión se ejecuta para cada punto de datos y devuelve propiedades definidas por el sistema y definidas por el usuario para ese elemento. Las propiedades definidas por el sistema son los ajustes que se configurarían en un elemento, como el color de texto y de fondo. Las propiedades definidas por el usuario las define el usuario en la expresión y se puede hacer referencia a ellas al configurar el elemento.

Nota:

Las expresiones de atributos creadas en mapas web no se trasladan para su uso en elementos de cuadro de mando.

La siguiente tabla resume los datos de su capa que se transferirán a la expresión:

Nombre de la variable	Tipo	Descripción
$datapoint	Entidad o diccionario	Se aplica al indicador y a la lista
$reference	Diccionario	Se aplica al indicador

Nota:

Tenga en cuenta lo siguiente al escribir expresiones de Arcade:

• Incluya una coma después de cada propiedad en un diccionario, excepto la última propiedad.
• Los nombres de atributos no pueden contener espacios ni caracteres especiales.

Formato avanzado en una lista

Para el elemento de lista, puede utilizar expresiones de Arcade habilitando la opción Formato avanzado. Una vez que elige utilizar el formato avanzado, las entradas de color dejan de estar disponibles, junto con cualquier otra propiedad definida por el sistema.

La expresión, que se ejecuta para cada elemento de línea, se utiliza para definir cómo se representa cada línea de la lista. Además, se puede usar una expresión para crear nuevos atributos a los que se puede hacer referencia en la plantilla de elemento de línea.

Se puede hacer referencia a los atributos del punto de datos mediante la variable global $datapoint en el editor de Arcade. En la siguiente tabla se proporciona la lista de propiedades que se pueden devolver de la expresión en forma de diccionario:

Propiedad	Tipo de valor	Descripción
textColor	Cadena	Color de texto base del elemento de línea
backgroundColor	Cadena	Color de fondo del elemento de línea
separatorColor	Cadena	Color de borde inferior del elemento de línea
selectionTextColor	Cadena	Color utilizado para el texto del elemento de línea cuando se selecciona el elemento
selectionColor	Cadena	Color de texto base utilizado cuando se selecciona el elemento
atributos	Diccionario	Un diccionario de pares de atributo-valor
yourAttributeName	Cadena de caracteres, Número, Fecha, Booleano	Atributo al que se puede hacer referencia en la plantilla del elemento de línea utilizando la sintaxis {expression/yourAttributeName}

Nota:

Las funciones de geometría no son compatibles.

Por ejemplo, si desea que el color de fondo de la lista cambie al rojo cuando el valor esté por encima de un determinado umbral, puede crear una variable que se parezca a la siguiente:

var color = IIF($datapoint.[field]>[threshold], '#F3DED7','')

En esta variable, [field] es el campo para sus valores y [threshold] es el valor al que desea cambiar el color de fondo. La variable se puede utilizar como un valor de propiedad, como en el siguiente ejemplo:

backgroundColor: color,

Utilizar esta variable en la propiedad de color de fondo le da una expresión que tiene una apariencia similar a la siguiente, donde el color de fondo del elemento de lista cambiará a rojo cuando el valor de la velocidad sea superior a 40:

Utilizar el formato avanzado en una lista

Para utilizar expresiones de formato en un elemento de lista, haga lo siguiente:

1. En la configuración del elemento, haga clic en la pestaña Lista.
2. En la sección Formato avanzado, haga clic en Habilitar.

   Nota:

   Una vez que el formato avanzado está habilitado, las entradas de color dejan de estar disponibles y, en su lugar, se establecen en la expresión. Si establece colores antes de habilitar el formato avanzado, se agregan automáticamente a su expresión.

3. Cree su expresión de formato en el editor.

Sugerencia:

Si necesita ayuda con alguna de las funciones de Arcade, haga clic en el botón Información que hay junto a la función para ver más detalles.
4. Si desea que su expresión se ejecute a un intervalo específico, por ejemplo, si su expresión utiliza la función Now(), active el botón de alternancia de Refrescar script y establezca un intervalo de actualización.
5. En Plantilla del elemento de línea, introduzca los nuevos atributos con la sintaxis {expression/yourAttributeName}.

Formato avanzado en un indicador

Para el elemento de indicador, puede utilizar expresiones de Arcade habilitando la opción Formato avanzado. Una vez que elige habilitar el formato avanzado, dejan de estar disponibles las propiedades definidas por el sistema, como las opciones de color y el formato de valores, y el formato condicional se desactiva. La expresión se utiliza para definir estas propiedades de representación en pantalla y la lógica condicional. Además, una expresión puede suministrar los atributos definidos por el usuario a los que se hará referencia en los campos Título y Descripción en la pestaña General.

Cuando se incluye un valor de referencia en el indicador, en la pestaña Datos solo hay disponible un tipo de referencia basado en estadísticas una vez que se ha habilitado el formato avanzado. Si definió previamente un tipo de referencia de valor fijo, se agrega automáticamente a la expresión, junto con cualquier factor de conversión, texto y formato de color. El formato de valor realizado antes de habilitar el formato avanzado se elimina y se debe definir en la expresión utilizando patrones de valor.

Nota:

El valor anterior no se admite en Arcade. Si definió un tipo de referencia de valor anterior antes de habilitar el formato avanzado, se convertirá al valor actual.

Se puede hacer referencia a los atributos del punto de datos mediante la variable global $datapoint en el editor de Arcade. Dependiendo de si el tipo de valor es Entidad o Estadística, $datapoint es del tipo entidad o diccionario, respectivamente. Si se ha configurado una estadística de referencia en la pestaña Datos, la variable global $reference también estará disponible en el editor.

En la siguiente tabla se proporciona la lista de propiedades que se pueden devolver de la expresión en forma de diccionario:

Propiedad	Tipo de valor	Descripción
textColor	Cadena	Color de texto base del elemento de indicador
backgroundColor	Cadena	Color de fondo del elemento de indicador
topText	Cadena	Se muestra como el texto superior
topTextColor	Cadena	Color del texto superior
topTextOutlineColor	Cadena	Color del contorno del texto superior
topTextMaxSize	Cadena	Tamaño máximo del texto superior (XXS | XS | S | M | L | XL | XXL)
middleText	Cadena	Se muestra como el texto central
middleTextColor	Cadena	Color del texto central
middleTextOutlineColor	Cadena	Color del contorno del texto central
middleTextMaxSize	Cadena	Tamaño máximo del texto superior (XXS | XS | S | M | L | XL | XXL)
bottomText	Cadena	Se muestra como el texto inferior
bottomTextColor	Cadena	Color del texto inferior
bottomTextOutlineColor	Cadena	Color del contorno del texto inferior
bottomTextMaxSize	Cadena	Tamaño máximo del texto superior (XXS | XS | S | M | L | XL | XXL)
iconName	Cadena	Nombre del icono definido para el indicador
iconAlign	Cadena	Ubicación del icono adyacente al texto central (izquierda | derecha)
iconColor	Cadena	Color de relleno del icono
iconOutlineColor	Cadena	Color de contorno del icono
noValue	Booleano	Marque para mostrar el texto Sin valor en lugar del indicador (true | false)
atributos	Diccionario	Un diccionario de pares de atributo-valor
yourAttributeName	Cadena de caracteres, Número, Fecha, Booleano	Atributo al que se puede hacer referencia en los campos Título y Descripción utilizando la sintaxis {expression/yourAttributeName}

Por ejemplo, si tiene un indicador que muestra un valor en una unidad de medida, pero también desea mostrar el mismo valor en otra unidad a continuación, puede crear una variable para convertir sus valores existentes. Con un indicador que muestra la temperatura media en Celsius, puede crear una variable Fahrenheit para utilizarla en la expresión y mostrar también los valores en Fahrenheit.

var fahrenheit = Floor(($datapoint["avg_Temperature"]/5*9)+32)

A continuación, puede incluir la variable como un valor de propiedad, como el siguiente:

bottomText: fahrenheit,

Utilizar esta variable en la propiedad de texto inferior le proporciona una expresión similar a la siguiente, donde la temperatura media (en Celsius) se muestra en el texto central del indicador y el valor Fahrenheit se muestra en el texto inferior:

Utilizar el formato avanzado en un indicador

Para utilizar expresiones de formato en un elemento de indicador, haga lo siguiente:

1. En el menú de configuración del elemento, haga clic en la pestaña Indicador.
2. En la sección Formato avanzado, haga clic en Habilitar.

   Nota:

   Una vez que se habilita el formato avanzado, los campos de texto superior, central e inferior dejan de estar disponibles. Estas configuraciones se realizan en su expresión. Si introdujo valores antes de habilitar el formato avanzado, se agregan automáticamente a la expresión.
3. Cree su expresión de formato en el editor.

Sugerencia:

Si necesita ayuda con alguna de las funciones de Arcade, haga clic en el botón Información que hay junto a la función para ver más detalles.
4. Si desea que su expresión se ejecute a un intervalo específico, por ejemplo, si su expresión utiliza la función Now(), habilite el botón de alternancia de Refrescar script y establezca un intervalo de actualización.
5. Si ha creado un nuevo atributo con la expresión, puede hacer referencia a él en los campos Título y Descripción utilizando la sintaxis {expression/yourAttributeName}.

Valores de color

Al incluir valores de color en una expresión, se deben devolver como cadenas de caracteres (entre comillas). Los valores de color que se dejan sin definir o que no son válidos utilizarán automáticamente los valores predeterminados. Entre los tipos de valor de color admitidos están los valores hexadecimales, RGB, RGBA, HSL y HSLA. A continuación, se muestran algunos ejemplos junto con las sintaxis admitidas:

Colores hexadecimales

• #090
• #009900
• #090a
• #009900aa

RGB y RGBA

• rgb(34, 12, 64)
• rgba(34, 12, 64, 0,6)

HSL y HSLA

• hsl(50, 33%, 25%)
• hsla(50, 33%, 25%, 0,75)