Visão geral dos dados de $convert

Artigo
08/03/2023

Observação

O FHIR® (Fast Healthcare Interoperability Resources) é uma especificação de serviços de saúde abertos.

Usando a $convert-data operação no serviço FHIR, você pode converter dados de integridade de vários formatos para dados FHIR R4 . A $convert-data operação usa modelos Liquid do projeto conversor FHIR para conversão de dados FHIR. Você pode personalizar esses modelos de conversão conforme necessário. Atualmente, a operação dá suporte a $convert-data quatro tipos de conversão de dados:

HL7v2 para FHIR R4
C-CDA para FHIR R4
JSON para FHIR R4 (destinado a mapeamentos de conversão personalizados)
FHIR STU3 para FHIR R4

Observação

Você pode usar o $convert-data ponto de extremidade como um componente dentro de um pipeline ETL (extrair, transformar e carregar) para a conversão de dados de integridade de vários formatos (por exemplo: HL7v2, CCDA, JSON e FHIR STU3) no formato FHIR. Você pode criar um pipeline de ETL para um fluxo de trabalho completo à medida que converte seus dados de integridade. Recomendamos que você use um mecanismo ETL baseado em Aplicativos Lógicos do Azure ou Azure Data Factory. Por exemplo, um fluxo de trabalho pode incluir: ingestão de dados, execução $convert-data de operações, validação, pré/pós-processamento de dados, enriquecimento de dados, eliminação de duplicação de dados e carregamento dos dados para persistência no serviço FHIR.

Usar o ponto de extremidade $convert-data

A $convert-data operação é integrada ao serviço FHIR como uma ação da API REST. Você pode chamar o $convert-data ponto de extremidade da seguinte maneira:

POST {{fhirurl}}/$convert-data

Os dados de integridade para conversão são entregues ao serviço FHIR no corpo da solicitação $convert-data . Se a solicitação for bem-sucedida, o serviço FHIR retornará uma resposta de pacote FHIR com os dados convertidos em FHIR R4.

Parâmetros

Uma $convert-data chamada de operação empacota os dados de integridade para conversão dentro de parâmetros formatados em JSON no corpo da solicitação. Os parâmetros estão descritos na tabela a seguir:

Nome do parâmetro	Descrição	Valores aceitos
inputData	Carga de dados a ser convertida em FHIR.	Para `Hl7v2`: cadeia de caracteres Para `Ccda`: XML Para `Json`: JSON Para `FHIR STU3`: JSON
inputDataType	Tipo de entrada de dados.	`Hl7v2`, `Ccda`, `Json`, `Fhir`
templateCollectionReference	Referência a uma coleção de modelos de imagem OCI em Registro de Contêiner do Azure. A referência é para uma imagem que contém modelos Liquid a serem usados para conversão. Ele pode se referir a modelos padrão ou a uma imagem de modelo personalizada registrada no serviço FHIR. As seções a seguir abrangem personalizar os modelos, hospedá-los em Registro de Contêiner do Azure e registrar-se no serviço FHIR.	Para modelos padrão/de exemplo : Modelos HL7v2 : `microsofthealth/fhirconverter:default` `microsofthealth/hl7v2templates:default` Modelos C-CDA : `microsofthealth/ccdatemplates:default` Modelos JSON : `microsofthealth/jsontemplates:default` Modelos do FHIR STU3 : `microsofthealth/stu3tor4templates:default` Para modelos personalizados : `<RegistryServer>/<imageName>@<imageDigest>`, `<RegistryServer>/<imageName>:<imageTag>`
rootTemplate	O modelo raiz a ser usado na transformação dos dados.	Para HL7v2: ADT_A01, ADT_A02, ADT_A03, ADT_A04, ADT_A05, ADT_A08, ADT_A11, ADT_A13, ADT_A14, ADT_A15, ADT_A16, ADT_A25, ADT_A26, ADT_A27, ADT_A28, ADT_A29, ADT_A31, ADT_A47, ADT_A60, OML_O21, ORU_R01, ORM_O01, VXU_V04, SIU_S12, SIU_S13, SIU_S14, SIU_S15, SIU_S16, SIU_S17, SIU_S26, MDM_T01, MDM_T02 Para C-CDA: CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary Para JSON: ExamplePatient, Stu3ChargeItem Para FHIR STU3: Nome do recurso FHIR STU3 (por exemplo: Paciente, Observação, Organização)

Observação

Os modelos FHIR STU3 para FHIR R4 são modelos Liquid que fornecem mapeamentos de diferenças de campo somente entre um recurso FHIR STU3 e seu recurso equivalente na especificação FHIR R4. Alguns dos recursos do FHIR STU3 são renomeado ou removidos do FHIR R4. Para obter mais informações sobre as diferenças de recursos e restrições para conversão do FHIR STU3 para FHIR R4, consulte Diferenças de recursos e restrições para conversão FHIR STU3 para FHIR R4.

