Eliminazione in blocco

Articolo
10/26/2023

'$bulk-delete' consente di eliminare le risorse dal server FHIR in modo asincrono. L'operazione di eliminazione bulk può essere eseguita a livello di sistema o per un singolo tipo di risorsa.

Livello di sistema: l'esecuzione dell'operazione a livello di sistema consente l'eliminazione delle risorse FHIR in tutti i tipi di risorse nel server FHIR.
```
  DELETE  /$bulkDelete
```
Tipo di risorsa individuale: l'esecuzione dell'operazione in singoli tipi di risorse consente l'eliminazione del mapping delle risorse FHIR al tipo di risorsa specificato nell'URL.
```
  DELETE /<Resource Type>/$bulkDelete
```

Nota

L'eliminazione bulk è un'operazione da usare con cautela. Le risorse nel servizio FHIR dopo l'eliminazione non possono essere ripristinate.

L'operazione di eliminazione bulk è attualmente in anteprima pubblica. Per informazioni dettagliate, vedere la dichiarazione di non responsabilità.

Importante

Le API di anteprima e gli SDK vengono forniti senza un contratto di servizio. È consigliabile non usarli per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero avere funzionalità limitate. Per altre informazioni, vedere Condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure.

Intestazioni

L'operazione di eliminazione bulk richiede due parametri di intestazione

Accetta: application/fhir+json
Preferenza: respond-async

Parametri della query

I parametri di query consentono di filtrare le risorse non elaborate che si intende eliminare. Per supportare il filtro, i parametri di query del servizio FHIR sono:

Query parameter (Parametro di query)	Valore predefinito	Descrizione
_hardDelete	False	Per l'eliminazione della risorsa, inclusa la versione della cronologia, passare il valore true.
_purgeHistory	False	Consente di eliminare le versioni della cronologia associate alla risorsa.
Parametri di ricerca supportati dal servizio FHIR		Consente di specificare i criteri di ricerca e le risorse corrispondenti ai criteri di ricerca vengono eliminati. Esempio: address:contains=Meadow subject:Patient.birthdate=1987-02-20

Tutti i parametri di query sono facoltativi.

risposta $bulk-delete

Dopo aver effettuato una richiesta per eliminare in blocco le risorse FHIR, in risposta si dovrebbe ricevere l'intestazione Content-Location con l'URL assoluto di un endpoint per le richieste di stato successive, ad esempio un endpoint di polling.

Endpoint di polling: la richiesta all'endpoint di polling ha uno dei quattro risultati a seconda dello stato del processo di eliminazione in blocco. Il risultato viene fornito all'interno di OperationOutcome della risposta FHIR

Processi in corso: questo risultato indica che il processo è in corso. Codice di stato 202
Completato: questo risultato indica che il processo è stato completato correttamente. Al termine, le informazioni sul numero di risorse eliminate verrebbero fornite a livello di singolo tipo di risorsa. Codice di stato 200
Annullata: questo risultato indica che il processo viene annullato dall'utente e fornisce informazioni sul numero di risorse eliminate a livello di singolo tipo di risorsa. Codice di stato 200
Operazione non riuscita: il processo di risultato non è riuscito. Il codice di stato dipende dal tipo di errore.

Richiesta e risposta di esempio per determinare lo stato Richiesta:

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

Risposta di esempio del processo di eliminazione completato correttamente.

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

Passaggi successivi

In questo articolo si è appreso come eliminare in blocco le risorse nel servizio FHIR. Per informazioni sulle funzionalità FHIR supportate, vedere

Funzionalità FHIR supportate

Funzionalità dell'API REST FHIR per il servizio FHIR di Health Data Services

FHIR® è un marchio registrato di HL7 e viene usato con l'autorizzazione di HL7.

Condividi tramite