Notas sobre a versão: API do Azure para FHIR

Importante

A API do Azure para FHIR será desativada em 30 de setembro de 2026. Siga as estratégias de migração para fazer a transição para FHIR® dos Serviços de Dados de Saúde do Azure até essa data. Devido à desativação da API do Azure para FHIR, novas implantações não serão permitidas a partir de 1º de abril de 2025. O serviço dos Serviços de Dados de Saúde do Azure para serviço FHIR é a versão evoluída da API do Azure para FHIR que permite aos clientes gerenciar os serviços FHIR, DICOM e serviço de tecnologia médica com integrações a outros serviços do Azure.

A API do Azure para FHIR® fornece uma implantação totalmente gerenciada do Microsoft FHIR Server para Azure. O servidor é uma implementação do padrão FHIR. Este documento fornece detalhes sobre os recursos e aprimoramentos feitos na API do Azure para FHIR.

Novembro de 2024

Serviço FHIR

Correções de bug

• Melhoria na validação de exportação: foi encontrado um problema em que as exportações prosseguiam apesar dos parâmetros de pesquisa inválidos. Uma nova mudança é implementada para impedir as exportações nessas condições. Esse é o comportamento padrão. Os clientes podem substituí-lo usando o sinalizador leniente. Essa mudança foi comunicada aos clientes no mês passado.
• Aprimoramento do desempenho do pacote: O processo de atualização do perfil durante a execução do pacote foi simplificado. Se um pacote contiver alterações em ValueSet, StructureDefinitione/ou CodeSystem, nenhuma atualização de perfil ocorrerá até que o pacote seja totalmente concluído. Essa alteração melhora o desempenho dos pacotes, reduzindo os atrasos causados por várias atualizações ao lidar com alterações nesses tipos de recursos.
• Análise de cabeçalho de tipo de conteúdo: um problema relacionado à análise do cabeçalho de application/x-www-form-urlencoded tipo de conteúdo foi resolvido.
• Aprimoramentos de reindexação A operação de reindexação foi aprimorada com a remoção de uma limitação artificial que anteriormente restringia o manuseio de grandes conjuntos de dados históricos ou casos em que os clientes solicitavam um tamanho de consulta limitado. Além disso, o processo de reindexação seria relatado incorretamente como "concluído" ao lidar com muitos recursos históricos sequenciais ou excluídos com o tamanho de consulta padrão. Esse problema foi resolvido para garantir que o processo de reindexação seja concluído corretamente e relate o status apropriado.

Outubro de 2024

Serviço FHIR

Correções de bug

• Validação de exportação: foi identificado um problema em que as exportações prosseguiam apesar dos parâmetros de pesquisa inválidos. Estamos introduzindo uma mudança que impede as exportações nessas condições. Esse recurso está atualmente por trás de um sinalizador de validação estrito e se tornará o comportamento padrão em ou após 30 de outubro.
• Inclusão de parâmetro de pesquisa: Resolvemos um problema em que parâmetros de pesquisa adicionais (por exemplo, _include, _has) não retornavam todos os resultados esperados, às vezes omitindo o próximo link.
• Execução do trabalho de exportação: uma ocorrência rara durante a conclusão do trabalho de System.ObjectDisposedException exportação foi resolvida evitando saídas prematuras.
• Atualização do código de status HTTP: o código de status HTTP para parâmetros inválidos durante $reindex a criação do trabalho agora é atualizado para 400, garantindo um melhor tratamento de erros.
• Limpeza de parâmetros de pesquisa: uma correção foi implementada para garantir a limpeza completa dos parâmetros de pesquisa no banco de dados quando acionada com chamadas de API de exclusão, abordando problemas relacionados a exclusões incompletas.

Agosto de 2024

Serviço FHIR

Correções de bugs Uma correção foi implementada para resolver problemas com grandes exportações exibindo incorretamente um status "concluído" enquanto as tarefas filho ainda estão sendo processadas. A solução incorpora um atraso para mitigar a ocorrência desses erros de status, melhorando a confiabilidade da exportação.

Julho de 2024

Serviço FHIR

Correções de bug

