Descripción general
Información
- La edición de funciones de gráficos es una característica avanzada que requiere conocimientos de JavaScript. El soporte de eGauge no puede ayudar a escribir o depurar código JavaScript.
Las funciones de gráfico permiten el uso de JavaScript para calcular nuevos valores basados en los datos registrados en los registros en la configuración del medidor.
Prerrequisitos
- Se requiere conocimiento de JavaScript.
Instrucciones
Paso 1: Acceda al 'Editor de funciones de gráficos' usando el icono de hamburguesa en la parte superior izquierda, seleccione ' Gráfico ' > ' Editar funciones '
Paso 2: Haga clic en una función de gráfico existente para editarla o haga clic en el icono " Agregar función " para agregar una nueva. Haga clic en la X para eliminar una función de gráfico existente.
Paso 3: Al hacer clic en " Agregar función " o editar una función existente, se abrirá la ventana " Editar función ". A continuación se muestra un ejemplo de función.
use , al que se le pasa el valor instantáneo del registro virtual de uso de eGauge (definido como $"Usage" ), y bat , al que se le pasa el valor instantáneo del registro virtual de "Battery" (definido como $"Battery" ). Tanto "Usage" como "Battery" son valores de registro definidos en la configuración de instalación de eGauge (enlace) del medidor. Nombre de la función (campo obligatorio): Un nombre único y arbitrario seleccionado por el usuario. Solo se usa en el gráfico eGauge y no necesita ser un nombre de función JavaScript válido. En el script de ejemplo anterior, el nombre de la función es use+charge.
Devuelve un valor acumulado : active esta opción para devolver un valor acumulado. Desactive esta opción para devolver un valor instantáneo.
Unidad del valor de retorno (campo obligatorio): Selecciona la unidad en la que se muestra el valor devuelto por la función. En el script de ejemplo anterior, se establece en vatios . Este valor debe modificarse según la unidad del cálculo que realiza la función.
Argumentos : Esta tabla define la lista de valores que se pasarán a la función. Solo se pueden pasar como argumentos valores de registro. Los nombres de los argumentos deben ser identificadores JavaScript válidos.
Cuerpo : esta sección define los cálculos que realizará la función.
Información
- Si un argumento de función hace referencia a un registro que ya no existe en la configuración del medidor, su valor será Indefinido. Esta es la razón por la que se usa "||0" en el código anterior: garantiza que, si los registros virtuales de uso o de batería no están definidos, se use el valor 0.
El ' Cuerpo ' puede ser un cuerpo de función de JavaScript arbitrario y permite funciones anidadas.
function reg_or_zero(reg) {
return reg || 0;
}
return reg_or_zero(use);Documentación : este campo se utiliza para agregar una descripción de lo que hace la función.
Paso 4: Haga clic en " Aceptar " para guardar la función del gráfico.
Paso 5: Las funciones de gráfico guardadas aparecerán en la lista de valores para graficar después de registrar los valores. Para agregar una función de gráfico guardada a un gráfico, agregue un nuevo elemento de gráfico y selecciónelo en la lista desplegable "Valor para graficar". La función de gráfico se comportará como cualquier otro elemento de gráfico.
