> For the complete documentation index, see [llms.txt](https://help.glpi-project.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.glpi-project.org/glpi-12/fr/tools/knowledgebase.md).

# Base de connaissances

La base de connaissances de GLPI a deux cibles principales :

* Rassembler les connaissances internes pour les techniciens ;
* Fournir des informations sous forme de FAQ publique pour permettre aux utilisateurs de résoudre eux-mêmes des problèmes simples.

{% hint style="success" %}
Seuls les articles de la FAQ publique sont visibles par les utilisateurs de l'interface simplifiée. Les autres éléments ne sont visibles que par les techniciens via l'interface standard.
{% endhint %}

Chaque article de la base de connaissances doit avoir une ou plusieurs cibles, qu'il s'agisse d'entités, de groupes, de profils ou d'utilisateurs, pour être lisible.

Tant qu'un article n'a pas de cible, il n'est visible que par son auteur, est marqué comme `Non publié` <i class="fa-eye-slash">:eye-slash:</i> et apparaît dans le tableau `Articles non publiés` ![](https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-44fc66b0fa41f3771de57a6e69352e2f76e43500%2Fimage%20\(2\).png?alt=media) sur la page d'accueil de la base de connaissances.

Il est également possible de joindre des documents aux articles de la base de connaissances.

{% hint style="info" %}

* Le ciblage s'applique de la même manière que l'article soit dans la FAQ ou uniquement dans la base de connaissances.
* Vous pouvez publier un article pour tout le monde en ciblant l'entité racine. D'autres options de d'[autorisations](#autorisations) sont disponibles
* Un article peut être rendu visible pendant une période définie en spécifiant une date de début et une date de fin.
  {% endhint %}

{% hint style="warning" %}
Les éléments qui ne doivent pas être interprétés lors de leur affichage peuvent être définis avec le style préformaté (`<pre>` en HTML). Des balises comme `<VirtualHost>` peuvent donc être insérées et seront affichées. D'autres balises HTML (`<TAG>...</TAG>`) peuvent disparaître lors de l'édition ; pour avoir une visibilité complète du texte, il est possible de passer en mode HTML où tous les éléments seront visibles. Le navigateur peut également modifier dynamiquement le contenu (changement de casse, ajout de balises) lors de l'édition.
{% endhint %}

Il est également possible de créer des catégories afin d'organiser les articles de la base de connaissance

<a href="broken://pages/mGXUQ9gngQpAjsdYbA1n" class="button secondary" data-icon="folder-tree">Voir les catégories</a>

***

## Création d'article

* Depuis **`Outils`** > **`Base de connaissances`**, cliquez sur **`+ Ajouter`** en haut de l'écran ou en cliquant sur + à côté d'un article déjà existant (cela créera un article enfant)

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-817220b573a06949923df6ac903ab27fae1e321d%2FKB-ajout-article.png?alt=media" alt=""><figcaption><p>Création d'un article</p></figcaption></figure>

Une fois l'article créé, vous pouvez ajouter :

* Une icône (parmi une liste prédéfinie ou vous pouvez ajouter vos propres icônes)
* Un titre
* Du contenu
* Des traductions
* Une programmation de visibilité

### Mise en forme

La commande **`/`** vous permet d'afficher les différentes options disponibles :

* Titre (1, 2 et 3)
* Liste à puces
* Liste numérotée
* Citation
* Bloc code
* Tableau
* Séparateur
* Image
* Vidéo

Vous pouvez également mettre en forme votre texte soit en surlignant le texte et en utilisant la barre d'outils contextuelle :

<div align="left"><figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-897a5bebd37cb202c0cb8ae263785d537f1b2fec%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

ou grâce aux raccourcis :

| Raccourci | Effet    |
| --------- | -------- |
| CTRL + b  | Gras     |
| CTRL + i  | Italique |
| CTRL + u  | Souligné |
| CTRL + e  | Code     |

### Ajouter / délier un document

{% stepper %}
{% step %}

#### Ajouter

Il est possible d'ajouter un document depuis son ordinateur ou de lier un document existant.

* Cliquez sur **`+ Ajouter un document`**
* Sélectionnez **`Télécharger un fichier`** pour en choisir depuis votre ordinateur ou **`Lier un document`** pour en choisir dans la bibliothèque de documents. Si vous télécharger un document depuis votre ordinateur, vous pourrez ajouter une description (optionnel)

<div align="left"><figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-c28628b4ff857055b2237b43f8bd2b3d385542c4%2FKB-ajout-doc.png?alt=media" alt=""><figcaption><p>Télécharger un document</p></figcaption></figure></div>

<div align="left"><figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-4185c5f6163946c088ae77a3c122e20f8a3c6856%2FKB-lier-doc.png?alt=media" alt=""><figcaption><p>Lier un document existant</p></figcaption></figure></div>
{% endstep %}

{% step %}

#### Délier

Pour délier un document, cliquez sur la croix à côté du document en question puis cliquez sur **`Délier`**

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-2f68bf23535e8439b6f5a02cea56f319e4c029c0%2FKB-delier-doc.png?alt=media" alt=""><figcaption><p>Délier un document</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Lier / délier un élément

{% stepper %}
{% step %}

#### Lier

Il est possible de lier un élément GLPI (applicatif, ordinateur, problème, etc.)

* Cliquez sur Lier un élément
* Sélectionnez l'élément souhaité dans le liste déroulante

{% hint style="info" %}
Vous pouvez lier plusieurs éléments de différents types
{% endhint %}

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-b4105e9c123e13e80944d5f1d467cdb9dee7cbba%2FKB-lier-element.png?alt=media" alt=""><figcaption><p>Lier un élément</p></figcaption></figure>
{% endstep %}

{% step %}

#### Délier

Pour délier un élément, cliquez sur la croix à côté de l'élément en question puis cliquez sur **`Délier`**

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-fe4e7995c510c6fda07c9edaa7f866557c3f0b01%2FKB-delier-element.png?alt=media" alt=""><figcaption><p>Délier un élément</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Ajouter / supprimer une traduction

{% stepper %}
{% step %}

#### Ajouter

* Pour traduire un article, cliquez sur traduction en dessous du titre de l'article
* Sélectionnez la langue souhaitée
* Traduisez le nom de l'article
* Procédez à la traduction du document
* Cliquez sur **`Enregistrer`**

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-4ab1b21aa5c30b1f117be0be1ec632ae6437f47b%2Fkb-traduction.png?alt=media" alt=""><figcaption><p>Traduire un article</p></figcaption></figure>
{% endstep %}

{% step %}

#### Supprimer

* Pour supprimer une traduction, cliquez **Traductions**
* Sélectionnez la langue souhaitée
* Cliquez sur la corbeille

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-9a0843055e65b8f822f6bdc2b8b75743ca3ae3eb%2Fkb-suppr-traduction.png?alt=media" alt=""><figcaption><p>Supprimer une traduction</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Gestion des articles

La gestion des articles se fait par le menu <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>de l'article

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-5cd199353ee4522631939e6da1186f575bd70c06%2Fkb-options.png?alt=media" alt=""><figcaption><p>Menu de gestion</p></figcaption></figure>

### Historique et restauration

#### Historique

Permet de consulter les modifications effectuées par les utilisateurs habilités (traduction, modification de l'article, ajout de document, etc.)

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-f7e0158d65c7cc5e33387b51adbf6b49aa673a68%2Fkb-historique.png?alt=media" alt=""><figcaption><p>Historique des modifications</p></figcaption></figure>

#### Restauration

Depuis l'historique, vous pouvez visualiser le contenu d'une des versions qui vous intéressent. Les changements opérés apparaitront sur l'article grâce à un code couleur :

* **Vert** : les **nouvelles** valeurs
* **Rouge** : les valeurs **supprimées**
* **Gris** : les valeurs **inchangées**

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-527c07170d49cbf5c684f45df8c74763171a1a21%2Fkb-restaurer-version.png?alt=media" alt=""><figcaption><p>Historique des modifications</p></figcaption></figure>

Il vous sera ensuite possible de cliquer sur l'icône de restauration <img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-94008577c2da0478e8fd228f134d6feeefd1907a%2Frestore.png?alt=media" alt="" data-size="line"> afin que l'article soit chargé avec cette version.

### Commentaires

Ajout de commentaires pour l'article souhaité. Ce commentaire sera visible depuis l'article en cliquant sur **commentaire** sous le titre de l'article.

### Catalogue de services

Depuis ce menu il est possible :

* De montrer cet article dans le catalogue de service
* De l'épingler en haut du catalogue de services
* D'afficher une description
* De classer cet article dans une catégorie

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-e3a8dfe73a1c507f89c5544c35d7e68a7c3752f8%2Fkb-catalogue-services.png?alt=media" alt=""><figcaption><p>Option du catalogue de services</p></figcaption></figure>

### Autorisations

Les permissions permettent d'identifier les personnes qui pourront consulter l'article. Vous pouvez sélectionnez des entités, des groupes, des profils ou des utilisateurs.

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-430d433b1b42d81893273c5c29adf97fd6f7b922%2Fkb-autorisations.png?alt=media" alt=""><figcaption><p>Permissions</p></figcaption></figure>

Vous pouvez également affiché des options supplémentaires pour les groupes et les profils qui vous permettront d'indiquer l'entité dans laquelle l'article sera visible

<div align="left"><figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-39cffd9d0dbf84b39212e296ede0c46c257139b7%2Fbdc-options-avancees.png?alt=media" alt="" width="542"><figcaption><p>Permissions avancées</p></figcaption></figure></div>

### Partage

Le partage, quant à a lui, permet de transmettre un article de la base de connaissances via un lien public. Ce lien sera consultable par quiconque aura le lien (sous réserve d'avoir également accès au sous-réseau ou se trouve votre instance GLPI. Pour les adresses locales, seuls les utilisateurs ayant accès au réseau local pourront visualiser l'article partagé. Pour les instance publiques, le lien sera consultable par tous).

Vous pouvez copier le lien grâce à l'icone <i class="fa-copy">:copy:</i> ou regénérer un lien grâce à <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-91cf82ab3b040275db7900b39855d0b7e738901d%2Fkb-partager.png?alt=media" alt=""><figcaption><p>Partage</p></figcaption></figure>

### Programmer une visibilité

Vous pouvez programmer une visibilité pour un article en indiquant des dates de début et fin.

* Si seule la date début est paramétrée, l'article sera visible à partir de cette date sans limite de fin.
* Si seule la date de fin est indiquée, l'article sera visible depuis le jour de sa publication jusqu'à la date de fin indiquée.

<figure><img src="https://717310897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI37OnoO4u22Gm6H4GJFI%2Fuploads%2Fgit-blob-927a6599f3293be5ba9302e53301bb37b96d19d7%2Fkb-visibilit%C3%A9.png?alt=media" alt=""><figcaption></figcaption></figure>

### Ajouter aux favoris

L'ajout aux favoris permet de retrouver rapidement lorsque vous naviguer dans la base de connaissance.

### Ajouter à la FAQ

L'ajout à la FAQ permet d'ajouter un article visible depuis l'interface simplifiée.

### Supprimer un article

Le suppression de l'article entraine sa suppression définitive. Vous ne pourrez pas revenir en arrière.

***

## Options de recherche

Le moteur de recherche de la base de connaissances fournit des opérateurs pour les recherches complexes : `+ - ~ < > * ” ” ()`.

<table><thead><tr><th width="277">Expression</th><th>Description</th></tr></thead><tbody><tr><td><code>+</code></td><td>Le mot doit être présent</td></tr><tr><td><code>-</code></td><td>Le mot ne doit pas être présent</td></tr><tr><td><code>*</code></td><td>Tronquer le suffixe</td></tr><tr><td><code>" "</code></td><td>La séquence contenue doit être recherchée littéralement</td></tr><tr><td><code>&#x3C; ></code></td><td>Définir l'ordre des éléments de recherche</td></tr><tr><td><code>()</code></td><td>Grouper lors de l'utilisation de <code>&#x3C;</code> et <code>></code></td></tr></tbody></table>

**Exemples** :

<table><thead><tr><th width="281">Exemple</th><th>Description</th></tr></thead><tbody><tr><td><code>échec imprimante</code></td><td>Recherche les lignes contenant au moins un de ces mots</td></tr><tr><td><code>+imprimante +échec</code></td><td>Recherche les lignes contenant les deux mots</td></tr><tr><td><code>+mail thunderbird</code></td><td>Recherche les lignes contenant le mot <em>mail</em> mais classe plus haut les lignes contenant aussi le mot <em>thunderbird</em></td></tr><tr><td><code>+mail -outlook</code></td><td>Recherche les lignes contenant le mot <em>mail</em> mais pas le mot <em>outlook</em></td></tr><tr><td><code>+mail +(>thunderbird &#x3C;outlook)</code></td><td>Recherche les lignes contenant le mot <em>mail</em> et <em>thunderbird</em>, ou <em>mail</em> et <em>outlook</em>, dans n'importe quel ordre, mais classe <em>mail thunderbird</em> plus haut que <em>mail outlook</em></td></tr><tr><td><code>ouvrir*</code></td><td>Recherche les lignes contenant des mots tels que <em>openoffice</em>, <em>openwriter</em>, <em>openbar</em>, <em>openphp</em>...</td></tr><tr><td><code>"suite openoffice"</code></td><td>Recherche les lignes contenant exactement la phrase <em>suite openoffice</em></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.glpi-project.org/glpi-12/fr/tools/knowledgebase.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
