Administración de historial y directivas de control de versiones
La directiva de control de versiones del servicio FHIR de Azure Health Data Services es una configuración, que determina cómo se almacena el historial para cada tipo de recurso con la opción de configuración específica del recurso. Esta directiva está directamente relacionada con el concepto de administrar el historial de los recursos de FHIR.
Historial en FHIR
El historial de FHIR ofrece la posibilidad de ver todas las versiones anteriores de un recurso. El historial de FHIR se puede consultar en el nivel de recurso, el nivel de tipo o el nivel del sistema. La documentación de HL7 FHIR tiene más información sobre la interacción del historial. El historial es útil en escenarios en los que desea ver la evolución de un recurso en FHIR o si desea ver la información de un recurso en un momento dado.
Todas las versiones anteriores de un recurso se consideran obsoletas y la versión actual de un recurso se debe usar para las operaciones normales de flujo de trabajo empresarial. Sin embargo, puede ser útil ver el estado de un recurso como un momento dado cuando se tomó una decisión pasada.
Directiva de control de versiones
La directiva de control de versiones en el servicio FHIR le permite decidir cómo se almacena el historial en un nivel de servicio de FHIR o en un nivel de recurso específico.
Hay tres niveles diferentes para la directiva de control de versiones:
versioned: el historial se almacena para la operación en los recursos. La versión del recurso se incrementa. Este es el valor predeterminado.version-update: el historial se almacena para la operación en los recursos. La versión del recurso se incrementa. Novedades requerir un encabezado válidoIf-Match. Para obtener más información, vea VersionedUpdateExample.http.no-version: el historial no se crea para los recursos. La versión del recurso se incrementa.
Directiva de control de versiones disponible para configurar en como una configuración de todo el sistema y también para invalidar en un nivel de recurso. La configuración de todo el sistema se usa para todos los recursos del servicio FHIR, a menos que se haya agregado una directiva de control de versiones de nivel de recurso específica.
Comparación de directivas de control de versiones
| Valor de directiva | Comportamiento del historial | meta.versionId Comportamiento de actualización |
Valor predeterminado |
|---|---|---|---|
versioned |
El historial se almacena | If-Match no es necesario | Sí |
version-update |
El historial se almacena | If-Match obligatorio | No |
no-version |
El historial no se almacena | If-Match no es necesario | No |
Nota
Cambiar la directiva de control de versiones a no-version no tiene ningún efecto en el historial de recursos existente. Si el historial debe quitarse para los recursos, use la operación $purge-history .
Configuración de la directiva de control de versiones
Para configurar la directiva de control de versiones, seleccione la hoja Configuración de directivas de control de versiones dentro del servicio FHIR.
Después de examinar la configuración de la directiva de control de versiones, podrá configurar la configuración tanto en el nivel de sistema como en el nivel de recurso (como una invalidación del nivel de sistema). La configuración de nivel de sistema (anotada como 1) se aplicará a todos los recursos del servicio FHIR a menos que se haya configurado una invalidación específica del recurso (anotada en 2).
Al configurar la configuración de nivel de recurso, podrá seleccionar el tipo de recurso FHIR (anotado como 1) y la directiva de control de versiones específica para este recurso específico (anotado como 2). Asegúrese de seleccionar el botón Agregar (anotado como 3) para poner en cola esta configuración para guardarla.
Asegúrese de seleccionar Guardar después de completar la configuración de la directiva de control de versiones.
Administración del historial
El historial de FHIR es importante para que los usuarios finales vean cómo ha cambiado un recurso con el tiempo. También es útil en coordinación con los registros de auditoría ver el estado de un recurso antes y después de que un usuario lo haya modificado. En general, se recomienda mantener el historial de un recurso a menos que sepa que el historial no es necesario. Las actualizaciones frecuentes de recursos pueden dar lugar a una gran cantidad de almacenamiento de datos, lo que puede no ser deseado en los servicios de FHIR con una gran cantidad de datos.
Cambiar la directiva de control de versiones en un nivel de sistema o en el nivel de recurso no quitará el historial existente de los recursos del servicio FHIR. Si desea reducir el tamaño de los datos del historial en el servicio FHIR, debe usar la operación de historial de $purge .
Pasos siguientes
En este artículo, ha aprendido a purgar el historial de los recursos del servicio FHIR. Para obtener más información sobre cómo deshabilitar el historial y algunos conceptos sobre la administración del historial, consulte
FHIR® es una marca registrada de HL7 y se usa con su permiso.