Usar gráficos en comunicaciones interactivas using-charts-in-interactive-communications

Un gráfico es una representación visual de los datos. Condensa grandes cantidades de información en un formato visual fácil de entender, lo que permite a los destinatarios de la comunicación interactiva visualizar, interpretar y analizar mejor los datos complejos.

Mientras crea una comunicación interactiva, puede agregar gráficos para representar visualmente los datos bidimensionales del modelo de datos de formulario de la comunicación interactiva. El componente Gráfico permite agregar y configurar los siguientes tipos de gráficos: Circular, Columna, Anillo, Barra, Línea, Línea y Punto, Punto, Área y Cuadrante.

Agregar y configurar un gráfico en una comunicación interactiva add-and-configure-chart-in-an-interactive-communication

Realice los siguientes pasos para agregar y configurar un gráfico en una comunicación interactiva:

  1. Seleccione Componentes de la barra de tareas de la comunicación interactiva.

  2. Arrastre y suelte el componente Gráfico a uno de los siguientes componentes:

    • Canal de impresión: área de destino o campo de imagen
    • Canal web: panel o área de destino
  3. Seleccione el componente de gráfico en el editor de comunicaciones interactivas y seleccione Configurar ( configure_icon ) en la barra de herramientas Componente.

    Las propiedades del gráfico se mostrarán en el panel izquierdo.

    Propiedades básicas de un gráfico de tipo línea en el canal Imprimir

    Propiedades básicas de un gráfico de tipo línea en el canal Imprimir

    Propiedades básicas de un gráfico de tipo línea en el canal Web

    Propiedades básicas de un gráfico de tipo línea en el canal Web

  4. Configure las propiedades del gráfico en función del tipo de canal.

  5. (Solo canal Imprimir) En la Configuración de Agente, especifique si es obligatorio que el agente use este gráfico. Si la opción t es obligatoria para que el agente use este gráfico no está seleccionada, el agente puede seleccionar el icono en forma de ojo para el gráfico en la ficha Contenido de la interfaz de usuario del agente para mostrar u ocultar el gráfico.

    chart_agentproperties

  6. Seleccione done_icon para guardar las propiedades del gráfico.

    Seleccione Vista previa para ver el aspecto y los datos asociados con el gráfico. Seleccione Editar para volver a configurar las propiedades del gráfico.

Configurar las propiedades del gráfico configure-chart-properties

Configurar las siguientes propiedades al crear gráficos para imprimir o para canales web:

Campo
Descripción
Tipo de canal
Nombre
Identificador del elemento del gráfico. El nombre del gráfico especificado en este campo no será visible en el gráfico. Se utiliza al hacer referencia al elemento desde otros componentes, scripts y expresiones SOM.
Impresa y web
Tipo de gráfico
Tipo de gráfico que desea generar. Las opciones disponibles son Circular, Columna, Anillo, Barra, Línea, Línea y punto, Punto y Área.
Impresa y web
Series > Varias series
Seleccione esta opción para agregar varias series para los elementos de recopilación del modelo de datos de formulario trazados en el eje X y el eje Y.
Impresa y web
Series > Objeto del modelo de datos
Nombre del elemento de recopilación del modelo de datos de formulario para agregar varias series al gráfico.
Elija una propiedad de objeto del modelo de datos del formulario principal para las propiedades trazadas en el eje X y en el eje Y para formar una serie significativa. El objeto del modelo de datos que enlace debe ser de tipo Número, Cadena o Fecha.
Impresa y web
Mostrar apilados
Seleccione para apilar los valores de cada serie uno encima de otro.
Impresa y web
Eje X > Título
Título para el eje X
Impresa y web
Eje X > Objeto del modelo de datos

Nombre del elemento de recopilación del modelo de datos de formulario que se va a trazar en el eje X.

Elija dos propiedades de tipo colección/matriz del mismo objeto del modelo de datos principal que tengan sentido en relación mutua para trazar en el eje X e Y de un gráfico. El objeto del modelo de datos que enlace debe ser de tipo Número, Cadena o Fecha.

Impresa y web
Eje Y > Título
Título para el eje Y
Impresa y web
Eje Y > Objeto del modelo de datos

Elemento de colección del modelo de datos de formulario que se va a trazar en el eje Y. En el canal Imprimir, el objeto del modelo de datos para el eje Y debe ser del tipo Número.

Elija dos propiedades de tipo colección/matriz del mismo objeto del modelo de datos principal que tengan sentido en relación mutua para trazar en el eje X e Y de un gráfico.

