Por cada fila

Dar de alta a cincuenta empleados, abrir un caso por cada equipo de una lista, avisar a cada persona de un archivo: son la misma tarea repetida con distintos datos. El bloque Por cada fila la hace de una vez. Quien tiene permiso manda un archivo por el chat, ELYRA lo lee y ejecuta la capacidad elegida una vez por fila, en segundo plano, y le va contando cómo va.

Lo que corre por fila es la capacidad entera, con las mismas reglas que si una persona la recorriera a mano: las preguntas se responden con las columnas del archivo, las condiciones se evalúan, el servicio corre, lo que guarda se guarda. Lo único distinto es la voz: por fila no se habla. Quien lanzó el lote lee una confirmación antes de empezar, una línea por fila con su resultado y un cierre.

Cómo se arma

En el documento de una capacidad, el catálogo (/) ofrece Por cada fila. Al elegir la capacidad que va a correr por fila, el documento la recorre —a ella y a todo lo que llama— y enseña qué columnas tendría que traer el archivo: una por cada pregunta.

Qué se ve	Qué significa
Columnas en verde	La capacidad se puede ejecutar por filas. Cada columna es el nombre de un dato de una pregunta; «opcional» si esa pregunta no es obligatoria.
Un hueco en rojo	No se puede, y el texto dice dónde y por qué: «en “Validar”, llamada desde “Crear orden”: ofrece un menú y una fila no elige».
Quién puede lanzarlo	El privilegio que la persona tiene que tener en su ficha de Personas. De fábrica es lotes; se cambia por bloque.
Cómo pide el archivo	Opcional. Sin texto propio, ELYRA lo pide nombrando las columnas. Con texto propio o sin él, la plantilla sale con el pedido.
Dónde deja su resultado	Opcional. El bloque deja si el lote se lanzó o se canceló en {{resultado_lote}}, y un bloque Caminos de más abajo puede decir una cosa u otra según eso. Se cambia el nombre solo si hay dos bloques así en la capacidad.
Descargar la plantilla	Un Excel generado desde la capacidad: la primera fila trae las columnas, la segunda un ejemplo válido por columna (la primera opción de una pregunta de elegir, una fecha, un correo).

Léalo así: la plantilla no se configura, se deriva. Si la capacidad cambia una pregunta, la plantilla cambia sola, y el bloque vuelve a comprobar que siga siendo posible cada vez que se abre el documento.

La salud del documento vigila dos cosas: que la capacidad siga siendo ejecutable por filas (un rojo que nombra el hueco) y que alguien de la agenda tenga el permiso que el bloque pide (un aviso; sin él, nadie podría lanzarlo). Ver La salud del documento.

Qué capacidades sirven

Una capacidad sirve para correr por filas cuando una fila puede responder todo lo que la capacidad necesitaría de una persona. La regla se aplica a la capacidad y a todo lo que llama, hasta el fondo: si una capacidad llamada desde dentro tiene un hueco, el hueco es de todas.

Sirve	No sirve, y por qué
Preguntas con nombre de dato (la columna se llama como el dato, o como su etiqueta).	Una pregunta sin nombre de dato: no hay columna que la responda.
Preguntas de elegir: la celda trae el valor o la etiqueta de una opción.	Una pregunta que pide un archivo: una fila no lo trae.
Servicios, mensajes, guardar, caminos y escenarios.	Un menú: una fila no elige.
Llamar otra capacidad que también sirva.	Pasar a una persona, poner un vigía, esperar un evento, calificar, consultar libre: necesitan a alguien delante.
	Un servicio que ofrece elegir entre sus resultados, o un aviso a una audiencia: piden una decisión.
	Un ciclo entre capacidades (A llama a B y B vuelve a A).

Un servicio que normalmente pide confirmación antes de escribir no la pide por fila: la confirmación la dio quien lanzó el lote, para el lote entero y contado.

Qué ve quien lo lanza

Todo pasa por el chat, por el mismo canal por el que la persona escribe.

