Skip to content

FHIR Connector Reference

The FHIR Connector allows you to work with resources in FHIR, which are the modular components of FHIR. The connector uses the FHIR RESTFul API to interact with FHIR.

Initializing the connector

Before you start performing various operations with the connector, make sure to import the FHIR certificate to your ESB client keystore.

To use the FHIR connector, add the element in your configuration before carrying out any other FHIR operations.

For more information on authentication/security of the FHIR REST API, see http://www.hl7.org/implement/standards/fhir/security.html.

fhir.init

The fhir.init operation initializes the connector to interact with the FHIR REST API.

Parameter Name Description Required
base The service root URL. Yes.

Sample configurations

<fhir.init>
    <base>{$ctx:base}</base>
<fhir.init>

Conformance

getConformance

The conformance interaction retrieves the server's conformance statement that defines how it supports resources. The conformance interaction retrieves the server's conformance statement that defines how it supports resources, For that use fhir.getConformance and specify the following properties. For more information, see FHIR API documentation.

Parameter Name Description Required
base The service root URL. Yes.
format The Mime Type. Yes.
id, content, lastUpdated, profile, query, security, tag, text, filter These are the optional parameters and are common search parameters for all resources. Optional.

Sample configurations

<fhir.getConformance>
    <base>{$ctx:base}</base>
    <format>{$ctx:format}</format>
    <id>{$ctx:id}</id>
    <content>{$ctx:content}</content>
    <lastUpdated>{$ctx:lastUpdated}</lastUpdated>
    <profile>{$ctx:profile}</profile>
    <query>{$ctx:query}</query>
    <security>{$ctx:security}</security>
    <tag>{$ctx:tag}</tag>
    <text>{$ctx:text}</text>
    <filter>{$ctx:filter}</filter>
</fhir.getConformance>

Sample request

{
    "base": "https://open-api.fhir.me",
    "format": "json",
    "id":"%s(id)",
    "content":"%s(content)",
    "lastUpdated":"%s(lastUpdated)",
    "profile":"%s(profile)",
    "query":"%s(query)",
    "security":"%s(security)",
    "tag":"%s(tag)",
    "text":"%s(text)",
    "filter":"%s(filter)"
}

History

history

To retrieves the history of a particular resource supported by the system , use fhir.history and specify the following properties. For more information, see related FHIR API documentation.

Parameter Name Description Required
base The service root URL. Yes.
type The name of a resource type (e.g., "Patient"). Yes.
idForHistory The id of the history that needs to be retrieved. Yes.
format The Mime Type. Yes.
id, content, lastUpdated, profile, query, security, tag, text, filter These are the optional parameters and are common search parameters for all resources. Optional.

Sample configurations

<fhir.history>
    <base>{$ctx:base}</base>
    <type>{$ctx:type}</type>
    <idForHistory>{$ctx:idForHistory}</idForHistory>
    <format>{$ctx:format}</format>
    <id>{$ctx:id}</id>
    <content>{$ctx:content}</content>
    <lastUpdated>{$ctx:lastUpdated}</lastUpdated>
    <profile>{$ctx:profile}</profile>
    <query>{$ctx:query}</query>
    <security>{$ctx:security}</security>
    <tag>{$ctx:tag}</tag>
    <text>{$ctx:text}</text>
    <filter>{$ctx:filter}</filter>
</fhir.history>

Sample request

{
    "base": "https://open-api.fhir.me",
    "type": "Patient",
    "idForHistory":1032702",
    "format": "json",
    "id":"%s(id)",
    "content":"%s(content)",
    "lastUpdated":"%s(lastUpdated)",
    "profile":"%s(profile)",
    "query":"%s(query)",
    "security":"%s(security)",
    "tag":"%s(tag)",
    "text":"%s(text)",
    "filter":"%s(filter)"
}
historyAll

To retrieves the history of all resources supported by the system , use fhir.historyAll and specify the following properties. For more information, see related FHIR API documentation.

Parameter Name Description Required
base The service root URL. Yes.
format The Mime Type. Yes.
id, content, lastUpdated, profile, query, security, tag, text, filter These are the optional parameters and are common search parameters for all resources. Optional.

Sample configurations

<fhir.historyAll>
    <base>{$ctx:base}</base>
    <format>{$ctx:format}</format>
    <id>{$ctx:id}</id>
    <content>{$ctx:content}</content>
    <lastUpdated>{$ctx:lastUpdated}</lastUpdated>
    <profile>{$ctx:profile}</profile>
    <query>{$ctx:query}</query>
    <security>{$ctx:security}</security>
    <tag>{$ctx:tag}</tag>
    <text>{$ctx:text}</text>
    <filter>{$ctx:filter}</filter>
</fhir.historyAll>

