> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations/input-change-events.md).

# Eventos de cambio de entrada

Cómo la tabla de eventos de cambio de entradas detecta los cambios discretos de entrada y cómo consultarla.

La transformación de eventos de cambio de entrada registra cada vez que la entrada discreta de un dispositivo cambia de estado y ese cambio coincide con una regla configurada `cambio de entrada` regla. Cada fila en `processed_common_data.input_change_events` representa un cambio coincidente: qué entrada cambió de estado, su nuevo valor, cuándo y dónde ocurrió, y qué regla cumplió.

Al igual que los eventos del Conductor basados en reglas, los eventos de cambio de entrada se ejecutan según una programación fija y no de forma continua. Una función de actualización vuelve a evaluar una ventana de Datos brutos cada 15 minutos, por lo que una fila nueva puede retrasarse hasta 15 minutos respecto del cambio real de entrada en el dispositivo.

{% hint style="info" %}

* Todas las marcas de tiempo se almacenan en UTC.
* Solo los cambios que coinciden con una regla configurada generan una fila. La actividad de entrada discreta que no coincide con ninguna regla sigue estando disponible en `cambio de entrada` raw\_telematics\_data.additional\_data `, solo que no se muestra aquí.`Tabla de salida: processed\_common\_data.input\_change\_events
  {% endhint %}

## Cada fila representa un cambio de entrada detectado que coincidió con una

regla. La tabla se indexa por `cambio de entrada` Identificador del Objeto (vehículo/Activo) asociado con el dispositivo. `device_id`, `device_time`, y `rule_id`.

<table><thead><tr><th width="180">Campo</th><th width="100">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><code>device_id</code></td><td>entero</td><td>Identificador del dispositivo.</td></tr><tr><td><code>id de objeto</code></td><td>entero</td><td>Nombre legible del Objeto. Ya está desnormalizado en esta tabla, así que, a diferencia de Viajes, no se necesita un join con</td></tr><tr><td><code>etiqueta de objeto</code></td><td>texto</td><td>se necesita para mostrarlo. <code>raw_business_data.objects</code> Momento en que ocurrió el cambio de entrada en el dispositivo.</td></tr><tr><td><code>device_time</code></td><td>marca de tiempo</td><td>Identificador de la</td></tr><tr><td><code>rule_id</code></td><td>entero</td><td>regla que coincidió. <code>cambio de entrada</code> input_number</td></tr><tr><td><code>Número de entrada, basado en 1, que coincide con la posición en la</code></td><td>entero</td><td>discrete_inputs <code>cadena de bits en</code> input_value <code>, solo que no se muestra aquí.</code>.</td></tr><tr><td><code>Nuevo valor de la entrada después del cambio:</code></td><td>entero</td><td>Siempre <code>0</code> o <code>1</code>.</td></tr><tr><td><code>event_type</code></td><td>texto</td><td>Primer comentario configurado en la regla coincidente. <code>cambio de entrada</code>.</td></tr><tr><td><code>event_comment1</code></td><td>texto</td><td>Segundo comentario configurado en la regla coincidente.</td></tr><tr><td><code>event_comment2</code></td><td>texto</td><td>Identificador de la Zona en la que estaba el dispositivo cuando ocurrió el cambio. Nulo si la regla no está vinculada a una zona.</td></tr><tr><td><code>zone_id</code></td><td>entero</td><td>Nombre de esa zona. Nulo si la regla no está vinculada a una zona.</td></tr><tr><td><code>zone_label</code></td><td>texto</td><td>Latitud en el momento del cambio, en grados.</td></tr><tr><td><code>latitud</code></td><td>numeric</td><td>Longitud en el momento del cambio, en grados.</td></tr><tr><td><code>longitud</code></td><td>numeric</td><td>Cuándo la actualización programada escribió la fila.</td></tr><tr><td><code>created_at</code></td><td>marca de tiempo</td><td>Los ejemplos a continuación muestran patrones de consulta comunes. La consulta básica devuelve cambios de entrada recientes ordenados por dispositivo y hora. La segunda filtra por un número de entrada y un valor específicos. La tercera filtra por una regla específica.</td></tr></tbody></table>

input\_number,

