Valores faltantes en expresiones
Comprenda por qué una fórmula o condición de IoT Logic no genera ningún valor cuando falta un valor que necesita, y qué patrones de comparación lo evitan.
Las fórmulas y condiciones en IoT Logic trabajan con los valores que envía un dispositivo GPS. Cuando falta un valor que una fórmula necesita, la mayoría de los operadores no pueden producir un resultado, y la fórmula no produce nada en absoluto: no falso, y no cero. Esta página explica cuándo falta un valor, cómo se ve la falla y cómo escribir fórmulas y condiciones que sigan funcionando. Está dirigida a cualquiera que configure un flujo de IoT Logic y no presupone conocimientos de programación.
La página se aplica a ambos lugares donde escribe una expresión: el Fórmula campo de un Iniciar atributo nodo, y el Expresión de condición (JEXL) campo de un IF/THEN Lógica nodo.
Cuando una expresión no puede producir un valor
Un valor vacío detiene toda la expresión. Eso se aplica a cualquiera de los lados de un cálculo, una comparación de tamaño, una prueba de prefijo de texto o una operación lógica !, &&, o ||. En una fórmula y en Analizador de datos, un valor vacío aparece como null.
Leer un atributo que un dispositivo GPS nunca ha enviado no es un error por sí mismo. Lo que se detiene es el operador que luego debe trabajar con el valor vacío. Un solo valor vacío detiene toda la expresión, incluidas las partes que tenían valores. Una condición que prueba cuatro geocercas se detiene en la primera que no puede responder, y las otras tres nunca se prueban. La excepción es un término anterior en la expresión que ya ha determinado el resultado.
Qué ve cuando una expresión no produce nada
Nada marca la falla. El resultado depende de qué nodo contiene la expresión:
Fórmula campo de un Iniciar atributo Nodo
El atributo no tiene valor para ese paquete, y Analizador de datos lo muestra como null.
Expresión de condición (JEXL) campo de un IF/THEN Lógica Nodo
Los datos salen por la conexión ELSE, y el nodo almacena su propio atributo como un valor vacío, no como falso.
Cómo maneja cada operador un valor vacío
Cuatro operadores siempre siguen funcionando con un valor vacío: ==, !=, =~, y !~. Los operadores && y || siguen funcionando solo cuando el lado que se lee primero determina la respuesta. Todos los demás operadores se detienen.
Esta tabla cubre un atributo al que usted hace referencia por nombre, que es la forma que autorrelleno inserta. Cuatro operadores se comportan de manera diferente cuando el valor proviene de value() en su lugar. Véase Lectura por nombre o con value().
==, != (igual a, distinto de)
Devuelve un sí o no real. null == null es true, y null != null es falso.
=~, !~ (está en una lista o coincide con un patrón de texto)
Devuelve un sí o no real. Un valor vacío nunca coincide, por lo que =~ devuelve falso y !~ devuelve true.
?? (usar un valor alternativo)
Devuelve el valor de la derecha. Solo sustituye un valor vacío.
?: (usar un valor alternativo)
Devuelve el valor de la derecha. También sustituye por falso, para 0, y para texto vacío.
a ? b : c (elegir entre dos valores)
Toma la c rama, igual que lo hace para falso.
=^, !^, =$, !$ (empieza con, termina con)
La expresión no produce nada.
<, <=, >, >= (comparaciones de tamaño)
La expresión no produce nada.
+, -, *, /, % (aritmética)
La expresión no produce nada.
&, |, ^ (operaciones a nivel de bits)
La expresión no produce nada.
! (no)
La expresión no produce nada.
&&, || (y, o)
La expresión no produce nada, a menos que el lado que se lee primero determine la respuesta.
Los seis operadores de texto se dividen en dos. =~ y !~ admiten un valor vacío, pero =^, !^, =$, y !$ no lo hacen cuando el atributo se referencia por nombre. Una condición como hardware_key !^ 'AB' parece una forma segura de excluir un prefijo, pero no produce nada en cada paquete que no tenga hardware_key.
El matemáticas: las funciones no producen nada cuando reciben un valor vacío, así que math:round(engine_temp) no produce nada cuando engine_temp falta. El útil: las funciones son más tolerantes y devuelven un valor vacío en su lugar, por lo que util:join y util:joinNonNull siguen produciendo un resultado cuando falta uno de sus argumentos. Al unir texto con + no es tolerante: 'Zone: ' + zone_label no produce nada.
Operadores lógicos con un valor vacío
El orden importa en ambos && y ||. Cada operador lee primero el lado izquierdo y se detiene allí cuando el lado izquierdo ya determina el resultado. Un falso el lado izquierdo determina el resultado &&, y un true el lado izquierdo determina el resultado ||.
false && (vacío)
falso. Un lado izquierdo falso determina AND, por lo que el lado derecho nunca se lee.
true && (vacío)
No produce nada.
(vacío) && cualquier cosa
No produce nada. El lado izquierdo se lee primero.
true || (vacío)
true. Un lado izquierdo verdadero determina OR, por lo que el lado derecho nunca se lee.
false || (vacío)
No produce nada.
(vacío) || cualquier cosa
No produce nada. El lado izquierdo se lee primero.
Colocar al final el término que podría estar vacío solo ayuda cuando el lado izquierdo fija el resultado en ese paquete. Rara vez puede garantizar ese resultado, así que, en su lugar, compare explícitamente el valor.
Lectura por nombre o con value()
Cuatro operadores proporcionan resultados diferentes para el mismo valor faltante, según cómo lo lea la fórmula. Los operadores son =^, !^, =$ y !$, los que comprueban el inicio o el final de un valor de texto.
Fórmula
Resultado cuando id_del_conductor nunca se envió
conductor_id !^ 'AB'
No produce nada
value('driver_id', 0, 'all') !^ 'AB'
true
Referenciar el atributo por nombre es el Formulario que autorrelleno inserciones, por lo que una condición creada con el selector de atributos toma la primera ruta. Escriba la comparación con value() cuando necesite !^ o !$ reportar true en un paquete que no contiene el atributo.
Todos los demás operadores se comportan igual en ambas formas. Una comparación de tamaño, aritmética y ! todos no producen nada de ninguna manera, y ==, !=, =~ y !~ todos dan un sí o un no real, de todas formas.
La misma división se aplica a los dos formularios de respaldo. ?? y ? : puede contener un cálculo fallido cuando el valor proviene de value(), y no puede cuando proviene de un nombre:
Fórmula
Resultado cuando odómetro nunca se envió
(odómetro + 1) ?? 0
No produce nada
(value('odómetro', 0, 'all') + 1) ?? 0
0
Una simple ?? sobre un nombre sigue funcionando, porque no se realiza ningún cálculo antes de ello. Solo un cálculo envuelto dentro de ?? o ? : se comporta de forma diferente.
Comparar un valor explícitamente
Para que un valor que podría estar vacío sea seguro en una condición, compárelo con == true o == false en lugar de usarlo por sí solo. Ambas == y != devuelven un sí o no reales para un valor vacío, por lo que un término que no tiene datos ya no detiene toda la condición.
Esta condición se detiene en cualquier paquete en el que falte uno de los dos atributos:
Esta condición sigue funcionando y devuelve sí cuando cualquiera de las puertas está abierta:
Las funciones de zona se comportan igual, porque devuelven un valor vacío cuando un paquete no contiene posición. Esta condición se detiene en cuanto una función no puede responder:
Esta condición prueba ambas zonas en cada paquete:
Elija la comparación que corresponda a lo que debe contar un paquete sin datos:
== truesignifica «conocido como sí». Un valor vacío dafalso, por lo que un paquete sin datos no coincide.== falsesignifica «conocido como no». Un valor vacío dafalso, por lo que un paquete sin datos no coincide.!= truesignifica «no conocido como sí». Un valor vacío datrue, por lo que un paquete sin datos sí coincide.
De dónde provienen los valores vacíos
Un atributo en una fórmula se resuelve como un valor vacío en estos casos:
El atributo nunca se ha enviado para ese dispositivo GPS.
El paquete actual no contiene el atributo, aunque un paquete anterior sí lo contenía.
La posición del historial que solicitó con
value()aún no existe, porque el dispositivo ha enviado menos paquetes de los que requiere la posición.El dispositivo no envió nada durante más de 30 días, así que Navixy descartó su historial almacenado. Consulte Sintaxis completa.
inGeofence(),enterGeofence(), oleaveGeofence()no puede responder, porque el paquete no contiene coordenadas o la zona ya no existe en la cuenta. Consulte Cuando una función de zona no da respuesta.geofenceName()no tiene ningún nombre que devolver. Consulte Lo que devuelve.
Todas estas causas se ven iguales en una fórmula. Una fórmula que debe seguir funcionando tiene que manejar el valor vacío en lugar de la causa.
Fórmulas que siempre deben producir un valor
Proteja el cálculo con != null, y coloque la protección primero. La protección usa !=, que devuelve un sí o no reales para un valor vacío, por lo que la protección misma nunca se detiene:
El orden es lo que hace que la protección funcione. Si invierte los términos, la comparación se ejecuta antes de la protección, y toda la condición no produce nada.
Para sustituir en su lugar un valor de reserva, use ??. Devuelve el lado derecho solo cuando el lado izquierdo está vacío:
?? sustituye un valor ausente, no un cálculo fallido. (can_speed * 1.1) ?? 0 no produce nada cuando can_speed falta, porque la multiplicación se detiene antes de ?? que se alcance. Coloque ?? alrededor del atributo en lugar de alrededor del cálculo:
También puede condicionar el cálculo desde fuera de la fórmula. Coloque un IF/THEN Lógica nodo antes del Iniciar atributo nodo, y pruebe los atributos para verificar si están presentes en su condición. Conecte la ruta THEN al nodo de cálculo, para que reciba solo los paquetes que contienen los valores que necesita.
Conecte la ruta ELSE a un Nodo de Salida nodo también. Una rama que termina sin uno descarta todos los paquetes que llegan a ella, de modo que los paquetes que no pasaron la prueba de presencia nunca salen del flujo.
Cuando no tener un valor es mejor que tener uno incorrecto, un atributo sin valor es el resultado correcto. Agregue un valor de respaldo solo cuando un sistema más adelante en el flujo necesite un valor en cada paquete.
Compruebe si una expresión no produce nada
Trabaje a partir de lo que puede ver en Analizador de datos:
Seleccione el flujo, luego el dispositivo GPS y el atributo calculado.
Desactive el Excluir nulos interruptor. Un cálculo fallido aparece como un
nullvalor. El interruptor oculta esos valores cuando está activado.Aumente la profundidad si el paquete que busca es más antiguo que los valores en pantalla.
Compare el atributo con los atributos que su fórmula lee. Un paquete en el que las entradas de la fórmula tienen valores y el atributo calculado es
nullapunta a la fórmula.Verifique cada operador de la fórmula con Cómo maneja cada operador un valor vacío.
Reescriba cada parte que podría estar vacía. Use
== true,== false, o un??valor de respaldo.
Preguntas frecuentes
¿Un valor vacío es lo mismo que falso?
No. Una condición que realmente está vacía falso almacena falso, y una condición que no pudo evaluarse almacena un valor vacío. Ambas envían los datos a través de la conexión ELSE de un IF/THEN Lógica nodo, así que la rama por sí sola no le indica cuál ocurrió. Una expresión posterior que pruebe el atributo con my_flag == false solo coincide con el primer caso.
¿Por qué un dispositivo GPS dejó de coincidir con una condición que sigue funcionando para los demás?
Los dispositivos de diferentes modelos no envían todos los mismos atributos, y un dispositivo puede dejar de reportar un atributo que los demás aún envían. Una condición que lee ese atributo sin una comparación entonces no produce nada solo para ese dispositivo. Compare cada término explícitamente con == true o == false.
Véase también
Expresiones y sintaxis de IF/THEN Lógica qué rama toma un nodo Logic y qué almacena.
Funciones de Zona para los casos en que una función de zona no puede responder.
Administrar atributos para la
value()función y las dos opciones de sintaxis.Ejemplos de cálculos para ejemplos de fórmulas.
Última actualización
¿Te fue útil?