C3-PRO uses the HAPI FHIR library and ResearchStack in an attempt to bring the C3-PRO functionality to Android.
Combining 🔥 FHIR and ResearchStack, usually for data storage into i2b2, this framework allows you to use
FHIR Questionnaire resources directly with a ResearchStack ViewTaskActivity and will return FHIR QuestionnaireResponse that
you can send to your server.
The library is hosted at bintray.
To set up a project to use the C3PRO framework, the library is available on jCenter and can simply be added as a dependency:
dependencies {
compile ('ch.usz.c3pro:c3-pro-android-framework:1.0'){
exclude module: 'javax.servlet-api'
exclude module: 'hapi-fhir-base'
}
}Some packages of third party dependencies need to be excluded to avoid duplicate class names.
#####The setup
A sample application to demonstrate the setup is available here
A subclass of Application is needed and set as main application in the AndroidManifest.
Most setup methods are best put in the onCreate() method of the C3PROApplication class to make sure they survive Activities' lifecycles.
The DataQueue or EncryptedDataQueue is best set up here with the FHIR url.
There are also some ResearchStack settings. More details about that can be found on the ResearchStack website.
The Applicationfile should look something like this:
public class C3PROApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// TODO: initialize C3-PRO
/**
* Initialize DataQueue:
* You have to provide a context (your application) and an URL to the FHIR Server.
* Once initialized, DataQueue can write and read Resources from your server in a
* background thread.
* */
DataQueue.init(this, "http://fhirtest.uhn.ca/baseDstu3");
/**
* Or initialize EncryptedDataQueue. It can do everything the DataQueue can do plus it can
* send jsonObjects containing encrypted FHIR resources to a special C3-PRO server.
* */
try {
EncryptedDataQueue.init(this, "http://fhirtest.uhn.ca/baseDstu3", "http://encrypted.c3-pro.org", "enc/public.crt", "");
} catch (CertificateException e) {
e.printStackTrace();
}catch (NoSuchAlgorithmException e) {
e.printStackTrace();
} catch (InvalidKeySpecException e) {
e.printStackTrace();
}
// TODO: following are some ResearchStack settings. For more info, visit http://researchstack.org
// ResearchStack: Customize your pin code preferences
PinCodeConfig pinCodeConfig = new PinCodeConfig(); // default pin config (4-digit, 1 min lockout)
// ResearchStack: Customize encryption preferences
EncryptionProvider encryptionProvider = new UnencryptedProvider(); // No pin, no encryption
// ResearchStack: If you have special file handling needs, implement FileAccess
FileAccess fileAccess = new SimpleFileAccess();
// ResearchStack: If you have your own custom database, implement AppDatabase
AppDatabase database = new DatabaseHelper(this,
DatabaseHelper.DEFAULT_NAME,
null,
DatabaseHelper.DEFAULT_VERSION);
StorageAccess.getInstance().init(pinCodeConfig, encryptionProvider, fileAccess, database);
}
}The AndroidManifest:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="ch.usz.c3pro.demo.android">
<application
android:name=".C3PROApplication"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>The build.gradle:
apply plugin: 'com.android.application'
android {
compileSdkVersion 23
buildToolsVersion "23.0.3"
defaultConfig {
applicationId "ch.usz.c3pro.demo.android"
minSdkVersion 16
targetSdkVersion 23
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
dexOptions {
javaMaxHeapSize "3g"
}
}
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
testCompile 'junit:junit:4.12'
// TODO: include C3PRO framework, but exclude some of the hapi library
compile('ch.usz.c3pro:c3-pro-android-framework:1.0') {
exclude module: 'javax.servlet-api'
exclude module: 'hapi-fhir-base'
}
}The library uses HAPI FHIR 1.6 for dstu3. Questionnaires in dstu2 (with group and question elements) will not work with this demo setup. Target Android sdk is 23, minimum sdk 16 due to ResearchStack.
Implementation is ongoing, not everything is complete and nothing has been tested systematically.
- EnableWhen conditions have only been tested with boolean and singlechoice answertypes
- The encrypted DataQueue is not tested yet and still has some testing artefacts in the framework code
- Proper error handling not thoroughly implemented as of yet.
The framework will consist of several modules that complement each other, similar to the C3-PRO ios framework.
Enables the conversion of a FHIR Questionnaire resource to a ResearchSTack task that can be presented to the user using a
ViewTaskActivity and conversion back from a TaskResult to a FHIR QuestionnaireResponse resource.
This module provides a FHIR server implementation used to move FHIR resources, created on device, to a FHIR server, without the need for user interaction nor -confirmation. An EncryptedDataQueue is available to send jsonObjects containing encrypted FHIR resources to a special C3-PRO server.
Supports easy interaction with the Google Fit API. Step count, height and latest weight of the user can be read and returned as FHIR Quantity and Observation.
It can also write new height and weight data into the Fit history.
This work will be Apache 2 licensed. A NOTICE.txt file will follow at some point, and don't forget to also add the licensing information of the submodules somewhere in your product: