Delen via


Bulk verwijderen

Met '$bulk-delete' kunt u resources asynchroon van de FHIR-server verwijderen. Bulksgewijs verwijderen kan worden uitgevoerd op systeemniveau of voor afzonderlijk resourcetype.

  • Systeemniveau: Uitvoering van de bewerking op systeemniveau maakt het verwijderen van FHIR-resources mogelijk voor alle resourcetypen in de FHIR-server.

      DELETE  /$bulkDelete
    
  • Afzonderlijk resourcetype: Uitvoering van de bewerking op afzonderlijke resourcetypen maakt het mogelijk om FHIR-resources te verwijderen naar het opgegeven resourcetype in de URL.

      DELETE /<Resource Type>/$bulkDelete
    

Notitie

Bulksgewijs verwijderen is een bewerking die met voorzichtigheid moet worden gebruikt. Resources in de FHIR-service nadat deze zijn verwijderd, kunnen niet meer worden teruggezet.

Bewerking voor bulksgewijs verwijderen is momenteel beschikbaar als openbare preview. Bekijk de disclaimer voor meer informatie.

Belangrijk

Preview-API's en SDK's worden aangeboden zonder een service level agreement. U wordt aangeraden deze niet te gebruiken voor productieworkloads. Sommige functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Raadpleeg aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.

Headers

Voor bulksgewijs verwijderen zijn twee headerparameters vereist

  • Accepteren: application/fhir+json
  • Voorkeur: respond-async

Queryparameters

Met queryparameters kunt u onbewerkte resources filteren die u wilt verwijderen. Ter ondersteuning van filteren zijn queryparameters van de FHIR-service:

Queryparameter Standaardwaarde Omschrijving
_hardDelete Onwaar Als u de resource wilt verwijderen, inclusief de geschiedenisversie, geeft u de waarde waar door.
_purgeHistory Onwaar Hiermee kunt u geschiedenisversies verwijderen die aan de resource zijn gekoppeld.
FHIR-service ondersteunde zoekparameters Hiermee kunt u zoekcriteria en resources opgeven die overeenkomen met de zoekcriteria, worden verwijderd. Voorbeeld: adres:contains=Weideonderwerp:Patient.birthdate=1987-02-20

Alle queryparameters zijn optioneel.

Antwoord $bulk verwijderen

Nadat de aanvraag is gedaan om FHIR-resources bulksgewijs te verwijderen, ontvangt u als antwoord de header Content-Location met de absolute URL van een eindpunt voor volgende statusaanvragen, zoals een polling-eindpunt.

Polling-eindpunt: aanvragen voor polling-eindpunten hebben een van de vier resultaten, afhankelijk van de status van de taak voor bulksgewijs verwijderen. Het resultaat wordt opgegeven in OperationOutcome van het FHIR-antwoord

  1. Taken die worden uitgevoerd: met dit resultaat wordt aangegeven dat de taak wordt uitgevoerd. Statuscode 202
  2. Voltooid: Met dit resultaat wordt aangegeven dat de taak is voltooid. Bij voltooiing zou de informatie over het aantal verwijderde resources worden opgegeven op het niveau van het afzonderlijke resourcetype. Statuscode 200
  3. Geannuleerd: met dit resultaat wordt de taak geannuleerd door de gebruiker en wordt informatie weergegeven over het aantal resources dat op het niveau van het afzonderlijke resourcetype wordt verwijderd. Statuscode 200
  4. Mislukt: dit resultaat geeft aan dat de taak is mislukt. Statuscode is afhankelijk van het fouttype.

Voorbeeldaanvraag en antwoord voor het bepalen van de statusaanvraag:

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

Voorbeeldantwoord van voltooide verwijdertaak.

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

Volgende stappen

In dit artikel hebt u geleerd hoe u resources bulksgewijs verwijdert in de FHIR-service. Zie voor meer informatie over ondersteunde FHIR-functies

FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.