Notas de 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 o serviço 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 FHIR dos Serviços de Dados de Saúde do Azure é a versão evoluída da API do Azure para FHIR que permite aos clientes gerir serviços FHIR, DICOM e MedTech com integrações noutros serviços do Azure.

A API do Azure para FHIR® fornece uma implantação totalmente gerenciada do Servidor Microsoft FHIR 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 erros

• Melhoria na validação de exportação: foi encontrado um problema em que as exportações prosseguiram apesar dos parâmetros de pesquisa inválidos. Uma nova mudança é implementada para evitar exportações nessas condições. Este é o comportamento predefinido. Os clientes podem substituí-lo usando a bandeira lenient. Esta alteração foi comunicada aos clientes no mês passado.
• Aprimoramento de 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 abordado e resolvido.
• Aprimoramentos de reindexação A operação de reindexação foi melhorada removendo uma limitação artificial que anteriormente restringia o tratamento 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 erros

• Validação de exportação: foi identificado um problema em que as exportações prosseguiram apesar dos parâmetros de pesquisa inválidos. Estamos a introduzir uma alteração que impede as exportações nestas condições. Esse recurso está atualmente atrá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âmetros 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 de 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 acionados com chamadas de API de exclusão, resolvendo 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 bugs

Corrigido: 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 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 "ler" do SMART.

Corrigido: Atualizando o código de status de HTTP 500 para HTTP 400 Durante uma operação de patch, se a carga útil solicitou uma atualização para um tipo de recurso diferente de Parâmetro, um erro interno do servidor (HTTP 500) foi inicialmente lançado. Isso foi atualizado para lançar um erro HTTP 400 em vez disso.

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 erros

• Corrigido: código de status HTTP para solicitações de longa execuçã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 pacotes em lote Os pacotes em 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 em lote

Correções de bugs

• Corrigido: Melhore o desempenho do processamento de pacotes. São feitas atualizações no método de execução de tarefas, levando à melhoria do desempenho do processamento do pacote. Ver PR#3727.

Fevereiro de 2024

Permite contar todas as versões (históricas e excluídas suavemente) 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 versionados. Essa contagem inclui recursos excluídos suavemente. 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 melhorar sua taxa de transferência. É importante notar que o uso deste 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 de operação.

Nota

Há um problema conhecido com a operação $export que pode resultar em exportações incompletas com sucesso de status. 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 de nomes para nome de arquivo exportado e conta de armazenamento padrão Com essa alteração, os nomes de arquivos exportados seguem o formato '{FHIR Resource Name}-{Number}-{Number}.ndjson'. Não é garantido que a ordem dos ficheiros corresponda a qualquer ordenação dos recursos na base 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 atingir a simultaneidade máxima durante a execução da consulta. Para obter mais informações, consulte Batch Bundles.

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 melhorar 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 Exportar $export operação agora suporta a exportação de recursos versionados e recursos excluídos suavemente. Para obter mais informações, consulte Exportar parâmetros de consulta.

Novembro de 2023

O recurso de exclusão em massa agora disponível na visualização '$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. Reveja a declaração de exoneração de responsabilidade para obter detalhes. [! INCLUIR isenção de responsabilidade de pré-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 agora 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 Por especificação FHIR, a URL do ponto de extremidade de metadados na declaração de capacidade precisa ser uma URL absoluta. Para obter detalhes sobre a especificação FHIR, visite Declaração de capacidade. Este fanix aborda a questão, para detalhes visite 3265.

Maio de 2023

SMART on FHIR : Mapeamento de escopo clínico fixo para aplicações

Esta 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 2023

Corrigidos problemas transitórios associados ao carregamento de parâmetros de pesquisa personalizados Esta 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 o PATCH

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

Maio de 2022

Melhoria

Melhoria	Informações relacionadas
A API do Azure para FHIR não cria 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 tiverem sido alterados, retornaremos OK com as informações do recurso existente sem atualizar VersionId e lastUpdated. Para obter mais informações, consulte #2519.

Abril de 2022

Melhorias

