¿Qué es Assembly Status?
Assembly Status de Transloadit es la representación JSON de una Assembly. Incluye su identificador, subidas, resultados, tiempos de ejecución y la información necesaria para localizar los archivos resultantes.
Cómo funciona Assembly Status
La representación del estado es la instantánea canónica de una tarea de procesamiento en el momento en que se genera. Transloadit utiliza este mismo formato en las respuestas de creación de Assemblies, la URL de estado y los contenidos de las notificaciones, reuniendo el estado del ciclo de vida, los tiempos, los registros de entrada, las salidas de los Steps, los errores y las ubicaciones de los resultados en un único documento legible por máquina. Las instantáneas intermedias pueden cambiar a medida que terminan las ramas, mientras que las instantáneas finales permiten incorporar los resultados de forma persistente. Un backend suele normalizar este documento para adaptarlo a su propio modelo de tareas y conserva los identificadores para los diagnósticos de soporte.
Datos clave
- 1Las subidas y los resultados generados son colecciones separadas en la respuesta, lo que permite a los clientes distinguir los registros de origen enviados de los archivos derivados que producen los Steps.
- 2Las entradas de resultados se organizan por nombre de Step, por lo que los consumidores deberían vincularse a la rama prevista del flujo de trabajo en lugar de asumir que el primer archivo devuelto es el activo deseado.
- 3Los clientes que realizan consultas periódicas necesitan reconocer explícitamente los estados finales de éxito y de fallo; la presencia de metadatos parciales o de algunos archivos de resultados no demuestra que todo el grafo se haya completado correctamente.
Cuándo es relevante Assembly Status
Recupéralo desde la URL de estado de la Assembly para comprobar si ha finalizado, recopilar las URL de los resultados o diagnosticar un Step fallido. El mismo documento se devuelve al crear una Assembly y se entrega en las Assembly Notifications. No trates una instantánea de un procesamiento sin terminar como si fuera definitiva y gestiona los estados finales de fallo antes de consumir las salidas.