Sample request

{
    "base": "https://open-api.fhir.me",
    "format": "json",
    "id":"%s(id)",
    "content":"%s(content)",
    "lastUpdated":"%s(lastUpdated)",
    "profile":"%s(profile)",
    "query":"%s(query)",
    "security":"%s(security)",
    "tag":"%s(tag)",
    "text":"%s(text)",
    "filter":"%s(filter)"
}
historyType

To retrieves the history of all resources of a given type supported by the system , use fhir.historyType and specify the following properties. For more information, see related FHIR API documentation.

Parameter Name Description Required
base The service root URL. Yes.
type The name of a resource type (e.g., "Patient"). Yes.
format The Mime Type. Yes.
id, content, lastUpdated, profile, query, security, tag, text, filter These are the optional parameters and are common search parameters for all resources. Optional.

Sample configurations

<fhir.historyType>
    <base>{$ctx:base}</base>
    <type>{$ctx:type}</type>
    <format>{$ctx:format}</format>
    <id>{$ctx:id}</id>
    <content>{$ctx:content}</content>
    <lastUpdated>{$ctx:lastUpdated}</lastUpdated>
    <profile>{$ctx:profile}</profile>
    <query>{$ctx:query}</query>
    <security>{$ctx:security}</security>
    <tag>{$ctx:tag}</tag>
    <text>{$ctx:text}</text>
    <filter>{$ctx:filter}</filter>
</fhir.historyType>

Sample request

{
    "base": "https://open-api.fhir.me",
    "type":"Patient"
    "format": "json",
    "id":"%s(id)",
    "content":"%s(content)",
    "lastUpdated":"%s(lastUpdated)",
    "profile":"%s(profile)",
    "query":"%s(query)",
    "security":"%s(security)",
    "tag":"%s(tag)",
    "text":"%s(text)",
    "filter":"%s(filter)"
}
search

To search from a particular resource supported by the system , use fhir.search and specify the following properties. For more information, see related FHIR API documentation on search operation and filter operation.

Parameter Name Description Required
base The service root URL. Yes.
type The name of a resource type (e.g., "Patient"). Yes.
format The Mime Type. Yes.
id, content, lastUpdated, profile, query, security, tag, text, filter These are the optional parameters and are common search parameters for all resources. Optional.

Sample configurations

<fhir.search>
    <base>{$ctx:base}</base>
    <type>{$ctx:type}</type>
    <format>{$ctx:format}</format>
    <id>{$ctx:id}</id>
    <content>{$ctx:content}</content>
    <lastUpdated>{$ctx:lastUpdated}</lastUpdated>
    <profile>{$ctx:profile}</profile>
    <query>{$ctx:query}</query>
    <security>{$ctx:security}</security>
    <tag>{$ctx:tag}</tag>
    <text>{$ctx:text}</text>
    <filter>{$ctx:filter}</filter>
</fhir.search>

Sample request

{
    "base": "https://open-api.fhir.me",
    "type": "Patient",
    "format": "json",
    "id":"%s(id)",
    "content":"%s(content)",
    "lastUpdated":"%s(lastUpdated)",
    "profile":"%s(profile)",
    "query":"%s(query)",
    "security":"%s(security)",
    "tag":"%s(tag)",
    "text":"%s(text)",
    "filter":"%s(filter)"
}
searchPost

To search from a particular resource supported by the system , use fhir.searchPost and specify the following properties. For more information, see related FHIR API documentation on the search operation.

Parameter Name Description Required
base The service root URL. Yes.
type The name of a resource type (e.g., "Patient"). Yes.
format The Mime Type. Yes.
id, content, lastUpdated, profile, query, security, tag, text, filter These are the optional parameters and are common search parameters for all resources. Optional.

Sample configurations

<fhir.historyAll>
    <base>{$ctx:base}</base>
    <format>{$ctx:format}</format>
    <id>{$ctx:id}</id>
    <content>{$ctx:content}</content>
    <lastUpdated>{$ctx:lastUpdated}</lastUpdated>
    <profile>{$ctx:profile}</profile>
    <query>{$ctx:query}</query>
    <security>{$ctx:security}</security>
    <tag>{$ctx:tag}</tag>
    <text>{$ctx:text}</text>
    <filter>{$ctx:filter}</filter>
</fhir.historyAll>

Sample request

{
    "base": "https://open-api.fhir.me",
    "type": "Patient",
    "format": "json",
    "id":"%s(id)",
    "content":"%s(content)",
    "lastUpdated":"%s(lastUpdated)",
    "profile":"%s(profile)",
    "query":"%s(query)",
    "security":"%s(security)",
    "tag":"%s(tag)",
    "text":"%s(text)",
    "filter":"%s(filter)"
}
Top