Contenido normativo de FHIR y compatibilidad de versiones
Guía para la implementación de FHIR de manera compatible con el futuro, con énfasis en el comportamiento estable (normativo) y evitando romper los cambios.
Contenido normativo y no normativo
FHIR contiene una mezcla de contenido normativo (estable) y no normativo (evolutivo). Cuando el contenido se declara completamente normativo, las publicaciones posteriores no deben introducir cambios que rompan ese comportamiento normativo.
- Normativo: no se esperan cambios de ruptura; los cambios deben ser aditivos o aclaratorios.
- No normativo (uso de prueba/informativo): los cambios de ruptura se pueden producir en todas las versiones.
Guía de compatibilidad de reenvíos para clientes
Para minimizar las interrupciones cuando los servidores evolucionan, implemente clientes a la defensiva:
- Ignorar elementos desconocidos en JSON en lugar de fallar el análisis (análisis compatible con reenvío).
- Evite las suposiciones de codificación fija sobre la unidad de respuesta más allá del estándar FHIR (por ejemplo, no es necesario que haya elementos opcionales).
- Validación tolerante preferente para áreas no normativas; reserve una validación estricta para los campos necesarios y las restricciones aplicadas por el servidor.
- Seguir reglas de negociación de contenido: defina
AcceptyContent-Typeen codificaciones soportadas para este servidor (consulte las páginas de recursos).
Expectativas de compatibilidad entre versiones
- Al utilizar los puntos finales de FHIR R4, espere estabilidad para las interacciones y los patrones que son normativos en el estándar R4.
- Cuando se utilizan puntos finales de FHIR R6, el servidor puede exponer recursos y parámetros de búsqueda más recientes alineados con R6.
- En todas las versiones, se esperan diferencias (por ejemplo, modelos de recursos, operaciones soportadas y parámetros de búsqueda). Diseñar clientes para manejar el comportamiento específico de la versión.
Flujo de trabajo recomendado para integraciones
Utilice la sentencia de capacidad (metadatos del servidor) para confirmar lo que soporta un despliegue antes de integrar:
- Verifique las interacciones y los tipos de recursos soportados (lectura/búsqueda/creación/actualización/supresión/lectura).
- Verifique las operaciones admitidas (por ejemplo, las operaciones de depuración administrativa).
- Verifique los formatos admitidos y las limitaciones específicas del despliegue.