Observação

Modelos JSON são modelos de exemplo para uso na criação de seus próprios mapeamentos de conversão. Eles não são modelos padrão que aderem a nenhum tipo de mensagem de dados de integridade predefinido. O JSON em si não é especificado como um formato de dados de integridade, ao contrário de HL7v2 ou C-CDA. Portanto, em vez de fornecer modelos JSON padrão, fornecemos alguns modelos JSON de exemplo que você pode usar como ponto de partida para seus próprios mapeamentos personalizados.

Aviso

Os modelos padrão são lançados sob a Licença mit e não são compatíveis com Suporte da Microsoft.

Os modelos padrão são fornecidos apenas para ajudá-lo a começar a usar o fluxo de trabalho de conversão de dados. Esses modelos padrão não se destinam à produção e podem ser alterados quando a Microsoft lança atualizações para o serviço FHIR. Para ter um comportamento de conversão de dados consistente em diferentes versões do serviço FHIR, você deve fazer o seguinte:

Hospede sua própria cópia dos modelos em uma instância de Registro de Contêiner do Azure.
Registre os modelos no serviço FHIR.
Use seus modelos registrados em suas chamadas à API.
Verifique se o comportamento de conversão atende aos seus requisitos.

Para obter mais informações sobre como hospedar seus próprios modelos, consulte Hospedar seus próprios modelos

Solicitação de exemplo

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "inputData",
            "valueString": "MSH|^~\\&|SIMHOSP|SFAC|RAPP|RFAC|20200508131015||ADT^A01|517|T|2.3|||AL||44|ASCII\nEVN|A01|20200508131015|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|\nPID|1|3735064194^^^SIMULATOR MRN^MRN|3735064194^^^SIMULATOR MRN^MRN~2021051528^^^NHSNBR^NHSNMBR||Kinmonth^Joanna^Chelsea^^Ms^^D||19870624000000|F|||89 Transaction House^Handmaiden Street^Wembley^^FV75 4GJ^GBR^HOME||020 3614 5541^PRN|||||||||C^White - Other^^^||||||||\nPD1|||FAMILY PRACTICE^^12345|\nPV1|1|I|OtherWard^MainRoom^Bed 183^Simulated Hospital^^BED^Main Building^4|28b|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|||CAR|||||||||16094728916771313876^^^^visitid||||||||||||||||||||||ARRIVED|||20200508131015||"
        },
        {
            "name": "inputDataType",
            "valueString": "Hl7v2"
        },
        {
            "name": "templateCollectionReference",
            "valueString": "microsofthealth/fhirconverter:default"
        },
        {
            "name": "rootTemplate",
            "valueString": "ADT_A01"
        }
    ]
}

Resposta de exemplo

{
    "resourceType": "Bundle",
    "type": "batch",
    "entry": [
        {
            "fullUrl": "urn:uuid:9d697ec3-48c3-3e17-db6a-29a1765e22c6",
            "resource": {
                "resourceType": "Patient",
                "id": "9d697ec3-48c3-3e17-db6a-29a1765e22c6",
          ...
          ...
            },
            "request": {
                "method": "PUT",
                "url": "Location/50becdb5-ff56-56c6-40a1-6d554dca80f0"
            }
        }
    ]
}

O resultado da conversão FHIR é um pacote FHIR como um lote.

O pacote FHIR deve se alinhar com as expectativas da especificação FHIR R4 – Bundle – FHIR v4.0.1.
Se você estiver tentando validar em relação a um perfil específico, precisará fazer algum pós-processamento utilizando a operação FHIR $validate .

Próximas etapas

Neste artigo, você aprendeu sobre a $convert-data operação e como usar o ponto de extremidade para converter dados de integridade em FHIR R4 usando o serviço FHIR no Serviço de Dados de Integridade do Azure.

Para saber como definir as configurações para $convert-data usar o portal do Azure, consulte

Definir configurações para dados de $convert usando o portal do Azure

Para saber como solucionar $convert-dataproblemas, consulte

Solucionar problemas de dados de $convert

Para saber mais sobre as perguntas frequentes (perguntas frequentes) para $convert-data, consulte

Perguntas frequentes sobre dados de $convert

O FHIR® é uma marca registrada da Health Level Seven International, registrada no Escritório de Marcas Registradas dos EUA e é usada com a respectiva permissão.

Visão geral dos dados de $convert

Usar o ponto de extremidade $convert-data

Parâmetros

Solicitação de exemplo

Resposta de exemplo

Próximas etapas

Recursos adicionais