Eureka! Clinical I2b2 Integration Webapp

Provides a proxy for accessing i2b2 integration services.

License	Apache License, Version 2.0
Categories	CLI User Interface Eureka Container Microservices
GroupId	org.eurekaclinical
ArtifactId	eurekaclinical-i2b2-integration-webapp
Last Version	2.2-Alpha-2
Release Date	Nov 16, 2020
Type	war
Description	Eureka! Clinical I2b2 Integration Webapp Provides a proxy for accessing i2b2 integration services.
Project URL	https://github.com/eurekaclinical/eurekaclinical-i2b2-integration-webapp.git
Project Organization	Emory University
Source Code Management	https://github.com/eurekaclinical/eurekaclinical-i2b2-integration-webapp.git

Download eurekaclinical-i2b2-integration-webapp

Filename	Size
eurekaclinical-i2b2-integration-webapp-2.2-Alpha-2.pom
eurekaclinical-i2b2-integration-webapp-2.2-Alpha-2.war	11 MB
eurekaclinical-i2b2-integration-webapp-2.2-Alpha-2-sources.jar	20 KB
eurekaclinical-i2b2-integration-webapp-2.2-Alpha-2-javadoc.jar	79 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.eurekaclinical/eurekaclinical-i2b2-integration-webapp/ -->
<dependency>
    <groupId>org.eurekaclinical</groupId>
    <artifactId>eurekaclinical-i2b2-integration-webapp</artifactId>
    <version>2.2-Alpha-2</version>
    <type>war</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.eurekaclinical/eurekaclinical-i2b2-integration-webapp/
implementation 'org.eurekaclinical:eurekaclinical-i2b2-integration-webapp:2.2-Alpha-2'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.eurekaclinical/eurekaclinical-i2b2-integration-webapp/
implementation ("org.eurekaclinical:eurekaclinical-i2b2-integration-webapp:2.2-Alpha-2")

Apache Buildr

'org.eurekaclinical:eurekaclinical-i2b2-integration-webapp:war:2.2-Alpha-2'

Apache Ivy

<dependency org="org.eurekaclinical" name="eurekaclinical-i2b2-integration-webapp" rev="2.2-Alpha-2">
  <artifact name="eurekaclinical-i2b2-integration-webapp" type="war" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.eurekaclinical', module='eurekaclinical-i2b2-integration-webapp', version='2.2-Alpha-2')
)

Scala SBT

libraryDependencies += "org.eurekaclinical" % "eurekaclinical-i2b2-integration-webapp" % "2.2-Alpha-2"

Leiningen

[org.eurekaclinical/eurekaclinical-i2b2-integration-webapp "2.2-Alpha-2"]

Dependencies

compile (7)

Group / Artifact	Type	Version
org.eurekaclinical : eurekaclinical-i2b2-integration-client	jar	2.2-Alpha-1
org.eurekaclinical : eurekaclinical-user-agreement-client	jar	2.4-Alpha-2
org.eurekaclinical : eurekaclinical-common	jar	5.1-Alpha-1
org.eurekaclinical : eurekaclinical-standard-apis	jar	4.1-Alpha-1
com.sun.xml.bind : jaxb-core	jar	2.3.0.1
javax.xml.bind : jaxb-api	jar	2.3.1
com.sun.xml.bind : jaxb-impl	jar	2.3.1

provided (1)

Group / Artifact	Type	Version
javax.servlet : javax.servlet-api	jar	4.0.1

Project Modules

There are no modules declared in this project.

Eureka! Clinical I2b2 Integration Webapp

Georgia Clinical and Translational Science Alliance (Georgia CTSA), Emory University, Atlanta, GA

What does it do?

It implements a proxy servlet and router for web clients to access the web services provided by eurekaclinical-i2b2-integration-service.

Version 2.0 development series

Latest release:

The 2.0 series will port the proxy over to the new eurekaclinical-i2b2-integration-service.

Version history

Version 1.0.1

The version 1 series implements the proxy and router for all service functionality, but it assumes the old version of the service (i2b2-eureka-service).

Build requirements

• Oracle Java JDK 8
• Maven 3.2.5 or greater

Runtime requirements

• Oracle Java JRE 8
• Tomcat 7
• Also running
  • The eurekaclinical-i2b2-integration-service war
  • The cas-server war

Proxied REST APIs

You can call all of eurekaclinical-i2b2-integration-service's REST APIs through the proxy. Replace /protected/api with /proxy-resource. The point of doing this is for web clients -- you can deploy the webapp on the same server as web client, and deploy the service on a separate server.

Building it

The project uses the maven build tool. Typically, you build it by invoking mvn clean install at the command line. For simple file changes, not additions or deletions, you can usually use mvn install. See https://github.com/eurekaclinical/dev-wiki/wiki/Building-Eureka!-Clinical-projects for more details.

Performing system tests

You can run this project in an embedded tomcat by executing mvn process-resources cargo:run -Ptomcat after you have built it. It will be accessible in your web browser at https://localhost:8443/eurekaclinical-i2b2-integration-webapp/. Your username will be superuser.

Installation

Configuration

This webapp is configured using a properties file located at /etc/ec-i2b2-integration/application.properties. It supports the following properties:

• eurekaclinical.i2b2integrationwebapp.callbackserver = https://hostname:port
• eurekaclinical.i2b2integrationservice.url = https://hostname.of.service:port/eurekaclinical-i2b2-integration-service
• eurekaclinical.i2b2integrationwebapp.url = https://hostname:port/eurekaclinical-i2b2-integration-webapp
• cas.url=https://hostname.of.casserver:port/cas-server

A Tomcat restart is required to detect any changes to the configuration file.

WAR installation

1. Stop Tomcat.
2. Remove any old copies of the unpacked war from Tomcat's webapps directory.
3. Copy the warfile into the Tomcat webapps directory, renaming it to remove the version. For example, rename eurekaclinical-i2b2-integration-webapp-1.0.war to eurekaclinical-i2b2-integration-webapp.war.
4. Start Tomcat.

Maven dependency

<dependency>
    <groupId>org.eurekaclinical</groupId>
    <artifactId>eurekaclinical-i2b2-integration-webapp</artifactId>
    <version>version</version>
</dependency>

Developer documentation

• Javadoc for latest development release

Getting help

Feel free to contact us at [email protected].

Eureka! Clinical

Microservices for clinical and translational research

Versions

Version
2.2-Alpha-2 Nov 16, 2020
2.2-Alpha-1 Aug 13, 2020
2.1 Dec 6, 2019
2.1-Alpha-6 Nov 1, 2019
2.1-Alpha-4 Oct 20, 2018
2.1-Alpha-3 Apr 25, 2018
2.1-Alpha-2 Apr 24, 2018
2.1-Alpha-1 Feb 23, 2018
2.0 Feb 17, 2018
2.0-Alpha-9 Nov 28, 2017
2.0-Alpha-8 Nov 18, 2017
2.0-Alpha-7 Aug 29, 2017
2.0-Alpha-6 Aug 21, 2017
2.0-Alpha-5 Jun 22, 2017
2.0-Alpha-4 May 8, 2017
2.0-Alpha-3 May 8, 2017
2.0-Alpha-2 May 6, 2017
2.0-Alpha-1 May 5, 2017
1.0.1 Oct 17, 2016
1.0 Sep 17, 2016
1.0-Alpha-5 Aug 26, 2016
1.0-Alpha-4 Aug 6, 2016
1.0-Alpha-3 Aug 6, 2016
1.0-Alpha-2 Aug 5, 2016
1.0-Alpha-1 Aug 5, 2016