Combinar variables personalizadas y scripting de mapeador de dispositivos

En esta guía, queremos demostrar un uso real de variables personalizadas y scripting del mapeador de dispositivos. El scripting del mapeador de dispositivos puede resolver problemas del tipo "Tengo una o más señales de entrada de mi rastreador GPS y quiero decidir qué hacer en la salida usando diferentes fórmulas". Los Campos Personalizados nos permiten asignar propiedades no estándar a nuestros activos como número de registro, tamaño del tanque de combustible, color del activo, etc.

Un caso práctico usando ambas soluciones sería, por ejemplo, si tenemos diferentes tanques de combustible en diferentes activos (activos del mismo tipo pueden tener diferentes tamaños de tanque de combustible). Puedes adaptar las señales de nivel de combustible para mostrar los valores correctos (litros, por ejemplo) para tu flota. La diferencia con mapeo no lineal es que en este caso usaremos una propiedad del activo y una entrada GPS para generar la salida correcta.

Pasos

1. Habilitar las propiedades requeridas para tus aplicaciones
2. Ingresar las variables personalizadas
3. Asignar la variable personalizada al valor de tu activo
4. Ingresar tu script en tu mapeador de dispositivos
5. Probar el script
6. Resultado

Habilitar las propiedades requeridas para tus aplicaciones

Lee cómo acceder a los privilegios y características de una aplicación y habilita los siguientes dos roles:

_EditDeviceMapperScript
_EditCustomField

Ingresar las Variables Personalizadas

1. Para agregar una Variable Personalizada, necesitamos ir al menú del panel de Activos > Gestionar Campos Personalizados

2. Agrega una nueva variable del tipo Texto llamada Fuel_Tanks. Puedes agregar un valor predeterminado o puedes insertar el valor para cada activo. (Opción de editar activo desde la lista del panel de Activos)

3. Actualiza el navegador para que se apliquen los cambios

Asignar la variable personalizada a tus activos

1. Para agregar una nueva propiedad a nuestros activos, necesitamos modificar el activo en el Editor de Tipos agregando un campo personalizado. Navega al menú Activos y selecciona Editor de Tipos.

La nueva propiedad se encuentra bajo Tipo de dispositivo > Detalles de las propiedades del usuario.

2. Marca ambas casillas para establecer este parámetro como obligatorio para futuros nuevos activos.

3. Define el valor para cada activo editando el activo.

Ingresar tu script en tu mapeador de dispositivos

1. Ve a Menú Principal > Admin > Mapeador de Dispositivos y selecciona el rastreador correcto para tus activos. La señal de entrada que queremos modificar con nuestro script necesita ser mapeada aquí.

En el ejemplo, la señal de entrada será el Analog01, que da el número de voltios (reflejando la capacidad del tanque para el activo dado).

2. Lea la Guía de Script del Mapeador de Dispositivos para habilitar el script del mapeador de dispositivos

3. Bajo el mapeador de dispositivos Script, seleccione la Variable de salida: Nivel de combustible.

3. Presione en Abrir Editor de Script

Algunos consejos útiles para su código Javascript:

• Para obtener una variable del Mapeador de Dispositivos use fields.get(‘device_mapper_variableName’, default_value)
• Para obtener una variable de los Campos Personalizados use user.getCustomFieldValue(‘custom_field_label’)
• Para registrar entradas que le permitan depurar su código, use log(‘variable_name’)

El siguiente script es JavaScript y es solo un ejemplo de la transformación que puede hacer a su entrada. Necesita tener algún conocimiento de JavaScript o programación para crear su script.

var Fuel_level_percent = fields.get('Analog01', 0);
var Tank_type = user.getCustomFieldValue('Fuel_Tanks');
var fuel_level = Fuel_level_percent * Tank_type /100;
return fuel_level;

Tiene algunas herramientas en el editor de scripts para probar sus scripts. Puede modificar los valores de las variables del Mapeador de Dispositivos y usar los registros en el código para verificar si el resultado es correcto

Resultado

Finalmente puede ver los cambios en sus puntos de seguimiento para un activo dado cuando se recibe la señal del nivel de combustible. Y con el scripting del mapeador de dispositivos, puede tener estos valores convertidos, por ejemplo, a litros (usando el tipo de tanque definido en las propiedades del activo).

Siempre puede realizar sus pruebas dentro del Editor de Script o si desea enviar señales a la plataforma para ver la respuesta también puede usar el simulador de activos.