# Jobs

## Qu'est-ce qu'un Job ?

Un Job représente le parcours d'un document au travers du workflow vers lequel il a été envoyé. Chaque Module, Etat ou Transition d'un workflow est retranscrit dans les jobs.

{% hint style="info" %}
Un job permet de:

* Suivre la progression d'un document.
* Identifier l'état d'un document : started, waiting, done, error, custom.
* Consulter les données à chaque étape du Workflow.
* Voir les logs à chaque étape du Workflow, et donc déboguer si besoin.
* Télécharger les documents originaux et les documents générés.
  {% endhint %}

## Consulter les jobs

Si vous avez réussi à envoyer un premier document - que ce soit par API (voir [Envoyer des documents dans un workflow](https://docs.recital.ai/products/integration-api/workflow/envoyer-des-documents-dans-un-workflow)) ou via l'upload d'un document pour tester le workflow - vous devriez voir apparaître un premier job.

<figure><img src="https://3247920337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FczKclNsLQDMlLjxNwSSw%2Fuploads%2FborFfwg5HGCdZ6XkvXa6%2Fimage.png?alt=media&#x26;token=5420217c-b230-4c7c-b987-1ee46ed634b8" alt=""><figcaption><p>Tableau des jobs</p></figcaption></figure>

Pour consulter les détails d'un job, cliquez sur l'ID du Job.

### Historique

Le premier onglet "Historique", permet de voir le statut et les données étape par étape. On y retrouve également les logs, permettant entre autres de débugger les différents paramètres d'un module, ou de débugger un module custom (code Python).

<figure><img src="https://3247920337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FczKclNsLQDMlLjxNwSSw%2Fuploads%2FlmaWX4tVGJB6TOdmknwt%2Fimage.png?alt=media&#x26;token=7bb3302d-c001-4c3c-a944-75e7f38b4094" alt=""><figcaption><p>Jobs - Historique</p></figcaption></figure>

### Données

Cet écran permet d'afficher **en direct** les données finales (ajout successif des données à chaque étape).

<figure><img src="https://3247920337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FczKclNsLQDMlLjxNwSSw%2Fuploads%2Fry4Lmo3aiAVmz38T1fGu%2Fimage.png?alt=media&#x26;token=610410dd-ec9c-4ada-a18a-4490d0917d47" alt=""><figcaption><p>Jobs - Données</p></figcaption></figure>

### Fichiers

Cet écran permet de retrouver tous les documents dans les différentes collections et de les télécharger.

{% hint style="info" %}
Le module de cleanup permet actuellement de supprimer les data et tous les fichiers.
{% endhint %}

<figure><img src="https://3247920337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FczKclNsLQDMlLjxNwSSw%2Fuploads%2FQAAGPCJ6kU8h03xgEhU2%2Fimage.png?alt=media&#x26;token=eb95297a-03be-4129-9b4f-a1ead86d0d08" alt=""><figcaption><p>Jobs - Fichier</p></figcaption></figure>