CSV 网关是一种将 CSV 文件自动导入 Canvas 的方法。文件通过安全文件传输协议 (SFTP) 进行传输。如果您的学生信息系统 (SIS) 没有与 Canvas 的直接 API 集成连接，CSV 网关将特别有用。
如果您有兴趣设置用于数据供应或成绩导出的 CSV 网关/SFTP，请联系您的 Instructure 客户成功经理 (CSM)。
你应该知道
- CSV 文件必须符合 Canvas CSV 格式指南。有关 Canvas CSV 格式的更多信息，请参阅：我们的指南。
- 标准 CSV 规则适用：
- 第一行被视为标题行，是必填项。
- 文件中的所有文本必须采用 UTF-8 编码。
- 所有时间戳均应采用 ISO 8601 格式。除非指定时区偏移量，否则所有时间戳默认为 UTC 时间。
- 数据导入并非实时进行，同步任务是按计划进行的。同步频率取决于您的数据集，您可以与您的 Instructure 顾问详细讨论。最常见的计划同步频率是每天一到两次。
- 可选的等级出口报告可以安排每天一次将其放入网关。
- A差异目录可根据要求进行配置。差异导入功能会查找已交付文件中的更改，并对任何缺失的记录采取相应措施。如果您有兴趣配置此功能，您的 Instructure 顾问可以在配置过程中提供更多信息。
- SFTP 配置完成并同步到生产环境后，客户需要联系支持部门进行故障排除和/或对 SFTP 进行任何配置更改。
我该如何开始？
首先，客户必须确定由谁来托管SFTP服务器。托管SFTP服务器有两种选择。
- Instructure 可以托管服务器
- 客户托管 SFTP 服务器
客户负责根据 Canvas CSV 规范创建包含其数据的 CSV 文件，并将这些文件上传到 SFTP 服务器。Instructure 将根据预定任务处理这些上传的文件。
CSV 网关最初将连接到客户的 Canvas Beta 版本进行初步测试。在客户向其 Instructure 顾问提供书面确认以完成测试之前，连接不会切换到客户的 Canvas 生产版本。
Instructure托管服务器
如果 Instructure 托管 SFTP 服务器，客户需要生成 SSH 密钥对。公钥将发送给您的 Instructure 顾问。
私钥不应共享。如果私钥被共享，Instructure 将请求生成新的密钥对。
生成 SSH 密钥对时，请注意以下事项：
- Instructure 要求密钥的最小比特长度为 2048。
- 公钥通常具有以下扩展名之一：.pub、.pem
- 某些密钥格式会将私钥与公钥一起提供，请仅发送公钥，否则需要重新生成密钥对。
公钥与 Instructure 顾问共享并上传到 SFTP 服务器后，客户将获得以下信息：
客户端托管服务器
如果客户选择自行托管SFTP服务器，则需要向Instructure提供连接信息。
请勿通过电子邮件发送此信息。
您的 Instructure 顾问将为您提供一个安全链接，供您上传包含以下信息的 .txt 文件：
除了向您的 Instructure 顾问提供所需信息外，客户可能还需要将 Instructure 的 IP 地址添加到允许列表中。您的 Instructure 顾问会为您提供所需信息。如果 Instructure 无法连接到远程 SFTP 服务器，则可能需要在客户的托管服务器上进行额外的配置/调整。