# Emplois
La fonctionnalité de tâches définit les unités de file d’attente exécutables dérivées des tâches et des événements du fournisseur. Il vous donne un contrôle opérationnel direct sur les tentatives, le déclenchement manuel et la résolution en cas d’échec du travail asynchrone.
Pourquoi c’est important
Cette fonctionnalité rend l’exécution de la file d’attente observable avec une granularité par tâche, de sorte que les échecs peuvent être diagnostiqués et récupérés sans approximation. Il prend en charge la récupération déterministe des opérateurs via des actions explicites de nouvelle tentative, de déclenchement et de résolution tout en gardant les opérations de nettoyage délibérées et étendues.
Flux de base
Les tâches ou les événements de fournisseur produisent des tâches que les travailleurs exécutent et annotent avec les détails de l’état, des tentatives et des échecs. Les opérateurs examinent les tâches ayant échoué ou bloquées dans les vues de file d’attente des comptes, exécutent des actions explicites de nouvelle tentative/résolution/déclenchement et utilisent l’état de la tâche résultant pour suivre le cycle de vie des tâches et auditer les traces.
Opérations
| Opération | Point de terminaison | Objectif |
|---|---|---|
| Liste des emplois | GET /api/accounts/:account_id/jobs |
Récupérer la file d’attente des tâches du compte |
| Rechercher des emplois | POST /api/accounts/:account_id/jobs/search |
Rechercher des emplois par filtre |
| Supprimer des emplois par recherche | POST /api/accounts/:account_id/jobs/search-delete |
Supprimer en masse les tâches correspondantes |
| Obtenir un emploi | GET /api/jobs/:job_id |
Récupérer un emploi |
| Mettre à jour le travail | PATCH /api/jobs/:job_id |
Modifier les champs de travail mutables |
| Supprimer le travail | DELETE /api/jobs/:job_id |
Supprimer un emploi |
| Réessayer le travail | POST /api/jobs/:job_id/retry |
Remettre en file d’attente le travail ayant échoué |
| Résoudre le travail | POST /api/jobs/:job_id/resolve |
Marquer l’état de traitement du terminal |
| Déclencheur de travail | POST /api/jobs/:job_id/trigger |
Déclencheur d’exécution forcée |
Données clés et état
{
id: "job_...",
account_id: "acc_...",
task_id: "tsk_...",
action: "imap_sync_messages",
attempt_count: 2,
last_error_code: "provider_timeout",
last_error_detail: "IMAP connection timed out"
}Modes de défaillance et contrôles
Les exécutions ayant échoué conservent les détails explicites des erreurs pour une gestion déterministe. La nouvelle tentative, le déclenchement et la résolution sont des opérations de type commande plutôt que des effets secondaires de lecture implicites, et les limites de liste/recherche au niveau du compte empêchent la visibilité de la file d’attente entre les comptes.
Connexes
[Travail] (/fr/types/job), [Tâche] (/fr/types/task), [07-jobs-retries-and-resolution] (/fr/guides/07-jobs-retries-and-resolution).