Configuración de gráfico del explorador de datos

En el caso de algunas zonas del explorador de datos, puede resultar más eficaz mostrar los resultados en un gráfico circular o de líneas, por ejemplo. Los parámetros de opciones de visualización permiten integrar la configuración del gráfico en la zona del explorador de datos que recupera la información.

Los parámetros de opciones de visualización soportan tres opciones:

  • Cuadrícula: muestra los datos en forma de una cuadrícula del explorador de datos estándar.
  • Gráfico: muestra los datos en forma de gráfico.
  • Mapa: ofrece la posibilidad de llamar a un mapa de UI para mostrar los datos.

Se puede especificar un máximo de cinco parámetros de opciones de visualización. Una de las opciones deberá ser la cuadrícula estándar, lo que deja un máximo restante de cuatro opciones gráficas. En la zona aparecerán los iconos correspondientes a los tipos de visualización, que permitirán cambiar entre distintas vistas. Estos iconos aparecen en el mismo orden en el que se han definido en la lista de parámetros.

Nota: si la única opción de visualización es una cuadrícula estándar, no será necesario especificar el valor de cuadrícula como parámetro de visualización.

Los parámetros de opciones de visualización se incluyen en los tipos de zona Explorador de datos de información - SQL único (F1–DE-SINGLE) y Explorador de datos de información - Varios SQL (F1–DE).

Configuración de parámetros de opciones de visualización

Se utilizan abreviaciones nemotécnicas para definir los atributos de un tipo de opción dentro del valor de parámetro.

Para una cuadrícula, la abreviación nemotécnica será ‘optiontype=GRID’. No son necesarias otras abreviaciones nemotécnicas.

En el caso del mapa, la abreviación nemotécnica será ‘optiontype=MAP map=MAP_​CD schemaPath=xpath’, donde ‘MAP_​CD’ corresponderá al ID del mapa de UI y ‘xpath’ será la ruta de acceso del esquema de dicho mapa. En la mayor parte de los casos de uso, los elementos del esquema coincidirán con el juego de resultados del explorador de datos, en cuyo caso no será necesaria la abreviación nemotécnica schemaPath. Si el esquema de mapa de UI incluye elementos adicionales, el atributo schemaPath definirá el nodo de grupo donde se copiará la información del explorador de datos.

En el caso de un gráfico, la abreviación nemotécnica de tipo de opción será ‘optiontype=CHART’. Irá seguida de los atributos de configuración de gráfico adecuados, que se describen en la siguiente sección.

Configuración de gráfico

Para configurar una representación gráfica de un juego de datos, se utilizan los atributos siguientes.

El atributo ‘oraChart:’ define el tipo de gráfico que se mostrará, así como la configuración general. El juego de parámetros de configuración disponible para este atributo es el siguiente:

Parámetro

Valores

Descripción

type:

pie

stacked

cluster

line

area

combo

Define el tipo de gráfico que se mostrará.

Necesario

showLegend:

true

false

Define si el gráfico debe tener una leyenda mostrada.

Opcional (el valor por defecto es true)

legendPosition:

left

right

bottom

top

Define dónde debe aparecer la leyenda.

Opcional (el valor por defecto es right)

Al definir la posición en left o right, se representará de modo automático en vertical.

Al definir la posición en top o bottom, se representará de modo automático en horizontal.

legendBorder:

true

false

Define si la leyenda se mostrará con un borde alrededor.

Opcional (el valor por defecto es false)

depth:

true

false

El valor true indica una profundidad tridimensional para el gráfico.

Opcional (por defecto false, que es un gráfico bidimensional)

animate:

true

false

El valor true indica que el gráfico debe animarse cuando se muestre.

Opcional (el valor por defecto es true). Si usa grandes juegos de datos, considere desactivar la animación.

dataCursor:

on

off

El valor on activa el texto desplegable en cualquier lugar del gráfico.

Opcional (el valor por defecto es off). No es aplicable a los gráficos circulares.

orientation:

horizontal

Define la orientación del gráfico. Solo se aplica a los gráficos de barras, líneas, área y combinados.

Por ejemplo, oraChart="type:cluster; orientation:horizontal" define un gráfico de grupo horizontal.

Opcional (el valor por defecto es vertical).

El atributo oraChartSeries define la información de origen para el gráfico. La mayoría de los gráficos soportan 5 de estos atributos, con las abreviaciones nemotécnicas siguientes:

  • oraChartSeries1
  • oraChartSeries2
  • oraChartSeries3
  • oraChartSeries4
  • oraChartSeries5

Los gráficos de barras apiladas soportan un número ilimitado de series añadiendo atributos oraChartSeries6 y superiores, pero tenga en cuenta las implicaciones del rendimiento y los límites de memoria al usar un número de series excesivamente alto. Todos los atributos son idénticos en formato y aceptan los mismos parámetros, descritos a continuación.

Nota: todos los gráficos requieren oraChartSeries1. Los gráficos de barras apiladas, grupos y líneas pueden incluir los atributos de series adicionales (para múltiples barras/líneas).

