Listas

Use una lista para parametrizar reglas sin editarlas en cada cambio. La lista es un conjunto de valores, referenciado en las expresiones por el nombre con el prefijo @:

$user_id in @clientes_cuarentena

La lista separa la responsabilidad de la operación, que mantiene los ítems, de la responsabilidad técnica, que mantiene las reglas. Esa separación reduce el riesgo de cambios accidentales en las reglas. Cada lista guarda valores de texto de hasta 128 caracteres, sin saltos de línea.

Crear una lista

En Configuración > Listas > Nueva lista:

  1. Elija un nombre usando solo letras, números, guion y guion bajo (ej.: clientes-cuarentena).
  2. Agregue una descripción opcional.
  3. Haga clic en Crear lista.

El nombre es el identificador usado en las expresiones y no puede cambiarse después de la creación: una regla que referenciara el nombre anterior dejaría de encontrar los ítems.

Agregar ítems

Abra la lista deseada y haga clic en Agregar ítems:

  1. Ingrese un ítem por línea.
  2. Agregue una descripción opcional, repetida en todos los ítems de la inserción (útil para referenciar un ticket de atención, por ejemplo).
  3. Opcionalmente, defina un plazo de expiración, en minutos, horas o días, con un mínimo de 5 minutos y un máximo de 2 años. Sin plazo, el ítem permanece hasta su eliminación manual.

Cada lista admite hasta 10.000 ítems. Puede agregar hasta 1.000 ítems por inserción; para registrar volúmenes mayores, divida el contenido en más de una inserción.

Agregue ítems también por la API, con POST /lists/{list_id}/items. Informe el plazo de expiración en expires_in, como un período ISO 8601 (PT30M, PT12H, P1D).

Ítems agregados por reglas

Una regla puede escribir en una lista durante el procesamiento de un evento, con la acción agregar a la lista. De esta forma, la regla incorpora lo que ya observó: una condición detecta el comportamiento y registra el valor en la lista. Los eventos siguientes consultan esa lista con una condición común.

Al seguir una lista escrita por reglas, considere que:

  • los ítems aparecen sin descripción y sin autor, ya que no fueron registrados por una persona;
  • un valor detectado nuevamente renueva el plazo del ítem existente, en lugar de crear otro;
  • con la lista llena, los valores nuevos dejan de agregarse; conviene seguir la cantidad de ítems en las listas alimentadas automáticamente.

Consultar y eliminar ítems

Pagine los ítems o búsquelos mediante el campo de búsqueda en la parte superior de la tabla. Para eliminar un ítem, use ⋮ > Eliminar en la fila del ítem. Para vaciar la lista, use Eliminar todos los ítems.

La plataforma elimina automáticamente los ítems con plazo de expiración, en barridos periódicos ejecutados cada pocos minutos. Un ítem puede seguir valiendo en una condición algunos minutos más allá del plazo. El mismo barrido justifica el plazo mínimo de 5 minutos.

Eliminar una lista

Una lista solo puede eliminarse cuando está vacía y no es usada por ninguna regla activa ni por ningún monitoreo. Elimine los ítems y las referencias antes de borrarla.