Configuración de Gráficos del Explorador de Datos

Para algunas zonas del Explorador de Datos, es más eficaz desplegar los resultados en forma gráfica, como en un gráfico de líneas o tipo torta. Los parámetros de opciones de visualización permiten integrar la configuración del gráfico con la zona del Explorador de Datos que recupera los datos.

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

  • Grilla: Despliega los datos en una grilla standard del Explorador de Datos
  • Gráfico: Despliega los datos en forma de gráfico
  • Mapa: Permite invocar un Mapa de Interface de Usuario para desplegar los datos

Se pueden especificar hasta cinco parámetros de opciones de visualización. Una de las opciones debe ser la grilla standard, que permite un máximo de cuatro opciones gráficas. La zona desplegará los íconos correspondientes a los tipos de visualización de modo que usted pueda alternar entre las distintas visualizaciones. Estos íconos se presentan en el mismo orden en que están definidos en la lista de parámetros.

Nota: Si la única opción de despliegue es una grilla standard, no es necesario especificar la grilla como parámetro de visualización.

Los parámetros de opciones de visualización se proporcionan en los tipos de zona Explorador de Datos de Información: SQL Único (F1–DE-SINGLE) y Explorador de Datos de Información: Múltiples SQLs (F1–DE).

Configuración de Parámetros de Opciones de Visualización

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

Para una grilla, el mnemotécnico es "optiontype=GRID". No se requieren otros mnemotécnicos.

Para un mapa, los mnemotécnicos son "optiontype=MAP map=MAP_​CD schemaPath=xpath", donde "MAP_​CD" es la ID del Mapa de Interface de Usuario y "xpath" es la ruta de acceso al esquema del Mapa de Interface de Usuario. En la mayoría de los casos de uso, los elementos del esquema estarán asociados con el juego de resultados del Explorador de Datos, en cuyo caso no se necesita ningún mnemotécnico schemaPath. Si el esquema del Mapa de Interface de Usuario tiene elementos adicionales presentes, el atributo schemaPath definirá el nodo de grupo en el que se copiará la información del Explorador de Datos.

Para un gráfico, el mnemotécnico de tipo de opción es "optiontype=CHART". Luego, se muestran los atributos de configuración del gráfico adecuados, que se describen en la siguiente sección.

Configuración de Gráfico

Los siguientes atributos se utilizan para configurar una representación gráfica de un juego de datos.

El atributo "oraChart:" define el tipo de gráfico que se desplegará y su configuración general. El juego de parámetros de configuración disponibles 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 debe desplegar.

Requerido

showLegend:

true

false

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

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).

Si se define la posición en left o right, la leyenda se presenta de manera vertical automáticamente.

Si se define la posición en top o bottom, la leyenda se presenta de manera horizontal automáticamente.

legendBorder:

true

false

Define si la leyenda debe desplegarse con un borde alrededor.

Opcional (el valor por defecto es false).

depth:

true

false

El valor true indica un gráfico con profundidad tridimensional.

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

animate:

true

false

El valor true indica que el gráfico se debe animar al desplegarse.

Opcional (el valor por defecto es true). Cuando use juegos de datos de gran tamaño, considere desactivar la animación.

dataCursor:

on

off

El valor on permite pasar el puntero por cualquier parte del gráfico.

Opcional (el valor por defecto es off). No se aplica a los gráficos tipo torta.

orientation:

horizontal

Define la orientación del gráfico. Esto solo se aplica gráficos de barra, de líneas, de área y combinados.

Por ejemplo, oraChart="type:cluster; orientation:horizontal" define un gráfico de columnas 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 cinco de estos atributos, con los siguientes mnemotécnicos:

  • oraChartSeries1
  • oraChartSeries2
  • oraChartSeries3
  • oraChartSeries4
  • oraChartSeries5

Los gráficos apilados admiten un número ilimitado de series mediante la adición reiterada de atributos oraChartSeries6 y superiores, pero tenga cuidado con el impacto en el rendimiento y los límites de memoria cuando use un número de series excesivamente alto. Todos los atributos son idénticos en cuanto al formato y aceptan los mismos parámetros, como se describe debajo.

