View a markdown version of this page

Mapeo de códigos entre terminologías con $translate - AWS HealthLake
De usoParámetros admitidosEjemplosParámetros de respuestaComportamientoGestión de erroresAdvertencias

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Mapeo de códigos entre terminologías con $translate

AWS HealthLake admite la $translate operación relativa a los ConceptMap recursos, lo que le permite asignar un código de un sistema de códigos a un código equivalente de otro utilizando los datos ConceptMaps que haya introducido en su almacén de datos. Esta operación es especialmente útil cuando necesitas:

  • Mapear códigos entre terminologías (por ejemplo, ICD-10-CM a SNOMED CT)

  • Normalice los datos entrantes a un sistema de código canónico

  • Soporta la interoperabilidad entre sistemas que usan terminologías diferentes

  • Ejecute el análisis de datos clínicos mediante la estandarización de terminologías de origen heterogéneas

De uso

La $translate operación se puede invocar en ConceptMap los recursos mediante los métodos GET y POST:

Operaciones admitidas

GET  [base]/ConceptMap/$translate?url={...}&system={...}&code={...}
GET  [base]/ConceptMap/[id]/$translate?system={...}&code={...}
POST [base]/ConceptMap/$translate
POST [base]/ConceptMap/[id]/$translate

Parámetros admitidos

HealthLake admite un subconjunto de parámetros del FHIR R4: $translate

Parámetro Tipo Obligatorio Description (Descripción)
code code Sí El código fuente a traducir
system uri Sí El sistema de código al que pertenece el código
url uri No URL canónica de una página específica ConceptMap para traducirla
source uri No Se restringe a los mapas cuyo conjunto de valores de origen sea igual a este URI
target uri No Se restringe a los mapas cuyo conjunto de valores objetivo sea igual a este URI
targetsystem uri No Restringe las coincidencias con los códigos de destino en este sistema de códigos
nota

Los target parámetros urlsource, y son filtros de ámbito que se aplican únicamente a la invocación a nivel de tipo (). [base]/ConceptMap/$translate En la instancia invoation (ConceptMap/[id]/$translate), se ignoran, solo como, y entran en code vigorsystem. targetsystem

Ejemplos

Solicitud GET (por ConceptMap ID)

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
Solicitud GET (por URL canónica)

GET [base]/ConceptMap/$translate?url=http://example.com/ConceptMap/sct-to-icd10&system=http://snomed.info/sct&code=44054006
Solicitud POST

POST [base]/ConceptMap/$translate
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "url",
      "valueUri": "http://example.com/ConceptMap/sct-to-icd10"
    },
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "44054006"
    },
    {
      "name": "targetsystem",
      "valueUri": "http://hl7.org/fhir/sid/icd-10-cm"
    }
  ]
}
Respuesta de ejemplo

La operación devuelve un Parameters recurso. El result parámetro indica si se encontró una coincidencia. Cada uno match contiene el objetivo concept y unequivalence:

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "valueBoolean": true
    },
    {
      "name": "match",
      "part": [
        {
          "name": "equivalence",
          "valueCode": "equivalent"
        },
        {
          "name": "concept",
          "valueCoding": {
            "system": "http://hl7.org/fhir/sid/icd-10-cm",
            "code": "E11.9",
            "display": "Type 2 diabetes mellitus without complications"
          }
        }
      ]
    }
  ]
}

Parámetros de respuesta

La respuesta incluye los siguientes parámetros:

Parámetro Tipo Descripción
result booleano Si se encontró una coincidencia
match BackboneElement Se encontró una coincidencia en ConceptMap
match.equivalence code El grado de equivalencia entre los conceptos de origen y destino
match.concept Codificación El concepto de destino (incluye el sistema, el código y la visualización)

Comportamiento

La $translate operación:

  1. Valida los parámetros requeridos (codeysystem).

  2. Resuelve el ConceptMap por instancia [id] o por url canónico.

  3. Traduce el código fuente y, si lo desea, filtra las coincidencias según targetsystem se proporcionen.

  4. Devuelve result: true con uno match por código de destino equivalente o result: false cuando no existe ninguna asignación.

Gestión de errores

La operación gestiona las siguientes condiciones de error:

  • 400 Solicitud incorrecta: solicitud no válida ($translatesolicitud no conforme o faltan los parámetros obligatorios)

  • 404 No encontrado: ConceptMap no se encuentra en el almacén de datos

Advertencias

En esta versión, no se admite lo siguiente:

  • reverseparámetro (traducción inversa del destino al origen)

  • Traducciones encadenadas entre múltiples ConceptMaps

  • Como más de 10 ConceptMap recursos pueden coincidir con la $translate consulta, solo se muestran las coincidencias de ConceptMaps los 10 primeros, ordenadas por el date campo ConceptMap s (la más reciente primero).

Para obtener más información sobre la especificación de la $translate operación, consulte la documentación del FHIR R4 ConceptMap $translate.