History

Stocks Description

Français

Le plugin Stocks surveille l'état des stocks et envoie des alertes en cas de "rupture" (popup et/ou emails).
Les items pris en charges sont les Ordinateurs, les Moniteurs, les Imprimantes, les Périphériques , les Equipements Réseaux ainsi que les Téléphones.

Configuration

Le status

Il est nécessaire de configurer le status correspondant aux éléments en stocks à surveiller. Cela se fait dans la configuration globale du plugin.

On appelera ce status "En stock" dans la suite.

Les seuils d'alertes

Stocks se base sur des seuils configurables sur 3 niveaux :
  1. Le niveau global - configuration globale du plugin
  2. Le niveau "item" (Ordinateurs, Moniteurs...) - onglet "config"
  3. Le niveau modèles et types d'item (types d'ordinateurs, modèles d'ordinateurs, types de moniteurs...) - onglets types/modèles

Seul le dernier niveau est pris en compte. Les niveaux suppérieurs servent à définir des niveaux par défaut qui sont alors repris par défaut par les niveaux suivants.

Les lieux

Par défaut, le lieu choisi dans la configuration générale sera considéré comme un lieu générique (méta lieu).
Ses sous-lieu seront automatiquements importés avec la possibilité de déterminer des seuils spécifiques par chacun d'eux.

Le lieu principal peut être considéré comme un meta-lieu ou comme un lieu normal.

Un meta-lieu considère que tous les items "En stock" se trouvent dans le meta-lieu.

Un lieu normal ajoute la contrainte que l'item doit se trouver effectivement dans le lieu en question.

Note : il est nécessaire de sélectionner un lieu, sinon le plugin importera tous les lieux définis dans glpi.

Les profils

Il est possible de limiter l'accès au plugin via les profils glpi. Acutellement, seule la valeur "stock" du profil est utilisable (pas Ordinateurs, Moniteurs...).

Les alertes

Stocks utilise des niveaux d'alertes pour la gestion des alertes.

Lorsque le stock est sain, le niveau d'alerte = 0

Lorsque le niveau du stock
  1. passe sous le au seuil d'alerte => niveau = 1
  2. passe sous la moitié du seuil d'alerte => niveau = 2
  3. devient nul => niveau 3

Le plugin enverra une alerte (popup et/ou email) chaque fois que le niveau d'alerte augmente.

Notes : Il est possible d'adapter le format du mail envoyé via les fichiers /templates/email_*

Bugs

  • Les items supprimés sont comptabilisés comme étant présents (corrigé dans la 0.92).
  • La modificiation du lieu principal par un lieu de la même branche pose problème (corrigé dans la 0.94).

Todo

  • Hook sur l'ajout/suppresion des lieux. (ajouté dans 0.94).
  • Hook sur mise à jour des lieux.

English

The stocks plugin monitors stocks levels and sends alerts on stock shortages (popup and/or emails).
The monitored items are
  • Computers
  • Monitors
  • Peripherals
  • Network Equipments
  • Phones
  • Printers

Configuration

The state

It is mandatory to select the stated to be monitored in the main plugin config form. The monitored state will be known as "Stock" below.

Alert levels

The Stocks plugin triggers on a 3-level threshold:
  1. The Main Level - see plugin's main config form
  2. The item level (Computer, Monitor...) - see item's config form
  3. The Models and Types Levels (computer types, computer models, monitor types...)

Only the latest level does matter regarding the monitoring. By default lower levels configs default to upper levels configs.

Locations

By default the selected main location will be seen as a meta-location.
All sub-locations will automatically be imported as well as their specific configs.

One can choose to use the main location as a meta-location as well as a common location.

A meta-location sees each "Stock" item as belonging to the location.

A common location needs the item to actually be in the location.

Note : it is mandatory to select a main location. Otherwise every glpi location would be imported.

Profiles

Stocks plugin access is configured through glpi profiles. Only the "stock" profile would work for the moment (not Computer, Monitor...).

Alerts

"Alerts levels" are used to monitor stocks healths.

A healthy stock's level = 0

Whenever "Stock" item count would
  1. go beneath the threshold => level 1
  2. go beneath half of the threshold => level 2
  3. become null => level 3

The plugin will send an alert (email and/or popup) whenever the "alert level" increases.

Notes : To adapt email format see /templates/email_* files

Known Bugs

  • Deleted items show in stocks tables (fixed in 0.92).
  • Updating the main stock location with a location within the same branch is buggy (fixed in 0.94)

Todo

  • Hook on adding/deleting locations (added in 0.94).
  • Hook on updating locations.

Stocks Versions