Correção: exportando dados como usuário SMART A exportação de dados como um usuário SMART não requer mais escopos de gravação. Anteriormente, era necessário conceder privilégios de "gravação" a um usuário SMART para exportar dados, o que implicava em níveis de privilégio mais altos. Para iniciar um trabalho de exportação como um usuário SMART, certifique-se de que o usuário seja membro da função de exportação FHIR no RBAC e solicite o escopo clínico SMART de "leitura".

Correção: atualizando o código de status de HTTP 500 para HTTP 400 Durante uma operação de patch, se a carga solicitasse uma atualização para um tipo de recurso diferente de Parâmetro, um erro interno do servidor (HTTP 500) era inicialmente lançado. Isso foi atualizado para gerar um erro HTTP 400.

Maio de 2024

Serviço FHIR

Aprimoramentos na operação de histórico de limpeza A operação de histórico de limpeza permite que você execute uma exclusão parcial usando o parâmetro de consulta 'allowPartialSuccess'. Por padrão, a operação de histórico de limpeza aguarda a conclusão bem-sucedida antes de excluir recursos. No entanto, se ocorrer um erro durante a execução, a exclusão de recursos será revertida. Usando o parâmetro de consulta 'allowPartialSuccess', você pode impedir que a transação seja revertida em caso de erro.

Correções de bug

• Corrigido: código de status HTTP para solicitações de longa duração. As solicitações FHIR que levam mais de 100 segundos para serem executadas retornam um código de status HTTP 408 em vez de HTTP 500.
• Corrigido: solicitação de histórico no pacote. Antes da correção, uma solicitação de histórico em um pacote retornava o código de status HTTP 404.

Março de 2024

Paralelização de pacote de lote Os pacotes configuráveis de lote são executados em série no serviço FHIR por padrão. Para melhorar a taxa de transferência com chamadas de pacote, habilitamos o processamento paralelo de pacotes em lote.

Saiba mais:

• Paralelização de pacotes configuráveis em lote

Correções de bug

• Corrigido: melhorar o desempenho do processamento de pacotes. Atualizações são feitas no método de execução de tarefas, levando à melhoria do desempenho do processamento de pacotes. Veja PR#3727.

Fevereiro de 2024

Habilita a contagem de todas as versões (históricas e excluídas de forma reversível) de recursos O parâmetro de consulta _summary=count e _count=0 pode ser adicionado a _history ponto de extremidade para obter a contagem de todos os recursos com versão. Essa contagem inclui recursos excluídos de forma reversível. Para obter mais informações, consulte gerenciamento de histórico.

Melhorar a taxa de transferência para a operação de exportação O parâmetro de consulta "_isparallel" pode ser adicionado à operação de exportação para aumentar sua taxa de transferência. É importante observar que o uso desse parâmetro pode resultar em um aumento no consumo de Unidades de Solicitação ao longo da vida útil da exportação. Para obter mais informações, consulte Exportar parâmetros de consulta da operação.

Observação

Há um problema conhecido com a operação $export que pode resultar em exportações incompletas com status bem-sucedido. O problema ocorre quando o sinalizador is_parallel foi usado. Os trabalhos de exportação executados com _isparallel parâmetro de consulta a partir de 13 de fevereiro de 2024 são afetados por esse problema.

Alteração na nomenclatura do nome para o nome do arquivo exportado e a conta de armazenamento padrão Com essa alteração, os nomes de arquivo exportados seguem o formato '{FHIR Resource Name}-{Number}-{Number}.ndjson'. Não há garantia de que a ordem dos arquivos corresponda a qualquer ordenação dos recursos no banco de dados. O nome da conta de armazenamento padrão é atualizado para 'Export-{Number}'. Não há alteração no número de recursos adicionados em arquivos exportados individuais.

Aprimoramento de desempenho A otimização paralela para consultas FHIR pode ser habilitada usando o cabeçalho HTTP "x-ms-query-latency-over-efficiency". Esse valor precisa ser definido como true para obter a simultaneidade máxima durante a execução da consulta. Para obter mais informações, consulte Pacotes em lote.

Janeiro de 2024

Execução simultânea de consultas com interações condicionais As interações condicionais podem ser complexas e exigem muito desempenho. Para aumentar a latência de consultas que envolvem interações condicionais, você tem a opção de utilizar o cabeçalho de solicitação x-conditionalquery-processing-logic. Para obter mais informações, consulte Considerações de desempenho para interações condicionais da API.

