SDS 的 CSV V1 文件格式

  • 项目

可以使用 CSV (逗号分隔值) SDS 格式的文件，将学校信息系统 (SIS) 与Office 365同步。 使用 SDS V1 CSV 文件格式引入以下数据类别，可以照亮用于预配的核心 SDS 功能。 它还允许你增强以下列出的 Microsoft 365 (Microsoft 365) 产品和功能的体验。

SDS CSV V1 的核心功能图表。

使用 SDS 格式 CSV 文件进行学校数据同步时，必须适当设置文件的格式。 本部分介绍用于 SDS 的格式设置要求。 CSV 文件必须采用 UTF-8 格式。 下面以绿色突出显示唯一 的绝对必填 字段。 这也与 CSV 文件示例 页上的示例信息有关。 必须具有以下 6 个 CSV 文件，具体命名如下所述。 若要查看和下载 SDS 格式的示例 CSV 文件集，请参阅 SDS GitHub 存储库。

student.csv

teacher.csv

school.csv

section.csv

studentenrollment.csv

teacherroster.csv

每个 csv 文件都必须包含必填字段。

每个 CSV 文件必须包含以下 绿色突出显示 的所有必填字段。 每个 CSV 文件还可以包含列出的任何可选字段。 如果 CSV 文件包含任何不受支持的字符，则通过在 SDS 同步配置文件安装向导中选择“替换不支持的特殊字符”选项，可以在同步期间内联替换这些字符。 但是，这不会删除“空格”，这些空格也无效。 下表按文件列出了文件中的必需属性和可选属性：

注意

Microsoft 建议对 SDS CSV 文件中的所有日期字段使用 ISO 8601 格式 ，格式为 YYYY-MM-DD 或 YYYYMMDD。 SDS 计划在未来几个月内引入功能，这些功能要求在下文所述的“期限开始日期”和“结束日期”字段中采用此格式。

  • >Students.csv 出生日期
  • >Sections.csv Term StartDate
  • >Sections.csv 术语结束日期

对所有日期字段使用 ISO 8601 格式。

sds 计划在未来几个月内推出功能。

使用正确的枚举。

![如果不使用正确的枚举，将收到单独的枚举]。] (图像/School-Data-Sync-format-CSV-files-for-SDS-5.png)

见解验证过程。

有关见解数据运行状况和监视，请参阅 sds。