fhir component

The fhir component allows for custom FHIR-based interfaces to benefit from all features that are available to FHIR-based IHE transactions, e.g. ATNA auditing. This is particularly valuable if you already use IHE transaction components but you need additional interfaces for which there is no defined IHE profile.


There is no mapping to a particular actor.


In a Maven-based environment, the following dependency must be registered in pom.xml:


Endpoint URI Format


The endpoint URI format of fhir component producers is:


where hostname is either an IP address or a domain name, port is a number, and path/to/service represents additional path elements of the remote service.


The endpoint URI format of fhir component consumers is:


The resulting URL of the exposed FHIR REST Service endpoint depends on the configuration of the deployment container. Consider a Tomcat container on host eHealth.server.org is configured in the following way:

port = 8888
contextPath = /IHE
servletPath = /fhir/*

Then the fhir consumer will be available for external clients under the URL http://eHealth.server.org:8888/IHE/fhir.

URI parameters controlling the transaction features are described below.


This is an example on how to use the component on the consumer side:

      // process the incoming request and create a response

Explicitly configured fhir component instances

As the fhirTransactionConfig is a property of the component and not of the endpoint, you cannot use two fhir endpoints with different fhirTransactionConfig parameters. Instead, you need to create separate component beans and refer to them by their scheme ID.

In the following example, we define two component instances as fhir1 and fhir2, configured with their distinct fhirTransactionConfig :

    <bean id="fhir1" class="org.openehealth.ipf.platform.camel.ihe.fhir.core.custom.CustomFhirComponent">
        <property name="fhirTransactionConfiguration" ref="fhirTransactionConfig1"/>

    <bean id="fhir2" class="org.openehealth.ipf.platform.camel.ihe.fhir.core.custom.CustomFhirComponent">
        <property name="fhirTransactionConfiguration" ref="fhirTransactionConfig2"/>

In the route definition, they can be used like this:

      // process the incoming request and create a response

      // process the incoming request and create a response

Basic Common Component Features

FHIR Component Features