IBM FHIR Server 4.7.1

This version of the IBM FHIR Server supports HL7 FHIR Specification version v4.0.1.

This release introduces support for integration with external terminology servers, fixes caching-related issues in terminology support, and adds support for skipping unnecessary update interactions.

Added

• Support client opt-in for skipping the update if a resource hasn't changed
  • Clients can now pass the header X-FHIR-UPDATE-IF-MODIFIED with a value of true to ask the server to skip the update when the proposed resource matches the existing resource.
• Remote terminology service provider using a REST client
• Support opt-in to warnings when search parameters are ignored

Changed

• AuthzPolicyEnforcement changes
  • The compartment-based authorization decision will now match our compartment-based search behavior, meaning that inclusion criteria with a versioned reference or absolute reference that matches the base server url will now be considered to be in the referenced compartment.
• Optionally reject references without explicit resource type
  • This tightens the validation of relative literal references to flag a common error we've seen. Set the existing fhirServer/core/checkReferenceTypes property to false to opt out of this enhanced validation.
• Ensure all OperationDefinition resources are pulled from FHIRRegistry for specification-defined operations

Fixed

• opd-0 warnings during startup
• Global caches in CodeSystemSupport and ValueSetSupport should be tenant-specific
• ServerRegistryResourceProvider cache invalidation is problematic in multi-server environments
• Failure acquiring local host IP address results in 400 errors but should be 500s
• $apply operation error when specifying practitioner
• fhir-provider tries to use httpHeaders and uriInfo in client mode
  • This change enables the fhir-provider to be used as a generic JAX-RS provider for FHIR resources.

Migration Considerations

To migrate from a prior version of the IBM FHIR Server to version 4.7.1:

1. Analyze configuration changes and prepare for the upgrade
   • This release adds support for configuring multiple graphTermServiceProviders. The fhirServer/term/remoteTermServiceProvider property is now fhirServer/term/remoteTermServiceProviders and it is now an array of objects instead of a single object.
   • This release introduces numerous properties under fhirServer/term/remoteTermServiceProviders. See the Terminology guide for more information.
2. Deploy the new server.

If upgrading from a version prior to 4.7.0, be sure to review the applicable migration considerations:

• 4.7.0 migration considerations

Using the Release

Run or extend the Docker image from https://hub.docker.com/r/ibmcom/ibm-fhir-server or download fhir-server-distribution.zip and install as described at https://ibm.github.io/FHIR/guides/FHIRServerUsersGuide.

Executable jar files for the fhir-persistence-schema, fhir-swagger-generator, fhir-bucket, and fhir-path projects are also available:

• fhir-persistence-schema-4.7.1-cli.jar
• fhir-swagger-generator-4.7.1-cli.jar
• fhir-bucket-4.7.1-cli.jar
• fhir-path-4.7.1-cli.jar

Usage is documented in the corresponding README files:

• https://github.com/IBM/FHIR/tree/master/fhir-persistence-schema
• https://github.com/IBM/FHIR/tree/master/fhir-swagger-generator
• https://github.com/IBM/FHIR/tree/master/fhir-bucket
• https://github.com/IBM/FHIR/tree/master/fhir-path

For Maven users, all project binaries are posted to Maven Central with a version of 4.7.1.