Suppression en bloc

  • Article

« $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.

  • Niveau système : l’exécution de l’opération au niveau du système permet la suppression de ressources FHIR sur tous les types de ressources du serveur FHIR.

      DELETE  /$bulkDelete

  • Type de ressource individuel : l’exécution de l’opération sur des types de ressources individuels permet la suppression du mappage des ressources FHIR au type de ressource spécifié dans l’URL.

      DELETE /<Resource Type>/$bulkDelete

Remarque

La suppression en bloc est une opération à utiliser avec précaution. Les ressources du service FHIR une fois supprimées ne peuvent pas être rétablies.

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

Important

Ces interfaces de programmation d’applications et kits de développement logiciel (SDK) en préversion sont fournis sans contrat au niveau du service. Nous vous recommandons de ne pas les utiliser pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’utilisation supplémentaires relatives aux préversions de Microsoft Azure.

En-têtes

L’opération de suppression en bloc nécessite deux paramètres d’en-tête

  • Accepter : application/fhir+json
  • Préférer : répondre-async

Paramètres de requête

Les paramètres de requête vous permettent de filtrer les ressources brutes que vous envisagez de supprimer. Pour prendre en charge le filtrage, les paramètres de requête de service FHIR sont les suivants :

Paramètre de requête. Valeur par défaut Description
_hardDelete False Pour supprimer la ressource, y compris la version de l’historique, passez la valeur true.
_purgeHistory False Permet de supprimer des versions d’historique associées à la ressource.
Paramètres de recherche pris en charge par le service FHIR Permet de spécifier des critères de recherche et des ressources correspondant aux critères de recherche supprimés. Exemple : address :contains=Meadow subject :Patient.birthdate=1987-02-20

Tous les paramètres de requête sont facultatifs.

$bulk-delete Response

Une fois la demande effectuée pour supprimer en bloc les ressources FHIR, en réponse, vous devez recevoir l’en-tête Content-Location avec l’URL absolue d’un point de terminaison pour les demandes d’état suivantes, comme un point de terminaison d’interrogation.

Point de terminaison d’interrogation : la demande au point de terminaison d’interrogation a l’un des quatre résultats en fonction de l’état du travail de suppression en bloc. Le résultat est fourni dans OperationOutcome de la réponse FHIR

  1. Travaux en cours : ce résultat indique que le travail est en cours. Code d’état 202
  2. Terminé : ce résultat indique que le travail a réussi. À l’achèvement, les informations sur le nombre de ressources supprimées sont fournies au niveau du type de ressource individuel. Code d’état 200
  3. Annulé : ce résultat indique que le travail est annulé par l’utilisateur et fournit des informations sur le nombre de ressources supprimées au niveau du type de ressource individuel. Code d’état 200
  4. Échec : ce résultat indique que le travail a échoué. Le code d’état dépend du type d’échec.

Exemple de demande et de réponse pour déterminer la demande d’état :

{{fhir_url}}/_operations/bulk-delete/<id>

Exemple de réponse de la tâche de suppression terminée.

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "ResourceDeletedCount",
            "part": [
                {
                    "name": "Practitioner",
                    "valueDecimal": 10.0
                },
                {
                    "name": "Specimen",
                    "valueDecimal": 7.0
                },
                {
                    "name": "Device",
                    "valueDecimal": 3.0
                }
            ]
        }
    ]
}

Étapes suivantes

Dans cet article, vous avez appris à supprimer en bloc des ressources dans le service FHIR. Pour plus d’informations sur les fonctionnalités FHIR prises en charge, consultez

Fonctionnalités prises en charge de FHIR

Fonctionnalités de l’API REST FHIR pour le service FHIR Azure Health Data Services

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