Si define múltiples series, deben proporcionarse datos para todas las series definidas. Las cantidades de datos pueden ser 0 (cero), pero tienen que estar presentes para que el gráfico se muestre de forma correcta.

El juego de parámetros de configuración disponible para el atributo oraChartSeriesN es el siguiente:

Parámetro

Valores

Descripción

list:

Valor de Xpath

Define el XPath de la lista en el XML que contiene los datos del gráfico.

Solo es necesario para las definiciones HTML de los mapas de UI. Los valores del explorador de datos se derivan a partir de las columnas de la zona.

amount:

Cn

Pn

Valor de Xpath

Define el elemento que contiene el importe que se mostrará en el gráfico. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, deberá especificarse la XPath del elemento.

Necesario

xaxis:

Cn

Pn

Valor de Xpath

Define el elemento que contiene los datos del eje X. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, se especificará la XPath del elemento.

Obligatorio para los gráficos de barras apiladas, grupos, líneas, áreas y combinados.

xaxisFormat:

date

dateTime

time

localDate

string

Define el formato de datos del eje X.

Si es date, dateTime o time, el valor se presenta en el formato definido en el perfil de visualización del usuario.

En el caso delocalDate o string, los datos se muestran sin ningún formato especial.

Opcional (el valor por defecto es date).

label:

Valor de texto

Define la etiqueta para la cantidad que se mostrará en el gráfico.

Es necesario definir este valor o labelPath:.

labelPath:

Cn

Pn

Valor de Xpath

Define el elemento que proporciona la etiqueta para el importe que se mostrará en el gráfico. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, deberá especificarse la XPath del elemento.

Es necesario definir este valor o label:.

currency:

Un código de divisa válido

Define el código de divisa para la cantidad que se mostrará en el gráfico.

Opcional.

currencyPath:

Cn

Pn

Valor de Xpath

Define el elemento que proporciona el código de divisa para el importe que se mostrará en el gráfico. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, deberá especificarse la XPath del elemento.

Opcional.

hoverText:

Valor de texto

Define el texto desplegable para el elemento de gráfico.

Opcional (siempre hay disponible un texto desplegable por defecto). Ignorado si hoverTextPath: está definido.

Están disponibles las variables de sustitución siguientes.

  • $label: se sustituirá por el texto de la etiqueta determinado por el valor de label: o labelPath:.
  • $amount: se sustituirá por el texto de cantidad especificado por el valor de amount:.
  • $axis: se sustituirá por el texto del eje X.
  • $%: se sustituirá por la "división" de porcentaje del gráfico circular o de barras.
  • $newline: forzará un salto de línea.

Si el texto desplegable definido contiene cualquiera de los valores anteriores, serán sustituidos por el texto equivalente antes de mostrarse.

Ejemplo:

"hoverText:$label$newline$amount"

hoverTextPath:

Cn

Pn

Valor de Xpath

Define el elemento que proporciona el texto desplegable para el elemento de gráfico. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, deberá especificarse la XPath del elemento.

El texto desplegable del elemento puede utilizar toda la funcionalidad de sustitución antes indicada en la descripción de hoverText:.

Opcional.

type:

bar

line

area

Este atributo solo se usa para el tipo de gráfico combinado. Define cómo debe representarse cada serie del gráfico combinado.

En el siguiente ejemplo se define un gráfico combinado, en el que una serie se representa como barras y otra como área.

oraChart="type:combo;" 
oraChartSeries1="xaxis:C3; 
label:C2; amount:C1;type:bar" 
oraChartSeries2="xaxis:C3; 
label:C2; amount:C1;type:area"

navOpt:

Código de opción de navegación.

Define una opción de navegación que se activará al pulsar el elemento gráfico.

Opcional.

navOptPath:

Cn

Pn

Valor de Xpath

Define el elemento que incluye la opción de navegación para activarse al pulsar el elemento gráfico. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, deberá especificarse la XPath del elemento.

Opcional

Tenga en cuenta que pueden configurarse navOpt: y navOptPath:. En primer lugar, se procesa la opción de navegación navOptPath:. Si se encuentra un valor, se utiliza; de lo contrario, se usa el valor de navOpt:. Esto significa que la definición de gráfico puede incluir una opción de navegación por defecto y otra presente en los datos para sustituirla.

key:

Cn

Pn

Valor de Xpath

Define el elemento que contiene los datos de campo clave que se utilizarán en la opción de navegación. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, deberá especificarse la XPath del elemento.

Esto es necesario si navOpt: o navOptPath: están definidos.

Nota: solo se puede configurar un campo clave para una opción de navegación.

script:

Un nombre de script del ayudante de proceso de negocio

Define el script de ayudante de proceso de negocio que se activará al pulsar el elemento gráfico.

Opcional

Cuando se ejecuta un script, todos los elementos de los datos de gráfico estarán a disposición del script como variables temporales.

scriptPath:

Cn

Pn

Valor de Xpath