Dezembro de 2023

Recursos adicionais adicionados à operação de exportação $export operação agora dão suporte à exportação de recursos com controle de versão e recursos excluídos de forma reversível. Para obter mais informações, consulte Exportar parâmetros de consulta.

novembrod e 2023

O recurso de exclusão em massa agora disponível na versão prévia '$bulk-delete' permite que você exclua recursos do servidor FHIR de forma assíncrona. A operação de exclusão em massa pode ser executada no nível do sistema ou para o tipo de recurso individual. Para obter mais informações, consulte operação de exclusão em massa.

A operação de exclusão em massa está atualmente em visualização pública. Revise o aviso de isenção de responsabilidade para obter detalhes. [! INCLUIR isenção de responsabilidade de visualização pública]

Correção de bug: consultas FHIR usando paginação e revinclude resultaram em um erro ao usar o próximo link

O problema foi resolvido e as consultas FHIR usando o token de continuação com include/revinclude não relatam mais uma exceção. Para obter detalhes sobre a correção, visite #3525.

Junho de 2023

Correção de Bug: URL do ponto de extremidade de metadados na instrução de capacidade é URL relativa De acordo com a especificação FHIR, a URL do ponto de extremidade de metadados na instrução de capacidade precisa ser uma URL absoluta. Para obter detalhes sobre a especificação FHIR, visite a Declaração de Capacidade. Este fanix aborda o problema, para obter detalhes, visite 3265.

Maio de 2023

SMART on FHIR: Mapeamento de escopo clínico fixo para aplicativos

Essa correção de bug resolve um problema com o escopo clínico não interpretado corretamente para aplicativos de back-end. Para mais detalhes, visite #3250

Abril de 2022

Corrigidos problemas transitórios associados ao carregamento de parâmetros de pesquisa personalizados Essa correção de bug resolve o problema, em que o serviço FHIR não carregava o status SearchParameter mais recente em caso de falha. Para mais detalhes, visite #3222

Novembro de 2022

Corrigido o erro gerado quando o recurso é atualizado usando o cabeçalho if-match e PATCH

O bug foi corrigido e o recurso será atualizado se corresponder ao cabeçalho Etag. Para obter detalhes, consulte #2877|.

Maio de 2022

Aprimoramento

Aprimoramento	Informações relacionadas
A API do Azure para FHIR não criará uma nova versão do recurso se o conteúdo do recurso não tiver sido alterado.	Se um usuário atualizar um recurso existente e apenas meta.versionId ou meta.lastUpdated tiver sido alterado, retornaremos OK com as informações de recurso existentes sem atualizar VersionId e lastUpdated. Para obter mais informações, confira Nº 2519.

Abril de 2022

Aprimoramentos

Aprimoramentos	Informações relacionadas
Patch FHIRPath	O Patch FHIRPath foi adicionado como um recurso à API do Azure para FHIR. Isso implementa o Patch FHIRPath conforme definido no site da HL7.
Mover a notificação de Bundle para o Core	Com a introdução do namespace Resource.Bundle ao Core, as referências de Resource ao arquivo de recursos de cadeia de caracteres precisaram se tornar mais explícitas. Para obter mais informações, confira PR nº 2478.
Processa um cabeçalho inválido na atualização com o controle de versão	Quando a política de controle de versão é definida como "versioned-update", exigimos que a versão mais recente do recurso seja fornecida no cabeçalho if-match da solicitação em uma atualização. A versão especificada precisa estar no formato Etag. Anteriormente, um erro 500 era retornado se a versão fosse inválida ou estivesse em um formato incorreto. Essa atualização agora retorna um erro 400 Solicitação Inválida. Para obter mais informações, confira PR nº 2467.

Correções de bug

Correções de bug	Informações relacionadas
Adiciona um núcleo ao caminho do recurso	Uma parte do caminho para um recurso de cadeia de caracteres foi removida acidentalmente na política de controle de versão. Essa correção a adiciona novamente. Para obter mais informações, confira PR nº 2470.
O tempo limite do SQL retorna um erro 500	Correção de um bug que ocorre quando uma solicitação SQL atinge um tempo limite e retorna um erro 500. Nos logs, esse é um tempo limite do SQL em comparação com a obtenção de um erro 429 do front-end. Para obter mais informações, confira PR nº 2497.