Impresa y web
Eje Y > Función
Función estadística/personalizada que se utilizará para calcular los valores en el eje Y.
Impresa y web
Ocultar objeto
Seleccione para ocultar el gráfico en la salida final.
Impresa y web
Título
Título del gráfico.
Impresa
Altura
Altura del gráfico en píxeles.
Impresa
Anchura
Anchura del gráfico en píxeles. Puede controlar la anchura del gráfico en el canal Web mediante la capa de estilo o al aplicar una temática.
Impresa
Salto de página obligatorio anterior
Seleccione para agregar un salto de página obligatorio antes del gráfico y coloque el gráfico sobre una página nueva.
Impresa
Salto de página obligatorio posterior
Seleccione para agregar un salto de página obligatorio después del gráfico y coloque el contenido que sigue al gráfico en la parte superior de una página nueva.
Impresa
Sangría
Sangría del gráfico desde la izquierda de la página.
Impresa
Información del objeto

Formato en el que aparece la información del objeto al pasar el ratón sobre un punto de datos del gráfico en el canal Web. El valor predeterminado es ${x}(${y}). Según el tipo de gráfico, cuando el ratón señala un punto, barra o fracción del gráfico, las variables ${x} y ${y} se reemplazarán dinámicamente con los valores correspondientes del eje X y del eje Y y se mostrarán en la información del objeto.

Para deshabilitar la información del objeto, deje Información del objeto en blanco. Esta opción no se aplica a los gráficos de líneas y áreas. Por ejemplo, consulte Ejemplo 1: Salida de gráfico en imprimir y web.

Web
Configuraciones específicas de gráficos

Además de las configuraciones comunes, están disponibles las siguientes configuraciones específicas del gráfico:

  • Mostrar leyenda: muestra una leyenda para el gráfico circular o de anillo cuando está habilitada.
  • Posición de la leyenda: especifica la posición del pie de ilustración con respecto al gráfico. Las opciones disponibles son Derecha, Izquierda, Superior e Inferior. Utilice la leyenda del lado derecho en el canal Imprimir.
  • Radio interior: disponible para gráficos de anillo para especificar el radio (en píxeles) del círculo interior del gráfico.
  • Color de línea: disponible para gráficos de líneas, líneas y puntos y áreas para especificar el color de la línea del gráfico.
  • Color de punto: disponible para gráficos de puntos y líneas y puntos para especificar el color de los puntos del gráfico.
  • Color de área: disponible para gráficos de área para especificar el color del área bajo la línea del gráfico.
  • Punto de referencia > Tipo de enlace: disponible para gráficos de cuadrante para especificar el tipo de enlace para el punto de referencia. Utilice la propiedad de objeto de texto estático o modelo de datos para definir el valor del punto de referencia.
  • Punto de referencia > Eje X: Disponible para gráficos de cuadrante si selecciona Estático en la lista desplegable Tipo de enlace para especificar el valor del eje X para el punto de referencia.
  • Punto de referencia > Eje Y: Disponible para gráficos de cuadrante si selecciona Estático en la lista desplegable Tipo de enlace para especificar el valor del eje Y para el punto de referencia.
  • Punto de referencia > Objeto del modelo de datos de la serie: Disponible para varias series de Gráficos de cuadrante si selecciona Objeto del modelo de datos en la lista desplegable Tipo de enlace. Defina la propiedad del objeto del modelo de datos de formulario para identificar la serie del punto de referencia.
  • Punto de referencia > Valor del objeto del modelo de datos para la serie: Disponible para varias series de Gráficos de cuadrante si selecciona Objeto del modelo de datos en la lista desplegable Tipo de enlace. Utilice la propiedad del objeto del modelo de datos de formulario de la serie y el valor definidos en este campo para identificar la serie del punto de referencia.
  • Punto de referencia > Objeto del modelo de datos para punto de referencia: Disponible para gráficos de cuadrante si selecciona Objeto del modelo de datos en la lista desplegable Tipo de enlace. Defina una propiedad de objeto del modelo de datos de formulario que sea similar a las propiedades trazadas en los ejes X e Y. Además, para varias series, defina una propiedad de objeto del modelo de datos que sea una entidad secundaria de la propiedad de objeto del modelo de datos definida para la serie.
  • Punto de referencia > Valor del objeto del modelo de datos para el punto de referencia: Disponible para gráficos de cuadrante si selecciona Objeto del modelo de datos en la lista desplegable Tipo de enlace. Utilice la propiedad del objeto del modelo de datos de formulario para el punto de referencia y el valor definido en este campo para identificar el punto de referencia del gráfico.
    Etiquetas de cuadrantes > Superior izquierdo: disponible para gráficos de cuadrantes para especificar el nombre del cuadrante superior izquierdo.
  • Etiquetas de cuadrantes > Superior derecho: disponible para gráficos de cuadrantes para especificar el nombre del cuadrante superior derecho.
  • Etiquetas de cuadrantes > Inferior derecho: disponible para gráficos de cuadrantes para especificar el nombre del cuadrante inferior derecho.
  • Etiquetas de cuadrantes > Inferior izquierdo: disponible para gráficos de cuadrantes para especificar el nombre del cuadrante inferior izquierdo.
