我如何使用Canvas和SIS为账户创建自动数据整合？

Canvas 最近推出了一个新的页面设计堪称Canvas 的用户新界面（UI）。本教程包括两个图像的具体步骤，以显示两种设计之间的差异。除非另外指出，组件的功能和位置保持不变。提供给您的视图也经您的机构确定可用。

学生信息系统（SIS）导入是一个手动导入批量数据（或更改）到Canvas系统的好方法。 此处提供一个基本教程关于如何使用Canvas 的API，以及选择设置一个自动管理SIS导入工作流程的程序设计语言。

有几种程序设计语言可以与Canvas建立自动整合工具一起使用。 如果您首选的程序设计语言可以对外部服务器做出安全套接字层（SSL）网络电话（HTTPS://），还有有发布文件的功能，您可以应用本教程的步骤到您选择的程序设计语言（或就安装cURL和撰写批量文件）。 本教程也提供简单的设置基本的自动导入系统的途径。 但是，按照您的具体SIS整合的技能，您或许发展一个更复杂的系统。

注意：您必须在Canvas整合数据前使用Canvas的CSV文件格式导出您的SIS文件。

测试数据整合

要防止在您的生产环境影响数据，为了精确的测试，您可能要在您的体验环境中设置您的SIS整合。 每三个星期，Canvas新产品发布的第二天，您的生产环境将给您的体验环境创建一个更新的副本，然后您可以使用更新的数据测试。 一旦您确认您的数据正确运作，您可以重新在您的生产环境中应用SIS整合。

另外，您可以在您的生产环境创建和更新，然后，您开始在体验环境实践前，等待下一次刷新。 了解关于Canvas发布周期。

超前的帮助

这是几个可能对高级用户的链接：

打开账户

打开账户

在全局导航，点击课程（Courses）的链接[1]，并点击账户的名字[2]。

在Canvas的新界面打开账户

在Canvas的新界面打开账户

如果您使用Canvas的新用户界面（UI），点击管理员（Admin）链接[1]，然后点击账户标题[2]。

修改用户角色和权限

修改用户角色和权限

在账户设置中，打开权限的链接。 在账户角色选项卡，创建账户级别用户角色和启用账户级别的SIS数据权限。 如果您不想创建新的用户角色，您可以使用现有的用户角色并修改权限。

手动地添加新用户

手动地添加新用户

您将要手动地添加新用户管理SIS数据。 您可以使用一个已通过SIS导入的现有用户，但是为了安全目的，建议手动创建新用户。 此新用户将只得到一个权限，但是这一权限授予创建、修改和删除许多Canvas的对象类型的功能。

作为管理员添加用户

作为管理员添加用户

要启用SIS权限，作为管理人员添加您的管理员到您的账户。 启用SIS数据权限，为用户设定用户角色。

获得API访问令牌

获得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和OSX）支持的转移数据命令工具。 API 可以向您显示如何练习导入测试文件并查看先前导入的状态。

了解更多关于使用API导入数据到Canvas。

创建导入脚本

创建导入脚本

使用您首选的程序设计语言，创建一个SIS脚本。 SIS脚本自动地对您机构的用户与您的Canvas账户同步。 查看或下载SIS脚本流程图。

导入脚本可以是简单或复杂，是按您的机构的要求。 另外，各个程序设计语言可以被使用来撰写您的导入脚本/程序。

了解更多关于创建一个Canvas SIS 脚本。

导出数据和创建Canvas CSV 文件

在 Canvas 的CSV文件格式导出您的SIS 数据。 把文件放到一个目录或只包含准备导入的 CSV 文件的文件夹。 取决于您的SIS，此步骤可能会自动地产生。 要更多整合的信息，请联系您的Canvas客户成功经理。

SIS 导出

由于学生信息系统（SIS）的广泛变化，本教程无法提供一个包罗万象导出数据的方法。 但是，您可使用以下几种数据访问方法：

  • API 访问：SIS可能会提供以某种形式的允许您收集数据的API。
  • 直接数据（数据库访问）：SIS可能允许直接的数据库（或其它直接的数据）对您的SIS数据访问。
  • 报告生成或数据导出：SIS可能有运行报告或导出数据的功能并让它们通过电子邮件、从网站/程序发送或保存到文件夹。
  • 引发或跟踪事件： SIS可能有运行引发事件工作的功能。 这种跟踪可能对直接Canvas 对象的API操纵，同时，您可以有一个脚本/程序专门在平常的时段中使用SIS导入来收集批量更新引发的更改。

一旦您知道如何访问您的SIS数据，一个脚本/程序可以被撰写，并应用于操作和过滤数据以匹配CSV SIS 要求的导入格式。 在某些案例，您可能要手动地进行此步骤。 您将需要与您的SIS管理团队或供应商一起找出最好的导出数据方法。

注意：在与您的SIS团队工作时，请确认给他们提供了Canvas CSV 文件记录，这可能会降低难度或消除要在导入前准备脚本/程序的需要。