Melhorias	Informações relacionadas
FHIRPath Patch	FHIRPath Patch foi adicionado como um recurso para ambos a API do Azure para FHIR. Isso implementa FHIRPath Patch conforme definido no site HL7.
Mover a notificação do pacote para o núcleo	Com a introdução do namespace Resource.Bundle no Core, as referências Resource ao arquivo de recursos de cadeia de caracteres tiveram que ser tornadas mais explícitas. Para obter mais informações, consulte PR #2478.
Manipula cabeçalho inválido na atualização versionada	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 deve estar no formato ETag. Anteriormente, um 500 seria retornado se a versão fosse inválida ou em um formato incorreto. Esta atualização agora retorna uma solicitação incorreta 400. Para obter mais informações, consulte PR #2467.

Correções de erros

Correções de erros	Informações relacionadas
Adiciona núcleo ao caminho do recurso	Parte do caminho para um recurso de cadeia de caracteres foi removida acidentalmente na política de controle de versão. Essa correção o adiciona novamente. Para obter mais informações, consulte PR #2470.
O tempo limite do SQL está retornando um erro 500	Corrigido um bug quando uma solicitação SQL atinge um tempo limite e a solicitação retorna um 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, consulte PR #2497.

Março de 2022

Funcionalidades

Caraterística	Informações relacionadas
FHIRPath Patch	Este novo recurso permite que você use a operação FHIRPath Patch em recursos FHIR. Para obter mais informações, consulte Recursos da API REST do FHIR para a API do Azure para FHIR.

Correções de erros

Correções de erros	Informações relacionadas
Duplicar recursos na pesquisa com _include	Corrigido o problema em que um único recurso pode ser retornado duas vezes em uma pesquisa que tem _include. Para obter mais informações, consulte PR #2448.
PUT cria na atualização versionada	Corrigido o problema: a criação com PUT resultava em um erro quando a política de controle de versão estava configurada como versioned-update. Para obter mais informações, consulte PR #2457.
Tratamento de cabeçalho inválido na atualização versionada	Corrigido o problema em que o cabeçalho inválido if-match resultava em um erro HTTP 500. Agora, uma solicitação HTTP incorreta é retornada. Para obter mais informações, consulte PR #2467.

Fevereiro de 2022

Recursos e aprimoramentos

Melhorias	Informações relacionadas
Adicionadas 429 novas tentativas e login em BundleHandler	Às vezes, encontramos 429 erros ao processar um pacote. Se o serviço FHIR receber um 429 na camada BundleHandler, interromperemos o processamento do pacote e ignoraremos os recursos restantes. Adicionamos outra nova tentativa (além da nova tentativa presente na camada de armazenamento de dados) que será executada uma vez por recurso que encontrar um 429. Para obter mais informações sobre esse aprimoramento de recursos, consulte PR #2400.
Faturação para $convert-data e $de-id	A API do Azure para conversão de dados e os recursos de exportação desidentificados do FHIR agora estão disponíveis ao público em geral. A cobrança $convert-data e $de-id as operações na API do Azure para FHIR foram habilitadas. Os medidores de faturamento foram ligados em 1º de março de 2022.

Correções de erros

Correções de erros	Informações relacionadas
Índice de pesquisa do compartimento de atualização	Houve um caso de esquina em que o índice de pesquisa do compartimento não estava sendo definido em recursos. Agora, usamos o mesmo índice da pesquisa principal para garantir que todos os dados estejam sendo retornados. Para obter mais informações sobre a correção de código, consulte PR #2430.

Dezembro de 2021

Recursos e aprimoramentos

Melhorias	Informações relacionadas
Adicionado Publisher a CapabilityStatement.name	Agora você pode encontrar o editor na declaração de capacidade em CapabilityStatement.name. #2319
Registro FhirOperation vinculado a chamadas anônimas para métricas de solicitação	Não estávamos registrando operações que não exigiam autenticação. Ampliamos a capacidade de digitar FhirOperation RequestMetrics para chamadas anônimas. #2295

Correções de erros

Correções de erros	Informações relacionadas
Corrigido erro 500 quando SearchParameter o código é nulo	Corrigido um problema com SearchParameter se tivesse um valor nulo para Código, o resultado seria um 500. Agora resulta em um InvalidResourceException como os outros valores fazem. #2343
Retornado BadRequestException com mensagem válida quando o corpo JSON de entrada é inválido	Para solicitações de corpo JSON inválidas, o servidor FHIR estava retornando um erro 500. Agora retornamos um BadRequestException com uma mensagem válida em vez de 500. #2239
_sort pode fazer com ChainedSearch que retorne resultados incorretos	Anteriormente, as opções de classificação do objeto da pesquisa encadeada não eram desmarcadas, fazendo com que as opções de classificação fossem passadas SearchOption para a subpesquisa encadeada, que não são válidas. Isso pode resultar em nenhum resultado quando deveria haver resultados. Este bug foi corrigido #2347. Ele resolveu o bug #2344 do GitHub.

