qualtRics v2.3

We found that surveys that use new lines in the questions break the readSurvey function.
The problem is, that read.csv (and read.table as well as the readr library implementation) ignore the quote = """ option when a skip = 2 or skip = 3 parameter is set.
As a result the read function slices off the questions row somewhere in the middle when first importing just the table body using skip.

qualtRics v2.2

Changes:

• readSurvey() now takes an additional argument, fileEncoding, so that user can import surveys using a specific encoding. 'fileEncoding' can also be passed as optional argument in getSurvey(). Added new parameter that reads legacy data format.
• Better argument checking.
• getSurveyQuestions() now returns additional information. h/t @phoebewong
• Fixes several bugs and stability issues
• More informative error messages

qualtRics v2.1

Bug fixes:

• readSurvey() and getSurvey() now take a 'fileEncoding' argument that allows user to read in survey results using a specific encoding. The encoding used in v2.0 caused errors for Windows users.

Qualtrics version 2.0

Ready for CRAN submission.

Changelog

• registerOptions() now takes more arguments. User can now set global options. See qualtRicsConfigFile() for more information. Same options are now passed through ... in specific functions.
• Added appveyor testing.
• Added support for a configuration file to store API key and root url in the working directory.
• registerApiKey() has been replaced by registerOptions(). This function stores both a user's API key and root url. Function also scans for a configuration file .qualtRics.yml that contains this information.
• Added a new script called zzz.R. When the package is loaded, the .onLoad() function in this file scans the working directory for a .qualtRics.yml configuration file so that the user doesn't have to register this information manually.
• Added a new function qualtRicsConfigFile() that prints instructions for the user on how to set up a configuration file to the R Console.
• Removed the root_url parameter from all functions that required it.
• Dates are now converted without a specific timezone.
• Added a new function getSurveyQuestions() that allows the user to download a data frame containing question labels and IDs.
• Added parameter includedQuestionIds so user can select questions they want to download. Need to use the QID value from getSurveyQuestions().
• Updated examples and documentation of functions.
• Added the following parameters to getSurvey():
  • seenUnansweredRecode: String. Recode seen but unanswered questions with a string value.
  • limit: Integer. Maximum number of responses exported. Defaults to NULL (all responses).
  • useLocalTime: Boolean. Use local timezone to determine response date values.
• getSurveys() now retrieves > 100 results.

qualtRics version 1.5

Ready for release on CRAN

Initial release

v1.0

Added add_headers to namespace