Define el elemento que incluye el script de ayudante de proceso de negocio para activarse al pulsar el elemento gráfico. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, deberá especificarse la XPath del elemento.

Opcional

Tenga en cuenta que pueden configurarse script: y scriptPath:. En primer lugar, se procesa la opción de script scriptPath:. Si se encuentra un valor, se utiliza; de lo contrario, se usa el valor de script:. Esto significa que la definición de gráfico puede incluir un script por defecto y otro presente en los datos para sustituirlo.

color:

Código de color HTML/valor RGB

Opcional (se aplican los colores por defecto)

Define el color de la serie. El formato es un código de color HTML válido como, por ejemplo green (verde) o blue (azul). Todos los nombres de colores válidos están definidos en este enlace: http://www.w3schools.com/htmL/html_​colornames.asp.

También se puede utilizar el formato RGB. (00FF00 correspondería al color verde y 0000FF al azul).

Nota: para obtener información sobre el uso del color 'red' HTML (rojo) y cómo afecta a la accesibilidad, consulte Contraste de color.

colorPath:

Cn

Pn

Valor de Xpath

Define el elemento que contiene un color para la serie. En el caso de los exploradores de datos, será un SQL o un identificador de columna posprocesamiento. En el caso de las definiciones HTML, deberá especificarse la XPath del elemento.

Se aplican los formatos válidos tal y como se describen en el valor de color:.

Opcional (se aplican los colores por defecto)

pieColors:

Código de color HTML/valor RGB

Define los colores de la serie circular. Se puede especificar cualquier número de códigos de color HTML o valores de color RGB, separados por espacios. Ejemplos:

pieColors: green blue
pieColors: 00FF00 0000FF

Opcional (se aplican los colores por defecto si la serie supera los valores especificados).

El atributo oraChartBroadcast: permite difundir un valor de un gráfico al contexto de portal. Se puede difundir un número ilimitado de campos, configurados como pares de nombre/valor; por ejemplo: oraChartBroadcast="FIELD_​NAME1:C1;FIELD_​NAME2:C2;" donde FIELD_​NAMEn será el nombre del campo de contexto de portal para su difusión y Cn (o Pn) será el elemento que contiene el valor de datos que difundir. La difusión se dispara pulsando la sección correspondiente del gráfico.

En el caso de las definiciones HTML de los mapas de UI, la sintaxis será oraChartBroadcast="FIELD_​NAME1:xpath1;FIELD_​NAME2:xpath2;" donde ‘xpathn’ es el elemento del esquema de lista que contiene el valor de datos para difundir.

Ejemplos de configuración de zona

Zona con un gráfico circular simple

En este ejemplo, el SQL de zona resume las entradas de tarea por rol. Las definiciones de columna son:

  • C1 - descripción de rol

  • C2 - recuento de entradas de tarea por rol

  • C3 - ID de rol

Opción de visualización 1

Esta opción muestra las entradas de tarea por rol, en forma de gráfico circular. El ID de rol se difundirá al portal cuando se pulse la sección correspondiente del gráfico circular.

optiontype=CHART
oraChart="type:pie;"
oraChartSeries1="labelPath:C1; amount:C2;hoverText:$label$newline$amount;"
oraChartBroadcast="ROLE_ID:C3"

Zona con dos tipos de gráfico

En este ejemplo, el SQL de zona resume las entradas de tarea por prioridad, además de calcular los recuentos independientes por estado de tarea según prioridad. Las definiciones de columna son:

  • C1 - descripción de prioridad

  • C2 - recuento de entradas de tarea por prioridad

  • C3 - valor de indicador de prioridad

  • C4 - recuento de tareas abiertas por prioridad

  • C5 - recuento de tareas en proceso por prioridad

  • C6 - etiqueta para la barra de tareas abiertas en el gráfico de grupo

  • C7 - etiqueta para la barra de tareas en proceso en el gráfico de grupo

Opción de visualización 1

Esta opción muestra las entradas de tarea por prioridad, en forma de gráfico circular. El valor de prioridad se difundirá al portal cuando se pulse la sección correspondiente del gráfico circular.

optiontype=CHART
oraChart="type:pie; legendBorder:true;"
oraChartSeries1="labelPath:C1; amount:C2;hoverText:$label$newline$amount;"
oraChartBroadcast="TD_PRIORITY_FLG:C3"

Opción de visualización 2

Esta opción muestra las entradas de tarea por prioridad, como un gráfico de grupo con dos series de datos, una de ellas para las tareas abiertas y otra para las que están en proceso. El valor de prioridad correspondiente se difundirá al portal al pulsar en los estados Abierto o En proceso de la barra del gráfico de grupo.

optiontype=CHART oraChart="type:cluster;  showLegend:true;" 
oraChartSeries1="xaxis:C1; xaxisFormat:string; labelPath:C6; amount:C4;hoverText:$label$newline$amount;"
oraChartSeries2="xaxis:C1; xaxisFormat:string; labelPath:C7; amount:C5;hoverText:$label$newline$amount;"
oraChartBroadcast="TD_PRIORITY_FLG:C3"