Impresa y web

Usar funciones en el gráfico use-functions-in-chart

Puede configurar un gráfico para que utilice funciones estadísticas a fin de calcular los valores a partir de los datos de origen para trazar en el gráfico. Al aplicar funciones en un gráfico, se pueden representar datos que el modelo de datos de formulario no proporciona directamente.

Funciones en gráficos

Aunque el componente Gráfico incluye algunas funciones integradas, puede escribir funciones personalizadas y hacer que estén disponibles para su uso en la configuración de gráficos del canal Web.

Las siguientes funciones están disponibles de forma predeterminada con el componente Gráfico:

Media (media) Devuelve la media de los valores del eje X o Y para un valor determinado del otro eje.

Suma Devuelve la suma de todos los valores del eje X o Y para un valor determinado del otro eje.

Máximo Devuelve el máximo de los valores del eje X o Y para un valor determinado del otro eje.

Frecuencia Devuelve el número de valores en el eje X o Y para un valor determinado del otro eje.

Rango Devuelve la diferencia entre el máximo y el mínimo de los valores del eje X o Y para un valor determinado del otro eje.

Mediana Devuelve el valor que separa los valores más altos e inferiores a la mitad en los ejes X o Y para un valor determinado en el otro eje.

Mínimo Devuelve el mínimo de los valores del eje X o Y para un valor determinado del otro eje.

Modo Devuelve el valor con la mayoría de las incidencias en el eje X o Y para un valor determinado en el otro eje.

Para obtener más información, consulte Ejemplo 2: Aplicar las funciones Suma y Frecuencia en un gráfico de líneas.

Funciones personalizadas en el canal Web customfunctionsweb

Además de utilizar las funciones predeterminadas en los gráficos, puede escribir funciones personalizadas en JavaScript™ y ponerlas a disposición en la lista de funciones del componente Gráfico para el canal Web.

Una función toma una matriz o valores y un nombre de categoría como entradas y devuelve un valor. Por ejemplo:

Multiply(valueArray, category) {
 var val = 1;
 _.each(valueArray, function(value) {
 val = val * value;
 });
 return val;
}

Una vez que haya escrito una función personalizada, haga lo siguiente para que esté disponible para usarla en la configuración del gráfico:

  1. Agregue la función personalizada en la biblioteca de cliente asociada a la comunicación interactiva correspondiente. Para obtener más información, consulte Configurar la acción Enviar y Usar bibliotecas del lado del cliente.

  2. Para mostrar la función personalizada en la lista desplegable Función, en CRXDe Lite, cree un nodo nt:unstructured en la carpeta apps con las siguientes propiedades:

    • Agregar propiedad guideComponentType con valor como fd/af/reducer. (obligatorio)

    • Agregue la propiedad value a un nombre completo de la función personalizada JavaScript™. (obligatorio) y establezca su valor en el nombre de la función personalizada, como Multiplicar.

    • Agregue la propiedad jcr:description con el valor que desea mostrar como nombre de la función personalizada que aparece en la lista desplegable Función. Por ejemplo, Multiplicar.

    • Agregue la propiedad qtip con valor que será una breve descripción de la función personalizada. Aparece como información del objeto al pasar el puntero sobre el nombre de la función en la lista desplegable Función.

  3. Haga clic en Guardar todo para guardar la configuración.

La función ahora está disponible para usarla en el gráfico.

Ejemplo 1: Salida de gráfico en imprimir y web chartoutputprintweb

En la pestaña Básico, se define el tipo de gráfico, las propiedades del modelo de datos del formulario de origen que contienen datos, las etiquetas que se van a trazar en el eje X y el eje Y del gráfico y, opcionalmente, la función estadística para calcular los valores para trazar en el gráfico.

Comprendamos en detalle la información mínima requerida en las propiedades básicas, con la ayuda de una instrucción de tarjeta generada mediante una comunicación interactiva. Imagine que quiere generar un gráfico para mostrar la cantidad de gastos diferentes en la instrucción. Quiere utilizar diferentes tipos de gráficos para la impresión y la salida web de la comunicación interactiva.

Gráfico de columnas para Imprimir columnchartprint

