---
title: Tâches programmées
slug: oip-next/f9h1-tache
icon: {"lucideIcon":"📘"}
createdAt: 2024-08-02T10:53:54.000Z
---

La fonction `scheduleTask` permet de programmer l'exécution d'une tâche à une date prédéfinie.

```javascript
export const scheduleTask: (args: {
    taskName: string;
    scheduledAt: Date;
    metadata?: unknown;
    projectId?: string;
  }) => Promise<void>;
```

Le `taskHandler` associé à une tâche programmée possède deux fonctions : `complete` et `reset`. La fonction `complete` permet de déclarer que la tâche programmée a été réalisée avec succès ; cette tâche programmée ne sera plus relancée. La fonction `reset` permet de déclarer que la tâche programmée a échoué ; cette tâche programmée sera relancée ultérieurement.

La fonction `cancelGroupTasks` permet d'annuler une liste de tâches rattachées à une entité `Project`.

```javascript
export const cancelGroupTasks: (
    projectId: string,
    taskNames: string[]) => Promise<void>;
```

## Exemple

:::CodeblockTabs
```javascript
await scheduleTask({
  metadata: { foo: 'bar' },
  projectId: '2',
  taskName: 'myTask',
  scheduledAt: DateTime.now()
});
```

oip.config.mjs

```javascript
const myTask = ({ taskHandler }) => {
  // Perform actions
  
  // Mark the task as completed
  taskHandler.complete();
};

export default {
  tasks: {
    myTask: {
      callback: myTask
    }
  }
};

```
:::
