Partager via

Notes de publication : API Azure pour FHIR

  • Article

Important

L’API Azure pour FHIR sera mise hors service le 30 septembre 2026. Suivez les stratégies de migration pour passer au service FHIR® de Services de données de santé Azure d’ici à cette date. En raison de la mise hors service de l’API Azure pour FHIR, les nouveaux déploiements ne seront plus autorisés à compter du 1er avril 2025. Le service FHIR des Services de données de santé Azure est la version évoluée de l’API Azure pour FHIR qui permet aux clients de gérer les services FHIR, DICOM et MedTech avec des intégrations dans d’autres services Azure.

L’API Azure pour FHIR® fournit un déploiement entièrement managé du serveur Microsoft FHIR pour Azure. Le serveur est une implémentation de la FHIR standard. Ce document fournit des détails sur les fonctionnalités et les améliorations apportées à l’API Azure pour FHIR.

Octobre 2024

Service FHIR

Correctifs de bogues

  • Validation de l’exportation : un problème a été identifié où les exportations se sont déroulées malgré des paramètres de recherche non valides. Nous introduisons un changement qui empêche les exportations dans ces conditions. Cette fonctionnalité se trouve actuellement derrière un indicateur de validation strict et devient le comportement par défaut le 30 octobre ou après le 30 octobre.
  • Inclusion des paramètres de recherche : nous avons résolu un problème où des paramètres de recherche supplémentaires (par exemple, _include, _has) n’ont pas retourné tous les résultats attendus, omettant parfois le lien suivant.
  • Exécution du travail d’exportation : une occurrence rare de la fin du System.ObjectDisposedException travail d’exportation a été traitée en empêchant les sorties prématurées.
  • Mise à jour du code d’état HTTP : le code d’état HTTP pour les paramètres non valides pendant la $reindex création du travail est désormais mis à jour vers la version 400, ce qui garantit une meilleure gestion des erreurs.
  • Nettoyage des paramètres de recherche : un correctif a été implémenté pour garantir le nettoyage complet des paramètres de recherche dans la base de données lorsqu’ils sont déclenchés avec des appels d’API de suppression, en traitant les problèmes liés aux suppressions incomplètes.

Août 2024

Service FHIR

Correctifs de bogues Un correctif a été implémenté pour résoudre les problèmes liés aux exportations volumineuses affichant incorrectement un état « terminé » pendant que les tâches enfants sont toujours en cours de traitement. La solution intègre un délai pour atténuer l’occurrence de ces erreurs d’état, ce qui améliore la fiabilité de l’exportation.

Juillet 2024

Service FHIR

Corrections de bogues

Résolu : L’exportation de données en tant que données d’exportation d’utilisateur SMART en tant qu’utilisateur SMART ne nécessite plus d’étendues d’écriture. Auparavant, il était nécessaire d’accorder des privilèges d’écriture à un utilisateur SMART pour exporter des données, ce qui implique des niveaux de privilèges supérieurs. Pour lancer un travail d’exportation en tant qu’utilisateur SMART, assurez-vous que l’utilisateur est membre du rôle d’exportation FHIR dans RBAC et demande l’étendue clinique SMART « read ».

Correction : Mise à jour du code d’état de HTTP 500 vers HTTP 400 Lors d’une opération corrective, si la charge utile a demandé une mise à jour pour un type de ressource autre que Le paramètre, une erreur de serveur interne (HTTP 500) a été levée initialement. Cette opération a été mise à jour pour lever une erreur HTTP 400 à la place.

Mai 2024

Service FHIR

Améliorations apportées à l’opération d’historique de purge L’opération d’historique de purge vous permet d’effectuer une suppression partielle à l’aide du paramètre de requête « allowPartialSuccess ». Par défaut, l’opération d’historique de vidage attend la réussite de la saisie semi-automatique avant de supprimer des ressources. Toutefois, si une erreur se produit pendant l’exécution, la suppression des ressources est restaurée. En utilisant le paramètre de requête « allowPartialSuccess », vous pouvez empêcher la restauration de la transaction en cas d’erreur.

