Listado y Gestión de Procesos
La página de procesos en /repositories/:repositoryId/processes muestra las ejecuciones relacionadas con un repositorio. Úsela para crear procesos, seguir el trabajo actual, reintentar ejecuciones interrumpidas, descargar resultados completados o eliminar registros de procesos.
Cuándo usar
- Revisar todos los procesos de un repositorio.
- Seguir estados y abrir los detalles de ejecución.
- Descargar resultados de procesos completados.
- Detener, reiniciar o eliminar un proceso cuando la acción esté disponible.
Antes de empezar
- Confirme la organización activa.
- Abra un repositorio con el preanálisis completado.
- Compruebe que no haya un proceso en conflicto ya pendiente o en ejecución.
Acceso a los procesos
Puede abrir la lista de procesos desde:
- La pestaña Procesos en el workspace del repositorio.
- La acción recomendada en la página de repositorios.
- El command palette cuando hay un repositorio activo.
Si entra desde una ruta global, seleccione primero un repositorio. El repositorio debe estar listo para su ejecución. Si no hay ningún repositorio disponible, la página lo lleva de vuelta a la lista de repositorios.
Entienda la lista
La lista muestra las ejecuciones del repositorio seleccionado. Puede:
- Buscar por nombre, descripción, tipo, idioma o estado.
- Filtrar por estado.
- Crear un nuevo proceso.
- Abrir los detalles de un proceso.
- Descargar el resultado de un proceso completado.
- Reiniciar un proceso con error, cancelado o revocado.
- Detener un proceso en ejecución o pendiente.
- Eliminar un proceso.
Estados de proceso
Los procesos pueden tener los siguientes estados:
PENDING: creado y a la espera de ejecución.RUNNING,STARTED,RECEIVED,RETRY: en curso.SUCCESS: completado y con resultados disponibles.FAILURE: falló.REVOKED: revocado.CANCELLED: cancelado.STOPPING: la aplicación está deteniendo un proceso en ejecución.
Cuando hay procesos pendientes o en curso, la lista se actualiza automáticamente a intervalos. Los mensajes de éxito aparecen temporalmente y se pueden descartar. Los mensajes de error permanecen visibles hasta que los cierre, para poder leer el motivo antes de reintentar.
Acciones de proceso
Las acciones disponibles dependen del estado:
- Ver: abre la pantalla de detalle y progreso del proceso.
- Descargar: descarga el paquete de resultados de un proceso exitoso.
- Detener: pide confirmación antes de detener un proceso en ejecución o pendiente.
- Reiniciar: inicia un nuevo intento para un proceso con error, cancelado o revocado.
- Eliminar: quita el proceso tras la confirmación.
Si la API bloquea un nuevo proceso porque otro está pendiente o en ejecución, espere a que el proceso activo termine o deténgalo antes de crear otro.
Secuencia de estado del proceso
Los procesos suelen pasar de PENDING a estados del worker como RECEIVED, STARTED y RUNNING. Luego pueden terminar con SUCCESS, fallar con FAILURE, reintentar con RETRY o pasar por STOPPING y CANCELLED cuando se solicita una detención.
Los procesos revocados, con error o cancelados se pueden reiniciar cuando la acción está disponible. Antes de reiniciar, revise el mensaje de error visible y los logs en la pantalla de detalle del proceso.
Comportamiento de la base de conocimiento
La ejecución de procesos alimenta la base de conocimiento del repositorio. La documentación posterior puede beneficiarse de la información recopilada en ejecuciones anteriores, y los resultados descargados pueden incluir contenido acumulativo según las opciones seleccionadas.
Resultado esperado
La lista debe mostrar el estado actual de las ejecuciones y ofrecer solo acciones compatibles con cada estado.