Add fetch_distribution_history() and
list_distribution_links() for more handling of distribution
data, thanks to @chrisumphlett and @dsen6644 (#221,
#239)
Changed handling of literal "NA" text input from
users so it is no longer converted to an R NA value thanks
to @jmobrien
(#244)
Use httr::RETRY() instead of
httr::VERB() in qualtrics_api_request() to
implement consistent API error-handling across all of the functions in
the package. They will be retried up to 3 times if there is any non-4xx
error. Thanks to @chrisumphlett (#217)
Update fetch_distributions() for changes to the
Qualtrics API, thanks to @chrisumphlett (#250)
fetch_description() to download complete survey
description metadata from v3 API endpoint (more up-to-date than older
metadata()) thanks to @jmobrien (#207)breakout_sets and label are both FALSEfetch_id() to return a surveyID based
on a unique survey name as it appears in the Qualtrics UI thanks to
@markjrieke
(#230).fetch_distributions() to access distribution data
for a specific survey thanks to @dsen6644 (#169)choiceId
thanks to @lyh970817 (#182)include_questions only contains one QID
thanks to @lyh970817 (#197)extract_colmap() function.include_questions argument to use correct name
in API request.fetch_survey() and read_survey() (#162) thanks
to @jntrcsqualtRicsConfigFile(), to avoid unexpected behaviorgetSurveys(),
getSurveyQuestions(), getSurvey(),
readSurvey()breakout_sets parameter thanks to @shaun-jacksinfer_data_types() for answers choices that
include HTMLlast_response argument no longer used by API
(#153)infer_data_types() to avoid errors with
factors/numeric valuesregisterOptions() to avoid unexpected
behavior with optionsctbqualtrics_api_credentials()
(registerOptions() is now soft deprecated with a
warning)all_surveys() (from old version of
getSurveys())survey_questions() (from old version of
getSurveyQuestions())fetch_survey() (from old version of
getSurvey())read_survey() (from old version of
readSurvey())getSurveys() and getSurveyQuestions() now
return a tibblereadSurvey() 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.getSurveyQuestions() now returns additional
information. h/t @phoebewongregisterOptions() now takes more arguments. User can
now set global options. See qualtRicsConfigFile() for more
information. Same options are now passed through ... in
specific functions.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.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.qualtRicsConfigFile() that prints
instructions for the user on how to set up a configuration file to the R
Console.root_url parameter from all functions that
required it.getSurveyQuestions() that allows
the user to download a data frame containing question labels and
IDs.getSurveyQuestions().getSurvey():
getSurveys() now retrieves > 100 results.readSurvey(). This function is
used in the getSurvey() function but will also work with
surveys downloaded manually from Qualtrics. Standard columns (completed
survey/startDate/endDate etc.) are now converted to their proper data
types. HT Adrian Brugger & Stefan Borer.getSurvey() function.
HT @samuelkaminsky & @eknud
getSurvey() no
longer sleeps when checking download status. Also added progress
bar.getSurvey()jsonlite and XML are added to
‘Suggests’ in DESCRIPTION.constructHeader() is now deprecated and should no
longer be used. Instead, users need to call
registerApiKey().registerApiKey() which saves the
user’s API key and header information in the tempdir()
environment.getSurvey()constructHeader,
getSurvey, getSurveyIDs)