View a markdown version of this page

Mapeando códigos entre terminologias com $translate - AWS HealthLake
UsageParâmetros compatíveisExemplosParâmetros de respostaComportamentoTratamento de errosAdvertências

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Mapeando códigos entre terminologias com $translate

AWS HealthLake suporta a $translate operação de ConceptMap recursos, permitindo que você mapeie um código de um sistema de código para um código equivalente em outro usando o que ConceptMaps você ingeriu em seu armazenamento de dados. Essa operação é particularmente útil quando você precisa:

  • Mapeie códigos entre terminologias (por exemplo, ICD-10-CM para SNOMED CT)

  • Normalize os dados recebidos em um sistema de código canônico

  • Ofereça suporte à interoperabilidade entre sistemas que usam terminologias diferentes

  • Execute análises de dados clínicos padronizando terminologias de origem heterogêneas

Usage

A $translate operação pode ser invocada em ConceptMap recursos usando os métodos GET e POST:

Operações com Suporte

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 compatíveis

HealthLake suporta um subconjunto de parâmetros FHIR R4: $translate

Parâmetro Tipo Obrigatório Description
code código Sim O código-fonte para traduzir
system uri Sim O sistema de código ao qual o código pertence
url uri Não URL canônico de um específico ConceptMap para traduzir
source uri Não Restringe aos mapas cujo conjunto de valores de origem é igual a esse URI
target uri Não Restringe aos mapas cujo valor alvo definido é igual a esse URI
targetsystem uri Não Restringe as correspondências aos códigos de destino neste sistema de código
nota

Os target parâmetrosurl,source, e são filtros de escopo que se aplicam somente à invocação em nível de tipo (). [base]/ConceptMap/$translate Na invocação da instância (ConceptMap/[id]/$translate), elas são ignoradas, como somente codesystem, e entram em targetsystem vigor.

Exemplos

Solicitação GET (por ConceptMap ID)

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
Solicitação GET (por URL canônico)

GET [base]/ConceptMap/$translate?url=http://example.com/ConceptMap/sct-to-icd10&system=http://snomed.info/sct&code=44054006
Solicitação 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"
    }
  ]
}
Resposta da amostra

A operação retorna um Parameters recurso. O result parâmetro indica se uma correspondência foi encontrada. Cada um match contém o alvo concept e umequivalence:

{
  "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 resposta

A resposta inclui os seguintes parâmetros:

Parâmetro Tipo Descrição
result booliano Se uma correspondência foi encontrada
match BackboneElement Uma combinação encontrada no ConceptMap
match.equivalence código O grau de equivalência entre os conceitos de origem e de destino
match.concept Codificação O conceito de destino (inclui sistema, código e exibição)

Comportamento

A $translate operação:

  1. Valida os parâmetros necessários (codeesystem).

  2. Resolve o ConceptMap por exemplo [id] ou por url canônico.

  3. Traduz o código-fonte, filtrando opcionalmente as correspondências para targetsystem quando fornecidas.

  4. Retorna result: true com um match por código de destino equivalente ou result: false quando não existe mapeamento.

Tratamento de erros

A operação lida com as seguintes condições de erro:

  • 400 Solicitação inválida: solicitação inválida ($translatesolicitação não conforme ou parâmetros obrigatórios ausentes)

  • 404 Não encontrado: ConceptMap não encontrado no armazenamento de dados

Advertências

Nesta versão, não há suporte para o seguinte:

  • reverseparâmetro (tradução reversa do alvo para a fonte)

  • Traduções em cadeia em várias ConceptMaps

  • Como mais de 10 ConceptMap recursos podem corresponder à $translate consulta, somente as correspondências dos 10 primeiros ConceptMaps são retornadas, ordenadas pelo ConceptMap date campo s (a mais recente primeiro).

Para obter mais informações sobre a especificação da $translate operação, consulte a documentação do FHIR ConceptMap $translate R4.