CSV File Format for SDS
You can use CSV (comma separated value) files in the SDS format to synchronize your School Information System (SIS) with Office 365. When using SDS format CSV Files for School Data Sync, the files must be appropriately formatted. This section describes the formatting requirements for use with SDS.The only absolutely required fields are highlighted in green below. This also ties over to the example information on our CSV File Samples page. You must have the following 6 CSV files named exactly as detailed below. To review and download sample set of CSV files in the SDS format, see the SDS GitHub Repository.
Each CSV file must contain all required fields highlighted in green below. Each CSV file may also contain any of the optional fields listed as well. If your CSV files contain any unsupported characters, they can be replaced inline during sync by selecting the "Replace Unsupported Special Characters" option within the SDS Sync Profile Setup Wizard. This however will not remove "white spaces" which are also not valid. The tables below list the required and optional attributes on a file by file basis:
Microsoft recommends using the ISO 8601 format for all dates fields in the SDS CSV files, in the form of YYYY-MM-DD or YYYYMMDD. SDS is planning to introduce features in coming months which will require this format within the Term Start and End Date fields noted below.
- Students.csv > Birthdate
- Sections.csv > Term StartDate
- Sections.csv > Term EndDate
If you are using Sync to Insights – Preview and you wish to pass grade values for Student and/ or Teachers, you must use the correct ENUM. If you do not use the correct ENUM, you will receive an error. For more information, please see SDS Errors.