Correctifs de bogues

  • Correction : code d’état HTTP pour les requêtes de longue durée. Les requêtes FHIR qui prennent plus de 100 secondes pour exécuter un code d’état HTTP 408 au lieu de HTTP 500.
  • Résolu : demande d’historique dans le bundle. Avant le correctif, une demande d’historique dans un bundle a retourné le code d’état HTTP 404.

Mars 2024

Par défaut, les bundles Batch de parallélisation batch sont exécutés en série dans le service FHIR. Pour améliorer le débit avec les appels groupés, nous avons activé le traitement parallèle des offres groupées par lots.

En savoir plus :

Corrections de bogues

  • Correction : Améliorez les performances pour le traitement de l’offre groupée. Les mises à jour sont apportées à la méthode d’exécution de tâche, ce qui entraîne une amélioration des performances de traitement groupée. Voir PR#3727.

Février 2024

Permet de compter toutes les versions (historiques et supprimées de manière réversible) des ressources Le paramètre de requête _summary=count et _count=0 peut être ajouté à _history point de terminaison pour obtenir le nombre de ressources avec version. Ce nombre inclut des ressources supprimées de manière réversible. Pour plus d’informations, consultez la gestion de l’historique.

Améliorez le débit pour l’opération d’exportation Le paramètre de requête « _isparallel » peut être ajouté à l’opération d’exportation pour améliorer son débit. Il est important de noter que l’utilisation de ce paramètre peut entraîner une augmentation de la consommation des unités de requête au cours de la durée d’exportation. Pour plus d’informations, consultez Les paramètres de requête d’exportation de l’opération.

Remarque

Il existe un problème connu avec l’opération de $export qui peut entraîner des exportations incomplètes avec succès d’état. Le problème se produit lorsque l’indicateur de is_parallel a été utilisé. Les travaux d’exportation exécutés avec _isparallel paramètre de requête à partir du 13 février 2024 sont affectés par ce problème.

Modification de la nomenclature de nom pour le nom de fichier exporté et le compte de stockage par défaut Avec cette modification, les noms de fichiers exportés suivent le format « {Nom de la ressource FHIR}-{Number}-{Number}.ndjson ». L’ordre des fichiers n’est pas garanti pour correspondre à l’ordre des ressources de la base de données. Le nom du compte de stockage par défaut est mis à jour sur « Export-{Number} ». Il n’existe aucune modification du nombre de ressources ajoutées dans des fichiers exportés individuels.

L’optimisation parallèle de l’amélioration des performances pour les requêtes FHIR peut être activée à l’aide de l’en-tête HTTP « x-ms-query-latency-over-efficiency ». Cette valeur doit être définie sur true pour atteindre la concurrence maximale pendant l’exécution de la requête. Pour plus d’informations, consultez Batch Bundles.

Janvier 2024

L’exécution simultanée de requêtes avec des interactions conditionnelles peut être complexe et gourmande en performances. Pour améliorer la latence des requêtes impliquant des interactions conditionnelles, vous avez la possibilité d’utiliser l’en-tête de requête x-conditionalquery-processing-logic. Pour plus d’informations, consultez Considérations relatives aux performances pour les interactions d’API conditionnelles.

Décembre 2023

Des fonctionnalités supplémentaires ajoutées à l’opération d’exportation $export l’opération prennent désormais en charge l’exportation de ressources avec version et de ressources supprimées de manière réversible. Pour plus d’informations, consultez Exporter les paramètres de requête.

Novembre 2023

La fonctionnalité de suppression en bloc désormais disponible en préversion « $bulk-delete » vous permet de supprimer des ressources du serveur FHIR de manière asynchrone. L’opération de suppression en bloc peut être exécutée au niveau du système ou pour un type de ressource individuel. Pour plus d’informations, consultez l’opération de suppression en bloc.

L’opération de suppression en bloc est actuellement en préversion publique. Passez en revue l’exclusion de responsabilité pour plus d’informations. [! INCLURE la clause d’exclusion de responsabilité en préversion publique]

