我该如何把 SIS 数据导入至 Canvas 帐户?
SIS 数据可通过帐户设置 (Account Settings) 中的 SIS 导入链接上传。SIS 数据只能在帐户级别访问,不能添加至子帐户。
SIS 导入 (SIS Import) 页面支持几种格式用于对 Canvas 执行标准导入:Instructure 格式的 CSV 文件或 CSV 压缩文件,IMS 企业规范 XML 压缩文件,或 Banner 评分交换结果 XML。文件可以设置为进行整批更新,并覆盖 UI 更改。
请确保您了解与这些上传选项相关的风险。如需了解更多与这些风险相关的详细信息,请查看 SIS 导入教程。
API 处理
SIS 导入添加至一个队列,该队列单独处理每个导入的 CSV(无论是单独上传或是放在 ZIP 文件内上传)。导入错误显示在 SIS 导入页内。
API 实践
导入 SIS 信息前,练习使用 API 管理 SIS 数据。您也可以使用测试环境来避免与实时生产数据发生冲突。您在测试环境中确认数据后,可以把 SIS 集成重新应用到生产环境中。此外,某些 SIS 数据选项只通过 API 提供。
注意:
- 文件上传到您的帐户前,SIS 导入必须由您的客户成功经理启用。
- 导入 CSV 文件是帐户权限。如果您无权管理 SIS 文件,则表示您的机构已限制了此功能。
- 给用户角色设置权限前,您必须确保您想分配给用户的角色已经存在于您的帐户中。了解如何创建帐户级别角色。
故障排除建议:当用户或管理员直接修改信息时,某些字段会“置顶”。置顶可防止通过 SIS 导入进行自动更改。如果导入 SIS 数据后未发生更改,则可能是用户通过用户界面 (UI) 执行了更改。您可以使用“覆盖用户界面更改”选项来覆盖更改。
如果使用自动系统从 SIS 导入数据,则可能需要限制用户直接在 Canvas 中编辑其姓名。要阻止用户修改其姓名,请在账户设置中取消选择用户可以编辑其姓名 (Users can edit their name) 选项。
您可以在 SIS 导入 API 页面上查看可能会变为置顶的字段的完整列表。
打开帐户
在全局导航 (Global Navigation) 页面,点击管理员 (Admin) 链接 [1],然后点击帐户名称 [2]。
打开 SIS 导入
在帐户导航 (Account Navigation) 中,点击SIS 导入 (SIS Import) 链接。
选择文件
点击选择文件 (Choose File) 按钮,并从您的电脑中找到 SIS 导入文件。
选择导入类型
在导入类型 (Import Type) 菜单中,选择您上传至 Canvas 的导入项的类型。默认情况下,菜单选择 CSV 导入选项。
设置整批更新
如果您想创建整批更新,请勾选这是整批更新 (This is a full batch update) 复选框 [1],一条警告消息会通知用户与勾选这是整批更新 (This is a full batch update) 复选框相关的风险。在学期 (Term) 下拉菜单 [2] 中,选择学期以实施整批更新。利用该选项,可以删除在 Canvas 中有 SIS ID 记录链接至在下拉菜单中所选的学期的任何课程、班级或注册学生。对于注册学生,该选项意味着链接的用户和课程/班次需要 SIS ID。Canvas 档案如不包含在当前导入文件中将会被删除。
该选项将仅影响通过先前 SIS 导入创建的数据。例如,手动创建的课程即使未出现在新的 SIS 导入中,也不会被删除。
注意:确保您在选择该选项前了解相关的风险。
覆盖 UI 更改
如果您想覆盖用户界面 (UI) 中的更改,请勾选覆盖 UI 更改 (Override UI changes) 复选框。此更改指示 Canvas 使用您正在导入的数据覆盖用户在其帐户中更改的所有"置顶"数据。
- 执行新用户导入时如未勾选此框,则 UI 中的名称更改将不会被覆盖,但是,如果用户删除了其列示的电子邮件地址,则会重新添加,但不会标记为默认。
- 执行新用户导入时如勾选此框,全名和可排序名称将会更改,但显示名称不会更改。电子邮件地址已添加,但仍未标记为默认。
处理数据
点击过程数据 (Process Data) 按钮。
确认更改
点击处理数据 (Process Data) 按钮后,会显示确认模式。点击取消 (Cancel) [1] 停止,或点击确认 (Confirm) [2] 继续。
查看导入数据
导入处理完毕后,Canvas 显示已导入文件的结果,以及多达 50 个错误和警告。如果您导入了整批更新,结果还会显示从帐户删除的删除项目的数量。删除项目包括注册学生、课程和班级。
刷新页面后,该信息将保留在最后批次 (Last Batch) 标题项下的 SIS 导入 (SIS Import) 页面中,直到执行下一次导入。
下载错误
如果您想下载上次导入文件中包含的所有警告和错误,请返回至 SIS 导入 (SIS Import) 页。在最后批次 (Last Batch) 标题项下 [1],点击最后批次下载 (Last Batch Download) 图标 [2]。CSV 文件下载项,其中包含上次导入的所有错误和警告。
注意:
- 您可能需要刷新页面以查看下载图标。
- 如果下载了报告,链接将在一小时后失效。如果刷新了页面,则会生成一个在一小时内有效的新 URL。
检查错误
如发现文件失败,请检查任何可用的错误消息。检查错误时注意以下几点:
- 您可能会发现文件本身有错误消息,或者文件中的特定行失败。
- 您可以利用 SIS 导入错误 API (SIS Import Errors API) 查看其他故障排除详细信息,此操作将在发生错误时返回 CSV 行号。
- CSV 需要特定格式才能正常上传。尤其要查看 CSV 标题。了解有关格式化 CSV 文件的更多信息。
- SIS 导入 CSV 文件必须以 UTF-8 编码,不带字节序号。大多数应用程序会自动进行 UTF-8 编码,但有些程序(如 Microsoft Excel)会改用其他编码。如果您的软件能将文件编码为 UTF-8,请在保存时选择 UTF-8 作为选项。
- 某些错误消息要求您联系支持人员进行检查。