Project Feedback, using REDCap of course: https://redcap.vcu.edu/surveys/?s=KJLHWRTJYA
The REDCap Api Library for .NET provides the ability to interact with REDCap programmatically using various .NET languages(C#,F#,VB.NET);
Prerequisites
- Local redcap instance installed (visit https://project-redcap.org) if you need to download files(assuming you have access)
- Create a new project with "Demographics" for the template; this gives you a basic project to work with.
- Create an api token for yourself, replace that with the tokens you see on the "RedcapApiTests.cs" files, and others
- You'll may need to add a field type of "file_upload" so that you can test the file upload interface of the API
- Build the solution, then run the tests
API METHODS SUPPORTED (Not all listed)
- ExportLoggingAsync
- ExportDagsAsync
- ImportDagsAsync
- DeleteDagsAsync
- ExportArmsAsync
- ImportArmsAsync
- DeleteArmsAsync
- ExportEventAsync
- ImportEventAsync
- ExportFileAsync
- ImportFileAsync
- DeleteFileAsync
- ExportMetaDataAsync
- ExportRecordsAsync
- ImportRecordsAsync
- ExportRedcapVersionAsync
- ExportUsersAsync
Usage:
- dotnet restore
- Add reference to the library in your project, or download from nuget into project
- Add "using Redcap" namespace
- Add "using Redcap.Models" for convenience
- Replace the demo api token with your test project or you can import the data dictionary in \Docs thats provided for convenience.
- Feel free to contribute
Sample / Example
using System;
using Newtonsoft.Json;
using Redcap;
using Redcap.Models;
namespace RedcapApiDemo
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("Redcap Api Demo Started!");
// Use your own API Token here...
var apiToken = "3D57A7FA57C8A43F6C8803A84BB3957B";
var redcap_api = new RedcapApi("https://localhost/redcap/api/");
Console.WriteLine("Exporting all records from project.");
var result = redcap_api.ExportRecordsAsync(apiToken).Result;
var data = JsonConvert.DeserializeObject(result);
Console.WriteLine(data);
Console.ReadLine();
}
}
}
Install directly in Package Manager Console or Command Line Interface
Package Manager
Install-Package RedcapAPI -Version 1.1.0
.NET CLI
dotnet add package RedcapAPI --version 1.1.0
Paket CLI
paket add RedcapAPI --version 1.1.0
Example Project
A console project has been included with the source code to get started. Some examples of method usage. You can use this to get started potentially.
Test Project
A project with associated test cases is included. Make sure to change the api token
Publications resulting from the use of this software should cite the Wright Center's Clinical and Translational Science Award (CTSA) grant #UL1TR002649, National Center for Advancing Translational Sciences, NIH.