Convertendo seus dados em FHIR para API do Azure para FHIR

O $convert-data ponto de extremidade personalizado no serviço FHIR® destina-se à conversão de dados de diferentes tipos de dados para FHIR. Ele usa o mecanismo de modelo Liquid e os modelos do projeto FHIR Converter como os modelos padrão. Pode personalizar estes modelos de conversão conforme necessário.

Atualmente, o $convert-data ponto de extremidade personalizado suporta quatro tipos de conversão de dados:

Utilizar o ponto final $convert-data

A $convert-data operação está integrada no serviço FHIR para funcionar como parte do serviço. Depois de ativar $convert-data em seu servidor, você pode fazer chamadas de API para o servidor para converter seus dados em FHIR usando https://<<FHIR service base URL>>/$convert-data.

Recurso de parâmetro

$convert-data usa um recurso Parameter no corpo da solicitação, conforme descrito na tabela a seguir. No corpo da solicitação de chamada de API, você incluiria os seguintes parâmetros:

Pedido de Amostra

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

Pedido de Resposta

{
  "resourceType": "Bundle",
  "type": "transaction",
  "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"
      }
    }
  ]
}

Personalizar modelos

Você pode usar a extensão FHIR Converter para Visual Studio Code para personalizar os modelos de acordo com suas necessidades. A extensão fornece uma experiência de edição interativa e facilita o download de modelos publicados pela Microsoft e dados de exemplo. Consulte a documentação na extensão para obter mais detalhes.

Alojar e utilizar modelos

É recomendável que você hospede sua própria cópia dos modelos no ACR. Há quatro etapas envolvidas na hospedagem de sua própria cópia de modelos e usá-los na $convert-data operação:

1. Envie os modelos por push para o Registro de Contêiner do Azure.
2. Habilite a Identidade Gerenciada em sua API do Azure para instância FHIR.
3. Forneça acesso do ACR à API do Azure para FHIR Managed Identity.
4. Registre os servidores ACR na API do Azure para FHIR.
5. Opcionalmente, configure o firewall ACR para acesso seguro.

Enviar modelos por push para o Registro de Contêiner do Azure

Depois de criar uma instância ACR, você pode usar o comando FHIR Converter: Push Templates na extensão FHIR Converter para enviar os modelos personalizados para o ACR. Como alternativa, você pode usar a ferramenta Template Management CLI.

Habilitar a identidade gerenciada na API do Azure para FHIR

Navegue até sua instância do serviço Azure API for FHIR no portal do Azure e selecione a folha Identidade . Altere o status para Ativado para habilitar a identidade gerenciada na API do Azure para FHIR.

Fornecer acesso do ACR à API do Azure para FHIR

1. Navegue até a folha Controle de acesso (IAM).

2. Selecione Adicionar e, em seguida, selecione Adicionar atribuição de função para abrir a página Adicionar atribuição de função.

3. Atribua a função AcrPull .

   

Para obter mais informações sobre como atribuir funções no portal do Azure, consulte Funções internas do Azure.

Registrar os servidores ACR na API do Azure para FHIR

Você pode registrar o servidor ACR usando o portal do Azure ou usando a CLI.

Registrando o servidor ACR usando o portal do Azure

Navegue até a folha Artefatos em Transformação de dados em sua instância FHIR da API do Azure. Você vê a lista de servidores ACR atualmente registrados. Selecione Adicionar e, em seguida, selecione o servidor de registo no menu pendente. Você precisa selecionar Salvar para que o registro entre em vigor. Pode levar alguns minutos para aplicar a alteração e reiniciar sua instância.

Registrando o servidor ACR usando CLI

Você pode registrar até 20 servidores ACR na API do Azure para FHIR.

Instale a CLI dos Serviços de Dados de Saúde do Azure a partir do Azure PowerShell, se necessário:

az extension add -n healthcareapis

Registre os servidores acr na API do Azure para FHIR seguindo estes exemplos:

Registrar um único servidor ACR

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

Registrar vários servidores ACR

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io fhiracr2020.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

Configurar firewall ACR

Selecione Rede para a conta de armazenamento do Azure no portal.

Selecione Redes selecionadas.

Na seção Firewall, especifique o endereço IP na caixa Intervalo de endereços. Adicione intervalos de IP para permitir o acesso a partir da Internet ou das suas redes locais.

Na tabela a seguir, você encontrará o endereço IP da região do Azure onde a API do Azure para serviço FHIR é provisionada.

Verificar

Faça uma chamada para a $convert-data API especificando sua referência de modelo no parâmetro templateCollectionReference.

<RegistryServer>/<imageName>@<imageDigest>

Próximos passos

Neste artigo, você aprendeu sobre a conversão de dados para a API do Azure para FHIR. Para obter mais informações sobre projetos relacionados do GitHub para a API do Azure para FHIR, consulte