Correctif de bogue : les requêtes FHIR utilisant la pagination et la réinitication ont entraîné une erreur lors de l’utilisation du lien suivant

Le problème est désormais résolu et les requêtes FHIR utilisant le jeton de continuation avec include/revinclude, ne signalent plus d’exception. Pour plus d’informations sur le correctif, visitez #3525.

Juin 2023

Correctif de bogue : l’URL du point de terminaison de métadonnées dans l’instruction de fonctionnalité est l’URL relative par spécification FHIR, l’URL du point de terminaison de métadonnées dans l’instruction de fonctionnalité doit être une URL absolue. Pour plus d’informations sur la spécification FHIR, consultez l’instruction de fonctionnalité. Ce fanix résout le problème, pour plus d’informations, visitez 3265.

Mai 2023

SMART sur FHIR : Mappage d’étendue clinique fixe pour les applications

Ce correctif de bogue résout le problème lié à l’étendue clinique qui n’est pas interprétée correctement pour les applications back-end. Pour plus d’informations, consultez #3250

Avril 2023

Correction des problèmes temporaires associés au chargement des paramètres de recherche personnalisés Ce bogue résout le problème, où le service FHIR ne chargerait pas le dernier état SearchParameter en cas de défaillance. Pour plus d’informations, consultez #3222

Novembre 2022

Correction de l’erreur générée lors de la mise à jour de la ressource à l’aide de l’en-tête if-match et patch

Le bogue est maintenant résolu et la ressource sera mise à jour si elle correspond à l’en-tête Etag. Pour plus d’informations, consultez #2877|.

Mai 2022

Amélioration

Amélioration Informations connexes
L’API Azure pour FHIR ne crée pas de nouvelle version de la ressource si le contenu de la ressource n’a pas changé. Si un utilisateur met à jour une ressource existante et que seulement meta.versionId ou meta.lastUpdated ont changé, nous renvoyons OK avec les informations de ressource existantes sans mettre à jour VersionId ni lastUpdated. Pour plus d’informations, consultez #2519.

Avril 2022

Améliorations

Améliorations Informations connexes
Correctif FHIRPath Le correctif FHIRPath a été ajouté en tant que fonctionnalité à l’API Azure pour FHIR. Cela implémente le correctif FHIRPath tel que défini sur le site web HL7.
Déplacement d’une notification Bundle dans Core Avec l’introduction de l’espace de noms Resource.Bundle dans Core, les références de ressources au fichier de ressources de chaîne devaient être rendues plus explicites. Pour plus d’informations, consultez PR #2478.
Gestion de l’en-tête non valide en cas de mise à jour versionnée Lorsque la stratégie de contrôle de version est définie sur « versioned-update », nous avons demandé que la version la plus récente de la ressource soit fournie dans l’en-tête if-match de la requête en cas de mise à jour. La version spécifiée doit être au format ETag. Auparavant, un message d’erreur 500 était renvoyé si la version n’était pas valide ou dans un format incorrect. Cette mise à jour renvoie désormais une erreur de requête 400. Pour plus d’informations, consultez PR #2467.

Correctifs de bogues

Résolution des bogues Informations connexes
Ajout de Core au chemin d’accès de la ressource Une partie du chemin d’accès à une ressource chaîne était supprimée accidentellement dans la stratégie de contrôle de version. Ce correctif la rajoute. Pour plus d’informations, consultez PR #2470.
Le délai d’expiration SQL renvoie une erreur 500 Correction d’un bogue lorsqu’une requête SQL atteint un délai d’expiration et que la requête renvoie une erreur 500. Dans les journaux, il s’agit d’un délai d’expiration de SQL plutôt qu’une erreur 429 du front-end. Pour plus d’informations, consultez PR #2497.

Mars 2022

Caractéristiques

Fonctionnalité Informations connexes
Correctif FHIRPath Cette nouvelle fonctionnalité vous permet d’utiliser l’opération du correctif FHIRPath sur des ressources FHIR. Pour plus d’informations, consultez Fonctionnalités de l’API REST FHIR pour l’API Azure pour FHIR.

Correctifs de bogues

