qedm-pcc44 component

The qedm-pcc44 component provides interfaces for actors of the Mobile Query Existing Data IHE transaction (PCC-44), which is described in the IHE Patient Care Coordination Technical Framework Supplement, Query for Existing Data Mobile (QEDm), Section 3.44.

Actors

The transaction defines the following actors:

PCC-44 actors
PCC-44 transaction and actors

Producer side corresponds to the Clinical Data Consumer actor. Consumer side corresponds to the Clinical Data Source actor.

Dependencies

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

    <dependency>
        <groupId>org.openehealth.ipf.platform-camel</groupId>
        <artifactId>ipf-platform-camel-ihe-fhir-r4-qedm</artifactId>
        <version>${ipf-version}</version>
    </dependency>

Endpoint URI Format

Producer

The endpoint URI format of qedm-pcc44 component producers is:

qedm-pcc44://hostname:port/path/to/service[?parameters]

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.

Consumer

The endpoint URI format of qedm-pcc44 component consumers is:

qedm-pcc44://serviceName[?parameters]

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 qedm-pcc44 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.

Transaction Options

This transaction defines the following options; at least one of them must be chosen to be supported:

  • OBSERVATIONS
  • ALLERGIES
  • CONDITIONS
  • DIAGNOSTIC_REPORTS
  • MEDICATIONS
  • IMMUNIZATIONS
  • PROCEDURES
  • ENCOUNTERS
  • ALL (default)

Note: the PROVENANCE option is not yet supported

The options are represented as enumeration in the class Pcc44Options.

Support for one or more options is configured using the optional options parameter, followed by a comma-separated list of options to be supported. If options is provided, the default option (see above) is used. The endpoint will reject resource types that are outside the scope of the configured option.

Example

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

    from("qedm-pcc44://service?audit=true&iheOptions=OBSERVATIONS")
      .process(myProcessor)
      // process the incoming request and create a response

Basic Common Component Features

FHIR Component Features