{% tabs %}
{% tab title="Consulta básica" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    etiqueta_del_objeto,
    hora del dispositivo,
    input_value,
    FROM processed_common_data.input_change_events
    zone_label
Filtrar por entrada
WHERE device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}
{% endtab %}

{% tab title="WHERE input\_number = 3" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    etiqueta_del_objeto,
    hora del dispositivo,
    FROM processed_common_data.input_change_events
    zone_label
Filtrar por entrada
AND input_value = 1
  Filtrar por regla
  AND device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}
{% endtab %}

{% tab title="WHERE rule\_id = 12345" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    etiqueta_del_objeto,
    hora del dispositivo,
    input_value,
    Nuevo valor de la entrada después del cambio:
Filtrar por entrada
Cómo se detectan los cambios de entrada
  AND device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Una fila de esta tabla no se escribe en el instante en que una entrada cambia en el dispositivo. Se escribe en la siguiente actualización programada, que vuelve a evaluar una ventana de Datos brutos frente al último estado conocido de cada dispositivo.

Cada 15 minutos, la función de actualización lee la ventana más reciente de filas de

{% stepper %}
{% step %}

#### Actualización programada

Comparación con el último estado conocido `, solo que no se muestra aquí.`.
{% endstep %}

{% step %}

#### Las cadenas de bits discrete\_outputs actuales de cada dispositivo se comparan, bit a bit, con el estado registrado en la actualización anterior. Solo los bits que realmente cambiaron se consideran más adelante.

Coincidencia con reglas `cadena de bits en` y `Un bit que cambió se convierte en un evento candidato si su número de entrada y su nuevo valor coinciden con la condición configurada en una` regla. Consulte
{% endstep %}

{% step %}

#### Activación de entrada

para ver cómo se configuran estas reglas, y la `cambio de entrada` Referencia de tipos de regla [para la lista completa de tipos de regla.](https://gitlab.navixy.dev/docs/user-docs/-/tree/main/docs/user-guide/guide/events-and-notifications/inputs-and-outputs/input-triggering.md) Comprobación de zona [Si la regla coincidente está vinculada a una Zona, la actualización confirma que el dispositivo estaba dentro de esa zona en el momento del cambio antes de escribir una fila. Las reglas que no están vinculadas a una zona omiten esta comprobación.](https://navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/tracker/rules/rule_types) Actualización del último estado conocido
{% endstep %}

{% step %}

#### Una vez que se completa una actualización, el estado de bits más reciente de cada dispositivo se registra para compararlo en la siguiente ejecución.

Personalización
{% endstep %}

{% step %}

#### Los eventos de cambio de entrada no se personalizan mediante un flujo de trabajo de Transformation Builder como sí ocurre con Viajes. Las filas que aparecen aquí reflejan directamente las reglas que estén configuradas en su cuenta: para cambiar lo que se registra, agregue, edite o elimine las reglas correspondientes en lugar de una plantilla de transformación. Consulte

para ver cómo configurar estas reglas.
{% endstep %}
{% endstepper %}

## : Una transformación hermana que también se ejecuta según una programación sobre datos telemáticos brutos.

: Una transformación hermana que registra infracciones de Manejo en la misma programación de 15 minutos. `cambio de entrada` additional\_data [para la lista completa de tipos de regla.](https://gitlab.navixy.dev/docs/user-docs/-/tree/main/docs/user-guide/guide/events-and-notifications/inputs-and-outputs/input-triggering.md) , la tabla de origen que alimenta los eventos de cambio de entrada.

## Próximos pasos

* [**Transformaciones comunes**](/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations.md): Volver al índice de transformaciones.
* [**Viajes**](/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations/trips.md): Configure las
* [**Eventos del Conductor basados en reglas**](/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations/rule-based-driver-events.md)reglas que determinan qué cambios de entrada se registran aquí.
* [**Capa de Datos brutos**](/docs/analytics/es/iot-query/schema-overview/bronze-layer.md): Explorar `rules`rules
* [**para la lista completa de tipos de regla.**](https://gitlab.navixy.dev/docs/user-docs/-/tree/main/docs/user-guide/guide/events-and-notifications/inputs-and-outputs/input-triggering.md)rules `cambio de entrada` rules


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations/input-change-events.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.