Eliminazione in blocco
'$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 /$bulkDeleteTipo 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
FHIR® è un marchio registrato di HL7 e viene usato con l'autorizzazione di HL7.