Résolution des bogues Informations connexes
Ressources en double dans la recherche avec _include Résolution du problème de renvoi en double d’une même ressource dans une recherche qui a _include. Pour plus d’informations, consultez PR #2448.
PUT creates sur une mise à jour versionnée Problème résolu : la création avec PUT a entraîné une erreur lorsque la stratégie de contrôle de version est configurée versioned-updatesur . Pour plus d’informations, consultez PR #2457.
Gestion des en-têtes non valides sur une mise à jour versionnée Correction du problème où un en-tête non valide if-match entraînait une erreur HTTP 500. Une requête incorrecte HTTP est désormais renvoyée. Pour plus d’informations, consultez PR #2467.

Février 2022

Fonctionnalités et améliorations

Améliorations Informations connexes
Ajout d’une erreur 429 de nouvelle tentative et journalisation dans BundleHandler Nous rencontrons parfois des erreurs 429 lors du traitement d’un bundle. Si le service FHIR reçoit une erreur 429 au niveau de la couche BundleHandler, nous annulons le traitement du bundle et ignorons les ressources restantes. Nous avons ajouté une autre nouvelle tentative (en plus de la nouvelle tentative présente dans la couche de magasin de données) qui s’exécute une fois par ressource qui rencontre une erreur 429. Pour plus d’informations sur cette amélioration de fonctionnalité, consultez PR #2400.
Facturation pour $convert-data et $de-id La conversion des données de l’API Azure pour FHIR et les fonctionnalités d’exportation dé-identifiées sont désormais en disponibilité générale. La facturation des opérations $convert-data$de-id dans l’API Azure pour FHIR a été activée. Les compteurs de facturation ont été activés le 1er mars 2022.

Correctifs de bogues

Résolution des bogues Informations connexes
Mise à jour de l’index de recherche des compartiments Il y avait un cas particulier où l'index de recherche du compartiment n'était pas défini sur les ressources. Nous utilisons désormais le même index que la recherche principale pour la recherche de compartiments pour s’assurer que toutes les données sont renvoyées. Pour plus d’informations sur le correctif de code, consultez PR #2430.

Décembre 2021

Fonctionnalités et améliorations

Améliorations Informations connexes
Ajout de Publisher à CapabiilityStatement.name Vous trouverez désormais l’éditeur dans la déclaration de capacité de CapabilityStatement.name. #2319
Journaliser FhirOperation lié aux appels anonymes à des métriques de requête Nous ne journalisions pas les opérations qui ne nécessitaient pas d’authentification. Nous avons étendu la possibilité d’obtenir le type FhirOperation dans RequestMetrics pour les appels anonymes. #2295

Correctifs de bogues

Résolution des bogues Informations connexes
Correction de l’erreur 500 lorsque le code SearchParameter est NULL Correction d’un problème lié à SearchParameter qui, en cas de valeur NULL pour Code, aurait pour résultat une erreur 500. À présent, elle génère une InvalidResourceException valeur semblable à celle des autres. #2343
Renvoyait BadRequestException avec un message valide lorsque le corps JSON en entrée n’était pas valide Pour les requêtes de corps JSON non valides, le serveur FHIR renvoyait une erreur 500. Nous renvoyons maintenant un BadRequestException message valide au lieu de 500. #2239
_sort peut amener ChainedSearch à renvoyer des résultats incorrects Auparavant, les options de tri de l’objet SearchOption de la recherche chaînée n’étaient pas effacées, ce qui entraînait la transmission de ces options non valides à la sous-recherche chaînée. Cela pouvait entraîner une absence de résultats alors qu’il en existait. Ce bogue a été corrigé #2347. Cela a résolu le bogue GitHub #2344.

Novembre 2021

Fonctionnalités et améliorations

