# 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="info" %}
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é` et apparaît dans le tableau `Articles non publiés` sur la page d'accueil de la base de connaissances.

{% hint style="info" %}
.. versionchanged:: 11

Le ciblage s'applique de la même manière que l'article soit dans la FAQ ou uniquement dans la base de connaissances.
{% endhint %}

{% hint style="info" %}
Vous pouvez publier un article pour tout le monde en ciblant l'entité racine.
{% endhint %}

Par défaut, les articles ne sont pas traduisibles. Cependant, cette fonctionnalité peut être activée, voir [configuration générale](https://help.glpi-project.org/documentation/fr/modules/configuration/general/general_configuration).

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

{% hint style="info" %}
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 possible de créer des catégories et des sous-catégories afin d'organiser la navigation (voir [Configurer les listes déroulantes](https://github.com/glpi-network/gitbook-fr/blob/main/manual/modules/tools/broken-reference/README.md)). L'utilisateur peut ensuite utiliser plusieurs onglets pour rechercher et parcourir la base de connaissances :

* **Recherche** Cet onglet est l'onglet par défaut, affichant les articles récents, les articles populaires et les dernières modifications. Il permet également de rechercher dans la base de connaissances.

  ![Onglet de recherche de la base de connaissances](https://3472943295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fOFvaYAGyPcoVZsr1BX%2Fuploads%2Fgit-blob-3da4477ee5ee4aa26224e23eec66f740a0305c71%2Fresearch-knowledgebase.png?alt=media)
* **Parcourir** Cet onglet permet de parcourir la structure arborescente des catégories.

  ![Onglet de parcours de la base de connaissances](https://3472943295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fOFvaYAGyPcoVZsr1BX%2Fuploads%2Fgit-blob-1e248dbcfa0ab8fdfc12f8c1d7f0608dbc5dde31%2Fbrowse-knowledgebase.png?alt=media)
* **Gérer** Cet onglet n'est visible que pour les administrateurs de la base de connaissances. Selon les permissions de l'utilisateur, il est possible d'accéder rapidement aux articles de l'utilisateur, aux articles non publiés de l'utilisateur, à tous les articles non publiés...

  ![Onglet de gestion de la base de connaissances](https://3472943295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fOFvaYAGyPcoVZsr1BX%2Fuploads%2Fgit-blob-28853c90df263e24904aa9411839209933989bba%2Fmanage-knowledgebase.png?alt=media)

{% hint style="info" %}
Le moteur de recherche de la base de connaissances fournit des opérateurs pour les recherches complexes : `+ - ~ < > * ” ” ()`.

* `+` : le mot doit être présent ;
* `-` : le mot ne doit pas être présent ;
* `*` : tronquer le suffixe ;
* `" "` : la séquence contenue doit être recherchée littéralement ;
* `< >` : définir l'ordre des éléments de recherche ;
* `()` : grouper lors de l'utilisation de `<` et `>`.

  ```
  Exemples :

  - échec imprimante
    -> Recherche les lignes contenant au moins un de ces mots

  - +imprimante +échec
    -> Recherche les lignes contenant les deux mots

  - +mail thunderbird
  -> Recherche les lignes contenant le mot *mail* mais classe plus haut les lignes contenant aussi le mot *thunderbird*

  - +mail -outlook
    -> Recherche les lignes contenant le mot *mail* mais pas le mot *outlook*

  - * +mail +(>thunderbird <outlook)
    -> Recherche les lignes contenant le mot *mail* et *thunderbird*, ou *mail* et *outlook*, dans n'importe quel ordre, mais classe *mail thunderbird* plus haut que *mail outlook*

  - ouvrir*
  -> Recherche les lignes contenant des mots tels que *openoffice*, *openwriter*, *openbar*, *openphp*...

  - "suite openoffice"
    -> Recherche les lignes contenant exactement la phrase *suite openoffice*
  ```

{% endhint %}

## Les différents onglets d'un article

### Base de connaissances

Cet onglet affiche un tableau avec la catégorie de l'article, le sujet, le contenu, l'auteur, la date de création, la date de dernière modification, le nombre de vues et l'appartenance à la FAQ.

Si un article n'est pas publié (c'est-à-dire qu'il n'a pas de cible), cette information apparaîtra en rouge au-dessus du nombre de vues.

### Cible

Cet onglet permet de gérer les cibles d'un article.

Un article est par défaut personnel et donc uniquement visible par son créateur.

Pour qu'un article devienne visible par d'autres utilisateurs, des cibles doivent lui être ajoutées, une cible étant soit une entité, un groupe, un profil ou un utilisateur qui pourra consulter l'article.

### Éditer

Cet onglet permet, si les permissions le permettent, de modifier ou de supprimer un article.

## Documents

Des informations supplémentaires sont stockées sous forme de documents externes qui sont des fichiers téléchargés dans GLPI. Dans l'onglet *Documents*, les documents peuvent être associés et dissociés de l'élément sélectionné. La [gestion des documents eux-mêmes](https://help.glpi-project.org/documentation/fr/modules/management/documents) est traitée dans un autre chapitre.

Il est également possible de créer rapidement un document via cet onglet en spécifiant le fichier désiré et éventuellement le champ dans lequel le nouveau document doit être placé. Le nom du document créé sera basé sur le nom du fichier ajouté.

![Écran de création de document](https://github.com/glpi-network/gitbook-fr/blob/main/modules/tabs/images/documents.png)

{% hint style="info" %}
Lorsque vous supprimez un document de cet onglet via les actions de masse, vous ne faites que supprimer le lien entre l'objet et le document ; le document lui-même est toujours présent.
{% endhint %}

## Historique

L'onglet *Historique* est utilisé pour afficher toutes les modifications apportées à un élément. Les informations suivantes sur les modifications sont disponibles :

* ID de la modification.
* Date et heure de la modification.
* Utilisateur qui a effectué la modification. Si ce champ n'est pas rempli, cela signifie que l'action a été effectuée automatiquement (Par exemple : mise à jour automatique de l'inventaire).
* Champ qui a été modifié.
* Description de la modification qui a été apportée.

La description de la modification représente soit la différence entre l'ancienne et la nouvelle valeur (Par exemple avec le champ localisation : Changement de Siège à Bureau à distance A), soit l'explication de l'action qui a été effectuée (Par exemple : Désinstallation d'un logiciel : "Gimp 2.0").

{% hint style="info" %}
Pour les listes déroulantes ou les objets ayant une relation parent/enfant, la modification d'un enfant apparaîtra dans l'historique de l'élément parent.
{% endhint %}

### Révision

Cet onglet permet de consulter toutes les révisions d'articles : chaque modification sauvegardée de l'article créera une révision stockant la version précédente de l'article.

Les révisions peuvent être affichées et restaurées.

![Révisions d'articles](https://3472943295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fOFvaYAGyPcoVZsr1BX%2Fuploads%2Fgit-blob-2bc4b8354dccc6c952e6a6a4d033ff7b100df44f%2Frevisions-knowledgebase.png?alt=media)

### Commentaires

Cet onglet permet aux utilisateurs de la plateforme d'ajouter leurs commentaires et de discuter de l'article.

![Commentaires d'articles](https://3472943295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fOFvaYAGyPcoVZsr1BX%2Fuploads%2Fgit-blob-fd3c04acdadb60d2a568052cc97f915171cab291%2Fcomments-knowledgebase.png?alt=media)

## Toutes les informations

Pour un élément, toutes les informations sont affichées sur une seule page depuis l'onglet *Tout*. Cela montre tous les onglets du formulaire d'un objet dans une seule vue, l'un en dessous de l'autre.