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 :- Le niveau global - configuration globale du plugin
- Le niveau "item" (Ordinateurs, Moniteurs...) - onglet "config"
- 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- passe sous le au seuil d'alerte => niveau = 1
- passe sous la moitié du seuil d'alerte => niveau = 2
- 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:- The Main Level - see plugin's main config form
- The item level (Computer, Monitor...) - see item's config form
- 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- go beneath the threshold => level 1
- go beneath half of the threshold => level 2
- 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¶
- Stocks 0.92 (beta)
- 0.94 - Locations bug fixed and hooks added for "ADD/PURGE" locations