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 /$bulkDeletePojedynczy 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
- Zadania w toku: ten wynik wskazuje, że zadanie jest w toku. Kod stanu 202
- 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
- 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
- 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
FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.