El widget de gráfico de barras está disponible como widget estándar en la plataforma y como componente Web que se puede importar desde un SDK. |
Eje X | Valor del eje Y | Valor N del eje Y | |
---|---|---|---|
Definición de campo | x:{name:'x',baseType:'STRING'} | value1:{name:'value1',baseType:'NUMBER'} | value1:{name:'value2',baseType:'NUMBER'} |
Uso | Permite definir los valores del eje X para la barra o columna del gráfico. Los datos deben tener un tipo base STRING. Cada fila se muestra como una categoría en el eje X. El nombre definido para esta columna es la opción que se debe seleccionar para la propiedad de widget XAaxisField. | Permite definir el valor del eje Y y el rótulo de leyenda para la categoría. | Permite definir el valor del eje Y y el rótulo de leyenda para cada serie de datos adicional. |
Tipo base | STRING | NUMBER | NUMBER |
Ejemplo de fila | x:'Apple': donde Apple es el nombre de la categoría que se debe mostrar en el eje X. | value1:10: el valor del eje Y para la categoría. | value2:30: el valor del eje Y para la segunda serie de datos. |
Se aplica a los caracteres la distinción entre mayúsculas y minúsculas. Por ejemplo, "M" representa el mes y "m" representa el minuto. |
Asegúrese de que un evento desencadena el servicio en tiempo de ejecución. |
Para actualizar los datos del gráfico automáticamente en tiempo de ejecución, cree una función de renovación automática y enlácela al servicio de datos que devuelve los datos del gráfico. Para obtener más información, consulte Renovación automática. |
Las propiedades del eje Y secundario están disponibles solo en ThingWorx 9.1 y versiones posteriores. |
Por defecto, todos los datos se muestran en el eje principal. |
Nombre de la propiedad | Descripción | Tipo base | Valor por defecto | ¿Es enlazable? (Sí/No) | ¿Es localizable? (Sí/No) |
---|---|---|---|---|---|
SecondYAxis | Permite añadir un eje Y secundario al gráfico. | BOOLEAN | Falso | S | N |
SecondYAxisLabel | Permite especificar el rótulo de texto del eje Y secundario. | STRING | Eje Y secundario | S | S |
SecondYAxisLabelAlignment | Permite alinear el rótulo del eje Y secundario. El rótulo se puede colocar Arriba, En medio o Abajo. Por defecto, el rótulo se coloca en el centro. | STRING | En medio | No | N |
SecondYAxisFormat | Permite definir el formato de los valores del eje Y secundario. Esta propiedad se puede utilizar para determinar el aspecto de los datos mostrados. Por ejemplo, se puede definir el número de dígitos que se deben mostrar después de la coma decimal. | STRING | 0000.0 | S | N |
SecondYAxisMaxValue | Permite definir el rango máximo para los valores del eje Y secundario. Por defecto, el rango se calcula automáticamente y se muestran todos los datos. | NUMBER | N/D | S | N |
SecondYAxisMinValue | Permite definir el rango máximo para los valores del eje Y secundario. Por defecto, el rango se calcula automáticamente en función de los datos del widget. | NUMBER | N/D | S | N |
UseSecondYAxis1..n | Permite mostrar los valores de la serie de datos n en el eje Y secundario. Esta propiedad está disponible cuando se cambia NumberOfSeries de Auto a un número fijo. | BOOLEAN | Falso | N | N |
YAxisRulerAlignment | Permite especificar el eje Y que se debe utilizar como referencia para las líneas de la regla. Se pueden alinear las líneas de la regla con los marcadores de valores de datos del eje Y principal o secundario. | STRING | Eje Y principal | S | N |
SecondYAxisSeriesDisplay | Permite controlar cómo se apilan las series de datos del eje Y secundario en el gráfico. Se pueden apilar y combinar los valores, se pueden apilar como un porcentaje del valor total o se pueden agrupar los valores. Por defecto, se agrupan las series de datos. | STRING | Agrupadas | S | N |
Nombre de la propiedad | Descripción | Tipo base | Valor por defecto | Enlazable | Localizable |
---|---|---|---|---|---|
EmptyChartIcon | Permite especificar el icono que se debe mostrar cuando el gráfico está vacío. | Entidad multimedia | not visible | N | N |
EmptyChartLabel | Permite especificar el texto que se debe mostrar cuando el gráfico está vacío. | STRING | [[ChartStateLabelEmpty]] | N | S |
ErrorStateIcon | Permite especificar el icono que se debe mostrar cuando el gráfico está vacío. | Entidad multimedia | error | N | N |
ErrorStateLabel | Permite especificar el texto que se debe mostrar cuando el gráfico está vacío. | STRING | N | S | |
LoadingIcon | Permite especificar el icono que se debe mostrar cuando se estén cargando los datos del gráfico. | Entidad multimedia | chart loading icon | N | N |
NoDataSourceIcon | Permite especificar el icono que se debe mostrar cuando el gráfico no está enlazado a ningún origen de datos. | Entidad multimedia | bind | N | N |
NoDataSourceLabel | Permite especificar el texto que se debe mostrar cuando el gráfico no está enlazado a ningún origen de datos. | STRING | [[ChartStateLabelNoData]] | N | S |
Nombre de la propiedad | Descripción | Tipo base | Valor por defecto | Enlazable | Localizable |
---|---|---|---|---|---|
ShowZoomButtons | Se muestran los botones de ampliar y alejar en la barra de herramientas del gráfico cuando el zoom horizontal o vertical está activado. | BOOLEAN | Falso | N | N |
Nombre de la propiedad | Descripción | Tipo base | Enlazable | Localizable | ||
---|---|---|---|---|---|---|
NumberOfYLabels | Permite establecer el número de rótulos que se deben mostrar en el eje Y.
| NUMBER | N | S |
Nombre de la propiedad | Descripción | Tipo base | Enlazable | Localizable |
---|---|---|---|---|
NumberOfReferenceLines | Permite especificar el número de líneas de referencia que se deben mostrar en el gráfico. Se pueden añadir hasta 24 líneas de referencia. Se añaden propiedades adicionales para cada línea de referencia. | NUMBER | S | N |
ReferecneLineNLabel | Permite definir el rótulo de texto de la línea de referencia. | STRING | S | S |
ReferecneLineNValue | Permite definir el valor de la línea de referencia. Se puede especificar un valor numérico o de fecha según el tipo de eje. | NUMBER o DATETIME | S | N |
ReferenceLineNAxis | Permite especificar el eje que se debe utilizar para la línea de referencia. Esta propiedad solo está disponible cuando un gráfico contiene dos ejes con datos continuos, como números o fechas. | STRING | N | N |
Nombre de la propiedad | Descripción | Tipo base | Valor por defecto | ¿Es enlazable? (Sí/No) | ¿Es localizable? (Sí/No) | ||
---|---|---|---|---|---|---|---|
ChartType | Permite definir el tipo de gráfico en Gráfico de barras o Gráfico de columnas. | STRING | Gráfico de barras | N | N | ||
CustomClass | Clase CSS definida por el usuario que se aplicará al elemento div superior del widget. Pueden introducirse varias clases, separadas por un espacio. | STRING | n/d | S | N | ||
Data | El origen de datos de infotable para el gráfico. | INFOTABLE | n/d | S | N | ||
DataField1 a DataField24 | Estas propiedades se enumeran cuando NumberOfSereis se define en un número fijo. Estas propiedades se pueden utilizar para seleccionar la columna de infotable que se debe utilizar para cada serie de datos. | Columna de infotable | n/d | N | N | ||
DataLabel1 a DataLabel24 | Estas propiedades se muestran cuando NumberOfSereis se define en un número específico. Las propiedades se pueden utilizar para especificar un rótulo personalizado para cada serie de datos de la leyenda. Para obtener más información, consulte Personalización de la leyenda del gráfico.
| STRING | n/d | N | S | ||
DataSeriesStyle | Permite abrir el cuadro de diálogo de configuración de formato de estado. Esta propiedad aparece cuando NumberOfSeries se define en Automático. La definición de estado se aplica a todas las series del gráfico.
| Definición de estado | n/d | N | N | ||
DataSeriesStyle1 a DataSereisStyle24 | Estas propiedades se enumeran en función del número que se haya definido para la propiedad NumberOfSereis. Estas propiedades se pueden utilizar para aplicar una definición de estado independiente a cada serie de datos del gráfico. | Definición de estado | n/d | N | |||
Disabled | Permite desactivar el widget en el mashup. El widget se muestra en el mashup, pero no se puede pulsar en él ni seleccionarse. | BOOLEAN | Falso | S | N | ||
DirectSelectionZoom | Permite ampliar mediante la selección de dos elementos de datos del gráfico. Las opciones disponibles para esta propiedad son Eje horizontal, Eje vertical, Ambos y Ninguno. Esta propiedad aparece en la lista de propiedades al seleccionar HorizontalZoom | STRING | Ninguno | S | N | ||
DragSelectionZoom | Permite ampliar una parte específica del gráfico dibujando un cuadro de selección alrededor del rango de datos que se desea ver. Las opciones disponibles para esta propiedad son Eje horizontal, Eje vertical, Ambos y Ninguno. Esta propiedad aparece en la lista de propiedades al seleccionar HorizontalZoom | STRING | Ninguno | S | N | ||
ExternalPadding | Permite definir el relleno a partir de los ejes. El relleno es un porcentaje del ancho de la barra. | NUMBER | 25 | S | N | ||
GroupPadding | Permite definir el relleno entre los grupos de series de datos. El relleno es un porcentaje del ancho de la barra. | NUMBER | 25 | S | N | ||
HideLegend | Permite ocultar el área de la leyenda. Cuando se selecciona esta propiedad, las propiedades LegendAlignment, LegendFilter, LegendMarkerShapes, LegendMaxWidth y LegendPosition no aparecen en la lista de propiedades. | BOOLEAN | Falso | S | N | ||
HideNotes | Permite ocultar el área notas. Cuando se selecciona esta propiedad, las propiedades Notes, NotesAlignment y NotesPosition no aparecen en la lista de propiedades. | BOOLEAN | Falso | S | N | ||
HideValues | Permite ocultar todos los rótulos de valores del gráfico. | BOOLEAN | Falso | S | N | ||
HideXAxis | Permite ocultar el eje X. | BOOLEAN | Falso | S | N | ||
HideYAxis | Permite ocultar el eje Y. | BOOLEAN | Falso | S | N | ||
HorizontalAxisMaxHeight | Permite definir una altura máxima para el eje horizontal. | NUMBER | 85 | S | N | ||
HorizontalAxisLabelsRotation | Permite definir el ángulo de rotación de los rótulos en el eje horizontal. Se puede introducir un valor de -180 a 180. | NUMBER | Tamaño automático | N | N | ||
HorizontalZoom | Permite ampliar el eje horizontal. Cuando se selecciona esta propiedad, las propiedades HorizontalIntervalControl, HorizontalRangeZoom, HorizontalSliderZoom, DirectSelectionZoom y DragSelectionZoom aparecen en la lista de propiedades. | BOOLEAN | Falso | S | N | ||
HorizontalIntervalControl | Permite añadir controles que permiten ampliar el eje horizontal según intervalos específicos. Las opciones disponibles son Ninguno, que es la selección por defecto, y Lista desplegable. Cuando se selecciona Lista desplegable, las propiedades HorizontalIntervalControlLabel y HorizontalIntervalData aparecen en la lista de propiedades. | STRING | Ninguno | N | N | ||
HorizontalIntervalControlLabel | Permite especificar el rótulo de texto de los controles de zoom de intervalo para el eje horizontal. | STRING | n/d | S | S | ||
HorizontalIntervalData | El origen de datos de las opciones de control de zoom de intervalo. Cuando se selecciona una entrada de la lista desplegable de intervalos horizontales, el gráfico se amplía según el valor de duración seleccionado y el punto de anclaje inicial/final. | INFOTABLE | n/d | S | N | ||
HorizontalIntervalAnchorPoint | Permite seleccionar la posición de anclaje del rango de intervalos en el conjunto de datos. Seleccione Inicio para colocar el intervalo al principio del conjunto de datos o Fin para colocar el intervalo al final. Por ejemplo, si se especifica un intervalo de 3 meses en un conjunto de datos de 12 meses, se puede seleccionar Inicio para mostrar los 3 primeros meses o Fin para mostrar los últimos 3 meses del conjunto de datos. Esta propiedad aparece cuando se selecciona la propiedad ShowHorizontalAnchorPointControl. | STRING | Inicio | S | N | ||
HorizontalIntervalAnchorPointLabel | Permite especificar el rótulo del punto de anclaje del intervalo para el eje horizontal. Esta propiedad aparece cuando se selecciona la propiedad ShowHorizontalAnchorPointControl. | STRING | n/d | S | S | ||
HorizontalRangeZoom | Permite añadir controles para especificar un rango de valores y ampliar el eje horizontal. Cuando se selecciona esta propiedad, las siguientes propiedades HorizontalStartZoomLabel y HorizontalEndZoomLabel aparecen en la lista de propiedades. | BOOLEAN | Falso | S | N | ||
HorizontalStartZoomLabel | Permite especificar el rótulo de texto para el inicio de la selección de rango. | STRING | n/d | S | S | ||
HorizontalEndZoomLabel | Permite especificar el rótulo de texto para el fin de la selección de rango. | STRING | n/d | S | S | ||
HorizontalSliderZoom | Permite añadir un control de corredera para mostrar los datos entre un valor mínimo y uno máximo en el eje horizontal. Cuando se selecciona esta propiedad, las propiedades HorizontalSliderZoomMaxLabel y HorizontalSliderZoomMinLabel aparecen en la lista de propiedades. | BOOLEAN | Falso | S | N | ||
HorizontalSliderZoomMaxLabel | Permite especificar el rótulo del valor máximo del control de zoom de corredera. | STRING | n/d | S | S | ||
HorizontalSliderZoomMinLabel | Permite especificar el rótulo del valor mínimo del control de zoom de corredera. | STRING | n/d | S | S | ||
InternalPadding | Permite definir el relleno entre la serie de datos. El relleno es un porcentaje del ancho de la barra. | NUMBER | 25 | S | N | ||
Label | Permite mostrar el texto del rótulo del gráfico de barras. | STRING | Gráfico de barras | S | S | ||
LabelType | Permite seleccionar el tipo de rótulo del gráfico de barras como Cabecera, Subcabecera, Rótulo o Cuerpo. | STRING | Subcabecera | S | N | ||
LabelAlignment | Permite alinear el rótulo del widget de gráfico de barras a la Izquierda, Centro o Derecha. | STRING | Izquierda | N | N | ||
LabelPosition | Permite definir la posición del rótulo en Arriba o Abajo. | STRING | Arriba | N | N | ||
LabelReset | Permite definir el rótulo que se muestra en el botón de redefinición para el control de zoom. | STRING | Redefinir | S | S | ||
LegendAlignment | Permite alinear el texto de la leyenda Arriba, En medio o Abajo. Las opciones disponibles para esta propiedad dependen de la configuración de la propiedad LegendPosition. | STRING | Arriba | N | N | ||
LegendFilter | Permite añadir un filtro de leyenda de modo que el usuario pueda filtrar el gráfico en tiempo de ejecución. | BOOLEAN | Falso | N | N | ||
LegendMarkerShapes | Permite definir la forma del marcador de la leyenda en Cuadrado o Círculo. | STRING | Cuadrado | N | N | ||
LegendMaxWidth | Permite definir un ancho máximo para el área de la leyenda. | NUMBER | 736 | S | N | ||
LegendPosition | Permite definir la posición de la leyenda Arriba, Abajo, Izquierda o Derecha. | STRING | Derecha | N | N | ||
MultipleDataSources | Permite utilizar varios orígenes de datos para la serie del gráfico. De este modo, se pueden visualizar datos de varios orígenes en el gráfico. | BOOLEAN | Falso | N | N | ||
Notes | Permite especificar el texto que se debe mostrar en el área notas del gráfico. Se puede introducir una cadena o seleccionar un token de localización. | STRING | n/d | S | S | ||
NotesAlignment | Permite alinear el texto de la nota a la Izquierda, Derecha o en el Centro del área notas. | STRING | Izquierda | N | N | ||
NotesPosition | Permite definir la posición del área de notas Arriba o Abajo. | STRING | Abajo | N | N | ||
NumberOfSeries | Permite definir el número de series de datos que se deben mostrar en el gráfico. En la configuración automática se muestran todas las series de datos. | NUMBER | Automático | N | N | ||
ResetToDefaultValue | Permite restaurar los valores por defecto de la entrada de este widget. | n/d | n/d | S | N | ||
ReverseXAxis | Permite mostrar los valores del eje X en orden inverso. | BOOLEAN | Falso | N | N | ||
ReverseYAxis | Permite mostrar los valores del eje Y en orden inverso. | BOOLEAN | Falso | N | N | ||
RulersInFront | Permite mostrar las reglas delante de los valores de datos. Por defecto, las reglas se muestran detrás de los datos. | BOOLEAN | Falso | S | N | ||
SeriesClicked | Permite activar un evento cuando se pulsa en un punto de datos. | n/d | n/d | S | N | ||
SeriesDisplay | Permite controlar el modo en que se muestran varias series de datos en el gráfico. Se pueden apilar o agrupar los valores de datos de cada serie mediante las opciones Apiladas o Agrupadas. Seleccione 100 % apiladas para mostrar la serie de datos como un porcentaje del valor total. | STRING | Agrupadas | S | N | ||
ShowHorizontalAnchorPointControl | Permite añadir controles para ajustar el valor de anclaje del eje horizontal. Cuando se selecciona esta propiedad, las propiedades HorizontalIntervalAnchorPoint y HorizontalIntervalAnchorPointLabel aparecen en la lista de propiedades. | BOOLEAN | Falso | S | N | ||
ShowHideLegend | Permite añadir un botón Mostrar/Ocultar para mostrar u ocultar la leyenda del gráfico en tiempo de ejecución.
| BOOLEAN | Falso | N | N | ||
ShowXAxisRuler | Permite mostrar la regla del eje X. | BOOLEAN | Falso | S | N | ||
ShowYAxisRuler | Permite mostrar la regla del eje Y. | BOOLEAN | Falso | S | N | ||
ShowZeroValueRuler | Permite mostrar la regla de valor cero. | BOOLEAN | Falso | S | N | ||
SparkView | Permite mostrar una vista simplificada de la visualización del gráfico. Active esta propiedad para ocultar los rótulos, las leyendas y las reglas. | BOOLEAN | Falso | S | N | ||
TabSequence | El número de secuencia del widget de gráfico de barras al pulsar el tabulador. | NUMBER | n/d | N | N | ||
ValuesPosition | Permite definir la posición de los rótulos de valores de datos con relación a las barras del gráfico como Fuera de la barra o Solapar barra. | STRING | Fuera de la barra | N | N | ||
VerticalAxisMaxWidth | Permite definir un ancho máximo para el eje vertical. | NUMBER | 85 | S | N | ||
VerticalZoom | Permite ampliar el eje vertical. Cuando se selecciona esta propiedad, aparece una propiedad VerticalSliderZoom en la lista de propiedades. | BOOLEAN | Falso | S | N | ||
VerticalSliderZoom | Permite añadir un control de corredera para mostrar los datos entre un valor mínimo y uno máximo en el eje vertical. Cuando se selecciona esta propiedad, las propiedades VerticalZoomMaxLabel y VerticalZoomMinLabel aparecen en la lista de propiedades. | BOOLEAN | Falso | S | N | ||
VerticalZoomMaxLabel | Permite especificar el rótulo de texto para el valor máximo del control de zoom de corredera. | STRING | n/d | S | S | ||
VerticalZoomMinLabel | Permite especificar el rótulo de texto para el valor mínimo del control de zoom de corredera. | STRING | n/d | S | S | ||
XAxisField | Campo de la infotable que representa el contenido de la barra para el eje X. Aparecen varios orígenes de infotable XAxisField en la lista de propiedades cuando se selecciona la propiedad MultipleDataSources. | INFOTABLE | n/d | N | N | ||
XAxisLabel | Se muestra el rótulo de texto del eje X. | STRING | Eje X | S | S | ||
XAxisLabelAlignment | Permite alinear el rótulo del eje X Arriba, En medio o Abajo. | STRING | En medio | N | N | ||
YAxisFormat | Permite definir el formato para los valores del eje Y. | STRING | 0000.0 | S | N | ||
YAxisLabel | Se muestra el rótulo de texto del eje Y. | STRING | Eje Y | S | S | ||
YAxisLabelAlignment | Permite alinear el rótulo del eje Y según los valores de Izquierda, Derecha o Centro. | STRING | Izquierda | N | N | ||
YAxisMaximumValues | Permite definir el rango máximo para los valores del eje Y. Por defecto, el rango se calcula automáticamente en función de los datos del widget. El valor de esta propiedad se desestima si los datos del gráfico contienen un valor mayor. | STRING | n/d | S | N | ||
YAxisMinimumValues | Permite definir el rango mínimo para los valores del eje Y. Por defecto, el rango se calcula automáticamente en función de los datos del widget. El valor de esta propiedad se desestima si los datos del gráfico contienen un valor inferior. | STRING | n/d | S | N |