Cómo utilizar la búsqueda multilingüe

Búsqueda multilingüe

FHIR especifica la extensión de traducción para almacenar traducciones del idioma base de un recurso a otros idiomas. En esta entrada, explicaremos cómo buscar recursos especificando el idioma.

1. Crear un recurso con traducciones:

Defina un recurso FHIR (p. ej., Location) con traducciones para campos específicos utilizando la extensión FHIR translation. Especifique las traducciones para cada idioma incluyendo las subextensiones lang y 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. Activar la búsqueda multilingüe:

Active la función _search-language en Aidbox proporcionando la siguiente variable de entorno BOX_FEATURES_MULTILINGUAL_ENABLE__SEARCH__LANGUAGE y estableciéndola en true. Esto le permite utilizar el parámetro de búsqueda no FHIR [_search-language](https://www.health-samurai.io/docs/aidbox/api-1/fhir-api/search-1/search-parameters-list/_search-language) para especificar la configuración regional de búsqueda.

3. Realizar búsquedas en idiomas específicos:

Utilice el parámetro _search-language en su solicitud a la API para especificar el idioma deseado para la búsqueda (p. ej., francés o inglés). Por ejemplo, para buscar ubicaciones por nombre en francés:

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

Para buscar ubicaciones por nombre en inglés:

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

4. Como alternativa, puede utilizar la cabecera Accept-Language:

En lugar del parámetro de búsqueda _search-language, puede habilitar el uso de la cabecera HTTP Accept-Language proporcionando la variable de entorno BOX_FEATURES_MULTILINGUAL_USE__ACCEPT__LANGUAGE__HEADER y estableciéndola en true. Esto le permite especificar el idioma directamente en la cabecera de la solicitud. Así, en lugar de utilizar la siguiente consulta de búsqueda:

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

Puede realizar la siguiente solicitud:

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

5. Traducir conceptos:

Utilice el endpoint $translate-concept para recuperar traducciones de conceptos de terminología específicos a partir de su código y sistema. Especifique el idioma de destino y la lista de conceptos para obtener sus traducciones. En el siguiente ejemplo, obtendremos traducciones al francés canadiense para conceptos de terminología LOINC.

POST /$translate-concepts

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

En la respuesta, recibirá los conceptos con las visualizaciones traducidas al francés canadiense.

- 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:'

Más detalles

Véase también: Motor de Terminology híbrido.