Gestion de la stratégie de contrôle de version et de l’historique

La stratégie de contrôle de version dans le service FHIR Azure Health Data Services est une configuration qui détermine comment l’historique est stocké pour chaque type de ressource avec l’option pour la configuration spécifique à la ressource. Cette stratégie est directement liée au concept de gestion de l’historique des ressources FHIR.

Historique dans FHIR

L’historique dans FHIR vous permet de voir toutes les versions précédentes d’une ressource. L’historique dans FHIR peut être interrogé au niveau de la ressource, du type ou du système. La documentation HL7 FHIR contient plus d’informations sur l’interaction de l’historique. L’historique est utile dans les scénarios où vous souhaitez voir l’évolution d’une ressource dans FHIR ou si vous souhaitez voir les informations d’une ressource à un moment spécifique dans le temps.

Toutes les versions antérieures d’une ressource sont considérées comme obsolètes et la version actuelle d’une ressource doit être utilisée pour les opérations de flux de travail métier normales. Toutefois, il peut être utile de voir l’état d’une ressource comme un point dans le temps où une décision passée a été prise.

Stratégie de version

La stratégie de contrôle de version dans le service FHIR vous permet de décider de la façon dont l’historique est stocké au niveau d’un service FHIR ou à un niveau de ressource spécifique.

Il existe trois niveaux différents pour la stratégie de contrôle de version :

• versioned: l’historique est stocké pour l’opération sur les ressources. La version de la ressource est incrémentée. Il s’agit de la valeur par défaut.
• version-update: l’historique est stocké pour l’opération sur les ressources. La version de la ressource est incrémentée. Mises à jour nécessitent un en-tête valideIf-Match. Pour plus d’informations, consultez VersionedUpdateExample.http.
• no-version: l’historique n’est pas créé pour les ressources. La version de la ressource est incrémentée.

Stratégie de contrôle de version disponible pour la configuration de en tant que paramètre à l’échelle du système et également pour remplacer au niveau de la ressource. Le paramètre à l’échelle du système est utilisé pour toutes les ressources de votre service FHIR, sauf si une stratégie de contrôle de version au niveau des ressources spécifique a été ajoutée.

Comparaison des stratégies de contrôle de version

Valeur de stratégie	Comportement de l’historique	meta.versionId Comportement de mise à jour	Default
versioned	L’historique est stocké	If-Match pas obligatoire	Oui
version-update	L’historique est stocké	If-Match obligatoire	Non
no-version	L’historique n’est pas stocké	If-Match pas obligatoire	Non

Notes

La modification de la stratégie de contrôle de version par n’a no-version aucun effet sur l’historique des ressources existantes. Si l’historique doit être supprimé pour les ressources, utilisez l’opération $purge-history .

Configuration de la stratégie de contrôle de version

Pour configurer la stratégie de contrôle de version, sélectionnez le panneau Configuration de la stratégie de contrôle de version dans votre service FHIR.

Une fois que vous avez parcouru la configuration de la stratégie de contrôle de version, vous pouvez configurer le paramètre au niveau du système et au niveau de la ressource (en remplacement du niveau système). La configuration au niveau du système (annotée sous la forme 1) s’applique à chaque ressource de votre service FHIR, sauf si un remplacement spécifique à la ressource (annoté à 2) a été configuré.

Lors de la configuration de la configuration au niveau de la ressource, vous pouvez sélectionner le type de ressource FHIR (annoté sous la forme 1) et la stratégie de contrôle de version spécifique pour cette ressource spécifique (annotée sous la forme 2). Veillez à sélectionner le bouton Ajouter (annoté sous la forme 3) pour mettre en file d’attente ce paramètre en vue de l’enregistrement.

Veillez à sélectionner Enregistrer une fois que vous avez terminé la configuration de votre stratégie de contrôle de version.

Gestion de l’historique

L’historique dans FHIR est important pour que les utilisateurs finaux puissent voir comment une ressource a changé au fil du temps. Il est également utile, en coordination avec les journaux d’audit, de voir l’état d’une ressource avant et après qu’un utilisateur l’a modifiée. En général, il est recommandé de conserver l’historique d’une ressource, sauf si vous savez que l’historique n’est pas nécessaire. Les mises à jour fréquentes des ressources peuvent entraîner une grande quantité de stockage de données, ce qui peut être indésirable dans les services FHIR avec une grande quantité de données.

La modification de la stratégie de contrôle de version au niveau du système ou de la ressource ne supprime pas l’historique existant pour les ressources de votre service FHIR. Si vous souhaitez réduire la taille des données d’historique dans votre service FHIR, vous devez utiliser l’opération d’historique $purge .

Étapes suivantes

Dans cet article, vous avez appris à vider l’historique des ressources dans le service FHIR. Pour plus d’informations sur la désactivation de l’historique et sur certains concepts relatifs à la gestion de l’historique, consultez

Opération d’historique de vidage

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