Canvas 允许您导入 CSV 文件，通过管理界面手动批量创建用户、帐户、学期、课程、章节、注册和登录信息。
本文档引用了SIS 导入 CSV 格式 API 页面，其中包含了大部分 CSV 信息。每个 CSV 文件都与其他文件协同工作，并告知 Canvas 如何管理帐户信息。 查看 SIS 关系图。
示例文件
本课程的每个步骤都详细介绍了 CSV 文件以及每个必填字段和可选字段的说明。每个步骤还包含一个示例 CSV 文件的下载链接。示例文件包含所有必填字段，也可能包含可选字段。此外，您还可以下载包含所有示例文件的压缩包。如果 CSV 链接无法下载，请尝试在新标签页中打开该链接。
在将任何内容导入生产环境之前，您应该在Canvas 测试环境中练习导入数据。
CSV 文件格式
要将数据批量上传到 Canvas，您必须创建一个或多个 CSV 文本文件。许多程序都可以生成 CSV 文件。学生信息系统 (SIS) 通常提供生成 CSV 格式报告的方法，您可以对其进行修改以适应 Canvas 所需的格式。如果您不知道如何将文件保存为 CSV 格式，请查看您用于创建 CSV 文件的程序（例如 Excel）的文档。
在SIS 导入页面使用 Instructure 格式导入文件时，您可以导入单个 CSV 文本文件，也可以将多个文件压缩到一个 ZIP 文件中进行批量导入。如果您手动上传单个文件，则必须按照本课程中所示的顺序上传文件。
CSV字段格式化
CSV 文件的第一行（标题行）必须包含每个文件的完整字段名称。列的顺序无关紧要，但对于像 accounts.csv 这样的文件，行的顺序至关重要。
粘性田野
默认情况下，用户界面中的某些更改不会被后续的 SIS 导入覆盖，这些更改被指定为“持久化”设置。本文档中列出了所有持久化字段。您可以通过在 API 中设置override_sis_stickiness或在SIS 导入页面中选中“覆盖 UI 更改”复选框来覆盖这些字段。
API 文档
CSV 文件仅包含一组特定字段。Canvas 包含其他值，这些值可通过各个 API 获取。在为贵机构运行 CSV 文件后，大多数机构的标准做法是上传所有 SIS CSV 文件，然后使用 Canvas API 更新完整的帐户和课程属性。有关更多信息，请参阅Canvas API 文档，了解用户、帐户、学期、课程、班级、注册和群组的相关内容。SIS 导入也可以使用SIS 导入 API进行管理。
注意： CSV 文件中的标题行定义了 Canvas 将处理哪些数据字段。虽然 SIS 导入指南列出了所有支持的字段，但您的实际 CSV 文件只需包含您当前正在更新的列即可。如果您的文件中缺少某个支持的字段，您可以手动将标题添加到第一行。
用户.csv
用户是指在机构内拥有用户账户的人员。users.csv 文件会将用户作为通用用户添加到系统中。enrollments.csv 文件会为这些用户分配角色（例如教师、学生等）。当用户账户被删除时，其所有注册信息也将被删除，并且该用户将无法登录其 Canvas 账户。如果您仍然希望用户能够登录但不能参与课程，或者您只想将其从特定课程中删除，则应将其用户账户保持激活状态，并分别将其在 enrollments.csv 文件中的注册状态更改为“已完成”或“已删除” 。
下载包含 10 个 Canvas 用户帐户的示例 users.csv 文件。
必填项*|粘性场^
- 用户身份*这是用于在 Canvas 中识别每个帐户的唯一值。此值对于每个用户都必须保持不变，并且在所有用户中也必须是唯一的。在用户界面中，这被称为 SIS ID，可以由任意字符组合构成。您可以通过访问任何用户帐户并查看其登录信息来找到此 SIS ID。
- integration_id：这是一个辅助唯一标识符，适用于更复杂的SIS集成。此标识符对用户而言不得更改，且必须全局唯一。
- 登录ID*^：
- 密码：如果帐户配置为使用 LDAP 或 SSO 协议，则无需输入密码。否则，此密码与上述“login_id”对应的密码相同。此密码长度必须至少为 8 个字符。
- ssha_password：您可以在此字段中传递使用SSHA 密码生成方案生成的预哈希密码，而不是明文密码。虽然这比传递明文密码要好，但您仍然应该鼓励用户在首次登录后更改密码。
- authentication_provider_id：这是登录名关联的身份验证提供程序。与特定提供程序关联的登录名只能用于该提供程序。旧版提供程序（LDAP、CAS、SAML）会搜索与其关联的登录名，也会搜索未关联的登录名。新版提供程序只会搜索与其明确关联的登录名。这可以是提供程序的整数 ID，也可以是提供程序的类型（在这种情况下，程序会找到第一个匹配的提供程序）。
- first_name^：这是用户的名字（即用户的名字）。如果存在，则用于构建 full_name 和/或 sortable_name。
- last_name^：这是用户的姓氏（last name）。如果存在，则用于构建 full_name 和/或 sortable_name。
- full_name^：这是用户的名字和姓氏。如果已提供 first_name 和 last_name，则省略它们。
- sortable_name^ : 这是 Canvas 中的可排序名称选项，通常是从用户名推断出来的，但也可以自定义。
- short_name^:这是用户的显示名称，通常根据用户名推断，但可以自定义。
- 电子邮件：这是机构分配的电子邮件地址，也将作为此用户帐户的默认电子邮件地址。即使此电子邮件地址与用户的登录 ID 相同，也应提供此电子邮件地址。
- 人称代词：如果启用了人称代词，则会在 Canvas 中用户姓名后显示这些人称代词。人称代词字段接受所有代词，即使它们并非在“帐户设置”页面中创建。
- declared_user_type：此声明的用户类型可以是 administrator、observer、staff、student、student_other 或 teacher。可以传递 "<delete>" 参数来从用户中移除已声明的用户类型。
- canvas_password_notification：默认值为 false。如果设置为 true，且 authentication_provider_id 为 canvas，则会通知用户设置密码。如果您的机构没有 Canvas SIS 集成，则必须填写此字段才能通知新用户其已创建的帐户。
- home_account：将 home_account 设置为 true 将在目标帐户中创建一个新用户以进行 SIS 导入，并将联盟内另一个帐户中具有匹配 integration_id 的现有用户合并到该帐户中。除非目标帐户与自动合并联盟关联，否则此设置将被忽略。
- 状态*^：您可以在此处向 Canvas 添加或删除用户。标记为“启用”以添加用户，标记为“暂停”以暂停用户，标记为“删除”以移除现有用户。
注意： CSV 文件无需包含所有字段。为确保导入成功，您的文件必须包含所有必需的标头，但可选标头（例如 integration_id 或 authentication_provider_id）仅在您提供这些特定字段的数据时才需要包含。
电子邮件地址冲突
Canvas 通过电子邮件地址识别用户。当学生被添加到课程时，Canvas 会在用户首次登录课程时尝试解决任何电子邮件地址冲突。
通常情况下，每个学生的电子邮件地址都是唯一的。但有时，多个学生可能会共用一个电子邮件地址。通过学生信息系统 (SIS) 导入学生到课程时，Canvas 会识别出一个电子邮件地址分配给了多个学生的情况。
- 如果新的 SIS ID 与已分配给现有 SIS ID 的电子邮件地址关联，Canvas 会向该电子邮件地址发送电子邮件。
- 通过学生信息系统 (SIS) 导入将用户添加到帐户时，除非系统检测到重复用户，否则用户不会收到电子邮件通知。但是，如果用户是手动添加或注册的，则会收到电子邮件通知，告知其已被添加或注册到新课程。共享电子邮件地址的学生将收到该电子邮件地址已被使用的通知，并被邀请在 Canvas 中创建新帐户。此流程也可能适用于将用户添加到课程注册的情况。
accounts.csv
在 Canvas 系统中， 账户是组织单元（例如，机构的父账户）。每个账户可以包含多层子账户，例如为机构内的各个学院创建账户，或为学区内的各个学校创建账户。子账户也可以包含多个子账户，例如，当学院细分为系或项目，或学校细分为年级或科目时。
下载包含以下子账户的示例 accounts.csv 文件：
- 您的主账户下有 3 个子账户。（艺术与人文、商业、数学与科学）
- 您的企业子账户下有 4 个子账户。（会计、计算机科学、经济学和市场营销）
- 您的数学与科学子账户下有 3 个子账户。（生物学、物理学和统计学）
- 您的人文艺术子账户下有 1 个子账户。（视觉艺术）
- 您的视觉艺术子账户下有两个子账户。（摄影和数字媒体）
必填项*|粘性场^
- account_id*:这是用于创建子账户的唯一标识符。courses.csv 文件允许您将课程分配给特定的账户 ID。此唯一标识符对于每个账户都必须保持不变，并且在所有账户中必须全局唯一。在 Canvas 用户界面中，这被称为 SIS ID，您可以通过访问每个子账户的“设置”来修改它。
- parent_account_id*^: 此标识符指示子账户应嵌套于此父账户之下。如果此字段为空，则子账户将嵌套于根账户或主账户之下。请注意，即使所有值都为空，也必须包含此列，以便将文件与组导入文件区分开来。
- 姓名*^ ： 这是子账户的名称。
- 地位*：以下是创建或删除子账户的方法。标记为“启用”以添加子账户，标记为“已删除”以删除现有子账户。
- integration_id：这是一个辅助唯一标识符，用于更复杂的 SIS 集成。此标识符对于同一帐户不得更改，且必须全局唯一。
terms.csv
学期为分配到该学期的所有课程提供一组默认的开始和结束日期。课程的学期日期可以在课程级别手动管理，无需导入文件。但是，将一个 term_id 关联到多个不同的课程可以确保该学期内的所有课程同时开始和结束。上传的学期日期还有助于您在管理界面查看数据和报告时对课程进行排序和整理。
下载包含 10 个术语的示例 terms.csv 文件。
必填项*|粘性场^
- term_id*： 这是学期的唯一标识符。courses.csv 文件允许您引用此 term_id，以便您的课程知道何时开始和结束。此标识符在整个学期内不得更改，并且在所有学期中必须全局唯一。在用户界面中，这被称为 SIS ID。
- 姓名*^： 这是您的术语名称。请制定一个良好的命名规则，以便于您轻松引用这些术语。许多管理工具允许您按术语名称搜索或查询数据。
- 地位*： 您可以按以下步骤创建或删除术语。标记为“启用”即可添加术语，标记为“已删除”即可删除现有术语。
- start_date^:这是学期开始的日期。格式应为ISO 8601 ：YYYY-MM-DDTHH:MM:SSZ（ T可以用空格代替，如示例截图所示）。例如，2013 年 8 月 26 日下午 5:00（美国东部时间）应写为 2013-08-26T17:00-5:00。
- end_date^：这是学期结束的日期。格式应为ISO 8601 ：YYYY-MM-DDTHH:MM:SSZ（ T可以替换为空格，如示例屏幕截图所示）。默认情况下，用户访问权限会在您指定的结束日期午夜关闭，这意味着前一天是用户访问学期的最后一个完整工作日。最佳实践是将结束日期设置为学期结束后的第二天。
- integration_id：这是一个辅助唯一标识符，用于更复杂的SIS集成。此标识符在整个生命周期内不得更改，并且必须是全局唯一的。
- date_override_enrollment_type：此设置允许您为现有学期内的特定注册类型设置或移除开始和结束日期。设置后，除 term_id、status、start_date 和 end_date 之外的所有列都将被忽略。如果 status 设置为 active，则学期日期仅适用于指定类型的注册。如果 status 设置为 deleted，则当前为指定注册类型设置的日期将被移除。注册类型可以设置为 StudentEnrollment、TeacherEnrollment、TaEnrollment 或 DesignerEnrollment。
courses.csv
课程是对特定主题的系统性讲解。有时，一门课程可能包含一系列课程。课程被安排在学期内，以创建默认的开始和结束日期。但是，如果课程包含特定的课程日期，这些日期将覆盖学期内由 term_id（如果已设置）标识的学生访问日期。添加 term_id 的好处在于，您可以在管理界面查看数据和报告时对课程进行排序和组织。一个 term_id 可以轻松地关联到多个开始/结束时间相同的课程。如果您未将课程关联到学期，则该课程将关联到名为“默认学期”的学期。
如果您的机构已启用蓝图课程，您可以使用 courses.csv 文件将关联课程添加到蓝图课程中。请注意，必须先创建蓝图课程并将其启用，才能添加关联课程。
下载包含 10 门课程的示例 courses.csv 文件；这些课程位于特定学期的各自子帐户中。
必填项*|粘性场^
- 课程 ID*：这是用于区分 Canvas 中课程的唯一标识符。此标识符在同一课程中不得更改，并且在所有课程中必须全局唯一。在用户界面中，它被称为 SIS ID。
- 简称*^： 这是课程的简称。在 Canvas 用户界面中，它也被称为课程代码或参考代码。
- 长名称*^： 这是课程的完整名称。（它可以与简称相同，但如果两者都可用，同时提供将提供更好的用户体验。）
- account_id^：这是唯一的 SIS ID 账户标识符（来自 accounts.csv 文件），用于指定课程所属的子账户。如果新课程未指定 account_id，则该课程将关联到您的主账户/根账户。SIS ID 可在子账户的设置中找到。
- term_id^：这是唯一的学期标识符（来自 terms.csv 文件），用于告知课程的开始和结束时间。如果已将 term_id 与课程关联，则无需输入 start_date 或 end_date。
- 地位*^： 这是课程状态，也称为 workflow_state。此字段允许您创建、删除、结束或发布课程。标记为“激活”以添加课程，标记为“已删除”以删除现有课程，标记为“已完成”以结束现有课程，或标记为“已发布”以发布新课程或现有课程。
- integration_id：这是一个辅助唯一标识符，用于更复杂的学生信息系统 (SIS) 集成。此标识符在整个课程中不得更改，并且必须是全局唯一的。
- start_date^：这是课程开始的日期。格式应为ISO 8601 ：YYYY-MM-DDTHH:MM:SSZ（ T可以用空格代替。）
- end_date^：这是课程结束的日期。格式应为ISO 8601 ：YYYY-MM-DDTHH:MM:SSZ（ T可以替换为空格）。默认情况下，用户访问权限会在您指定的结束日期午夜关闭，这意味着用户最后一天可以访问课程，即课程结束的前一天。最佳做法是将结束日期设置为课程结束后的第二天。
- course_format ：这是课程的形式。形式可以是线上、线下或混合式。
- blueprint_course_id ：这是您要添加关联课程的蓝图课程的课程 ID。要移除蓝图课程链接，您可以将 ID 替换为“dissociate”。在用户界面中，这是蓝图课程的 SIS ID。
- homeroom_course：用于为 Canvas 小学版账户指定班级课程。需要启用 Canvas 小学版设置。
sections.csv
课程中的班级将学生细分为不同的班级。多个班级可以交叉列在同一门课程中，尤其是在所有班级学习相同课程内容的情况下。多个班级可以设置在同一门课程中，但一个班级不能包含多个班级。班级继承学期设定的课程日期。但是，如果班级包含特定日期，则这些日期将覆盖课程的学生访问日期以及学期的开始和/或结束日期。
如果您要删除课程，并且用户与课程部分相关联，则需要在 CSV 导入中包含 section_id 参数以及课程部分的 SIS ID。
下载包含以下部分的示例 sections.csv 文件：
- ACCT300 - 成本会计课程分为 4 个部分
- ACCT310 - 管理会计课程共分为 4 个部分。
- BIO101 - 生物学导论课程的两个部分
此文件假设您的课程中可能包含多个班级。许多院校会将课程班级作为单独的课程导入。您可以按以下步骤操作：(1) 在 courses.csv 文件中的每个班级创建一个 Canvas 课程；(2) 在每个 Canvas 课程中创建一个班级。课程和班级的数据基本相同，包括 SIS ID，课程 ID 和班级 ID 的 SIS ID 应相同。
必填项*|粘性场^
- section_id*:这是用于在课程中创建班级的唯一标识符。该标识符在同一班级内不得更改，且必须全局唯一。在用户界面中，它被称为学生信息系统 (SIS) ID。
- 课程编号*^： 这是要添加或删除课程章节的唯一标识符（在 courses.csv 中添加）。
- 姓名*^： 这是章节名称。章节按名称字母顺序排列。
- 地位*：以下是如何在课程中创建或删除章节的方法。标记为“启用”即可创建新章节，标记为“已删除”即可删除现有章节。
- integration_id：这是一个辅助唯一标识符，适用于更复杂的 SIS 集成。此标识符在该部分中不得更改，并且必须是全局唯一的。
- start_date^:这是本节开始的日期。格式应为ISO 8601 ：YYYY-MM-DDTHH:MM:SSZ（ T可以用空格代替）。
- end_date^：这是该章节结束的日期。格式应为ISO 8601 ：YYYY-MM-DDTHH:MM:SSZ（ T可以替换为空格）。默认情况下，用户访问权限会在您指定的结束日期午夜关闭，这意味着用户最后一天可以访问该章节。最佳实践是将结束日期设置为该章节结束后的第二天。
注意：导入节 CSV 文件时，如果导入文件中未包含integration_id列，则会保留现有的integration_id值。要删除integration_id ，必须使用change_sis_id.csv文件显式取消设置。
注册.csv
注册是指已注册课程并拥有特定角色的用户。enrollments.csv 文件允许您为用户分配角色并将其分配到相应的课程中。当任何用户的注册状态标记为“已完成”时，该用户对该课程的访问权限将被限制为只读。
注意：包含 start_date 和 end_date 值的 SIS 注册 CSV 文件会覆盖学期日期、课程日期和班级日期。
下载包含以下入学信息的示例 enrollments.csv 文件：
- 1 位用户担任ACCT300 - 成本会计课程的教师
- 1 位用户在ACCT300 - 成本会计课程中担任助教
- 1 位用户作为设计师参与了ACCT300 - 成本会计课程
- 3 名用户作为学生参加了ACCT300 - 成本会计课程的第一部分
- 3 名用户作为ACCT300 - 成本会计课程第二部分的学生
- 1 位用户作为观察员旁听了ACCT300 - 成本会计课程第一部分的学生课程。
必填项*|粘性场^
- course_id*：（如果缺少 section_id，则为必填项） 这是用户将要注册的课程的唯一标识符（已添加到 courses.csv 文件中）。如果要将学生注册到整个课程而不是特定班级，请在此字段中填写 course_id。否则，请留空。
- root_account ：这是要搜索用户的帐户域。
- start_date^:这是注册开始日期。要使 start_date 生效，还需要填写 end_date。格式应为ISO 8601 ：YYYY-MM-DDTHH:MM:SSZ。
- end_date^:这是注册结束日期。要使 end_date 生效，还需要填写 start_date。格式应为ISO 8601 ：YYYY-MM-DDTHH:MM:SSZ。
- 用户身份*：这是将被注册到指定课程的用户的唯一标识符（已添加到 users.csv 文件中）。如果已存在 user_integration_id，则此字段将被忽略。
- user_integration_id*：（如果缺少 user_id，则为必填项）这是用户的辅助唯一标识符（在 users.csv 中添加为 integration_id）。
- 角色*：这是分配给用户在指定课程中的角色。您可以为用户分配以下任意角色：教师、设计者、助教、学生、观察员，或您自定义的角色。每个角色都有一组权限，管理员可以在主账户/根账户或子账户级别进行自定义。
- role_id*：（如果缺少角色，则为必填项）这是用户在注册过程中将被添加的角色的唯一标识符。
- section_id*:（如果缺少 course_id，则此项为必填项） 这是用户将要注册的课程班级的唯一标识符（已添加到 sections.csv 文件中）。如果要将学生注册到课程的特定班级，请在此处填写该班级的 section_id。否则，请将此字段留空。如果未指定 section_id，则将使用该课程的默认班级。如果默认班级不存在，则会自动创建一个，但不会设置 SIS ID。
- 地位*： 以下是如何注册、结束、停用（设为非活跃状态）或移除课程注册的方法。标记为“激活”可将用户注册到课程中，标记为“完成”可结束用户的课程注册，标记为“非活跃”可停用用户在课程中的注册，标记为“删除”可将用户从课程中移除。处于“非活跃”状态时，学生仍会列在教师的课程名单中，但无法查看或参与课程，直到注册状态被激活。
- associated_user_id：（仅限观察员角色）这是观察员可以查看其信息（包括成绩）的用户的唯一标识符。观察员必须与您希望其观察的用户选修同一课程/班级。除观察员角色外，其他任何角色都将被忽略此字段。
- limit_section_privileges：此设置用于指定注册后，用户只能查看和与 course_section_id 指定的班级中的其他学生互动。此字段默认为 false。限制学生按班级互动仅影响协作、聊天、人员和对话功能。注册教师和助教时，班级限制允许他们为同一班级的学生评分。讨论主题和页面不受班级限制，任何学生均可查看。可以通过在课程组中创建内容来限制这些功能区域的访问权限。
- 通知：这是您选择向已注册用户发送课程通知的方式。
注意：在识别受信任帐户中的用户时，建议使用 root_account 字段。
group_categories.csv
群组类别允许您在 Canvas 中组织群组。group_categories.csv 文件允许您在帐户或课程级别创建群组类别。在用户界面中，群组类别被称为群组集。
下载包含以下分组类别的示例 group_categories.csv文件：
必填项*|粘性场^
- group_category_id：这是用于引用组类别的标识符。该标识符对于同一组类别不得更改，且必须全局唯一。
- account_id：这是将群组类别关联到帐户的标识符（在 accounts.csv 文件中添加）。如果未指定帐户或课程，则该群组将关联到根帐户。
- course_id：这是将分组类别关联到课程的标识符（在 courses.csv 文件中添加）。如果未指定课程或帐户，则该分组将关联到根帐户。
- category_name*^ : 这是分组类别的名称。
- 地位*：这是分组类别的状态。标记为“启用”以创建分组类别，标记为“已删除”以删除分组类别。
groups.csv
群组可用于为学生、教师、管理员或其他用户提供协作机会。groups.csv 文件允许您创建课程级和账户级群组。通过学生信息系统 (SIS) 上传的群组只能通过 SIS 进行更新或删除。
下载包含以下分组的示例 groups.csv 文件：
必填项*|粘性场^
- group_id*：这是用于引用您所在组的唯一标识符。该标识符对于同一组而言不得更改，并且必须是全局唯一的。
- group_category_id：这是您要添加群组的群组类别（在 group_categories.csv 文件中添加）的标识符。如果未指定群组类别，则该群组将被放置在已定义帐户或课程的默认群组类别中。如果未指定帐户或课程，则该群组将被放置在根帐户的默认群组类别中。
- account_id：这是将组关联到帐户的标识符（在 accounts.csv 文件中添加）。如果未指定，则组将关联到根帐户。
- course_id：这是将群组关联到课程的标识符（在 courses.csv 文件中添加）。如果未指定课程或帐户，则该群组将关联到根帐户。
- 姓名*^： 这是该组织的名称。
- 地位*：这是群组的状态。标记为“可用”可开放群组成员资格，标记为“已删除”可删除群组。
groups_membership.csv
加入群组后，用户可以在 Canvas 中协作完成活动。使用 groups_membership.csv 文件，您可以批量添加或移除通过 groups.csv 创建的群组成员。
下载包含以下组成员关系的示例 groups_membership.csv文件：
- 管理员组中有 1 位已接受的用户
- 数学教师组有 1 位已接受的用户
- 数学教师组中有 1 位用户被删除
必填项*
- group_id*：这是用于引用您的组的唯一标识符（已添加到 groups.csv 中）。
- 用户身份*：这是要添加到组的用户的唯一标识符（已添加到 users.csv 中）。
- 地位*：这是用户在群组中的状态。标记为“已接受”可将用户添加到群组，标记为“已删除”可将用户从群组中移除。
xlists.csv
跨课程列表功能允许您将课程章节移至其他课程。您可以使用 xlist.csv 文件将课程章节跨课程列表到现有课程中，并创建章节层级结构。
课程章节 ID 必须已存在，并且已引用其他课程 ID。如果此文件中提供了课程章节 ID，则会将其从现有课程 ID 移动到新的课程 ID。这样，如果新课程被移除或跨课程列表被移除，该章节将恢复到之前的课程 ID。如果 xlist_course_id 未引用现有课程，则会创建该课程。如果您想提供有关跨课程列表课程的更多信息，请在 courses.csv 文件中进行填写。
下载包含以下课程和班级的示例 xlists.csv 文件：
- ACCT300（成本会计）课程的 4 个活跃部分已并入ACCT310（管理会计）课程。
必填项*
- xlist_course_id*:这是新课程的标识符（已添加到 courses.csv 中）。
- section_id*:这是该部分的标识符（在 sections.csv 中添加）。
- 地位*：这是该版块的状态。标记为“启用”可启用该版块，标记为“删除”可移除该版块。
user_observers.csv
观察员角色可用于注册家长并将其与学生关联，允许他们查看学生的成绩和课程互动情况。user_observers.csv 文件允许您注册观察员并将其与指定学生的每个注册信息关联起来。
下载包含以下注册信息的示例 user_observers.csv文件：
必填项*
- observer_id*：这是观察者的唯一标识符（在 users.csv 中添加为 user_id）。
- 学生ID*：这是学生的唯一标识符（已添加到 users.csv 文件中，作为 user_id）。
- 地位*：这是观察员的状态。标记为“启用”可将观察员添加到每位学生的注册信息中，标记为“删除”则移除该观察员的所有注册信息。
logins.csv
logins.csv 文件允许您创建或更新用户的登录凭据。登录凭据只能添加到现有用户。登录凭据可以使用 users.csv 文件删除。
下载包含三个用户登录信息的示例 logins.csv 文件。
必填项*|粘性场^
- 用户身份*：这是用户的唯一标识符（在 enrollments.csv 文件中引用）。该值对于每个用户都必须保持不变，并且在所有用户中必须是唯一的。在 Canvas 用户界面中称为 SIS ID。
- integration_id：这是一个辅助唯一标识符，用于复杂的 SIS 集成。此值对于每个用户都必须保持不变，并且在所有用户中必须唯一。合并具有匹配集成 ID 的用户时，此字段应留空。
- 登录 ID*：这是用户登录 Canvas 时使用的名称。对于已配置的身份验证服务（例如 LDAP），这将是远程系统的用户名。
- 密码：这是用户登录 Canvas 时使用的密码。对于配置为 LDAP 或 SSO 的帐户，此字段不应填写。
- ssha_password：这是使用预哈希 SSHA 生成方案生成的密码。
- authentication_provider_id：这是登录所关联的身份验证提供程序。
- existing_user_id^:这是用户的 SIS ID，可在 users.csv 文件中找到。
- existing_integration_id^:这是用户的集成 ID，可在 users.csv 文件中找到。
- existing_canvas_user_id^:这是用户的 Canvas ID。
- root_account：这是用户的域帐户。
- 电子邮件：这是用户的电子邮件地址。
笔记：
- existing_user_id、existing_integration_id 或 existing_canvas_user_id*：（成功导入 logins.csv 时必需）
- root_account*：（在识别用户时需要）受信任账户例如，在受信任帐户内跨帐户交叉列出用户时）。
- 状态*：（使用 logins.csv 执行 SIS 导入时必填）
admins.csv
管理员负责管理整个账户或子账户的设置。admins.csv 文件允许您在 Canvas 中将用户指定为账户管理员或其他自定义账户或子账户角色。
下载包含以下管理员的示例 admins.csv 文件：
- 2 个活跃账户管理员
- 1 个已删除的管理员帐户
- 2 个活跃的自定义帐户角色
必填项*
- 用户身份*： 这是您要指定为管理员的用户的唯一 ID（已添加到 users.csv 中）。
- account_id*: 这是您希望管理员所在的帐户的唯一标识符（已添加到 accounts.csv 文件中）。如果此列留空，则用户将位于根帐户中。即使值为空，此列也始终是必填项。
- role_id*：（如果角色缺失，则为必填项）这是角色的 ID，可以是默认 ID，也可以是帐户定义的自定义 ID。
- role*：（如果缺少 role_id，则为必填项）这是角色名称，可以是默认的账户管理员角色，也可以是账户定义的自定义角色。如果要添加账户管理员，请将此字段格式化为“AccountAdmin”。如果要添加自定义角色，请将此字段格式化为与 Canvas UI 中显示的内容完全一致。
- 地位*： 这是管理员的状态。标记为“活跃”以创建一个活跃管理员，标记为“已删除”以移除管理员。
- root_account：这是要搜索用户的帐户域。
change_sis_id.csv
SIS ID 是 Canvas 中对象的唯一标识符。change_sis_id.csv 文件允许您批量更改现有帐户、学期、课程、班级、小组或用户的 SIS ID。
下载包含以下 SIS ID 更改的示例 change_sis_id.csv 文件：
- 1. 用户 SIS ID 变更
- 1. 课程 SIS ID 变更
- 1. SIS ID 变更
必填项*
- old_id*: 这是该对象的当前SIS ID。
- new_id*： 这是该对象所需的 SIS ID。新的 SIS ID 必须对对象类型和根帐户保持唯一性。
- 类型*： 这是对象类型。类型可以是帐户、学期、课程、班级、组或用户。