跳到目录

质量管理体系

作者： 朱莉娅·希尔奇,约瑟夫·奥布莱恩,贾斯珀·金恩
许可证： 麻省理工学院

Qualtrics公司是一个在线调查和数据收集软件平台。Qualtrics在学术界和工业界的许多领域都被用于在线调查和研究。虽然用户可以通过浏览器从Qualtrics手动下载调查响应，但将此数据导入R中会很麻烦。qualtRics R软件包使用qualtRics API检索调查数据，旨在减少分析此类调查所需的预处理步骤。目前，此软件包是CRAN上唯一提供此类功能的软件包，包含在Qualtrics API官方文档中。

请注意，您的机构必须支持API访问，并且必须为您的帐户启用API访问。无论是谁管理您的Qualtrics帐户，都可以帮助您实现这一点。请参阅Qualtrics文件以查找您的API令牌。

此包的作者不隶属于Qualtrics，Qualtric也不支持此包。有关Qualtrics API的具体信息，可以参考官方文件.

安装

此软件包可以从CRAN安装：

安装.包(“qualtRics”)

或者，您可以使用遥控器包装（或者，开发工具):

安装.包(“遥控器”)
遥控器::安装github(“ropensci/qualtRics”)

访问Qualtrics数据

目前，该软件包包含三个核心功能：

  1. 所有调查（）从Qualtrics获取您拥有或有权访问的所有调查的列表。
  2. 获取_调查（）从Qualtrics下载调查并将其加载到
  3. 阅读_调查（）允许您读取从Qualtrics手动下载的CSV文件。

它还包含多个助手函数包括：

  1. qualtrics_api_credentials（）将API密钥和基本URL存储在环境变量中。
  2. 调查_问题（）检索包含调查问题和问题ID的数据框；提取_列映射（）检索类似的数据框，其中包含从列到标签的更详细映射。
  3. 元数据（）检索有关调查的元数据，例如问题、调查流程、回复数量等。

请注意，您只能导出您拥有的或您被授予管理权限的调查。

注册您的Qualtrics凭据

使用Qualtrics API进行身份验证需要两个重要凭据。这些是你的API密钥和特定于数据中心的基本URL。传递给qualtRics包的基本URL应如下所示yourdatacenterid.qualtrics.com，没有这样的方案https（https）：//. TheQualtrics API文档解释了如何查找基本URL。

您可以存储API凭据QUALTRICS_API_键和质量_基础_URL在您的.伦维龙跨会话重复使用的文件。qualtRics软件包具有帮助实现这一点的功能。

图书馆(质量管理体系)

qualtrics_api_credentials公司(api密钥= “<YOUR-QUALTRICS_API_KEY>”,
基本url= “<YOUR-QUALTRICS_BASE_URL>”,
安装= 真的)

使用此功能后，重新加载环境(readRenviron（“~/.Renviron”）)所以您可以使用凭据，而无需重新启动R。

一个简单的Qualtrics工作流程

存储Qualtrics API凭证后，您可以查看哪些调查可供您使用。

然后，您可以将这些单独调查（例如，可能是第六次调查）中的数据直接下载到R中。

我的调查 <- 获取_调查(调查ID= 调查$身份证件[6],
冗长的= 真的)

有关变量元数据、变量自动转换、检索特定日期之间的响应或特定调查项目的更多详细信息，请参阅qualtRics vignette。

社区指南

此项目发布时带有贡献者行为准则。参与此项目即表示您同意遵守其条款。欢迎反馈、错误报告（和修复！）和功能请求；提交问题或寻求支持在这里.