Améliorations Informations connexes
Traiter les liens Patient-everything Nous avons étendu les fonctionnalités Patient-everything pour traiter les liens des patients #2305. Pour plus d’informations, consultez la documentation Patient-everything dans FHIR.
Ajout du nom et de la version du logiciel à la déclaration de capacité Dans la déclaration de capacité, le nom du logiciel distingue désormais l’utilisation de l’API Azure pour FHIR ou des Services de données de santé Azure. La version du logiciel spécifie désormais quel package de version open source est actif dans le service managé #2294. Corrige : #1778 et #2241
Journal 500s à RequestMetric Auparavant, les erreurs 500 ou inconnues/non prises en charge n’étaient pas consignées dans RequestMetric. Elles sont désormais journalisées #2240. Pour plus d’informations, consultez Activer les paramètres de diagnostic dans l’API Azure pour FHIR
Compression des jetons de continuation Dans certains cas, le jeton de continuation était trop long pour pouvoir suivre le lien suivant dans les recherches et entraînait une erreur 404. Pour résoudre ce problème, nous avons compressé le jeton de continuation pour veiller à ce qu’il reste inférieur à la limite de taille #2279. Corrige le problème #2250.

Correctifs de bogues

Résolution des bogues Informations connexes
Erreur 500 résolue lorsque la date était transmise avec un fuseau horaire. Cela corrige une erreur 500 lorsqu’une date avec un fuseau horaire était transmise dans un champ datetime #2270.
Problème résolu lorsque la publication d’un bundle avec un type de média incorrect renvoyait une erreur 500. Auparavant, lors de la publication d’une recherche avec une clé contenant certains caractères, une erreur 500 était renvoyée. Cela résout ce problème #2264 et le problème #2148.

Octobre 2021

Correctifs de bogues

Bogue de boucle infinie Informations connexes
Résolution du problème où une suppression conditionnelle pouvait entraîner une boucle infinie. #2269

Septembre 2021

Fonctionnalités et améliorations

Améliorations Informations connexes
Ajout de la prise en charge du correctif conditionnel Correctif conditionnel
Correctif conditionnel #2163
Ajout de l’événement d’audit des correctifs conditionnels. #2213
Autorisation du correctif JSON dans les bundles Correctif JSON dans les bundles
Autorise les bundles d’historique de recherche avec les demandes de correctif. #2156
Correctif JSON activé dans les bundles avec des ressources binaires. #2143
Nouveaux sous-types d’événements d’audit Informations connexes
Ajout de nouveaux sous-types d’audit OperationName. #2170
Améliorations apportées à la réindexation Informations connexes
Ajout de limites pour les paramètres de réindexation . #2103
Message d’erreur de mise à jour pour les limites des paramètres de réindexation. #2109
Ajout de la vérification finale du nombre de réindexations. #2099

Correctifs de bogues

Résolution des bogues Informations connexes
Capture plus large des exceptions lors de l’application d’un correctif. #2192
Corrige l’historique avec PATCH dans STU3. #2177
Bogues de recherche personnalisée Informations connexes
Résout l’échec avec les paramètres de recherche personnalisés. #2133
Ajout d’une logique de nouvelle tentative lors de la suppression du paramètre de recherche. #2121
Définissez le nombre maximal d’éléments dans les options de recherche dans SearchParameterDefinitionManager. #2141
Assure une meilleure exception si le paramètre de recherche comprend une expression incorrecte. #2157
Erreur 503 de nouvelle tentative résolue Informations connexes
Erreur 503 de nouvelle tentative dans Azure Cosmos DB. #2106
Corrige le traitement des erreurs 429 de StoreProcedures. #2165
Problèmes GitHub clôturés Informations connexes
Impossible de créer un paramètre de recherche personnalisé pour le périphérique médical CarePlan. #2146
Message d’erreur peu clair pour la création conditionnelle sans ID. #2168

Connecteur IoT pour FHIR (préversion)

Résolution des bogues Informations connexes
Correction d’un lien rompu. Lien mis à jour vers la documentation Azure du connecteur IoT dans le portail Azure API pour FHIR.

Étapes suivantes

Pour plus d’informations sur les fonctionnalités et les correctifs de bogues dans Services de données de santé Azure (service FHIR, service DICOM et service MedTech), consultez

Notes de publication : Services de données de santé Azure

Remarque

FHIR® est une marque déposée de HL7 utilisé avec l’autorisation de HL7.