Gestione dei criteri di controllo delle versioni e della cronologia

I criteri di controllo delle versioni nel servizio FHIR di Azure Health Data Services sono una configurazione, che determina la modalità di archiviazione della cronologia per ogni tipo di risorsa con l'opzione per la configurazione specifica della risorsa. Questo criterio è direttamente correlato al concetto di gestione della cronologia per le risorse FHIR.

Cronologia in FHIR

La cronologia in FHIR consente di visualizzare tutte le versioni precedenti di una risorsa. La cronologia in FHIR può essere eseguita una query a livello di risorsa, livello di tipo o livello di sistema. La documentazione di HL7 FHIR contiene altre informazioni sull'interazione con la cronologia. La cronologia è utile negli scenari in cui si vuole visualizzare l'evoluzione di una risorsa in FHIR o se si desidera visualizzare le informazioni di una risorsa in un momento specifico.

Tutte le versioni precedenti di una risorsa vengono considerate obsolete e la versione corrente di una risorsa deve essere usata per le normali operazioni del flusso di lavoro aziendale. Tuttavia, può essere utile vedere lo stato di una risorsa come un punto nel momento in cui è stata presa una decisione precedente.

Criteri di controllo delle versioni

I criteri di controllo delle versioni nel servizio FHIR consentono di decidere in che modo la cronologia viene archiviata a livello di servizio FHIR o a un livello di risorsa specifico.

Esistono tre livelli diversi per i criteri di controllo delle versioni:

• versioned: la cronologia viene archiviata per l'operazione sulle risorse. La versione della risorsa viene incrementata. Questo è il valore predefinito.
• version-update: la cronologia viene archiviata per l'operazione sulle risorse. La versione della risorsa viene incrementata. Aggiornamenti richiedere un'intestazione validaIf-Match. Per altre informazioni, vedere VersionedUpdateExample.http.
• no-version: la cronologia non viene creata per le risorse. La versione della risorsa viene incrementata.

Criteri di controllo delle versioni disponibili per configurare come impostazione a livello di sistema e anche per eseguire l'override a livello di risorsa. L'impostazione a livello di sistema viene usata per tutte le risorse nel servizio FHIR, a meno che non sia stato aggiunto un criterio di controllo delle versioni a livello di risorsa specifico.

Confronto dei criteri di controllo delle versioni

Valore dei criteri	Comportamento della cronologia	meta.versionId Comportamento di aggiornamento	Predefinito
versioned	La cronologia viene archiviata	If-Match non obbligatorio	Sì
version-update	La cronologia viene archiviata	If-Match obbligatorio	No
no-version	La cronologia non viene archiviata	If-Match non obbligatorio	No

Nota

La modifica dei criteri di controllo delle versioni in modo che no-version non abbia effetto sulla cronologia delle risorse esistente. Se la cronologia deve essere rimossa per le risorse, usare l'operazione $purge cronologia .

Configurazione dei criteri di controllo delle versioni

Per configurare i criteri di controllo delle versioni, selezionare il pannello Configurazione criteri di versione all'interno del servizio FHIR.

Dopo aver esplorato la configurazione dei criteri di controllo delle versioni, sarà possibile configurare l'impostazione a livello di sistema e a livello di risorsa (come override del livello di sistema). La configurazione a livello di sistema (annotata come 1) verrà applicata a ogni risorsa nel servizio FHIR, a meno che non sia stata configurata un'override specifica della risorsa (annotata a 2).

Quando si configura la configurazione a livello di risorsa, sarà possibile selezionare il tipo di risorsa FHIR (annotato come 1) e il criterio di controllo delle versioni specifico per questa risorsa specifica (annotata come 2). Assicurarsi di selezionare il pulsante Aggiungi (annotato come 3) per accodare questa impostazione per il salvataggio.

Assicurarsi di selezionare Salva dopo aver completato la configurazione dei criteri di controllo delle versioni.

Gestione cronologia

La cronologia in FHIR è importante per gli utenti finali per vedere come una risorsa è cambiata nel tempo. È utile anche in coordinamento con i log di controllo per visualizzare lo stato di una risorsa prima e dopo la modifica di un utente. In generale, è consigliabile mantenere la cronologia per una risorsa a meno che non si sappia che la cronologia non è necessaria. Gli aggiornamenti frequenti delle risorse possono comportare una grande quantità di archiviazione dati, che può essere indesiderata nei servizi FHIR con una grande quantità di dati.

La modifica dei criteri di controllo delle versioni a livello di sistema o a livello di risorsa non rimuoverà la cronologia esistente per le risorse nel servizio FHIR. Se si vuole ridurre le dimensioni dei dati della cronologia nel servizio FHIR, è necessario usare l'operazione di $purge cronologia .

Passaggi successivi

In questo articolo si è appreso come eliminare la cronologia per le risorse nel servizio FHIR. Per altre informazioni su come disabilitare la cronologia e alcuni concetti sulla gestione della cronologia, vedere

Operazione di eliminazione della cronologia

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