Qualtrics

A nice wrapper for the Qualtrics REST API. Currently under fast iterations. Full functional, but may see many changes before 1.0 release. Not recommended for production use before then.

Just add the gem.

gem 'qualtrics'

Set the user, token and default library id

Qualtrics.configure do |config|
  config.user = ENV['QUALTRICS_USER']
  config.token = ENV['QUALTRICS_TOKEN']
  config.default_library_id = ENV['QUALTRICS_LIBRARY_ID']
end

Add/remove a panel to Qualtrics

panel = Qualtrics::Panel.new({
  name: 'My first panel'
})

panel.save
panel.destroy

Add/remove recipients to panel

recipient = Qualtrics::Recipient.new({
  panel_id: panel.id
})

recipient.save
recipient.delete

Retrieve all survey and messages in Qualtrics

Qualtrics::Survey.all   -> returns array of Qualtrics::Survey objects
Qualtrics::Message.all

Send a survey to a panel or individual with the Mailer object

mailer = Qualtrics::Mailer.new({
  from_email: 'from_email',
  from_name: 'from_name',
  subject: 'subject'
})

mailer.send_survey_to_individual(recipient, message, survey)
mailer.send_survey_to_panel(panel, message, survey)

Retrieve submission results if you know the Qualtrics response_qid

submission = Qualtrics::Submission.new({
  id: 'response_qid',
  survey_id: 'survey_id'
})

submission.raw_csv

Can batch update all the recipients in a panel for efficency.

1. Allow retrieving responses in different formats.
2. Qualtrics does not all deleting library messages, find a way to test around this.

1. Fork it ( https://github.com/[my-github-username]/qualtrics/fork
2. Add tests.
3. Make your feature addition or bug fix.
4. Send me a pull request.

To run the test suite, you will need to configure a .env file, following the example of the .env.example file:

cp .env.example .env

You will need to set the QUALTRICS_USER variable to your Qualtrics User ID value, the QUALTRICS_TOKEN variable needs to be set to the API Token value associated with your User ID, and the QUALTRICS_LIBRARY_ID needs to be set to the ID of the survey Library you wish to access.

Now you can run the tests with:

rake