Novembro de 2021

Recursos e aprimoramentos

Melhorias	Informações relacionadas
Processar Paciente-tudo links	Expandimos os recursos do Paciente-tudo para processar links de pacientes #2305. Para obter mais informações, consulte Patient-everything na documentação do FHIR .
Nome e versão do software adicionados à declaração de capacidade	Na declaração de capacidade, o nome do software agora distingue se você estiver usando a API do Azure para FHIR ou os Serviços de Dados de Saúde do Azure. A versão do software agora especificará qual pacote de lançamento de código aberto está ativo no serviço gerenciado #2294. Endereços: #1778 e #2241
Registre 500s em RequestMetric	Anteriormente, 500s ou quaisquer erros desconhecidos/não tratados não estavam sendo conectados RequestMetric. Eles agora estão sendo registrados #2240. Para obter mais informações, consulte Habilitar configurações de diagnóstico na API do Azure para FHIR
Comprimir tokens de continuação	Em certos casos, o token de continuação era muito longo para poder seguir o próximo link nas pesquisas e resultaria em um 404. Para resolver isso, compactamos o token de continuação para garantir que ele permaneça abaixo do limite de tamanho #2279. Resolve o problema #2250.

Correções de erros

Correções de erros	Informações relacionadas
Erro 500 resolvido quando a data foi passada com um fuso horário.	Isso corrige um erro 500 quando uma data com um fuso horário foi passada para um campo datetime #2270.
Problema resolvido ao postar um pacote com tipo de mídia incorreto retornou um erro 500.	Anteriormente, ao postar uma pesquisa com uma chave que contém determinados caracteres, um erro 500 era retornado. Isso corrige esse problema #2264 e aborda #2148.

Outubro de 2021

Correções de erros

Bug de loop infinito	Informações relacionadas
Corrigido o problema em que a exclusão condicional podia resultar em um loop infinito.	#2269

Setembro de 2021

Recursos e aprimoramentos

Melhorias	Informações relacionadas
Adicionado suporte para patch condicional	Patch condicional
Patch condicional	#2163
Adicionado evento de auditoria de patch condicional.	#2213

Permitir patch JSON em pacotes	Patch JSON em pacotes
Permite pacotes de histórico de pesquisa com solicitações de patch.	#2156
Patch JSON ativado em pacotes usando recursos binários.	#2143

Novos subtipos de eventos de auditoria	Informações relacionadas
Adicionados novos subtipos OperationName de auditoria.	#2170

Melhorias na reindexação	Informações relacionadas
Adicionados limites para parâmetros de reindexação .	#2103
Mensagem de erro de atualização para limites de parâmetros de reindexação.	#2109
Adicionada verificação de contagem de reindexação final.	#2099

Correções de erros

Correções de erros	Informações relacionadas
Maior captura para exceções ao aplicar patch.	#2192
Corrige o histórico com PATCH no STU3.	#2177

Bugs de pesquisa personalizados	Informações relacionadas
Resolve a falha com os parâmetros de pesquisa personalizados.	#2133
Adicionada lógica de repetição ao excluir o parâmetro de pesquisa.	#2121
Defina a contagem máxima de itens nas opções de pesquisa em SearchParameterDefinitionManager.	#2141
Fornece melhor exceção se houver uma expressão incorreta no parâmetro de pesquisa.	#2157

Erro de repetição 503 resolvido	Informações relacionadas
Repita o erro 503 do Azure Cosmos DB.	#2106
Corrige o processamento de 429s de StoreProcedures.	#2165

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

Conector IoT para FHIR (visualização)

Correções de erros	Informações relacionadas
Corrigido link quebrado.	Link atualizado para a documentação do Azure do conector IoT no portal da API do Azure para FHIR.

Próximos passos

Para obter informações sobre os recursos e correções de bugs nos Serviços de Dados de Saúde do Azure (serviço FHIR, serviço DICOM e serviço MedTech), consulte

Notas de versão: Azure Health Data Services

Nota

FHIR® é uma marca registada da HL7 e é utilizada com a permissão da HL7.