Formato de archivo CSV SDS V1

Puede usar archivos CSV (valores separados por comas) en el formato SDS V1 para sincronizar el sistema de información escolar (SIS) con Office 365. El uso del formato de archivo CSV SDS V1 para ingerir las categorías de datos le permite iluminar las funcionalidades básicas de SDS para el aprovisionamiento. También le ayuda a mejorar las experiencias de los productos y características de Microsoft 365.

Si usa el formato SDS V1, los archivos deben tener el formato adecuado. Cargue los archivos, denominados exactamente como se detalla en este artículo. Los encabezados de columna distinguen mayúsculas de minúsculas. Los archivos CSV deben estar en formato UTF-8 y deben ser compatibles con RFC. Tampoco aceptamos saltos de línea en los datos entrantes. Para revisar y descargar el conjunto de ejemplo de archivos CSV SDS V1, consulte el repositorio de GitHub de SDS.

Obligatorio: se deben seleccionar los tres archivos siguientes para poder avanzar. Si solo administra usuarios y no clases, solo debe proporcionar estos archivos.

• school.csv

• student.csv

• teacher.csv

Opcional o obligatorio: no es necesario si solo se administran los usuarios. Si también administra clases e inscripciones de clases, debe proporcionar los tres archivos siguientes, junto con los tres archivos mencionados anteriormente. Si no lo está, no seleccione ningún archivo con estos nombres.

• section.csv

• studentenrollment.csv

• teacherroster.csv

Opcional: los siguientes archivos no son necesarios para continuar, pero podrían mejorar las experiencias. Si se selecciona uno de los siguientes archivos, también se debe seleccionar el otro para continuar.

• user.csv

• guardianrelationship.csv (Requiere el registro de usuario y alumno para crear la asociación de contactos).

Cada archivo CSV debe contener datos para los campos que se indican en "Sí" en "Obligatorio", los campos que se indican como "No" son datos "Opcionales". Los encabezados de campo marcados como "Obligatorio" deben existir en los archivos proporcionados o no se aceptarán. Los encabezados de campo marcados como "Opcional" no son necesarios para estar presentes en los archivos si no se pasan los datos opcionales correspondientes.

Los campos con valores enumerados definidos como marcados en la columna "Tipos de datos" tienen un conjunto específico de valores que admiten. El conjunto admitido de valores predeterminados para los campos de enumeración consulte Lista predeterminada de valores.

school.csv

• Todas las organizaciones enumeradas se establecerán en el tipo de organización "school".

student.csv

• Requiere una referencia a la escuela asociada mediante el campo "School SIS ID" y genera una dependencia en el archivo school.csv.
• Todos los usuarios enumerados se establecerán en el tipo de rol "student".
• Espere que los valores de fecha se proporcionen en formato ISO8601.
• Los ceros iniciales '0' que faltan en el valor entrante de LAUM de nivel de calificación, por ejemplo'1', coincidirán con la lista de valores (ENUM) '01' definida y se almacenarán como '01'.

teacher.csv

• Requiere una referencia a la escuela asociada mediante el campo "School SIS ID", lo que genera una dependencia en el archivo school.csv.
• Todos los usuarios enumerados se establecerán en el tipo de rol "teacher".
• Faltan ceros iniciales "0" en el valor entrante para la ENUMERAción de nivel de grado. Por ejemplo, '1' coincidirá con la lista de valores (ENUM) '01' definida y se almacenará como '01'.

section.csv

• Requiere una referencia a la escuela asociada mediante el campo "School SIS ID", lo que genera una dependencia en el archivo school.csv.
• Si se necesita información del término, se recomienda pasar al formato CSV sds v2.1 y también proporcionar academicSessions.csv archivo.

studentenrollment.csv

• Esto requiere una referencia a la sección asociada mediante el campo "Section SIS ID" (Id. de SIS de sección) y genera una dependencia en el archivo section.csv.
• Esto requiere una referencia al usuario asociado mediante el campo "ID de SIS" y genera una dependencia en el archivo student.csv.

teacherroster.csv

• Esto requiere una referencia a la sección asociada mediante el campo "Section SIS ID" (Id. de SIS de sección) y genera una dependencia en el archivo section.csv.
• Esto requiere una referencia al usuario asociado mediante el campo "ID de SIS" y genera una dependencia en el archivo teacher.csv.

user.csv

• Si también está sincronizando relaciones de contacto (tutores), debe incluir un registro para ellos en el user.csv.
• Espere que el campo de teléfono se formatee según el estándar E.164, donde el carácter más se usa y se ejecuta correctamente con el número de teléfono, o el carácter más seguido del código de país, el código de área, el prefijo de teléfono y el número de línea.

guardianrelationship.csv

• Si también está sincronizando relaciones de contacto (tutores), debe incluir un registro para ellos en el user.csv.
• Esto requiere una referencia al usuario asociado mediante el campo "Email" y genera una dependencia en el archivo user.csv.
• Esto requiere una referencia al usuario asociado mediante el campo "ID de SIS" y genera una dependencia en el archivo student.csv.
• Si no se proporciona el valor de rol, el valor de relación predeterminado es "userContact".