qualtRics v0.1

0

Monthly downloads

0th

Percentile

Download qualtrics data into R

This package contains convenience functions to work with the Qualtrics API. It is under active development.

Readme

qualtRics

This project contains an R package to interact with the Qualtrics API. It is currently under development. I will add more functionality later.

Note that your institution must support API access and that it must be enabled for your account. Whoever manages your Qualtrics account can help you with this.

Installation

To install this package, execute the following in R:

install.packages("devtools")
devtools::install_github("JasperHG90/qualtRics")

Dependencies

This package depends on httr and stringr. Both dependencies will be installed when you install qualtRics.

Updates

Periodically check this repository for updates and execute devtools::install_github("JasperHG90/qualtRics") to update.

Usage

Currently, the package contains three functions. It supports fetching a list of courses and their IDs from qualtrics, as well as downloading and reading a survey export.

Note that, while requests will work without a base url, it is desirable that you supply it to the functions when needed. Supplying the correct url will reduce the number of errors you'll experience. Please refer to the official documentation to find out your institution-specific base url.

Note that you can only export surveys that you own, or to which you have been given explicit administration rights.

Commands

Load the package:

library(qualtRics)

Construct the header information:

head <- constructHeader(API.TOKEN = "<yourapitoken>")

Get a list of surveys:

surveys <- getSurveys(head, survey_baseurl="https://leidenuniv.eu.qualtrics.com/API/v3/responseexports/") # URL is for my own institution

Export a survey and load it into R:

mysurvey <- getSurvey(surveyID = surveys[[6]]$id, headers = head, base_url = "https://leidenuniv.eu.qualtrics.com/API/v3/responseexports/", verbose = TRUE)

Other information

For specific information about the Qualtrics API, you can refer to the official documentation.

Issues

Should you encounter any bugs or issues, please report them here

Requests

If you have a request (like adding a new argument), please leave it here

Changelog

  • Added first three functions (constructHeader, getSurvey, getSurveyIDs)

Functions in qualtRics

Name Description
constructHeader Construct a header to send to qualtrics API
getSurvey Export a survey and download into R
getSurveys Retrieve a list of all active surveys that you own on qualtrics
No Results!

Last month downloads

Details

Type Package
URL https://github.com/JasperHG90/qualtRics
BugReports https://github.com/JasperHG90/qualtRics/issues
License Apache 2.0
Encoding UTF-8
LazyData true
VignetteBuilder knitr
RoxygenNote 5.0.1
imports httr , stringr
suggests knitr , rmarkdown
Contributors Jasper Ginn

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/qualtRics)](http://www.rdocumentation.org/packages/qualtRics)