> For the complete documentation index, see [llms.txt](https://help.glpi-project.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.glpi-project.org/glpi-12/fr/administration/rules.md).

# Règles

## **Qu'est-ce qu'une règle dans GLPI ?**

Il existe plusieurs types de règles dans GLPI. Les règles servent à automatiser et simplifier certaines tâches. Il est, par exemple, possible d'assigner un élément à une entité lors d'un upload d'inventaire, d'allouer une habilitation à un utilisateur lors de sa connexion, ou d'assigner un ticket via un collecteur.

***

## **Comment fonctionnent les règles ?**

Les règles dans GLPI sont composées de **critères** et d’**actions**. Elles permettent d’automatiser des traitements selon des conditions spécifiques.

**Exemple : affectation des habilitations à un utilisateur**

Imaginons que vous souhaitiez attribuer automatiquement un profil et une entité à certains utilisateurs :

**Critères :**

1. Le type d’authentification est **externe** (autre que la base interne ou LDAP).
2. L’ID utilisateur contient `@mondomaine.com`.

**Actions :**

1. Assigner le **profil self-service**.
2. Assigner l’**entité A**.
3. Activer la **récursivité** sur cette affectation.

***

## Les différentes règles

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-cloud-arrow-down">:cloud-arrow-down:</i></h3></td><td><h4>Règles d'inventaire</h4></td><td><a href="https://help.glpi-project.org/glpi-12/fr/administration/rules/inventorytools.md">Règles d'inventaire</a></td></tr><tr><td><h3><i class="fa-user-check">:user-check:</i></h3></td><td><h4>Règles d'affectation d'habilitations à un utilisateur</h4></td><td><a href="https://help.glpi-project.org/glpi-12/fr/administration/rules/regles-daffectation-dhabilitations-a-un-utilisateur.md">Règles d'affectation d'habilitations à un utilisateur</a></td></tr><tr><td><h3><i class="fa-grid-2-plus">:grid-2-plus:</i></h3></td><td><h4>Règles d'affectation d'une catégorie aux logiciels</h4></td><td><a href="https://help.glpi-project.org/glpi-12/fr/administration/rules/regles-daffectation-dune-categorie-aux-logiciels.md">Règles d'affectation d'une catégorie aux logiciels</a></td></tr><tr><td><h3><i class="fa-circle-exclamation">:circle-exclamation:</i></h3></td><td><h4>Règles métier pour les tickets</h4></td><td><a href="https://help.glpi-project.org/glpi-12/fr/administration/rules/ticketbusinessrules.md">Règles métier pour les tickets</a></td></tr><tr><td><h3><i class="fa-clipboard-check">:clipboard-check:</i></h3></td><td><h4>Règles métier pour les changements et les problèmes</h4></td><td><a href="https://help.glpi-project.org/glpi-12/fr/administration/rules/regles-metier-pour-les-changements-et-les-problemes.md">Règles métier pour les changements et les problèmes</a></td></tr><tr><td><h3><i class="fa-empty-set">:empty-set:</i></h3></td><td><h4>Listes noires</h4></td><td><a href="https://help.glpi-project.org/glpi-12/fr/administration/rules/listes-noires.md">Listes noires</a></td></tr></tbody></table>

***

## **Quels opérateurs sont disponibles dans les critères ?**

Dans les règles GLPI, vous devez utiliser des opérateurs pour pouvoir construire votre règle. Par exemple, si login **`contient`** @mondomaine.com ou si groupe **`est`** infrastructure. Un certain nombre d'opérateurs sont disponibles pour créer vos règles de manière aussi explicite et logique que possible.

Ces opérateurs permettent de construire des règles précises et adaptées à vos besoins et à la structure de votre organisation.

Selon le critère sélectionné, les opérateurs proposés par GLPI peuvent varier.

<table><thead><tr><th>Actions</th><th width="198">Description</th><th width="97">Valeur en entrée</th><th width="263">Exemple (champ - opérateur - pattern)</th><th>Résultat</th></tr></thead><tbody><tr><td><strong>est</strong></td><td>Vrai si la valeur est strictement égale au critère (insensible à la casse).</td><td><code>Dell</code></td><td><code>Fabriquant</code> <code>est</code> <code>Dell</code></td><td>✅</td></tr><tr><td><strong>n’est pas</strong></td><td>Vrai si la valeur est différente du critère.</td><td><code>HP</code></td><td><code>Fabriquant</code> <code>n'est pas</code> <code>Dell</code></td><td>✅</td></tr><tr><td><strong>contient</strong></td><td>Vrai si la valeur contient le critère comme sous-chaîne.</td><td><code>HP LaserJet</code></td><td><code>Type</code> <code>contient</code> <code>Laser</code></td><td>✅</td></tr><tr><td><strong>ne contient pas</strong></td><td>Vrai si la valeur ne contient pas le critère.</td><td><code>HP LaserJet</code></td><td><code>Type</code> <code>ne contient pas</code> <code>Dell</code></td><td>✅</td></tr><tr><td><strong>commence par</strong></td><td>Vrai si la valeur commence par le critère.</td><td><code>GLPI-123</code></td><td><code>Nom</code> <code>commence par</code> <code>GLPI</code></td><td>✅</td></tr><tr><td><strong>se termine par</strong></td><td>Vrai si la valeur se termine par le critère.</td><td><code>PC-01</code></td><td><code>Nom</code> <code>se termine par</code> <code>01</code></td><td>✅</td></tr><tr><td><strong>correspond à l’expression régulière</strong></td><td>Vrai si la valeur correspond à l’expression régulière donnée.</td><td><code>GLPI-2025</code></td><td><code>Nom</code> <code>correspond à l’expression régulière</code> <code>/GLPI-\d+/</code></td><td>✅</td></tr><tr><td><strong>ne correspond pas à l’expression régulière</strong></td><td>Vrai si la valeur ne correspond <strong>pas</strong> à l’expression régulière donnée.</td><td><code>GLPI-ABC</code></td><td><code>Nom</code> <code>ne correspond à l’expression régulière</code> <code>/\d+/gm</code></td><td>✅</td></tr><tr><td><strong>existe</strong></td><td>Permet de vérifier si le champ est présent dans les données envoyées au moteur, quel que soit son contenu.</td><td><code>Description</code></td><td><code>nom</code> <code>existe</code> <code>oui</code></td><td>✅</td></tr><tr><td><strong>n’existe pas</strong></td><td>Permet de vérifier si le champ est absent des données envoyées au moteur.</td><td><code>Description</code></td><td><code>champ_fantome</code> <code>n'existe pas</code> <code>oui</code></td><td>✅</td></tr><tr><td><strong>est sous</strong></td><td>Vérifie si un élément (ex. entité, catégorie) est enfant ou descendant d’un parent donné dans la hiérarchie GLPI.</td><td><code>Paris</code></td><td><code>Entité</code> <code>est sous</code> <code>France</code></td><td>✅</td></tr><tr><td><strong>n’est pas sous</strong></td><td>Vérifie si un élément (ex. entité, catégorie) n’est pas descendant du parent spécifié.</td><td><code>Lyon</code></td><td><code>Entité</code> <code>n’est pas sous</code> <code>Paris</code></td><td>✅</td></tr><tr><td><strong>est vide</strong></td><td>Vrai si le champ est vide.</td><td></td><td><code>Nom</code> <code>est vide</code> <code>oui</code></td><td>✅</td></tr><tr><td><strong>correpond au CIDR</strong></td><td>Vrai si l’adresse IP appartient au sous-réseau donné.</td><td><code>192.168.1.5</code></td><td><code>IP</code> <code>correpond au CIDR</code> <code>192.168.1.0/24</code></td><td>✅</td></tr><tr><td><strong>ne correpond pas au CIDR</strong></td><td>Vrai si l’adresse IP n’appartient pas au sous-réseau donné.</td><td><code>10.0.0.1</code></td><td><code>IP</code> <code>ne correpond pas au CIDR</code> <code>192.168.1.0/24</code></td><td>✅</td></tr><tr><td><strong>date avant</strong></td><td>Vrai si la date est strictement antérieure au critère.</td><td><code>2025-01-01</code></td><td><code>Date</code> <code>avant</code> <code>2025-06-01</code></td><td>✅</td></tr><tr><td><strong>date après</strong></td><td>Vrai si la date est strictement postérieure au critère.</td><td><code>2025-12-01</code></td><td><code>Date</code> <code>après</code> <code>2025-06-01</code></td><td>✅</td></tr><tr><td><strong>date égale</strong></td><td>Vrai si la date est exactement égale au critère.</td><td><code>2025-09-26</code></td><td><code>Date</code> <code>est</code> <code>2025-09-26</code></td><td>✅</td></tr><tr><td><strong>date différente</strong></td><td>Vrai si la date est différente du critère.</td><td><code>2025-09-25</code></td><td><code>Date</code> <code>n’est pas</code> <code>2025-09-26</code></td><td>✅</td></tr><tr><td><strong>est déjà présent</strong></td><td>Vrai si déjà présent</td><td></td><td></td><td></td></tr></tbody></table>

### Cas particuliers

#### Regex dans le moteur de règles GLPI

**Format attendu :**

* Le champ `pattern` doit contenir une **expression régulière valide en PHP**, entourée de `/`.
  * Exemple correct : `/GLPI-(\d+)/`
* L’expression est automatiquement complétée avec les *flags* `si` :
  * s : Active le mode « dotall », qui permet au point `.` de correspondre également au caractère de saut de ligne `\n`.
  * **i** : insensible à la casse.
* Exemple de pattern : `/GLPI-(\d+)/` devient `/GLPI-(\d+)/si` lors de l’évaluation.

**Fonctionnement :**

1. Le moteur effectue un `preg_match_all` sur la valeur du champ avec le pattern.
2. Si un ou plusieurs matchs sont trouvés :
   * Chaque groupe capturé est récupéré et ajouté dans le tableau `$regex_result`.
3. Si aucun match n’est trouvé, le critère sera évalué à `faux`.

**Groupes de capture multiples :**

* Il est possible d’utiliser plusieurs parenthèses dans le pattern pour capturer plusieurs sous-valeurs.
* Ces valeurs peuvent ensuite être récupérées dans l’action **“Valeur depuis expression régulière”**.
* Les groupes capturés sont accessibles avec `#0`, `#1`, `#2`, etc., en fonction de leur ordre dans le pattern.

**Exemple :**

* Pattern : `/GLPI-(\d+)-([A-Z]+)/`
* Champ : `GLPI-123-ABC`
* Résultat dans `$regex_result` :
  * `#0` = `123`
  * `#1` = `ABC`

***

## **Quels actions sont disponibles ?**

Dans GLPI, les **actions** définissent ce qui doit se produire lorsqu’une règle est déclenchée. Elles permettent, par exemple :

* **De modifier un champ** existant
* **D’assigner une valeur** à une liste déroulante
* **D’ajouter une valeur** dans un champ
* **De supprimer la valeur** d’un champ

Ces actions sont exécutées automatiquement dès que les conditions de la règle sont remplies, ce qui permet d’**automatiser le traitement** des éléments et d’assurer une **gestion cohérente et efficace**.

Selon le champ sélectionné , les actions proposés par GLPI peuvent varier.

<table data-search="false"><thead><tr><th>Actions</th><th>Description</th><th>Exemple (champ - action - valeur)</th></tr></thead><tbody><tr><td><strong>Assigner</strong></td><td>Affecte / remplace la valeur indiquée à un champ</td><td><code>Lieu</code> <code>Assigner</code> <code>Paris</code></td></tr><tr><td><strong>Ajouter</strong></td><td>Ajoute la valeur à une liste existante</td><td><code>Demandeur</code> <code>Ajouter</code> <code>John Doe</code></td></tr><tr><td><strong>Assigner valeur depuis l'expression régulière</strong></td><td>Assigner / remplace la valeur extraite d’une expression régulière</td><td><code>Entité de puis le TAG</code> <code>Assigner valeur depuis l'expression régulière</code> <code>#0</code></td></tr><tr><td><strong>Ajouter le résultat de l'expression régulière</strong></td><td>Ajouter le résultat de l'expression régulière</td><td><code>OS Version</code> <code>Ajouter le résultat de l'expression régulière</code> <code>#1</code></td></tr><tr><td><strong>Assigner : matériel par adresse IP</strong></td><td>Assign un équipement basé sur son adresse IP</td><td><code>Élément associé</code> <code>Assigner matériel par adresse IP</code> <code>192.168.1.10</code></td></tr><tr><td><strong>Assigner : matériel par FQDN</strong></td><td>Assign un équipement basé sur son FQDN</td><td><code>Élément associé</code> <code>Assigner matériel par FQDN</code> <code>server1.example.com</code></td></tr><tr><td><strong>Assigner : matériel par MAC</strong></td><td>Assign un équipement basé sur la MAC adresse</td><td><code>Élément associé</code> <code>Assigner matériel par MAC</code> <code>00:37:6C:E2:EB:62</code></td></tr><tr><td><strong>Recalculer</strong></td><td>Recalcule automatiquement une valeur</td><td><code>Priorité</code> <code>Recalculer</code></td></tr><tr><td><strong>Supprimer</strong></td><td>Supprime la valeur du champ</td><td><code>TTR</code> <code>supprimer</code></td></tr><tr><td><strong>Ne pas calculer</strong></td><td>Empêche le calcul automatique d’un champ</td><td><code>Délai de prise en charge</code> <code>Ne pas calculer</code></td></tr><tr><td><strong>Envoyer</strong></td><td>Envoie une notification</td><td><code>Rappels automatiques pour les SLAs</code> <code>Envoyer</code> <code>Oui</code></td></tr><tr><td><strong>Envoyer une demande de validation</strong></td><td>Envoie une demande de validation</td><td><code>Envoyer une demande de validation - Utilisateur</code> <code>Envoyer</code> <code>John Doe</code></td></tr><tr><td><strong>Copier depuis l'utilisateur</strong></td><td>Copie la valeur depuis l’utilisateur</td><td><code>Lieu</code> <code>Copier depuis l’utilisateur</code></td></tr><tr><td><strong>Copier le défaut depuis l'utilisateur</strong></td><td>Copie la valeur par défaut depuis l’utilisateur</td><td><code>Groupe</code> <code>Copier le défaut depuis l'utilisateur</code></td></tr><tr><td><strong>Copier le premier groupe de l’utilisateur</strong></td><td>Copie le premier groupe de l’utilisateur</td><td><code>Groupe</code> <code>Copier le premier groupe depuis l'utilisateur</code></td></tr><tr><td><strong>Copier depuis l'élément</strong></td><td>Copie la valeur depuis un élément associé</td><td><code>Groupe de technicien</code> <code>Copier depuis l'élément</code></td></tr></tbody></table>

***

## Import / Export

L'exportation, l'importation et la duplication sont possibles pour toutes les règles. Ces opérations peuvent être effectuées globalement depuis la page principale des règles ou par lots depuis les moteurs de recherche des différentes règles via des actions massives. Ces fonctionnalités sont intéressantes par exemple dans le contexte de la bascule de règles d'un environnement de pré-production vers un environnement de production.

{% hint style="info" %}
l'exportation ou l'importation utilisent un format de fichier XML
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.glpi-project.org/glpi-12/fr/administration/rules.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
