学生信息系统 (SIS) 导入功能是手动将批量数据(或更改)导入 Canvas 系统的绝佳方式。本课程将提供使用 Canvas API 和您选择的编程语言来设置自动化系统以管理 SIS 导入工作流程的基础知识。
可以使用多种编程语言来构建与 Canvas 的自动化集成工具。如果您的编程语言能够通过安全套接字层 (SSL) 协议 (HTTPS) 与外部服务器进行 Web 连接并上传文件,您可以将本课程中的步骤应用到您选择的编程语言中(或者直接安装 cURL 并编写批处理文件)。本课程提供了一种设置基本自动化导入系统的简单方法。但是,您可能需要根据自身技能和特定 SIS 集成的功能来开发更复杂的系统。
测试数据集成
为避免影响生产环境中的数据,您可能需要在测试环境中设置 SIS 集成,以便进行准确的测试。每三周,在 Canvas 发布新版本后的第二天,生产环境将创建一个更新副本供测试环境使用,以便您可以使用最新数据进行测试。确认数据运行正常后,您可以将 SIS 集成重新应用到生产环境中。
或者,您可以在生产环境中进行更改,然后等待下次刷新,再开始在测试环境中进行练习。
高级帮助
开户
点击管理员链接[1],然后点击帐户名称[2]。
开放权限
在“帐户导航”中,单击“权限”链接。
修改用户角色和权限
在“帐户角色”选项卡中, 创建一个帐户级用户角色,并允许用户管理 SIS 数据。如果您不想创建新的用户角色,可以使用现有用户角色并修改其权限。
手动添加新用户
您需要手动添加一个新用户来管理 SIS 数据。您可以使用通过 SIS 导入的现有用户,但出于安全考虑,手动创建新用户更有利。这个新用户最终只会拥有一个权限,但该权限允许其在 Canvas 中创建、修改和删除多种对象类型。
添加用户为管理员
要启用SIS权限,请将您的管理员添加为帐户的管理员用户。为该用户设置启用SIS数据权限的用户角色。
获取 API 访问令牌
先退出 Canvas,然后以新用户身份重新登录。在“用户设置”的“已批准集成”下,添加新的访问令牌。除非有特殊原因需要指定过期日期,否则请将过期日期留空。了解如何获取 API 访问令牌。
注意:请务必将此 API 访问令牌保存在安全的地方。API 访问令牌与用户名和密码的作用相同,因此请采取类似的安全措施。请记住,在测试环境中创建的令牌将在下次测试环境刷新周期内被生产环境中创建的令牌替换。
通过 API 导入数据
curl -H "Authorization: Bearer <api_token>" 'https://<canvas_fqdn>/api/v1/accounts/self/sis_imports/<import_id>'
练习通过 API 导入数据。其中一种 API 方法是使用 cURL,这是一个命令行数据传输工具,支持所有操作系统(Windows、Linux 和 macOS)。该 API 可以演示如何练习导入测试文件以及如何检查先前导入的状态。
了解更多关于如何使用 API 将数据导入 Canvas 的信息。
创建导入脚本
使用您偏好的编程语言,创建一个 SIS 脚本。SIS 脚本会自动将您机构中的用户与您的 Canvas 帐户同步。 查看 SIS 脚本流程图。
导入脚本可以根据贵机构的需求,设计得简单或复杂。此外,您可以使用多种编程语言来编写导入脚本/程序。
了解更多关于创建Canvas SIS 脚本的信息。
导出数据并创建 Canvas CSV 文件
将您的学生信息系统 (SIS) 数据导出为Canvas CSV 文件格式。将文件放置在仅包含待导入 CSV 文件的目录或文件夹中。根据您使用的 SIS 系统,此步骤可能已自动完成。有关集成的更多信息,请联系您的 Canvas 客户成功经理。
SIS出口
由于学生信息系统 (SIS) 之间存在诸多差异,本课程无法介绍一种适用于所有情况的数据导出方法。但是,以下列出一些您可能可以使用的数据访问方法:
- API 访问:SIS 可能会以某种形式提供 API,允许您收集数据。
- 直接数据(数据库访问):SIS 可能允许直接数据库(或其他直接数据)访问您的 SIS 数据。
- 报告生成或数据导出:SIS 可能具备运行报告或导出数据的功能,并可通过电子邮件、网站/程序或保存到文件夹的方式进行交付。
- 触发或跟踪事件:SIS 可能具备在触发事件发生时运行作业的功能。这种类型的跟踪可能更适合直接通过 API 操作 Canvas 对象,但您也可以编写脚本/程序,利用 SIS 导入功能,定期收集触发的更改以进行批量更新。
一旦您了解如何访问您的SIS数据,就可以编写脚本/程序来处理和筛选数据,使其符合CSV SIS导入所需的格式。在某些情况下,您可能需要手动执行此步骤。您需要与SIS管理团队或供应商合作,找到最佳的数据导出方法。
注意:在与您的 SIS 团队合作时,请务必向他们提供 Canvas CSV 文件格式文档,这可能会降低导入前准备数据的复杂性,或者消除使用脚本/程序的需要。