ResearchKit surveys enable researchers to gather data from participants. With RKStudio's visual designer, you can, for example, build ResearchKit surveys to query users about their symptoms on a set schedule, or use ResearchKit Active Tasks to collect data from their phone's sensors.
Creating a Survey
Most projects will involve several surveys. After joining an organization, you will be prompted to create or import a survey.
RKStudio's survey editor lets you build rich surveys. To get started, this guide will show you how to create a simple survey for a hypothetical sleep project.
From the Create or Import Survey dashboard, enter a survey name of "Sleep Time" and click "Add Survey." This brings up the survey editor.
Select "Add Step" to add a new step to the survey. Our first step will just contain some introductory instructions, so we'll use the "Instruction Step" type.
Select the "+" button next to the step preview to add a second step. This step will query for how many hours of sleep the participant got last night, so use the "Question Step" type. For the answer format, you could leave it open-ended with a "Numeric" answer, or provide a more graphical sliding scale with the "Scale (Discrete)" type.
Once you're finished adding steps, click "Save and Publish" to publish the survey.
Testing the Survey
You can get a quick preview of the survey in a browser by clicking the "Try It Out" button while viewing any step.
Some survey steps require device input or advanced features, and can only be tested through the MyDataHelps app. See Testing Projects and Surveys for advanced testing options.
Importing a Survey
Instead of starting from scratch, you can leverage an existing template by importing a survey from the survey store. These surveys have been created and shared by others. You can re-use one wholesale or use it as a starting point and then customize it. For more information, see Importing Surveys from the Survey Store.
Adding a Consent Survey
A project can have as many surveys as you want, but one of them must be a consent survey. A consent survey is used to inform participants about what data is collected and how it will be used. The consent survey is presented to new users before they join a project, and effectively serves as a gate to accessing other surveys.
Most consent surveys contain consent documents, which capture the details of your project's consent form and have a place to record the participant's electronic signature. A consent document is not required if you have already obtained consent on paper or in an external system.
For the sample sleep project, create a new consent survey named "Sleep Consent." You may wish to add an instructional step to introduce the consent process, or other steps as needed.
Next select the "+" next to "Consent Documents" to add a new consent document. Enter at least one section and select "Done" to save the document.
Add a new step of type "Consent Review." It will automatically select your consent document as the associated document for review. This step will present the consent document and record the participant's electronic signature at the time of enrollment. For more information about consent documents, see Creating a Consent Document and Consent Surveys.