什么时候 配置排班表对于 OneRoster 集成,您应该同时支持排班服务配置并遵守最佳实践指南。
遵循最佳实践指南进行集成,可确保正确的排班数据传输,并消除注册更正方面的猜测。
笔记:Instructure 是 OneRoster 的消费者。有关 OneRoster 消费者和提供者的定义,请参阅[此处]。OneRoster简介。
学年/学期
如果您的学生信息系统 (SIS) 使用通用术语 ID 对术语进行分组,请在 API 响应中包含该通用术语 ID。如果需要在 Canvas 中合并术语,可以使用该通用术语 ID 来识别术语。
了解更多关于 OneRoster 的信息学期规定.
例子 |
|---|
{
“title”: “A 707 07/08”
“sourcedId”: “{hash}-{schoolId}-{termIdentifer}”
...
}
|
可用数据集
设置 OneRoster 数据提取的截止日期,涵盖本学年内所有历史数据和未来数据(具体定义以系统为准)。此外,请确保数据提取中包含所有数据对象,并设置必要的截止日期,以避免目标系统中的数据被意外删除。
了解更多关于 OneRoster 的信息排班终点 和 排班终点合规性。
重复的入学记录
如果用户对同一课程有多个报名记录,则仅提供当前的报名记录。
例如,如果学生 A 在 123 班注册了该课程,然后被移除,之后又重新注册,则在进行 API 调用时提供最合适的注册状态,而不是提供学生 A 的多个注册记录。
报名开始和结束日期
每条注册记录都必须包含开始日期和结束日期,即使这些日期与学期日期相同。通过比对注册日期和学期日期,Canvas 可以维护正确的注册状态。
获取所有用户/用户
如果您的机构支持使用 Canvas 观察员角色(例如家长、监护人等),建议您将这些用户配置文件添加到您的实施配置中。
增量数据同步
您可以配置增量数据同步,而不是使用完整的数据拉取。最后修改日期查询筛选条件。
笔记:为了可靠地实现增量数据同步,您必须包含每条注册记录的删除状态或结束日期。如果没有此信息,则只能通过将新的完整数据同步与之前的完整数据同步进行比较来计算注册人数下降情况。