Download
REDCap PHP plugin: To download the REDCap_PHP file, please contact Krishagni.
OpenSpecimen-REDCap Plugin: To download the OpenSpecimen-REDCap plugin, please contact Krishagni.
Installation
Installation of these plugins to the remote server helps in sharing data or information across datasets. There are two parts to this process:
Installation of REDCap PHP Plugin
Log in to the REDCap server and navigate to the REDCap install directory containing the file redcap_connect.php and database.php files.
Following are example commands executed in our dev environment.
$ cd /home/var-www/html/redcap/ $ ls database.php redcap_connect.php database.php redcap_connect.php
Create a new 'plugins' directory if not present.
$ mkdir -p plugins
Copy the REDCap_PHP file to the plugin's directory.
$ cp $RC_OS_PLUGIN/openspecimen_plugin.php plugins
To ensure that the plugins are correctly installed, you can invoke the following API using the HTTP client program of choice or run the commands as shown below.
Below is an example done using Postman
Replace <host> with hostname where REDCap server is deployed
Replace <Project API token> with actual API token issued for accessing REDCap project using APIs
In response, you should see the REDCap audit log events nicely formatted using JSON.
The following commands should succeed with printing JSON string on the console.
RC_HOST- URL of the REDCap server. E.g. https://redcap.openspecimen.orgRC_DOCROOT- Document root of the REDCap server. E.g. /, /rOS_PLUGIN- Relative path of the OpenSpecimen REDCap plugin w.r.t document root. E.g. /plugins/openspecimen_plugin.php
Test Project Details
$ curl -X POST -D "token=<Project API token>" -d "content=project" -d "format=json" -d "returnFormat=json" $RC_HOST/$RC_DOCROOT/api/ Example command: curl -X POST -d "token=xxxx" -d "content=project" -d "format=json" -d "returnFormat=json" https://redcap.openspecimen.org/r/api/ // project details JSON Output <!DOCTYPE html> <html> <head> <title>REDCap Project</title> </head> <body> ........ </body> </html>
Test Events list
$ curl -X POST -d "token=<Project API token>" -d "content=event" -d "format=json" -d "returnFormat=json" $RC_HOST/$RC_DOCROOT/$OS_PLUGIN
// events list JSON
Example command:
curl -X POST -d "token=xxxx" -d "content=event" -d "format=json" -d "returnFormat=json" https://redcap.openspecimen.org/r/plugins/openspecimen_plugin.php
Output
>>[{"event_id":"40","day_offset":"1","offset_min":"0","offset_max":"0","event_name":"Event 1","arm_num":"1","repeatable":"0"}]
Please contact your REDCap system admin for these steps. There might be slight differences based on the REDCap version, operating system, etc.
Installation of OpenSpecimen plugin
Exact the JAR file from your downloaded zip file.
Login to your OpenSpecimen server and navigate to the
$TOMCAT_HOME/bindirectory.Stop the tomcat service using the command:
./shutdown.sh force
Now, navigate to the plugin's directory and remove an older copy of the REDCap-OpenSpecimen plugin (if any) and copy the current version.
Navigate back to the
$TOMCAT_HOME/bindirectory and restart the tomcat service using the command:./startup.sh
How to check the plugin version?
Use the below command to check the version of the plugin installed on the REDCap server-side
PHP plugin version
$ curl -X POST -d "token=<Project API token>" -d "content=version" -d "format=json" -d "returnFormat=json" $RC_HOST/$RC_DOCROOT/$OS_PLUGIN
Example command:
curl -X POST -d "token=xxxx" -d "content=version" -d "format=json" -d "returnFormat=json" https://redcap.openspecimen.org/r/plugins/openspecimen_plugin.php
Output
>>{"version":"2020-10-12T07:58:48.225Z"}