---
title: Gestions des tasks < 2.2.0
slug: oip-next/tflmosi4lpffnjqlywt
description: Learn how to effectively define, use, and manage tasks within the Open Insurance Platform (OIP) with this comprehensive document. Discover how tasks can be executed manually or automatically using a scheduler, and gain valuable insights into configuring t
icon: {"lucideIcon":"📘"}
createdAt: 2023-02-10T09:28:28.000Z
---

*Ce document explique le concept de tâches dans le contexte de l'OIP (Open Insurance Platform). Les tâches sont des fonctions qui peuvent être exécutées manuellement par un utilisateur ou automatiquement par un planificateur (cron) pour des événements récurrents. Le document fournit des instructions sur la façon de définir et d'utiliser des tâches dans la configuration de l'OIP, y compris l'utilisation manuelle et l'utilisation avec cron. Il explique également comment lancer une tâche et mettre à jour son état à l'aide des fonctions fournies.*

# Tasks

:::hint{type="warning"}
Ce fonctionnement est valable jusqu'à la version 2.2.0.

Bien qu'il soit toujours disponible dans les versions supérieur, ses controllers sont passés en statut `Deprecated` et ne sont plus maintenues.

Il est vivement conseillé de passer à la nouvelle version de gestion des tasks mise en place a partir de la version 2.2.0&#x20;
:::

### Introduction

Les tâches (tasks) sont des fonctions qui peuvent être éxécutées par un utilisateur ou par un planificateur (cron) pour des évènements récurents, par exemple tous les jours à 18h.

### Utilisation manuelle

Dans votre configuration de l'OIP, vous devez ajouter une propriété `tasks`

:::CodeblockTabs
oip.config.mjs

```javascript
export default {
  ...votreConfig,
  tasks: {
    nomDeLaTask: callbackAssocieeAVotreTask
  }
};
```
:::

### Utilisation avec CRON

Vous pouvez aussi déclarer une task et la faire executer par un cron.

:::CodeblockTabs
oip.config.mjs

```javascript
export default {
  ...votreConfig,
  tasks: {
    nomDeLaTask: {
      callback: callbackAssocieeAVotreTask,
      // équivalent de tous les jours à 18h
      cron: '0 18 * * *'
    }
  }
};
```
:::

### Lancer une task

Pour lancer une task définie, vous devez appeler la fonction `runTask`

```javascript
import { runTask } from '@fasstech/oip-core/controllers';

/**
 * @param {string} projectId
 */
export const monTraitement = (projectId) => {
  runTask({ taskName: 'nomDeLaTask', projectId });
};
```

### Mettre à jour l'état d'une task

Vous pouvez mettre à jour l'état d'une task avec la méthode `onUpdateTaskStateHandler`

:::CodeblockTabs
my-task.mjs

```javascript
import { onUpdateTaskStateHandler } from '@fasstech/oip-core/process';

export const myTask = async ({ taskHandler }) => {
  const updateTask = onUpdateTaskStateHandler(taskHandler);

  console.log('Task started');
  await new Promise(res => setTimeout(res, 1500)); // heavy processing

  updateTask({ state: 'IN_PROGRESS' });

  console.log('Task in progress');
  await new Promise(res => setTimeout(res, 4200)); // heavy processing

  updateTask({ state: 'COMPLETED' });
};
```

oip.config.mjs

```javascript
import OIP from '@fasstech/oip-core';
import { myTask } from './my-task.mjs';

export default {
  tasks: {
    myTask,
  },
};
```
:::
