Configuración avanzada de informes gráficos

Prev Next

Puedes personalizar los elementos del aspecto de un gráfico de informe utilizando el campo de configuración Avanzada, por ejemplo:

  • Cambiar el gráfico y los títulos de los ejes
  • Cambiar el tamaño, el color y el estilo de la fuente
  • Modificar la posición y el estilo de la leyenda
Ten en cuenta que una serie de personalizaciones avanzadas de gráficos no están disponibles actualmente con ChartJS.

A partir de Totara 13, el campo de configuración avanzada para los informes gráficos de Totara está escrito en formato JSON para especificar la configuración personalizada que funcionará en todas las bibliotecas de gráficos. Estos ajustes no son específicos de una biblioteca de gráficos y funcionarán cuando se utilicen gráficos ChartJS y SVGGraph.

Configuración del título

ConfiguraciónDescripción

texto

El texto del título que se mostrará en el gráfico.

Ejemplo: "Informe de finalización del curso"

posición

En qué parte del gráfico se muestra el título.

Valores permitidos: "superior", "izquierda", "inferior", "derecha"

fuente

Fuente a utilizar para el título. Solo funciona si el usuario tiene la fuente instalada.

Ejemplo: "Horas en Nueva Romana"

tamaño de fuente

Tamaño del texto en el título en píxeles.

Ejemplo: 16

estilo de fuente

Estilo de texto para aplicar al título.

Ejemplo: "bold"

color

Color para el texto del título en hexadecimal o RGB.

Ejemplo: "#f0f0f0"

relleno

Cantidad de espacio alrededor del texto del título en píxeles.

Ejemplo: 5

Ejemplo

{
        "title": "Example Graph Title"
}

OR

{
        "title": {
               "text": "Example Graph Title",
                "position": "top",
                "font": "Times New Roman",
                "fontSize": 16,
                "fontStyle": "bold",
                "color": "#fff",
                "padding": 5
        }
}

Configuración de leyenda

ConfiguraciónDescripción

mostrar

Determina si se muestra la leyenda.

Ejemplo: verdadero

posición

En qué parte del gráfico se muestra la leyenda.

Valores permitidos: "superior", "izquierda", "inferior", "derecha"

fuente

Fuente a utilizar para los elementos de leyenda. Solo funciona si el usuario tiene la fuente instalada.

Ejemplo: "Horas en Nueva Romana"

tamaño de fuente

Tamaño del texto en la leyenda en píxeles.

Ejemplo: 16

estilo de fuente

Estilo de texto para aplicar a la leyenda.

Ejemplo: "bold"

color

Color para el texto de la leyenda en hexadecimal o RGB.

Ejemplo: "#f0f0f0"

relleno

Cantidad de espacio alrededor del texto de la leyenda en píxeles.

Ejemplo: 5

Ejemplo

{
        "legend": {
                "display": true,
                "position": "left",
                "font": "Times New Roman",
                "fontSize": 16,
                "fontStyle": "bold",
                "color": "fff",
                "padding": 5
        }
}

Ajustes de información sobre herramientas

ConfiguraciónDescripción

mostrar

Determina si se muestran las sugerencias.

Ejemplo: verdadero

fondoColor

El color del fondo de la información sobre herramientas.

Ejemplo: "#dad4da"

fuente

Fuente a utilizar en las sugerencias. Solo funciona si el usuario tiene la fuente instalada.

Ejemplo: "Horas en Nueva Romana"

tamaño de fuente

Tamaño del texto en la sugerencia en píxeles.

Ejemplo: 16

estilo de fuente

Estilo de texto para aplicar a la información sobre herramientas.

Ejemplo: "bold"

color

Color para el texto de información sobre herramientas en hexadecimal o RGB.

Ejemplo: "#f0f0f0"

Radio de frontera

La redondez de los bordes de la sugerencia (en píxeles).

Ejemplo: 2

bordeColor

El color del borde de la información sobre herramientas.

Ejemplo: "#0a7b92"

ancho de borde

El grosor del borde de la información sobre herramientas (en píxeles).

Ejemplo: 2

Ejemplo

{
        "tooltips": {
                "display": true,
                "backgroundColor": "#ddd",
                "font": "Times New Roman",
                "fontSize": 16,
                "fontStyle": "bold",
                "color": "#fff",
                "borderRadius": 5,
                "borderColor": "#0a7b92",
                "borderWidth": 3
        }
}

Ajustes del eje

