Fields

Le plugin Fields permet d'ajouter des champs supplémentaires sur divers éléments gérés par GLPI : tickets, ordinateurs, utilisateurs, ...

Prérequis (auto-hébergé)

Version GLPI
PHP Minimum
Recommandé

10.0.x

8.1

8.2

11.0.x

8.2

8.4

Ce plugin est disponible sans souscription GLPI Network. Il est également disponible sur GLPI Cloud.

Installer le plugin

  • Allez sur le marketplace. Téléchargez et installez le plugin Fields.

Fonctionnalités

  • Ajouter des blocs de conteneurs sur divers éléments,

  • Ajouter des champs dans les blocs,

  • Afficher les blocs dans un onglet existant ou dans leur propre onglet,

  • De nombreux types de champs disponibles,

  • Les champs peuvent être marqués comme obligatoires,

  • Gérer les ACLs de profils par conteneur,

  • ...

Installer le Plugin

  • Décompressez l'archive.

  • Déplacez le répertoire fields dans le répertoire <GLPI_ROOT>/plugins.

  • Naviguez vers la page Configuration > Plugins.

  • Installez et activez le plugin.

Utilisation

Le plugin créera automatiquement les tables nécessaires dans la base de données et certains fichiers sur le disque (dans <GLPI_ROOT>/files/_plugins/fields). Ces fichiers et tables seront mis à jour avec le plugin.

L'utilisation du plugin est assez simple :

  • créez un bloc lié à certains éléments,

  • créez des champs dans ce bloc.

Vous accéderez à la configuration du plugin depuis le menu Configuration > Champs additionnels.

Ajout d'un nouveau bloc

image
  • Label : le libellé du bloc qui apparaîtra sur les formulaires des éléments,

  • Type : type d'affichage, l'un des suivants :

    • Ajouter un onglet : ajoutera un nouvel onglet sur le formulaire de l'élément contenant le bloc,

    • Insertion dans le formulaire : ajoutera le bloc à la fin du formulaire principal de l'élément,

    • Insertion dans le formulaire d'un onglet spécifique : ajoutera le bloc à la fin d'un onglet spécifique de l'élément.

  • Type d'élément associé : une liste des types d'éléments sur lesquels le bloc sera ajouté,

  • Actif : si le bloc est actif ou non.

Vous ne pouvez ajouter qu'un seul bloc de type Insertion dans le formulaire pour un type d'élément associé.

L'insertion d'un bloc dans un onglet spécifique n'est possible que pour un seul élément :

image

Une fois qu'un bloc a été créé, il est possible de modifier son libellé ou son indicateur d'activité, mais pas son type ou sa liste d'éléments associés.

Profils

Vous pouvez affiner les accès des profils sur le bloc en utilisant l'onglet Profils du bloc. Vous pourrez choisir entre Aucun accès, Lecture ou Écriture pour chaque profil existant.

image

Ajout d'un nouveau champ

image
  • Label : le libellé du bloc qui apparaîtra sur les formulaires des éléments,

  • Type : type de champ, l'un des suivants :

    • En-tête : un libellé d'en-tête, pour une distinction visuelle,

    • Texte (une ligne) : une ligne unique ( input/@type="text" ) de texte,

    • Texte (plusieurs lignes) : un texte multiligne ( textarea ),

    • Nombre : un nombre unique (aucun texte autorisé),

    • Liste déroulante : une liste déroulante configurable, les valeurs sont configurées à partir de la configuration principale des listes déroulantes de GLPI que vous trouverez dans le menu Configuration > Listes déroulantes,

    • Oui/Non : une liste déroulante avec uniquement les valeurs Oui et Non,

    • Date : une date autonome avec un sélecteur de date,

    • Date et heure : un champ de date avec un sélecteur de date et un champ déroulant d'heure (le pas est configuré à partir du cœur de GLPI),

    • Utilisateurs : liste des utilisateurs.

  • Actif : si le bloc est actif ou non,

  • Lecture seule : marquer ce champ comme lecture seule,

  • Valeurs par défaut : valeurs par défaut du champ,

  • Champ obligatoire : marquer ce champ comme obligatoire.

Une fois les champs créés, vous pouvez les réorganiser ou les modifier depuis l'onglet Champs du bloc :

image

Et voir à quoi cela devrait ressembler sur un élément Utilisateur, par exemple :

image

Recherche

Tous les champs qui ont été ajoutés sont disponibles dans les formulaires de recherche des éléments associés.

Interface simplifiée

Seuls les blocs attachés aux tickets et de type Insertion dans le formulaire seront affichés dans l'interface simplifiée de création de ticket. Bien sûr, cela prendra également en compte les droits du profil actuel !

Traductions

Ajouté dans la version 1.4.0.

Le plugin lui-même est traduit à l'aide des services transifex ; mais vous pouvez également traduire les valeurs des libellés des blocs et des champs ; le processus est identique pour les deux :

Sur le formulaire du bloc, choisissez l'onglet Traductions :

image

Lors de la création d'un bloc, une nouvelle traduction avec la langue actuelle et la valeur définie comme libellé sera créée ; vous pouvez ajouter autant de traductions que vous le souhaitez.

image

Les valeurs des listes déroulantes peuvent être traduites en utilisant la configuration des listes déroulantes du cœur.

Entités

Si vous utilisez des entités dans votre instance GLPI, un bloc sera affiché uniquement si l'entité à laquelle il est attaché est compatible avec celle de l'élément auquel il s'applique.

Lorsque vous créez ou modifiez un bloc en mode multi-entités, vous devrez choisir si le bloc sera disponible dans les entités enfants :

image

Par exemple, supposons que nos entités aient la structure suivante :

  • root

    • A

      • C

    • B

Le tableau suivant vous indiquera dans quels cas le bloc est affiché ou non :

Entité du bloc
Bloc récursif
Entité de l'élément
Bloc affiché

A

Oui ou Non

A

Oui

A

Oui ou Non

B

Non

A

Oui

C

Oui

A

Non

C

Non

FAQ

Si vous avez des questions sur l'utilisation du plugin, veuillez consulter notre FAQ

Mis à jour

Ce contenu vous a-t-il été utile ?