Usuwanie zbiorcze

Polecenie "$bulk-delete" umożliwia asynchroniczne usuwanie zasobów z serwera FHIR. Operację usuwania zbiorczego można wykonać na poziomie systemu lub dla pojedynczego typu zasobu.

• Poziom systemu: Wykonanie operacji na poziomie systemu umożliwia usunięcie zasobów FHIR we wszystkich typach zasobów na serwerze FHIR.

    DELETE  /$bulkDelete
  

• Pojedynczy typ zasobu: wykonanie operacji w poszczególnych typach zasobów umożliwia usunięcie mapowania zasobów FHIR na określony typ zasobu w adresie URL.

    DELETE /<Resource Type>/$bulkDelete
  

Uwaga

Usuwanie zbiorcze to operacja, która ma być używana z ostrożnością. Nie można przywrócić zasobów w usłudze FHIR po usunięciu.

Operacja usuwania zbiorczego jest obecnie dostępna w publicznej wersji zapoznawczej. Przejrzyj zastrzeżenie, aby uzyskać szczegółowe informacje.

Ważne

Interfejsy API i zestawy SDK w wersji zapoznawczej są udostępniane bez umowy dotyczącej poziomu usług. Zalecamy, aby nie używać ich w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zapoznaj się z dodatkowymi warunkami użytkowania dla wersji zapoznawczych platformy Microsoft Azure.

Nagłówki

Operacja zbiorczego usuwania wymaga dwóch parametrów nagłówka

• Akceptuj: application/fhir+json
• Preferuj: respond-async

Parametry zapytań

Parametry zapytania umożliwiają filtrowanie nieprzetworzonych zasobów, które mają zostać usunięte. Aby obsługiwać filtrowanie, parametry zapytania usługi FHIR są następujące:

Parametr zapytania	Wartość domyślna	opis
_hardDelete	Fałsz	Aby usunąć zasób, w tym wersję historii, przekaż wartość true.
_purgeHistory	Fałsz	Umożliwia usuwanie wersji historii skojarzonych z zasobem.
Obsługiwane parametry wyszukiwania w usłudze FHIR		Umożliwia określenie kryteriów wyszukiwania i zasobów pasujących do kryteriów wyszukiwania. Przykład: address:contains=Meadow subject:Patient.birthdate=1987-02-20

Wszystkie parametry zapytania są opcjonalne.

$bulk usuń odpowiedź

Po wysłaniu żądania zbiorczego usunięcia zasobów FHIR w odpowiedzi powinien zostać wyświetlony nagłówek Content-Location z bezwzględnym adresem URL punktu końcowego dla kolejnych żądań stanu, takich jak punkt końcowy sondowania.

Punkt końcowy sondowania: żądanie sondowania punktu końcowego ma jeden z czterech wyników w zależności od stanu zadania usuwania zbiorczego. Wynik jest dostarczany w ramach operacjiOutcome odpowiedzi FHIR

1. Zadania w toku: ten wynik wskazuje, że zadanie jest w toku. Kod stanu 202
2. Ukończono: ten wynik wskazuje, że zadanie zostało ukończone pomyślnie. Po zakończeniu informacje o liczbie usuniętych zasobów będą udostępniane na poziomie pojedynczego typu zasobu. Kod stanu 200
3. Anulowano: to zadanie oznacza, że zadanie wyniku jest anulowane przez użytkownika i zawiera informacje o liczbie zasobów usuniętych na poziomie pojedynczego typu zasobu. Kod stanu 200
4. Niepowodzenie: to zadanie stanu wyniku nie powiodło się. Kod stanu zależy od typu błędu.

Przykładowe żądanie i odpowiedź na żądanie stanu:

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

Przykładowa odpowiedź pomyślnego zakończenia zadania usuwania.

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

Następne kroki

W tym artykule przedstawiono sposób zbiorczego usuwania zasobów w usłudze FHIR. Aby uzyskać informacje o obsługiwanych funkcjach FHIR, zobacz

Obsługiwane funkcje FHIR

Możliwości interfejsu API REST FHIR dla usługi Azure Health Data Services FHIR

FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.