Los ajustes del eje deben aplicarse al eje x o al eje y. Los ajustes disponibles para cada eje son idénticos.

ConfiguraciónDescripciónNotas

mostrar

Si se muestra la línea para este eje.

Ejemplo: verdadero

-

título

Etiqueta del eje para el gráfico.

Utilizan la misma configuración que el título del gráfico.

-

cuadrícula

Ajustes para controlar la cuadrícula del eje.

-

cuadrícula  → mostrar

Si se muestran las líneas para la cuadrícula del eje.

Ejemplo: verdadero

-

cuadrícula  → color

Color de las líneas de la cuadrícula del eje.

Ejemplo: "#0ff000"

-

máx.

Este es el valor máximo de cualquiera de los ejes.

Este valor dependerá de los valores utilizados en tu eje, por lo que podría ser numérico o alfanumérico, por ejemplo, si el eje x contenía una lista de meses, podrías establecer el máximo en 'abril' para que no muestre contenido más allá de este valor, si querías restringirlo al ejercicio actual, por ejemplo. 

Si estás usando un valor de texto como tu máximo, este debe ser un valor con datos asociados a él. 

Por ejemplo, si uno de tus ejes está etiquetado con días de la semana y tus datos incluyen los valores lunes, martes, jueves, viernes y sábado, no podrás usar la configuración "max":"miércoles". Esto se debe a que no hay datos de miércoles en el gráfico. 

Esto no se aplica a valores numéricos.

Ejemplo

{
        "axis": {
               "x": {
                       "display": true,
                       "max": "April",
                       "title": {
                               "text": "Horizontal Axis Label",
                               "font": "Times New Roman",
                               "fontSize": 22,
                               "fontStyle": "bold",
                               "color": "#fff000",
                               "padding": 10
                       },

                       "grid": {
                               "display": true,
                               "color": "#fff000"
                       }
               },

               "y": {
                       "display": true,
                       "title": {
                               "text": "Vertical Axis Label",
                               "font": "Times New Roman",
                               "fontSize": 22,
                               "fontStyle": "bold",
                               "color": "#f0f0ff",
                               "padding": 10
                       },

                       "grid": {
                               "display": true,
                               "color": "#3a4f3a"
                       }
               }
        }
}

Configuraciones del color del gráfico

Puedes especificar los colores del gráfico con ChartJS y SVGGraph.

ConfiguraciónDescripción

colores

Colores utilizados para el contenido principal de un gráfico (p. ej., diferentes barras en un gráfico de barras). Ver ejemplos a continuación.

Ejemplos:

Los colores por defecto utilizados para el contenido del gráfico se muestran aquí:

{"colors" : [
"#3869B1",
"#DA7E31",
"#3F9852",
"#CC2428",
"#958C3D",
"#6B4C9A",
"#8C8C8C"
]}

Puedes delinear tantos colores como necesites de la siguiente manera:

{"colors": ["#ff0000", "#00ff00", "#0000ff"]}

A partir de Totara 17.28 es posible especificar los colores que se asociarán con conjuntos de datos específicos utilizando ChartJS y SVGGraph.

ConfiguraciónDescripción

categoríaColores

Colores utilizados para una serie o categorías con un nombre específico en el gráfico. Estos permanecerán mientras se aplican diferentes filtros al informe.

Para los gráficos circulares, los colores se aplican por segmento. Para otros gráficos, los colores se aplican por serie de datos.

{
  "categoryColors": {
    "item1": "#ff0000",
    "item2": "#00ff00"
  }
}

Puedes describir tantas categorías nombradas como necesites de esta manera. Si algún conjunto de datos no coincide con una categoría nombrada, se utilizarán los colores regulares anteriores.

Si tu gráfico admite la opción multilenguaje, deberás definir un color para cada traducción.

Ajustes de dona de progreso

ConfiguraciónDescripción

totalessuministrados

Habilitar si la segunda columna contiene totales.

porcentajesValores

Habilitar si la primera columna contiene porcentajes en lugar de conteo.

rangos de color

Este ajuste le permite asignar colores a los rangos de valores. Definir una matriz de valores porcentuales como límites para el siguiente color en el conjunto de colores.

fondoColor

Establece el color de la parte "vacía" del gráfico circular (es decir, el valor total menos el valor de progreso).

Ejemplo 1

{
"colors" : ["red", "yellow", "green"],
"colorRanges": [20, 100],
"type" : {
  "progress": {
    "totalsSupplied": true,
    "percentageValues": true
  }
}
}

