Un Job est un graphe acyclique de Tasks nommées. Les branches indépendantes s’exécutent en parallèle et les dépendances contrôlent l’ordonnancement.
Modèle d’exécution
Les Tasks d’import produisent des Files, les Tasks convert les transforment et les Tasks export livrent les résultats. Chaque exécution physique est conservée comme TaskAttempt.
Exemple de Job
Déclarez les tâches par nom et référencez les sorties de tâches précédentes. ConverterHQ valide les dépendances et rejette les cycles avant l’exécution.
{
"tasks": {
"source": {"operation": "import/url", "input": {"url": "https://example.com/report.docx"}},
"pdf": {"operation": "convert", "input": "source", "options": {"output_format": "pdf"}},
"delivery": {"operation": "export/s3", "input": "pdf", "options": {"connection": "conn_...", "key": "processed/report.pdf"}}
}
}Retries et échecs
Les retries d’infrastructure, le fallback moteur et les retries demandés par le client sont distincts. Un nouvel essai crée un nouvel historique au lieu d’effacer l’échec précédent.
Annulation
L’annulation empêche les tâches en attente de démarrer, invalide les éléments en file et signale aux workers actifs de terminer proprement les processus de conversion.