smtech/grading-analytics

此包已被废弃,不再维护。未建议替代包。

跟踪并呈现Canvas中教师行为丰富的反馈(类似于学生课程分析数据)

v2.0 2017-06-08 18:27 UTC

This package is auto-updated.

Last update: 2023-05-25 12:43:18 UTC


README

Latest Version Scrutinizer Code Quality

生成有关教师评分实践的某些报告。要开始自动化数据收集,请运行一次private/data-collection.sh脚本。它将收集第一轮数据,然后创建cronab作业,以便每晚午夜重复此过程。

收集的信息描述可在网上获取

安装

要求

  • Apache 2
  • MySQL 5.5或更高版本
  • PHP 5.6或更高版本
  • Composer

步骤

这通常遵循标准的PHP应用程序安装模式,并增加了一些额外的兴奋元素。

  1. 将存储库克隆到您的Web根目录。
cd path/to/web/root
git clone https://github.com/smtech/grading-analytics.git
  1. 运行设置脚本(这将安装依赖项,设置文件权限,安排Cron作业等。--它在做的时候会告诉你它在做什么,并且它将定期要求sudo密码)。
cd grading-analytics
./setup
  1. 编辑新创建的config.xml文件,包括应用程序的凭据(用于数据存储的MySQL登录凭证以及用于与Canvas API通信的凭据--开发密钥和密钥或API访问URL和令牌)。

  2. 将浏览器指向安装以完成应用程序设置(这将读取配置文件,设置数据库表等)。

https://server.com/path/to/grading-analytics

如果您以后需要重新运行安装过程,请将浏览器指向

https://server.com/path/to/grading-analytics?action=install

安装过程的最终结果是带您进入LTI消费者管理页面,在那里您需要创建新的消费者密钥和密钥。

  1. 在Canvas中安装API。它应该安装在其包含所有将被监控的课程子帐户中,例如,我们将它安装到包含我们所有系级子帐户的Academics子帐户中。使用Canvas的“通过URL”选项粘贴来自消费者管理页面的消费者密钥,共享密钥和配置URL。

  2. 访问LTI的帐户导航位置以完成安装(这将通过LTI身份验证捕获根帐户的帐户ID,这允许数据收集脚本知道要监控哪个帐户)。

从v1.x升级到v2.0

从1.x分支切换到2.0的原因主要围绕底层LTI身份验证结构的变化。这要求现有用户重新运行上述应用程序安装过程(步骤1-4),然后重新在Canvas中安装LTI(步骤5-6)。

底层数据在1.x和2.0分支之间保留不变的。然而,LTI结构的变化也在MySQL数据库中创建了一个tool_metadata表,它取代了app_metadata表,可以被删除。

course_statistics表中,我选择运行一个快速脚本来更新所有的analytics_page字段,以便指向新的LTI安装,但这并不是必需的,因为一旦收集到新数据,那些旧链接就不再可见了。