Nota: Todos los gráficos requieren oraChartSeries1. Los gráficos apilados, de columnas y de líneas pueden incluir, de manera opcional, atributos de series adicionales (para múltiples barras/líneas).

Si se definen múltiples series, se deben proporcionar datos para todas las series definidas. Los importes de los datos pueden ser iguales a 0 (cero), pero deben estar presentes para que el gráfico se despliegue correctamente.

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

Parámetro

Valores

Descripción

list:

Valor de XPath

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

Requerido únicamente para definiciones HTML en Mapas de Interface de Usuario. Los valores del Explorador de Datos se derivan de las columnas de la zona.

amount:

Cn

Pn

Valor de XPath

Define el elemento que contiene la cantidad que se debe desplegar en el gráfico. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se debe especificar la XPath del elemento.

Requerido

xaxis:

Cn

Pn

Valor de XPath

Define el elemento que contiene los datos del eje x. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se especifica la XPath del elemento.

Requerido para gráficos Apilados, de Columnas, de Líneas, de Área 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 que se define en el perfil de despliegue del usuario.

En el caso de localDate o string, los datos se despliegan como están, sin ningún formato especial.

Opcional (el valor por Defecto es date).

label:

Valor de texto

Define la etiqueta para el importe que se debe desplegar en el gráfico.

Se debe definir este valor o labelPath:.

labelPath:

Cn

Pn

Valor de XPath

Define el elemento que proporciona la etiqueta para la cantidad que se debe desplegar en el gráfico. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se debe especificar la XPath del elemento.

Se debe definir este valor o label:.

currency:

Un código de Divisa válido

Define el código de divisa para el importe que se debe desplegar 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 debe desplegar en el gráfico. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se debe especificar la XPath del elemento.

Opcional.

hoverText:

Valor de texto

Define la ayuda contextual para el elemento del gráfico.

Opcional (la ayuda contextual por defecto siempre está disponible). Se ignora si se define hoverTextPath:.

Las siguientes variables de sustitución están disponibles.

  • $label, que se sustituye con el texto de etiqueta según lo determinado por la configuración de label: o labelPath:.
  • $amount, que se sustituye con el texto de importe según lo especificado por la configuración de amount:.
  • $axis, que se sustituye con el texto del eje X.
  • $%, que se sustituye con la "porción" de porcentaje del gráfico de barra o tipo torta.
  • $newline, que genera un salto de línea.

Si la ayuda contextual contiene cualquiera de los valores anteriores, estos se sustituyen por el texto equivalente antes de desplegarse.

Ejemplo:

"hoverText:$label$newline$amount"

hoverTextPath:

Cn

Pn

Valor de XPath

Define el elemento que proporciona la ayuda contextual para el elemento del gráfico. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se debe especificar la XPath del elemento.

La ayuda contextual del elemento puede utilizar todas las funcionalidades de sustitución mencionadas anteriormente 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 se debe presentar cada serie en el gráfico combinado.

En el siguiente ejemplo, se define un gráfico combinado en el que se presenta una serie en forma de barras y la otra en forma de área.

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

navOpt:

Un código de Opción de Navegación válido.

Define una opción de navegación para que se active cuando se haga click en el elemento del gráfico.

Opcional.

navOptPath:

Cn

Pn

Valor de XPath

Define el elemento que proporciona la opción de navegación que se activará cuando se haga click en el elemento del gráfico. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se debe especificar la XPath del elemento.

Opcional

Tenga en cuenta que tanto navOpt: como navOptPath: se pueden configurar. La opción de navegación navOptPath: se procesa en primer lugar. Si se encuentra un valor, se lo usa; de lo contrario, se usa el valor de la configuración navOpt:. Esto significa que la definición del gráfico puede incluir una opción de navegación por defecto, que será sustituida por la opción de navegación presente en los datos.

key:

Cn

Pn

Valor de XPath

Define el elemento que contiene los datos de campo clave que se utilizarán en una opción de navegación. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se debe especificar la XPath del elemento.

Esto se requiere si se define navOpt: o navOptPath:.

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

script:

Un nombre de script de Asistente de Proceso de Negocios