Progress donuts based on the code example above.

Ejemplo 2

{
"colors" : ["red", "yellow", "green"],
"colorRanges": [20, 100],
"type" : {
    "progress": {
    "totalsSupplied": true,
    "percentageValues": false
  }
}
}

Progress donuts based on the code example above.

Ejemplo 3

{"colors" : ["green"],
"type" : {
    "progress": {
    "totalsSupplied": true,
    "backgroundColor": "red"
  }
}
}

Progress donuts based on the code example above.

Ajustes del conjunto de datos

ConfiguraciónDescripción

llenar

Determina si el elemento está lleno o no, como el área debajo de la línea en un gráfico de áreas.

Ejemplo: verdadero

bordeDash

El estilo de guión para el trazo de un elemento. Los dos números proporcionados controlan la longitud de cada guión y la longitud de cada espacio.

Ejemplo: [15, 5]

bordeColor

El color del trazo del elemento de datos (p. ej., punto, línea, barra).

Ejemplo: #CCFFCC

ancho de borde

El ancho de carrera para el elemento.

Ejemplo: 3

fondoColor

El color de relleno del elemento de datos (p. ej., punto, línea, barra).

Ejemplo: #CCFFCC

estilopunto

La apariencia de cada punto en un gráfico.

Ejemplo: círculo

Los ajustes enumerados anteriormente son solo una selección de ajustes útiles. Puedes encontrar la lista completa de ajustes en la documentación de ChartJS.

Ten en cuenta que estos ajustes solo están disponibles en la biblioteca ChartJS, no en el gráfico SVG.

Ejemplo

{
    "data-settings": {
         "0": {
             "fill": true,
             "borderDash":[15,5],
             "backgroundColor": "#CCFFCC"
          }
     }
}

A line graph based on the code example above.

Ajustes específicos de la biblioteca

Si deseas escribir ajustes más avanzados para aprovechar algunas de las capacidades extendidas de tu biblioteca de gráficos, puedes usar el campo de ajustes "personalizados" para pasar los ajustes directamente a la biblioteca. Estos no serán compatibles entre sí.

Documentación oficial para SVGGraph

Documentación oficial para ChartJS

Ejemplo de SVGGraph

{
        "custom": {
              "legend_columns": 3,
              "legend_title_font_weight": "italic",
              "legend_draggable": false
        }
}

Ejemplo de ChartJS

{
        "custom": {
               "axis": {
                       "scales": {
                               "yAxes": [{
                                       "gridLines": {
                                              "display": false
                                      }
                               }]
                       }
               }
        }
}

Ejemplo completo

{
        "title": {
                "text": "Graph Title",
                "position": "top",
                "font": "Times New Roman",
                "fontSize": 22,
                "fontStyle": "bold",
                "color": "#ea22a9",
                "padding": 10
        },

        "legend": {
                "display": "true",
                "position": "top",
                "font": "Times New Roman",
                "fontSize": 16,
                "fontStyle": "italic",
                "color": "#ee22a9",
                "padding": 5
        },

        "tooltips": {
                "display": true,
                "backgroundColor": "#eaeaea",
                "font": "Times New Roman",
                "fontSize": 16,
                "fontStyle": "bold",
                "color": "#1f1f1f",
                "borderRadius": 5,
                "borderColor": "#ee22a9",
                "borderWidth": 1
        },

        "axis": {
               "x": {
                       "display": false,
                       "title": {
                               "text": "Horizontal Axis",
                               "font": "Times New Roman",
                               "fontSize": 16,
                               "fontStyle": "italic",
                               "color": "#ea22a9",
                               "padding": 10
                               "max": "April",
                       },

                       "grid": {
                               "display": true,
                               "color": "#eaeaea"
                       }
               },

               "y": {
                       "display": false,
                       "title": {
                               "text": "Vertical Axis",
                               "font": "Times New Roman",
                               "fontSize": 16,
                               "fontStyle": "italic",
                               "color": "#ea22a9",
                               "padding": 10
                       },

                       "grid": {
                               "display": true,
                               "color": "#eaeaea"
                       }
               }
        }
}

Course badge Get involved in the conversation about Reporting on the Totara Community. 

Why not visit the Totara Academy for our latest course on Reports in Totara. Here you can learn more on how to use reports, see best practice, and give it a go yourself.

Join the Totara Community for more resources to help you get the most out of Totara. 


© Copyright 2026 Totara Learning Solutions. All rights reserved.