Março de 2022

Recursos

Recurso	Informações relacionadas
Patch FHIRPath	Esse novo recurso permite que você use a operação Patch FHIRPath em recursos FHIR. Para obter mais informações, confira Funcionalidades da API REST do FHIR para a API do Azure para FHIR.

Correções de bug

Correções de bug	Informações relacionadas
Duplicar recursos na pesquisa com _include	Correção de um problema em que um recurso individual pode ser retornado duas vezes em uma pesquisa que tenha _include. Para obter mais informações, confira PR nº 2448.
Criações com PUT na atualização com o controle de versão	Problema corrigido: a criação com PUT resultava em um erro quando a política de controle de versão era configurada como versioned-update. Para obter mais informações, confira PR nº 2457.
Tratamento de cabeçalho inválido na atualização com o controle de versão	Correção de um problema em que um cabeçalho if-match inválido resultava em um erro HTTP 500. Agora, um erro HTTP Solicitação Inválida é retornado. Para obter mais informações, confira PR nº 2467.

Fevereiro de 2022

Recursos e aprimoramentos

Aprimoramentos	Informações relacionadas
Adição de um erro 429 Repetição e do log em BundleHandler	Às vezes, encontramos erros 429 ao processarmos um pacote. Se o serviço FHIR receber um 429 na camada de BundleHandler, anularemos o processamento do pacote e ignoraremos os recursos restantes. Adicionamos outra repetição (além da repetição presente na camada de armazenamento de dados), que será executada uma vez por recurso que encontrar um erro 429. Para obter mais informações sobre esse aprimoramento de recurso, confira PR nº 2400.
Cobrança de $convert-data e $de-id	Os recursos de conversão de dados e de exportação não identificados da API do Azure para FHIR já estão em disponibilidade geral. A cobrança das operações $convert-data e $de-id na API do Azure para FHIR foi habilitada. Os medidores de cobrança foram ativados em 1º de março de 2022.

Correções de bug

Correções de bug	Informações relacionadas
Atualizar o índice de pesquisa do compartimento	Houve um caso pouco frequente em que o índice de pesquisa do compartimento não estava sendo definido nos recursos. Agora, usamos o mesmo índice da pesquisa principal para a pesquisa de compartimento a fim de garantir que todos os dados sejam retornados. Para obter mais informações sobre a correção de código, confira PR nº 2430.

Dezembro de 2021

Recursos e aprimoramentos

Aprimoramentos	Informações relacionadas
Adição de editor a CapabilityStatement.name	Você já pode encontrar o editor na declaração de funcionalidades em CapabilityStatement.name. Nº 2319
Log de FhirOperation vinculado a chamadas anônimas nas métricas de solicitação	Não estávamos registrando as operações que não exigiam autenticação. Estendemos a capacidade de obter o tipo FhirOperation em RequestMetrics para chamadas anônimas. Nº 2295

Correções de bug

Correções de bug	Informações relacionadas
Correção do erro 500 quando o Code SearchParameter é nulo	Correção de um problema com SearchParameter. Se ele tivesse um valor nulo para Code, o resultado seria um erro 500. Agora isso resulta em um InvalidResourceException como os outros valores. Nº 2343
Retorno de BadRequestException com uma mensagem válida quando o corpo JSON de entrada é inválido	Para as solicitações de corpo JSON inválidas, o servidor FHIR retornava um erro 500. Agora retornamos a BadRequestException com uma mensagem válida em vez de 500. Nº 2239
_sort pode fazer com que ChainedSearch retorne resultados incorretos	Anteriormente, as opções de classificação do objeto SearchOption da pesquisa encadeada não eram limpas, fazendo com que as opções de classificação fossem transmitidas para a subpesquisa encadeada, que não são válidas. Isso podia gerar nenhum resultado quando devia haver resultados. Esse bug já foi corrigido – Nº 2347. Ele resolveu o bug Nº 2344 do GitHub.

Novembro de 2021

Recursos e aprimoramentos