Para ello, especifique las siguientes propiedades:

  • Nombre: especifique el nombre del gráfico.
  • Tipo de gráfico: seleccione Columna de la lista desplegable.
  • Título: especifique el tipo de gasto para el eje X y el importe de la transacción para el eje Y.
  • Objetos del modelo de datos: seleccione las propiedades del objeto del modelo de datos para crear enlaces de datos para los ejes X (Tipo de gasto) e Y (Importe de transacción).

Gráfico de columnas en el canal Imprimir de una comunicación interactiva

Gráfico de columnas en el canal Imprimir de una comunicación interactiva

Gráfico de anillo para la web donutchartweb

Para ello, especifique las siguientes propiedades:

  • Nombre: especifique el nombre del gráfico.
  • Tipo de gráfico: seleccione Anillo de la lista desplegable.
  • Objetos del modelo de datos: seleccione las propiedades del objeto del modelo de datos para crear enlaces de datos para los ejes X (Tipo de gasto) e Y (Importe de transacción).
  • Radio interior: especifique el valor del Radio interior como 150 para especificar el radio (en píxeles) del círculo interior del gráfico.
  • Información de objeto: utilice el formato predeterminado ${x}(${y}) para mostrar la información del objeto. La información del objeto se muestra de la siguiente manera: Tipo de gasto (Importe de transacción). Ejemplo: Débito de bitcoin (10 000).

Gráfico de anillo en el canal Web de una comunicación interactiva

Gráfico de anillo en el canal Web de una comunicación interactiva

Ejemplo 2: Aplicar las funciones Suma y Frecuencia en un gráfico de líneas applicationsumfrequency

Al aplicar funciones en un gráfico, se pueden representar datos que el modelo de datos de formulario no proporciona directamente. En este ejemplo, utilizamos un ejemplo de instrucción de un extracto de tarjetas de crédito para comprender cómo se pueden aplicar las funciones Suma y Frecuencia al gráfico.

Gráfico de líneas sin una función con dos transacciones “Débito para AirBnB”

Gráfico de líneas sin una función con dos transacciones “Débito para AirBnB”

Función Suma sum-function

Puede aplicar la función Suma para agregar valores de varias instancias de la misma propiedad de datos y mostrarlos solo una vez. Por ejemplo, en el siguiente gráfico, la función Suma se aplica en el eje Y para sumar la cantidad de ambas transacciones “Débito para AirBnB” (2050 y 1050) y mostrar solo una transacción (3100).

La función Suma puede hacer que el gráfico sea más útil cuando desea recopilar y mostrar la suma para muchas instancias de la misma propiedad de datos.

Suma del gráfico de líneas

Función Frecuencia frequency-function

La función Frecuencia devuelve el número de valores del eje Y para un valor determinado del otro eje. Con la aplicación de la función Frecuencia en el eje Y (Importe de transacción), el gráfico muestra que ha habido dos incidencias de transacciones “Débito para AirBnB” y una incidencia del resto de tipos de transacciones.

Frecuencia del gráfico de líneas

Ejemplo 3: Gráfico de cuadrantes de varias series en la web example-multi-series-quadrant-chart-in-web

El gráfico representa la cantidad de transacciones realizadas en un intervalo de fechas determinado. El gráfico de cuadrantes permite dividir el área del gráfico en cuatro secciones etiquetadas. El gráfico utiliza un punto de referencia estático para el eje X y el eje Y. Utilice la función de varias series para separar los datos en función del nombre del banco.

Para ello, especifique las siguientes propiedades:

  • Nombre: especifique el nombre del gráfico.

  • Tipo de gráfico: seleccione Cuadrante de la lista desplegable.

  • Seleccione la casilla de verificación Varias series.

  • Objeto del modelo de datos: especifique la propiedad del objeto del modelo de datos para la serie. La propiedad del objeto del modelo de datos para el nombre del banco es una propiedad principal de las propiedades del objeto del modelo de datos trazadas en los ejes X e Y.

  • Objetos del modelo de datos: seleccione las propiedades del objeto del modelo de datos para crear enlaces de datos para los ejes X (Fecha de transacción) e Y (Importe de transacción).

  • En el Punto de referencia, seleccione Estático como tipo de enlace.

  • Especifique los valores para los puntos de referencia del eje X y del eje Y.

  • Especifique las etiquetas de cuadrante para los cuadrantes Superior izquierdo, Superior derecho, Inferior derecho e Inferior izquierdo.

  • Seleccione la casilla de verificación Mostrar leyendas para mostrar los códigos de color de los nombres de banco.

Gráficos de cuadrante

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2