Ferme proprement la session GLPI active.

Liste les tickets avec pagination optionnelle.

• status : 1=Nouveau 2=En cours(attribué) 3=En cours(planifié) 4=En attente 5=Résolu 6=Clos

• type : 1=Incident 2=Demande de service

• range_start / range_limit : pagination

Retourne le détail complet d'un ticket, avec libellés lisibles.

Recherche avancée de tickets via l'API GLPI /search/Ticket. Tous les paramètres sont optionnels et combinables (combinés en ET).

Trois portées de recherche textuelle, à ne pas confondre :

• keywords : le titre seulement. Rapide, mais aveugle au corps du ticket et aux suivis. C'est la portée historique de cet outil.

• content_keywords : la description du ticket (corps initial).

• followup_keywords : le contenu des suivis. Indispensable pour l'analyse historique : sur la plupart des instances, l'essentiel de la connaissance d'investigation vit dans les suivis, pas dans les titres. Le nom d'un outil ou d'un correctif mentionné uniquement en cours de diagnostic ne se trouve que par cette portée.

Note de performance : content_keywords et followup_keywords produisent un LIKE '%motif%' côté MySQL. Sans index FULLTEXT, ces recherches sont sensiblement plus lentes que par titre — les combiner avec status, category_id ou ticket_type pour réduire l'ensemble balayé.

Crée un nouveau ticket.

• type : 1=Incident 2=Demande de service

• priority : 1 (très basse) → 6 (majeure)

Met à jour un ticket. Passer uniquement les champs à modifier. Exemples de champs : status, priority, name, content, itilcategories_id

Supprime un ticket par son ID.

Crée un lien entre deux tickets.

• link_type : 1=Lié à, 2=Duplique, 3=Enfant de, 4=Parent de

Liste tous les liens d'un ticket avec d'autres tickets.

Fusionne un ou plusieurs tickets source vers un ticket cible.

• Lie chaque ticket source au ticket cible comme doublon (link_type=2)

• Copie les suivis des tickets source vers le ticket cible (si add_followups=True)

• Ferme les tickets source avec un suivi explicatif (si close_source=True)

Paramètres :

• target_ticket_id : ID du ticket cible (celui qui reste ouvert)

• source_ticket_ids : liste des IDs de tickets à fusionner dans le cible

• add_followups : copier les suivis des tickets source vers le cible

• close_source : fermer les tickets source après la fusion

Liste toutes les catégories ITIL disponibles (Incident, Demande, Changement, Problème).

Liste tous les suivis d'un ticket.

Ajoute un suivi à un ticket.

• is_private : True pour un suivi visible uniquement par les techniciens

Retourne le détail d'un suivi spécifique.

Met à jour un suivi existant. Exemples de champs : content, is_private.

Le champ content doit être en HTML compatible GLPI, jamais en Markdown (cf. instructions du serveur).

Note : un suivi est une pièce horodatée et signée du dossier. Corriger le contenu d'un suivi déjà publié réécrit l'historique visible par l'équipe — à réserver aux corrections d'erreurs factuelles récentes. Pour un changement de fond, préférer l'ajout d'un nouveau suivi via add_followup, qui conserve la trace du raisonnement antérieur.

Supprime un suivi.

ATTENTION : opération destructive et non réversible depuis cet outil — le suivi disparaît de la piste d'audit du ticket. Ne l'utiliser que sur un suivi publié par erreur (mauvais ticket, doublon). Pour corriger un contenu, utiliser update_followup ; pour nuancer une conclusion, add_followup.

Liste toutes les tâches d'un ticket.

Crée une tâche sur un ticket.

• status : 1=À faire 2=Terminée

• duration_seconds : durée en secondes (ex. 3600 = 1h)

Met à jour une tâche. Exemples : state (1/2), content, actiontime, users_id_tech

Supprime une tâche.

Retourne la solution d'un ticket.

Poste une solution sur un ticket (le clôture automatiquement selon la config GLPI).

• solution_type_id : ID du type de solution si applicable

Retourne le nombre de tickets ouverts par statut.

Retourne le nombre de tickets par type (Incident / Demande de service).

Retourne le nombre de tickets ouverts par priorité.

Retourne le nombre de tickets par catégorie ITIL.

Retourne le nombre de tickets par technicien assigné.

Retourne le délai moyen de résolution des tickets résolus ou clos.

