# Dec 24th, 2022: \[FR\] Définissez vos propres facettes avec les sources Custom dans Workplace Search

**URL:** <https://discuss.elastic.co/t/dec-24th-2022-fr-definissez-vos-propres-facettes-avec-les-sources-custom-dans-workplace-search/318641>\
**Category:** Advent Calendar\
**Created:** [December 24, 2022, 8:00am UTC](https://discuss.elastic.co/t/dec-24th-2022-fr-definissez-vos-propres-facettes-avec-les-sources-custom-dans-workplace-search/318641 "2022-12-24T08:00:55Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![dadoonet](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/dadoonet/32/137187_2.png) [@dadoonet](https://discuss.elastic.co/u/dadoonet)\
**Post date:** [December 24, 2022, 8:00am UTC](https://discuss.elastic.co/t/dec-24th-2022-fr-definissez-vos-propres-facettes-avec-les-sources-custom-dans-workplace-search/318641/1 "2022-12-24T08:00:55Z")

</div>

![image](https://us1.discourse-cdn.com/elastic/original/3X/8/1/818d8394376817d1c96c61c72ef059a1fe26594a.jpeg)

This article is also available [in english](https://discuss.elastic.co/t/318640).

Workplace Search fournit un moyen sympa et facile pour rechercher dans tous les documents que vous pouvez avoir dans votre entreprise/entité.

Vous pouvez ainsi chercher depuis plusieurs sources comme Github, Dropbox, Box, Google Drive...

Sympa, non ?

# La navigation par facettes pour les sources "standard"

Les sources "standard" sont fournies, par défaut, avec un ensemble de champs pour la navigation par facettes. Par exemple, lorsque vous sélectionnez une source GitHub, cela vient avec les capacités de filtrage suivantes :

 ![image](https://us1.discourse-cdn.com/elastic/original/3X/f/1/f1b8021e05cd4f28f3cd6e108bdce8e2f796e9af.jpeg)

# API Custom Source

Il y a deux ans, j'ai expliqué [comment utiliser l'API Custom Source](https://discuss.elastic.co/t/254739) pour ajouter votre propre source de documents à Workplace Search.

Mais le comportement par défaut pour la navigation par facettes peut ne pas correspondre à vos besoins. Par exemple, avec Elastic 8.5.0, le comportement par défaut lorsque vous utilisez [FSCrawler](https://fscrawler.readthedocs.io/) comme source, donne les facettes suivantes :

 ![image](https://us1.discourse-cdn.com/elastic/original/3X/d/1/d1b66b849b52050e1312b6fd652519ccf6e4e787.png)

Comme vous le voyez, le panneau des facettes à gauche est assez vide, alors que par défaut, FSCrawler génère les champs suivants :

```
"body": "text",
"comments": "text",
"tags": "text",
"title": "text",
"type": "text",
"url": "text",
"extension": "text",
"mime_type": "text",
"path": "text",
"size": "number",
"created_by": "text",
"name": "text",
"language": "text",
"text_size": "number",
"created_at": "date",
"last_modified": "date"

```

# Implémenter ses propres facettes

Pour ajouter vos propres facettes, vous devez les définir lorsque vous créez le schéma Workplace Search en utilisant le tableau `facets.overrides`. Fournissez simplement un objet pour chaque facette. Chaque objet doit contenir :

- `display_name` : le nom de la facette pour l'affichage
- `field` : le nom du champ qui sera utilisé pour calculer les valeurs des facettes et pour le filtrage
- `enabled` : doit être positionné à `true` si vous souhaitez activer la navigation par facette

Par exemple, dans FSCrawler, [nous avons défini les facettes suivantes](https://github.com/dadoonet/fscrawler/blob/9b2ea54c4cf74bf9875815a32f06dac0e5094ce4/settings/src/main/resources/fr/pilato/elasticsearch/crawler/fs/_default/8/_wpsearch_settings.json#L77-L106) :

```auto
"facets": {
  "overrides": [
    { "display_name": "Media Type", "field": "mime_type", "enabled": true },
    { "display_name": "Extension", "field": "extension", "enabled": true },
    { "display_name": "Tags", "field": "tags", "enabled": true },
    { "display_name": "Created By", "field": "created_by", "enabled": true },
    { "display_name": "Language", "field": "language", "enabled": true }
  ]
}

```

Lorsque vous reveniez du coup sur l'interface de recherche, vous pouvez maintenant voir les facettes en action.

 ![image](https://us1.discourse-cdn.com/elastic/original/3X/9/9/9938867ec5d29143c2a8bc8c555a3b6a9fe703b1.png)

**Conseil de pro :** si vous utilisez les mêmes noms de facettes et de champs que ceux des [sources standard de Workplace Search](https://www.elastic.co/guide/en/workplace-search/8.5/workplace-search-custom-api-sources.html#custom-api-source-recommended-field-names), vous pourrez afficher les facettes et utiliser les filtres sur toutes les sources à la fois.

Documentation: [Customizing content source filters | Workplace Search Guide [8.5] | Elastic](https://www.elastic.co/guide/en/workplace-search/8.5/workplace-search-customizing-filters.html#enabling-faceted-fields)

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\
**Post date:** [January 21, 2023, 8:01am UTC](https://discuss.elastic.co/t/dec-24th-2022-fr-definissez-vos-propres-facettes-avec-les-sources-custom-dans-workplace-search/318641/2 "2023-01-21T08:01:36Z")

</div>

This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.