Introdução ao serviço FHIR

Artigo
06/27/2024

Este artigo descreve as etapas básicas para começar a usar o serviço FHIR® nos Serviços de Dados de Saúde do Azure.

Como pré-requisito, precisará de permissões e de uma subscrição do Azure para criar grupos de recursos do Azure e implementar os recursos do Azure. Você pode seguir todas as etapas ou ignorar algumas se tiver um ambiente existente. Além disso, pode combinar todos os passos e completá-los em scripts do PowerShell, CLI do Azure e API REST.

Criar uma área de trabalho na sua subscrição do Azure

Você pode criar um espaço de trabalho a partir do portal do Azure ou usando PowerShell, CLI do Azure e API REST. Você pode encontrar scripts dos exemplos dos Serviços de Dados de Saúde do Azure.

Nota

Há limites para o número de espaços de trabalho e o número de instâncias de serviço FHIR que você pode criar em cada assinatura do Azure.

Criar um serviço FHIR no espaço de trabalho

Você pode criar uma instância de serviço FHIR a partir do portal do Azure ou usando PowerShell, CLI do Azure e API REST. Você pode encontrar scripts dos exemplos dos Serviços de Dados de Saúde do Azure.

Opcionalmente, você pode criar um serviço DICOM e um serviço MedTech no espaço de trabalho.

Aceder ao serviço FHIR

O serviço FHIR é protegido pelo ID do Microsoft Entra que não pode ser desativado. Para acessar a API de serviço, você deve criar um aplicativo cliente também conhecido como uma entidade de serviço no Microsoft Entra ID e concedê-lo com as permissões corretas.

Registar uma aplicação cliente pública

Você pode criar ou registrar um aplicativo cliente no portal do Azure ou usando scripts PowerShell e CLI do Azure. Este aplicativo cliente pode ser usado para uma ou mais instâncias de serviço FHIR. Ele também pode ser usado para outros serviços nos Serviços de Dados de Integridade do Azure.

Se o aplicativo cliente for criado com um certificado ou segredo de cliente, certifique-se de renovar o certificado ou o segredo do cliente antes da expiração e substitua as credenciais do cliente em seus aplicativos.

Você pode excluir um aplicativo cliente. Antes de excluir um aplicativo cliente, verifique se ele não é usado em ambientes de produção, desenvolvimento, teste ou garantia de qualidade (QA).

Conceder permissões de acesso

Você pode conceder permissões de acesso ou atribuir funções no portal do Azure ou usando scripts PowerShell e CLI do Azure.

Executar transações de criação, leitura, atualização e exclusão (CRUD)

Você pode executar transações Criar, Ler (pesquisar), Atualizar e Excluir (CRUD) no serviço FHIR em seus aplicativos ou usando ferramentas como Postman, Cliente REST e cURL. Como o serviço FHIR é protegido por padrão, você precisa obter um token de acesso e incluí-lo em sua solicitação de transação.

Obter um token de acesso

Você pode obter um token de acesso do Microsoft Entra usando PowerShell, CLI do Azure, CCI REST ou SDK do .NET. Para obter mais informações, consulte Obter um token de acesso.

Acesso utilizando ferramentas existentes

Carregar dados

Você pode carregar dados diretamente usando o método POST ou PUT no serviço FHIR. Para carregar dados em massa, você pode usar $import operação. Para obter informações, visite operação de importação.

CMS, pesquisa, validação de perfil e reindexação

Você pode encontrar mais detalhes sobre interoperabilidade e acesso do paciente, pesquisa, validação de perfil e reindexação na documentação do serviço FHIR.

Exportar Dados

Opcionalmente, você pode exportar ($export) dados para o Armazenamento do Azure e usá-los em seus projetos de análise ou aprendizado de máquina. Você pode exportar os dados "no estado em que se encontram" ou deID no ndjson formato.

Converter dados

Opcionalmente, você pode converter dados HL7 v2 e outros formatos para FHIR.

Usando dados FHIR no painel do Power BI

Opcionalmente, você pode criar relatórios de painel do Power BI com dados FHIR.

Próximos passos

Implantar um serviço FHIR nos Serviços de Dados de Saúde do Azure