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 (p. ex., Location) avec des traductions pour des champs spécifiques à l'aide de l'extension FHIR translation. Précisez les traductions pour chaque langue en incluant les sous-extensions lang et content.
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 :
GET /Location?_search-language=fr-CA&name=Clinique
Pour rechercher des emplacements par nom en anglais :
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 :
GET /Location?_search-language=fr-CA&name=Clinique
Vous pouvez effectuer la requête suivante :
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 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.
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.
- 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:'
Voir aussi : Moteur de Terminology hybride.