Define un script de Asistente de Proceso de Negocios para que se active cuando se haga click en el elemento del gráfico.

Opcional

Cuando se ejecuta un script, todos los elementos de los datos del gráfico quedan disponibles para el script como variables temporarias.

scriptPath:

Cn

Pn

Valor de XPath

Define el elemento que proporciona el script de Asistente de Proceso de Negocios que se activará cuando se haga click en el elemento del gráfico. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se debe especificar la XPath del elemento.

Opcional

Tenga en cuenta que tanto script: como scriptPath: se pueden configurar. La opción de script scriptPath: se procesa en primer lugar. Si se encuentra un valor, se lo usa; de lo contrario, se usa el valor de la configuración script:. Esto significa que la definición del gráfico puede incluir un script por defecto, que será sustituido por el script presente en los datos.

color:

Código de Color HTML / valor RGB

Opcional (se aplican los colores por defecto).

Define el color para la serie. El formato es un código de color HTML válido, por ejemplo, green o blue. En este enlace, se definen todos los nombres de colores válidos: http://www.w3schools.com/htmL/html_​colornames.asp.

De forma alternativa, se puede usar un formato RGB. (00FF00 es verde y 0000FF es azul).

Nota: Consulte Contraste de Color para obtener información sobre el uso del color "rojo" HTML y su impacto en la accesibilidad.

colorPath:

Cn

Pn

Valor de XPath

Define el elemento que contiene un color para la serie. Para los Exploradores de Datos, este será un identificador de columna de postprocesamiento o SQL. Para las definiciones HTML, se debe especificar la XPath del elemento.

Se aplican los formatos válidos que se describen en la configuración color:.

Opcional (se aplican los colores por defecto).

pieColors:

Código de color HTML / valores RGB

Define los colores para la serie de gráfico tipo torta. 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 (si la serie excede los valores especificados, se aplican los colores por defecto).

El atributo oraChartBroadcast: ofrece la capacidad de difundir un valor desde un gráfico al contexto del 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 es el nombre del campo de contexto del portal que se difundirá y Cn (o Pn) es el elemento que contiene el valor de los datos que se difundirá. La difusión se activa al hacer click en la sección correspondiente del gráfico.

Para las definiciones HTML en Mapas de Interface de Usuario, la sintaxis es oraChartBroadcast="FIELD_​NAME1:xpath1;FIELD_​NAME2:xpath2;", donde "xpathn" es el elemento del esquema de lista que contiene el valor de los datos que se difundirá.

Ejemplos de Configuración de Zonas

Zona con un gráfico tipo torta simple

En este ejemplo, el SQL de zona resume las Tareas por Rol. Las definiciones de las columnas son:

  • C1: descripción de rol

  • C2: recuento de Tareas por rol

  • C3: ID de rol

Opción de Visualización 1

Esta opción muestra las Tareas por Rol en forma de un gráfico tipo torta. La ID de rol se difundirá al portal cuando se haga click en la sección correspondiente del gráfico tipo torta.

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

Zona con dos tipos de gráficos

En este ejemplo, el SQL de zona resume las Tareas por Prioridad y también calcula recuentos separados por estado de Tarea dentro de la prioridad. Las definiciones de las columnas son:

  • C1: descripción de prioridad

  • C2: recuento de Tareas por prioridad

  • C3: valor del indicador de prioridad

  • C4: recuento de Tareas Abiertas por prioridad

  • C5: recuento de Tareas en Progreso por prioridad

  • C6: Etiqueta para la barra de Tareas Abiertas en el gráfico de columnas

  • C7: Etiqueta para la barra de Tareas en Progreso en el gráfico de columnas

Opción de Visualización 1

Esta opción muestra las Tareas por Prioridad en forma de un gráfico tipo torta. El valor de prioridad se difundirá al portal cuando se haga click en la sección correspondiente del gráfico tipo torta.

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 Tareas por Prioridad como un gráfico de columnas con dos series de datos, una para las Tareas Abiertas y otra para las Tareas en Progreso. El valor de prioridad correspondiente se difundirá al portal al hacer click en la barra Abiertas o En progreso del gráfico de columnas.

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"