Retourne les tickets en retard (date d'échéance dépassée et non résolus). Utilise le champ time_to_resolve de GLPI.

Liste les utilisateurs GLPI.

Liste les groupes GLPI.

Liste les fournisseurs enregistrés dans GLPI.

• name_contains : filtre optionnel sur le nom (recherche partielle)

• only_active : n'inclure que les fournisseurs actifs (is_active = 1)

• range_start / range_limit : pagination

Crée un fournisseur.

• name : raison sociale (seul champ obligatoire)

• supplier_type_id : ID d'un SupplierType existant (optionnel)

• comment : texte libre, en HTML compatible GLPI (jamais de Markdown)

Crée un contact (personne-ressource chez un fournisseur).

• name : nom de famille (seul champ obligatoire)

• contact_type_id : ID d'un ContactType existant (optionnel)

• supplier_id : si fourni, le contact est rattaché à ce fournisseur via Contact_Supplier. Le résultat contient alors la clé "_supplier_link".

• comment : texte libre, en HTML compatible GLPI (jamais de Markdown)

Crée un contrat.

• name : intitulé du contrat (seul champ obligatoire)

• num : numéro de contrat chez le fournisseur

• begin_date : date de début, format AAAA-MM-JJ

• duration / notice / periodicity / billing : en MOIS (convention GLPI)

• supplier_id : si fourni, le contrat est rattaché à ce fournisseur via Contract_Supplier. Le résultat contient alors la clé "_supplier_link".

• comment : texte libre, en HTML compatible GLPI (jamais de Markdown)

Met à jour un fournisseur. Passer uniquement les champs à modifier. Exemples de champs : name, suppliertypes_id, address, town, phonenumber, email, website, comment, is_active Pour restaurer un fournisseur mis à la corbeille : {"is_deleted": 0}

Met à jour un contact. Passer uniquement les champs à modifier. Exemples de champs : name, firstname, contacttypes_id, phone, mobile, email, comment Pour restaurer un contact mis à la corbeille : {"is_deleted": 0}

Met à jour un contrat. Passer uniquement les champs à modifier. Exemples de champs : name, num, contracttypes_id, begin_date, duration, notice, periodicity, billing, accounting_number, comment Les durées sont en MOIS et begin_date au format AAAA-MM-JJ. Pour restaurer un contrat mis à la corbeille : {"is_deleted": 0}

Supprime un fournisseur.

• purge=False (défaut) : mise à la corbeille, réversible via update_supplier(supplier_id, {"is_deleted": 0})

• purge=True : suppression définitive et IRRÉVERSIBLE, qui retire aussi les rattachements du fournisseur à ses contrats, contacts, matériels et tickets. À n'utiliser que sur un doublon ou une saisie erronée.

Supprime un contact.

• purge=False (défaut) : mise à la corbeille, réversible via update_contact(contact_id, {"is_deleted": 0})

• purge=True : suppression définitive et IRRÉVERSIBLE.

Supprime un contrat.

• purge=False (défaut) : mise à la corbeille, réversible via update_contract(contract_id, {"is_deleted": 0})

• purge=True : suppression définitive et IRRÉVERSIBLE, qui retire aussi les rattachements du contrat à ses matériels et à son fournisseur.

List GLPI knowledge base articles with pagination.

Each KnowbaseItem returned by the API embeds the full HTML answer. On large KBs this makes the JSON response heavy: in production we observed that range_start > 60 combined with range_limit > 10 is enough to exceed PHP-FPM memory_limit on the GLPI side and the request fails. To stay below that ceiling, range_limit is auto-clamped to 10 when range_start > 60. When clamping kicks in the response is wrapped in a dict carrying _clamped_range_limit and _warning so callers can detect the change. Behaviour is unchanged for range_start <= 60.

Retourne le détail complet d'un article de la base de connaissances.

Search knowledge base articles by keyword.

By default the search runs only against the title column, which is fast on any GLPI instance. Set search_content=True to also match against the full HTML body. On a GLPI instance that has no MySQL FULLTEXT index on knowbaseitems.answer, that branch produces a LIKE '%keyword%' scan on the answer column which routinely exceeds the 30 second client timeout on KBs with sizeable HTML payloads.

Field IDs are discovered at runtime via listSearchOptions/KnowbaseItem and looked up by column name ("name", "answer") so the tool works on both GLPI 10 and GLPI 11 (where numeric IDs may differ). When discovery fails the legacy GLPI 10 IDs (6 for title, 7 for body) are used as a fallback.

Parameters:

• keywords: text to search for

• range_start, range_limit: pagination

• search_content: also match against the article body (default False). Only enable when the GLPI database has a FULLTEXT index on knowbaseitems.answer, otherwise the request will be slow.

Crée un nouvel article dans la base de connaissances.

• name : titre de l'article

• answer : contenu / solution (HTML accepté)

• category_id : ID de la catégorie KB (optionnel)

• is_faq : True pour publier dans la FAQ publique

Met à jour un article de la base de connaissances. Exemples de champs : name, answer, is_faq, knowbaseitemcategories_id

Liste toutes les catégories de la base de connaissances.

Retourne les règles de visibilité d'un article KB : profils, groupes, utilisateurs et entités ayant accès.

Ajoute un profil dans la visibilité d'un article KB.

• profiles_id : ID du profil GLPI

• entities_id : 0 = entité racine

• is_recursive : appliquer aux sous-entités

Ajoute un groupe dans la visibilité d'un article KB.

• groups_id : ID du groupe GLPI

Met à jour une règle de visibilité par profil d'un article KB.

• visibility_id : ID de l'entrée KnowbaseItem_Profile (obtenu via get_kb_article_visibility)

• update_fields : champs à modifier, ex: {"entities_id": 1, "is_recursive": 1}

Met à jour une règle de visibilité par groupe d'un article KB.

• visibility_id : ID de l'entrée KnowbaseItem_Group (obtenu via get_kb_article_visibility)

• update_fields : champs à modifier, ex: {"entities_id": 1, "is_recursive": 1}