Recuperando detalhes do conceito com $lookup - AWS HealthLake
UsoParâ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á.

Recuperando detalhes do conceito com $lookup

AWS HealthLake agora suporta a $lookup operação de CodeSystem recursos, permitindo que você recupere detalhes sobre um conceito específico em um sistema de código fornecendo informações de identificação, como seu código. Essa operação é particularmente útil quando você precisa:

  • Recupere informações detalhadas sobre códigos médicos específicos

  • Valide os significados e propriedades do código

  • Acesse definições e relacionamentos de conceitos

  • Support a tomada de decisões clínicas com dados terminológicos precisos

Uso

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

Operações com Suporte

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup

Parâmetros compatíveis

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

Parameter Type Obrigatório Descrição
code código Sim O código conceitual que você está procurando (por exemplo, “71620000" no SNOMED CT)
system uri Sim O URL canônico do sistema de código (por exemplo, "http://snomed.info/sct “)
version string Não Versão específica do sistema de código

Exemplos

Solicitação GET

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
Solicitação POST

POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
Resposta da amostra

A operação retorna um recurso de Parâmetros contendo os detalhes do conceito:

{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}

Parâmetros de resposta

A resposta inclui os seguintes parâmetros, quando disponíveis:

Parameter Tipo Descrição
name string Nome do sistema de código
version string Versão do sistema de código
display string Nome de exibição do conceito
designation BackboneElement Representações adicionais para esse conceito.
property BackboneElement Propriedades adicionais do conceito (definição, relacionamentos, etc.)

Comportamento

A $lookup operação:

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

  2. Pesquisa o conceito dentro do sistema de código especificado armazenado no armazenamento de dados

  3. Retorna informações detalhadas do conceito, incluindo nome de exibição, designações e propriedades.

  4. Suporta pesquisas específicas da versão quando o parâmetro é fornecido version

  5. Opera somente em sistemas de código armazenados explicitamente no armazenamento de HealthLake dados

Tratamento de erros

A operação trata das seguintes condições de erro:

  • 400 Solicitação inválida: $lookup operação inválida (solicitação não conforme ou ausência de parâmetros obrigatórios)

  • 404 Não encontrado: sistema de código não encontrado ou código não encontrado no sistema de código especificado

Advertências

Para esta versão, não há suporte para o seguinte:

  • $lookupoperação chamando servidores de terminologia externos

  • $lookupoperação CodeSystems gerenciada por HealthLake , mas não armazenada explicitamente no armazenamento de dados

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