# Lanzar un trabajo

[← Índice](readme.md)

El administrador puede lanzar trabajos directamente desde la lista de tipos de trabajo usando el botón **Nuevo trabajo** en cada tarjeta. Esto es útil para pruebas o para ejecuciones puntuales sin necesitar la app operativa.

---

## Paso 1 — Tipo de trabajo

El tipo de trabajo ya está seleccionado al venir desde la tarjeta. El formulario muestra el nombre, descripción y configuración activa.

---

## Paso 2 — Cargar datos

Selecciona o arrastra el archivo con los elementos a procesar.

### Formatos aceptados

| Formato | Extensión | Consideraciones |
|---|---|---|
| JSON | `.json` | Debe ser un array de objetos. Cada objeto es un elemento. |
| CSV | `.csv` | La primera fila debe ser el encabezado con los nombres de campo. Separador: coma. |
| Tabulado | `.csv` o `.txt` | Igual que CSV pero con tabulador como separador. |
| Excel | `.xlsx` | La primera hoja se procesa. La primera fila debe ser el encabezado. |

### Vista previa

Al cargar un archivo JSON o CSV el sistema muestra las primeras 5 filas para que puedas verificar que los datos se leyeron correctamente. Para archivos Excel la vista previa no está disponible — el servidor procesará el contenido al encolar.

### Campos relevantes para la configuración

Los campos que hayas definido en **Campo de contexto variable** deben existir en los elementos del archivo. Si el campo no existe en un elemento, ese elemento se procesará sin contexto variable.

---

## Paso 3 — Confirmar y lanzar

El resumen muestra el tipo de trabajo seleccionado y la cantidad de elementos detectados en el archivo. Revisa que todo sea correcto antes de lanzar.

Pulsa **Lanzar trabajo** para encolar. El sistema responde con el identificador del job (`job_id`). A partir de ese momento puedes seguir el progreso en el [Log de ejecuciones](07-log.md).

---

## Formas alternativas de lanzar trabajos

Además de la interfaz, los trabajos pueden lanzarse de otras formas:

- **App operativa** — los operadores autorizados pueden lanzar trabajos desde `agent.induxsoft.net/batch`
- **Webhook / sistema externo** — cualquier sistema puede llamar directamente a `POST https://ai-batch.api.induxsoft.net/enqueue/` usando el token de encolamiento
- **Conector Devkron** — un endpoint a medida que extrae datos de una fuente y encola automáticamente

---

[← Gestión de usuarios](05-usuarios.md) · [Log de ejecuciones →](07-log.md)
