---
{
  "title": "Comment utiliser la recherche multilingue",
  "description": "FHIR définit l'extension de traduction pour stocker les traductions de la langue de base d'une ressource vers d'autres langues. Dans cet article, nous verrons comment effectuer des recherches dans les ressources en précisant la langue.",
  "date": "2025-04-11",
  "author": "Evgeny Mukha",
  "reading-time": "5 min",
  "tags": [
    "Aidbox",
    "FHIR Tools"
  ]
}
---
## Recherche multilingue

FHIR définit l'extension de traduction pour stocker les traductions de la langue de base d'une ressource vers d'autres langues. Dans cet article, nous verrons comment effectuer des recherches dans les ressources en précisant la langue.

**1. Créer une ressource avec des traductions :**

Définissez une [ressource FHIR](http://www.health-samurai.io/articles/extending-fhir-resources) (p. ex., `Location`) avec des traductions pour des champs spécifiques à l'aide de l'extension FHIR [translation](https://hl7.org/fhir/extensions/StructureDefinition-translation.html). Précisez les traductions pour chaque langue en incluant les sous-extensions `lang` et `content`.


```javascript
POST /fhir/Location

resourceType: Location
id: loc-1
status: active
name: Location name
_name:
  extension:
    - url: http://hl7.org/fhir/StructureDefinition/translation
      extension:
        - url: lang
          valueCode: fr-CA
        - url: content
          valueString: Clinique médicale du cœur de la ville
    - url: http://hl7.org/fhir/StructureDefinition/translation
      extension:
        - url: lang
          valueCode: en-CA
        - url: content
          valueString: Downtown Heart Medical Clinic
```


**2. Activer la recherche multilingue :**

Activez la fonctionnalité `_search-language` dans Aidbox en fournissant la variable d'environnement `BOX_FEATURES_MULTILINGUAL_ENABLE__SEARCH__LANGUAGE` et en la définissant à `true`. Cela vous permet d'utiliser le paramètre de recherche **non-FHIR** `[_search-language](https://www.health-samurai.io/docs/aidbox/api-1/fhir-api/search-1/search-parameters-list/_search-language)` pour préciser la langue de recherche.

**3. Effectuer des recherches dans des langues spécifiques :**

Utilisez le paramètre `_search-language` dans votre requête API pour préciser la langue souhaitée pour la recherche (p. ex., le français ou l'anglais). Par exemple, pour rechercher des emplacements par nom en français :


```javascript
GET /Location?_search-language=fr-CA&name=Clinique
```


Pour rechercher des emplacements par nom en anglais :


```javascript
GET /Location?_search-language=en-CA&name=Downtown
```


**4. Vous pouvez également utiliser l'en-tête `Accept-Language` :**

Plutôt que d'utiliser le paramètre de recherche `_search-language`, vous pouvez activer l'utilisation de l'en-tête HTTP `Accept-Language` en fournissant la variable d'environnement `BOX_FEATURES_MULTILINGUAL_USE__ACCEPT__LANGUAGE__HEADER` et en la définissant à `true`. Cela vous permet de préciser la langue directement dans l'en-tête de la requête. Ainsi, au lieu d'utiliser la requête de recherche suivante :


```javascript
GET /Location?_search-language=fr-CA&name=Clinique
```


Vous pouvez effectuer la requête suivante :


```javascript
GET /Location?name=Clinique
Accept-Language: fr-CA
```


**5. Traduire des concepts :**

Utilisez le point de terminaison `$translate-concept` pour récupérer les traductions de concepts de [Terminology](/blog/automate-terminology-translation-with-aidbox-tx-engine) spécifiques à partir de leur code et de leur système. Précisez la langue cible et la liste des concepts dont vous souhaitez obtenir les traductions. Dans l'exemple suivant, nous allons récupérer les traductions en français canadien pour des concepts de Terminology LOINC.


```javascript
POST /$translate-concepts

language: fr-CA
concepts:
- system: http://loinc.org
  code: 1-8
- system: http://loinc.org
  code: 2-6
```


En réponse, vous recevrez les concepts avec leurs affichages traduits en français canadien.


```javascript
- code: 2-6
  system: http://loinc.org
  language: fr-CA
  translation: Almécilline:Susceptibilité:Temps ponctuel:Isolat:Quantitatif:CLM
- code: 1-8
  system: http://loinc.org
  language: fr-CA
  translation: 'Acyclovir:Susceptibilité:Temps ponctuel:Isolat:Quantitatif ou ordinal:'
```


[Plus de détails](https://www.health-samurai.io/docs/aidbox/readme-1/data-api/how-to-use-multilingual-search)

Voir aussi : [Moteur de Terminology hybride](/blog/introducing-hybrid-terminology-engine).