> For the complete documentation index, see [llms.txt](https://athome-1.gitbook.io/athome-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://athome-1.gitbook.io/athome-docs/doc-glpi-12-fr/setup/crontasks.md).

# Actions automatiques

GLPI dispose de plusieurs actions automatiques (également appelées crontasks) qui sont des tâches planifiées périodiquement. Ces actions peuvent être configurées pour s'exécuter à une fréquence spécifique et fonctionner en mode GLPI ou CLI.

En mode GLPI, les actions sont démarrées occasionnellement lorsque les utilisateurs naviguent dans GLPI. En mode CLI, les actions sont démarrées dans leur propre session via cron, les tâches planifiées ou un autre planificateur de tâches externe. Vous pouvez configurer certaines actions pour qu'elles s'exécutent en mode GLPI et d'autres en mode CLI. Certaines actions peuvent ne supporter qu'un seul des modes.

***

## Configuration du mode CLI

Pour exécuter des tâches en mode CLI, vous devrez configurer votre planificateur de tâches externe pour appeler périodiquement le fichier `front/cron.php` de GLPI. Il est recommandé de le faire s'exécuter chaque minute pour garantir que les actions prêtes à être exécutées le soient dès que possible.

Pour Linux/MacOS, vous devriez ajouter la ligne suivante au crontab de l'utilisateur du serveur web (www-data, apache, etc.) :

```
* * * * * php GLPI/front/cron.php
```

Vous devrez remplacer `GLPI` par le chemin d'accès à votre dossier GLPI. Vous devrez peut-être également remplacer `php` par le chemin complet de votre binaire php s'il n'est pas dans le PATH.

***

## Forcer l'exécution d'une action depuis la CLI

Pour exécuter une action spécifique depuis la ligne de commande, vous pouvez exécuter (pour l'action mailgate) :

```
php GLPI/front/cron.php --force mailgate
```

Vous devrez remplacer `GLPI` par le chemin d'accès à votre dossier GLPI.

Forcer l'exécution de l'action garantira qu'elle s'exécute même si elle n'est pas encore planifiée pour s'exécuter à nouveau.

***

## Forcer l'exécution d'une action depuis la GUI

<figure><img src="https://779199212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgrxMtr6mpTz5PY5L7SR%2Fuploads%2Fgit-blob-6021c9756cbc5bd8e869f3c84567c1376e093421%2Fcron.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Les différents onglets

### Action automatique

<figure><img src="https://779199212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgrxMtr6mpTz5PY5L7SR%2Fuploads%2Fgit-blob-4da7d4cfd769d53763faaed72eb34eba6d26b282%2Fautomatics_action.png?alt=media" alt=""><figcaption></figcaption></figure>

Pour chaque action, il est possible de configurer :

* Fréquence d'exécution
* Statut : Permet de désactiver l'action si nécessaire
* Mode d'exécution : **CLI** ou **GLPI** (nous vous recommandons la valeur CLI qui se base sur le cron de l'instance. En mode GLPI, les actions automatiques ne sont déclenchées que lorsque l'utilisateur est connecté).
* Plage horaire d'exécution : Permet de désactiver certaines actions la nuit par exemple
* Temps de conservation des journaux (en jours) : de 0 à 360 ou infini

L'interface permet également de réinitialiser la date d'exécution et de forcer manuellement l'exécution.

Certaines actions automatiques peuvent avoir des paramètres particuliers, tels que le nombre maximum d'e-mails à envoyer à chaque fois pour l'action **`mailqueue`**. De plus, les plugins peuvent définir leurs propres actions automatiques.

***

### Statistiques

<figure><img src="https://779199212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgrxMtr6mpTz5PY5L7SR%2Fuploads%2Fgit-blob-1d6cf9fdf34049919f1bdf80a5491289f8f94131%2Fautomatics_action_statistics.png?alt=media" alt=""><figcaption></figcaption></figure>

Affiche des informations sur l'exécution de cette tâche (nombre d'exécutions, date de début, durées minimale, maximale, moyenne et totale).

### Journaux

<figure><img src="https://779199212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgrxMtr6mpTz5PY5L7SR%2Fuploads%2Fgit-blob-319cec7891a03f2ced806ed52bb4424ca8239366%2Fautomatics_action_logs.png?alt=media" alt=""><figcaption></figcaption></figure>

Liste les dernières exécutions selon le paramètre défini dans l'onglet *Action automatique* (voir ci-dessus). Un lien sur la date d'exécution permet d'obtenir les détails d'une exécution spécifique.