Share via


Comece a usar o serviço FHIR

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, você precisará de uma assinatura do Azure e das permissões para criar grupos de recursos do Azure e implantar recursos do Azure. Você pode seguir todas as etapas abaixo ou ignorar algumas, se tiver um ambiente existente. Além disso, você pode combinar todas as etapas e concluí-las no PowerShell, CLI do Azure e scripts da API REST.

Comece a usar o diagrama de fluxo do serviço FHIR.

Criar um workspace na sua assinatura do Azure

Você pode criar um workspace no portal do Azure ou usar o PowerShell, a CLI do Azure e a API REST. Você pode encontrar scripts nos exemplos do Serviços de Dados de Saúde do Azure.

Observação

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

Criar um serviço FHIR no workspace

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

Opcionalmente, você pode criar um serviço DICOM e um serviço de tecnologia médica no workspace.

Acessar o serviço FHIR

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

Registrar um aplicativo cliente

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

Se o aplicativo cliente for criado com um certificado ou segredo do 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, certifique-se de que ele não seja 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 usar scripts do PowerShell e da CLI do Azure.

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

Você pode executar transações Criar, Ler (pesquisar), Atualizar e Excluir (CRUD) em relação ao 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ê deve obter um token de acesso e incluí-lo na sua solicitação de transação.

Obter um token de acesso

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

Acesso usando ferramentas existentes

Carregar dados

Você pode carregar dados diretamente usando o método POST ou PUT no serviço FHIR. Para carregamento de dados em massa, você pode usar a operação $import. 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 de pacientes, pesquisa, validação de perfil e reindexação na documentação do serviço FHIR.

Exportar dados

Opcionalmente, você pode exportar ($exportar) dados para o Armazenamento do Azure e usá-los em suas análises ou projetos de aprendizado de máquina. Você pode exportar os dados "como estão" ou deid no formato ndjson.

Convertendo dados

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

Usando dados FHIR no painel do Power BI

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

Próximas etapas

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

Observação

FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.