View a markdown version of this page

Mappage des codes entre les terminologies avec $translate - AWS HealthLake
UsageParamètres pris en chargeExemplesParamètres de réponseComportementGestion des erreursMises en garde

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mappage des codes entre les terminologies avec $translate

AWS HealthLake prend en charge les $translate opérations relatives aux ConceptMap ressources, vous permettant de mapper un code d'un système de code à un code équivalent d'un autre en utilisant ce ConceptMaps que vous avez ingéré dans votre banque de données. Cette opération est particulièrement utile lorsque vous devez :

  • Codes de mappage entre les terminologies (par exemple, ICD-10-CM vers SNOMED CT)

  • Normaliser les données entrantes selon un système de code canonique

  • Favoriser l'interopérabilité entre les systèmes utilisant des terminologies différentes

  • Analysez les données cliniques en normalisant les terminologies sources hétérogènes

Usage

L'$translateopération peut être invoquée sur ConceptMap des ressources à l'aide des méthodes GET et POST :

Opérations prises en charge

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

Paramètres pris en charge

HealthLake prend en charge un sous-ensemble de paramètres FHIR $translate R4 :

Paramètre Type Obligatoire Description
code code Oui Le code source à traduire
system uri Oui Le système de code auquel appartient le code
url uri Non URL canonique d'un objet spécifique ConceptMap à traduire
source uri Non Limite aux cartes dont la valeur source définie est égale à cet URI
target uri Non Limite aux cartes dont la valeur cible définie est égale à cet URI
targetsystem uri Non Limite les correspondances aux codes cibles dans ce système de code
Note

Les target paramètresurl,source, et sont des filtres de portée qui s'appliquent uniquement à l'invocation () [base]/ConceptMap/$translate au niveau du type. Sur l'instance invocation (ConceptMap/[id]/$translate), ils sont ignorés, en tant que tels codesystem, et targetsystem prennent effet.

Exemples

Demande GET (par ConceptMap identifiant)

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
Requête GET (par URL canonique)

GET [base]/ConceptMap/$translate?url=http://example.com/ConceptMap/sct-to-icd10&system=http://snomed.info/sct&code=44054006
Requête 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"
    }
  ]
}
Exemple de réponse

L'opération renvoie une Parameters ressource. Le result paramètre indique si une correspondance a été trouvée. Chacune match contient la cible concept et un equivalence :

{
  "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"
          }
        }
      ]
    }
  ]
}

Paramètres de réponse

La réponse inclut les paramètres suivants :

Paramètre Type Description
result booléen Si une correspondance a été trouvée
match BackboneElement Une correspondance trouvée dans ConceptMap
match.equivalence code Le degré d'équivalence entre les concepts source et cible
match.concept Codage Le concept cible (comprend le système, le code et l'affichage)

Comportement

L'$translateopération :

  1. Valide les paramètres requis (codeetsystem).

  2. Résout le ConceptMap par instance [id] ou par canonique. url

  3. Traduit le code source, en filtrant éventuellement les correspondances au targetsystem moment où il est fourni.

  4. Renvoie result: true avec une valeur match par code cible équivalent, ou result: false lorsqu'aucun mappage n'existe.

Gestion des erreurs

L'opération gère les conditions d'erreur suivantes :

  • 400 Mauvaise demande : $translate demande non valide (demande non conforme ou paramètres obligatoires manquants)

  • 404 introuvable : ConceptMap introuvable dans la banque de données

Mises en garde

Pour cette version, les éléments suivants ne sont pas pris en charge :

  • reverseparamètre (traduction inverse de la cible vers la source)

  • Traductions enchaînées sur plusieurs ConceptMaps

  • Comme plus de 10 ConceptMap ressources peuvent correspondre à la $translate requête, seules les réponses des 10 premières ConceptMaps sont renvoyées, classées par le date champ ConceptMap « s » (les plus récentes en premier).

Pour plus d'informations sur les spécifications de $translate fonctionnement, consultez la documentation du FHIR R4 ConceptMap $translate.