Sdílet prostřednictvím

Hromadné odstranění

  • Článek

Příkaz $bulk-delete umožňuje asynchronně odstranit prostředky ze serveru FHIR. Operace hromadného odstranění se dá spustit na úrovni systému nebo pro jednotlivé typy prostředků.

  • Úroveň systému: Provádění operace na úrovni systému umožňuje odstranění prostředků FHIR napříč všemi typy prostředků na serveru FHIR.

      DELETE  /$bulkDelete

  • Jednotlivé typy prostředků: Spuštění operace u jednotlivých typů prostředků umožňuje odstranění prostředků FHIR mapování na zadaný typ prostředku v adrese URL.

      DELETE /<Resource Type>/$bulkDelete

Poznámka:

Hromadné odstranění je operace, která se má používat s opatrností. Prostředky ve službě FHIR po odstranění nelze vrátit zpět.

Operace hromadného odstranění je aktuálně ve verzi Public Preview. Podrobnosti najdete v právní dokumentaci.

Důležité

Rozhraní API a sady SDK verze Preview jsou poskytovány bez smlouvy o úrovni služeb. Doporučujeme je nepoužívat pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview Microsoft Azure.

Hlavičky

Operace hromadného odstranění vyžaduje dva parametry hlavičky.

  • Přijmout: application/fhir+json
  • Preferovat: respond-async

Parametry dotazu

Parametry dotazu umožňují filtrovat nezpracované prostředky, které chcete odstranit. Pro podporu filtrování jsou parametry dotazu služby FHIR následující:

Parametr dotazu Výchozí hodnota Popis
_hardDelete False Pokud chcete odstranit prostředek včetně verze historie, předejte hodnotu true.
_purgeHistory False Umožňuje odstranit verze historie přidružené k prostředku.
Podporované parametry hledání ve službě FHIR Umožňuje zadat kritéria hledání a prostředky odpovídající kritériím hledání se odstraní. Příklad: adresa:contains=Meadow subject:Patient.birthdate=1987-02-20

Všechny parametry dotazu jsou volitelné.

odpověď $bulk odstranění

Po provedení požadavku na hromadné odstranění prostředků FHIR byste v odpovědi měli obdržet hlavičku Content-Location s absolutní adresou URL koncového bodu pro následné žádosti o stav, jako je koncový bod dotazování.

Koncový bod dotazování: Požadavek na koncový bod dotazování má jeden ze čtyř výsledků v závislosti na stavu úlohy hromadného odstranění. Výsledek se poskytuje v rámci operace OperationOutcome odpovědi FHIR.

  1. Probíhající úlohy: Tento výsledek uvádí, že úloha probíhá. Stavový kód 202
  2. Dokončeno: Tento výsledek uvádí, že úloha byla úspěšně dokončena. Po dokončení by se informace o počtu odstraněných prostředků zobrazily na úrovni jednotlivých typů prostředků. Stavový kód 200
  3. Zrušeno: Úloha stavu tohoto výsledku je zrušena uživatelem a poskytuje informace o počtu prostředků odstraněných na úrovni jednotlivých typů prostředků. Stavový kód 200
  4. Nezdařilo se: Tento výsledek uvádí, že úloha selhala. Stavový kód závisí na typu selhání.

Ukázkový požadavek a odpověď pro určení žádosti o stav:

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

Ukázková odpověď úspěšně dokončené úlohy odstranění

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

Další kroky

V tomto článku jste se dozvěděli, jak hromadně odstranit prostředky ve službě FHIR. Informace o podporovaných funkcích FHIR najdete v tématu

Podporované funkce FHIR

Funkce rozhraní REST API FHIR pro službu Azure Health Data Services FHIR

FHIR® je registrovaná ochranná známka HL7 a používá se s povolením HL7.