# Inventory Number Generation

## Source

| Téléchargement                                               | Sources                                             |
| ------------------------------------------------------------ | --------------------------------------------------- |
| <https://github.com/pluginsGLPI/geninventorynumber/releases> | <https://github.com/pluginsGLPI/geninventorynumber> |

***

## Prérequis

| Version GLPI | PHP minimum | Recommandé |
| ------------ | ----------- | ---------- |
| 10.0.x       | 8.1         | 8.2        |
| 11.0.x       | 8.2         | 8.4        |

{% hint style="info" %}
Ce plugin est disponible sans souscription [GLPI Network](https://services.glpi-network.com/#offers). Il est également disponible sur [GLPI Cloud](https://glpi-network.cloud).
{% endhint %}

***

## Fonctionnalité

Le plugin Inventory number generation permet de générer dynamiquement des numéros d’inventaire en suivant un modèle configuré par l’utilisateur.

***

## Installer le plugin

Téléchargez et installez le plugin **Inventory number generation** depuis le marketplace

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FRpzHjp3vhPZK1BVgrZG5%2Finstall-ING.png?alt=media&#x26;token=cd7bd411-9e6e-4dbe-96b3-8dfdaf6e3e2c" alt=""><figcaption></figcaption></figure></div>

***

## Configuration du plugin

Vous retrouverez la page de configuration dans **`Outils` > `Génération de numéros d’inventaire`**.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FpfDGaAP1aXk9K61l1CHv%2Fsetup-IGN.png?alt=media&#x26;token=304dd061-7c09-40bf-9ee1-72a426a5e18a" alt=""><figcaption></figcaption></figure>

### Configuration globale

* **Champ**: Indique le champ qui recevra la valeur d’inventaire générée par le plugin.
* **Activé**: Permet d’activer ou non la génération automatique des numéros d’inventaire
* **Position de l’index global**: Position de l’index global dans l’incrémentation
* **Mode de réinitialisation de l’index**: Fréquence de réinitialisation de l’index global
* **Commentaire**: Saisir un commentaire

### Configuration spécifique

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2F8WOzRkH76wZDKztHPjWe%2Fspecific-configuration.png?alt=media&#x26;token=04869ae9-c788-4230-96a2-be55dd058144" alt=""><figcaption></figcaption></figure>

La configuration spécifique permet de faire une configuration plus personnalisée pour un type d’objet précis.

* **Modèle de génération**: Configuration du modèle pour la génération des numéros d’inventaire.
* **Activé**: Autorise ou non le plugin à générer un numéro d’inventaire pour le type d’objet
* **Utiliser l’index global**: Utiliser l’index global ou privé comme index de référence dans l’indentation des numéros d’inventaire. L’indentation de l’index global sera effective pour tous les objets qui l’utilisent.

Les options suivantes s’affichent si l’option “Utiliser l’index global“ est défini sur “Non“

* **Position de l’index**: Position de l’index de l’objet dans l’incrémentation
* **Mode de réinitialisation de l’index**: Fréquence de réinitialisation de l’index de l’objet

***

## Configurer un modèle de génération

Un modèle est une chaîne de texte contenant une partie générée **automatiquement**. Chaque partie générée doit être délimitée par `<` et `>`. Le texte situé en dehors de ces délimiteurs est traité comme du texte brut.

### Masque du compteur auto-incrémenté

La valeur est définie par une suite de dièses (`#`) et permet de représenter un nombre qui s’incrémente de 1 à chaque génération. Le nombre de `#` indique le nombre de chiffres significatifs à générer. Les positions non utilisées sont complétées par des zéros.

Si la valeur dépasse le nombre de chiffres défini dans le masque, le compteur continuera à s’incrémenter et un chiffre supplémentaire sera ajouté. L’ajout de ce chiffre supplémentaire concerne uniquement le numéro d’inventaire généré et ne modifie pas le modèle.\
\
**Exemple**:

| Modèle   | Index | Résultat |
| -------- | ----- | -------- |
| <###>    | 0     | 001      |
| <###>    | 20    | 021      |
| <#>      | 9     | 10       |
| PC-<###> | 0     | PC-001   |

### Masque de date

La valeur est remplacée en sélectionnant, le jour, le mois et/ou l’année suivant les masques utilisés dans le modèle. Il est obligatoire d’avoir un masque de compteur auto-incrémenté pour que le masque de date fonctionne correctement.

| Masque | Description          |
| ------ | -------------------- |
| \d     | Jour sur 2 chiffres  |
| \m     | Mois sur 2 chiffres  |
| \y     | Année sur 2 chiffres |
| \Y     | Année sur 4 chiffres |

**Exemple**:

Date: 24/02/2026

| Modèle        | Index | Résultat      |
| ------------- | ----- | ------------- |
| <\d-###>      | 0     | 24-001        |
| <\m-###>      | 0     | 12-001        |
| <\y-###>      | 0     | 26-001        |
| <\Y-###>      | 0     | 2026-001      |
| PC-<\d\m\Y-#> | 2     | PC-24022026-3 |

### Masque d’objet

Il est possible d’utiliser certaines informations de l’objet pour générer le numéro d’inventaire. Il est obligatoire d’avoir un masque de compteur auto-incrémenté pour que le masque de date fonctionne correctement.

| Masque | Description                |
| ------ | -------------------------- |
| \s     | Numéro de série de l'objet |
| \n     | Nom de l'objet             |

**Exemple**:

Numéro de série: 123

Nom: Bureau

| Modèle         | Index | Résultat          |
| -------------- | ----- | ----------------- |
| <\s-###>       | 0     | 123-001           |
| <\n-###>       | 0     | Bureau-001        |
| PC-<\n-\s-###> | 2     | PC-Bureau-123-003 |

***

## Génération du nombre d’inventaire pour les objets personnalisés

GLPI 11 introduit les objets personnalisés, qui ont été rendus nativement compatibles avec le plugin.

Par défaut, les assets personnalisés ne sont pas impactés par le plugin. Pour permettre au plugin de générer également des numéros d’inventaire pour ces objets, il est nécessaire de :

1. Se rendre dans la liste des capacités de l’asset concerné ;
2. Activer la capacité ajoutée par le plugin : **« Génération de numéros d’inventaire »**.

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FA5fnkoH119IK89SK0URU%2Fasset-deffinition-IGN.png?alt=media&#x26;token=fbcf031a-d18b-4e99-af64-71c083f5a95c" alt=""><figcaption></figcaption></figure></div>