Aprimoramentos	Informações relacionadas
Processar links Patient-everything	Expandimos as funcionalidades Patient-everything para processar os links de pacientes – Nº 2305. Para obter mais informações, confira a documentação Patient-everything no FHIR.
Adição de nome de software e versão à declaração de funcionalidades	Na declaração de funcionalidades, o nome do software já distingue o uso da API do Azure para FHIR dos Serviços de Dados de Saúde do Azure. A versão de software agora especificará o pacote de versão de software livre que está ativo no serviço gerenciado – Nº 2294. Resolve os bugs Nº 1778 e Nº 2241
Registre 500s para RequestMetric	Anteriormente, os anos 500 ou todos os erros desconhecidos/sem tratamento não eram registrados em RequestMetric. Agora, eles são registrados – Nº 2240. Para obter mais informações, confira Habilitar as configurações de diagnóstico na API do Azure para FHIR
Compactar os tokens de continuação	Em algumas ocasiões, o token de continuação era muito longo para conseguir seguir o próximo link nas pesquisas e resultava em um erro 404. Para resolver isso, compactamos o token de continuação para garantir que ele permaneça abaixo do limite de tamanho – Nº 2279. Resolve o problema Nº 2250.

Correções de bug

Correções de bug	Informações relacionadas
Resolução do erro 500 que ocorria quando a data era transmitida com um fuso horário.	Isso corrige um erro 500 ocorrido quando uma data com um fuso horário era transmitida para um campo de datetime – Nº 2270.
Resolução de um problema que ocorria quando um pacote postado com um tipo de mídia incorreto retornava um erro 500.	Anteriormente, quando uma pesquisa era postada com uma chave contendo determinados caracteres, um erro 500 era retornado. Isso corrige o problema Nº 2264 e resolve o bug Nº 2148.

Outubro de 2021

Correções de bug

Bug de loop infinito	Informações relacionadas
Correção de um problema em que a Exclusão Condicional podia resultar em um loop infinito.	Nº 2269

Setembro de 2021

Recursos e aprimoramentos

Aprimoramentos	Informações relacionadas
Adição de suporte para o patch condicional	Patch condicional
Patch condicional	Nº 2163
Adição de um evento de auditoria de patch condicional.	Nº 2213

Permitir um patch JSON em pacotes	Patch JSON em pacotes
Permite pacotes de histórico de pesquisa com solicitações de patch.	Nº 2156
Patch JSON habilitado em pacotes que usam recursos binários.	Nº 2143

Novos subtipos de eventos de auditoria	Informações relacionadas
Adição de novos subtipos OperationName de auditoria.	Nº 2170

Aprimoramentos de reindexação	Informações relacionadas
Adição de limites para parâmetros de reindexação.	Nº 2103
Atualização da mensagem de erro para limites de parâmetro de reindexação.	Nº 2109
Adição da verificação de contagem de reindexação final.	Nº 2099

Correções de bug

Correções de bug	Informações relacionadas
Captura mais ampla de exceções quando o patch é aplicado.	Nº 2192
Correção do histórico com PATCH no STU3.	Nº 2177

Bugs da pesquisa personalizada	Informações relacionadas
Resolve falhas com os parâmetros de pesquisa personalizados.	Nº 2133
Adicionada lógica de repetição ao excluir o parâmetro de pesquisa.	Nº 2121
Definição da contagem máxima de itens nas opções de pesquisa em SearchParameterDefinitionManager.	Nº 2141
Fornece uma exceção melhor se há uma expressão inválida no parâmetro de pesquisa.	Nº 2157

Resolução do erro 503 Repetição	Informações relacionadas
Erro 503 Repetição do Azure Cosmos DB.	Nº 2106
Correção do processamento de erros 429 de StoreProcedures.	Nº 2165

Problemas do GitHub fechados	Informações relacionadas
Não é possível criar um parâmetro de pesquisa personalizada para o dispositivo médico CarePlan.	Nº 2146
Mensagem de erro confusa para a criação condicional sem ID.	Nº 2168

Conector de IoT para FHIR (versão prévia)

Correções de bug	Informações relacionadas
Correção de um link desfeito.	Atualização do link para a documentação do conector de IoT do Azure no portal da API do Azure para FHIR.

Próximas etapas

Para obter informações sobre os recursos e as correções de bugs nos Serviços de Dados de Saúde do Azure (serviço FHIR, serviço DICOM e serviço de tecnologia médica), confira

Notas sobre a versão: 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.