1. ELYRA mira primero si puede: la persona tiene que estar vinculada a una ficha de la agenda con el privilegio que el bloque pide, y no tener otro lote en marcha. Si falta algo, lo dice con nombre («Esto necesita el permiso “lotes” y tu ficha no lo tiene») y la capacidad termina ahí.
2. Si el archivo ya venía adjunto, se lee. Si no, ELYRA lo pide nombrando las columnas y manda la plantilla con el pedido: el mismo Excel que se descarga desde el bloque, con una columna por dato y una fila de ejemplo. En WhatsApp, Telegram, Slack y el correo llega como archivo; en el chat web, como una tarjeta para descargarlo. Escribir en vez de adjuntar no sirve: se vuelve a pedir.
3. ELYRA lee el archivo y lo compara con las columnas. Las que faltan y son obligatorias impiden arrancar («le faltan columnas que “Crear caso” necesita: descripcion»); las opcionales que faltan van vacías; las que sobran se ignoran y se avisa. Si el mismo archivo ya pasó por un lote hace poco, se avisa antes de preguntar.
4. La confirmación cuenta: «Voy a ejecutar “Crear caso” 37 veces, una por fila de “casos.xlsx”, y te voy contando cómo va por aquí. ¿Lo lanzo?». Solo un sí claro lanza; un no cancela y no queda nada.
5. El lote corre en segundo plano. La conversación queda libre: la persona puede seguir escribiendo mientras tanto.
6. Cada pocas filas llega una tanda con una línea por fila: Fila 3, Ana Pérez: INC000123 ✓ o Fila 7, Luis Gómez: faltó «Correo» ✗. Lo que la línea trae es lo que la capacidad produjo (un número de caso, por ejemplo) o el motivo del fallo: un dato que la fila no traía, lo que dijo el sistema, o «entró en un ciclo». Cada tanda lleva el botón de parar.
7. Al terminar: «Terminé “casos.xlsx”: 35 bien, 2 fallaron. ¿Reintento las que fallaron?». Reintentar vuelve a correr solo las que fallaron, en el mismo lote; nada se duplica.

Los frenos

Un bloque que convierte un mensaje en quinientas ejecuciones necesita límites, y todos se dicen.

Freno	Qué hace
Permiso	Solo lanza quien tiene el privilegio del bloque en su ficha de Personas.
Topes por lote	Filas por archivo y peso del archivo. Un archivo que se pasa no arranca, y se le dice a quien lo mandó que lo parta.
Un lote vivo por persona	Mientras uno corre, no se lanza otro.
Tope diario	Filas por día entre todos los lotes de la organización. Lo que no cabe espera a mañana.
Ritmo	Cuántas filas por minuto, en segundo plano, repartiendo el turno con los demás lotes.
Parar	Quien lo lanzó, con el botón de cada tanda; quien administra, desde Actividad. Lo hecho, hecho está.
Reintento sin duplicar	Solo vuelven las filas que fallaron. Un archivo repetido se avisa antes de confirmar.
Fallos seguidos	Si varias filas seguidas fallan por lo mismo, el lote se detiene solo y avisa. Tres filas seguidas «en ciclo» lo detienen antes.

Los números —filas por lote, peso, diario, ritmo, fallos seguidos— se ajustan en Personas, en «Lotes por archivo».

Dónde queda cada cosa

• Actividad, pestaña Lotes: cada lote con su archivo, su capacidad, cuántas filas, cuántas bien y cuántas mal, quién lo paró si alguien lo paró, y los botones de parar y de reintentar. Ver Actividad.
• El expediente: cada fila es una conversación propia, cerrada, que dice de qué archivo y qué fila viene y desde qué conversación se lanzó. Lo que la capacidad habría dicho queda en ella, marcado como silenciado. Ver Auditar con EFEMERIS.
• El uso: las filas se cuentan como filas, no como conversaciones.
• La caducidad: las filas del archivo y sus resultados caducan con «Lo que la gente escribe»; sobreviven los números y quién lo lanzó. El archivo en sí se descarta en cuanto se leyó.