Compartir a través de


Formato de archivo CSV SDS V1

Importante

CLIENTES DE TRANSICIÓN DE SDS (clásico): no se admiten todos los campos para incorporar datos a la nueva experiencia de SDS en función del formato v1. Los encontrará anotados en formato de archivo CSV SDS v1 en la columna ¿Se requieren? como datos no admitidos.

Importante

Además, los valores de grado y los valores de Sujeto del curso pasados deben alinearse con sus códigos de lista de valores (ENUM) correspondientes. Si es necesario, use Administrar lista de valores para expandir Los valores de grado y Curso sujeto para admitir valores de código no admitidos de forma predeterminada.

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 siguientes 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 a continuación. 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.

Importante

Después de la carga inicial durante la creación del flujo de entrada, deberá proporcionar siempre el mismo conjunto de archivos para cargas posteriores, independientemente de los cambios de datos realizados en los archivos opcionales o no. Si no lo hace, el sistema determinará que los registros ya no están activos y los marcará como tales.

Obligatorio: los tres archivos que se enumeran a continuación deben seleccionarse 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 está administrando las clases y las inscripciones de clases, debe proporcionar los tres archivos que se enumeran a continuación, junto con los tres archivos anteriores. Si no lo está, no seleccione ningún archivo con estos nombres.

  • section.csv

  • studentenrollment.csv

  • teacherroster.csv

Opcional: no son necesarias para continuar, pero pueden mejorar las experiencias. Si se selecciona uno de los archivos siguientes, 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

Campo ¿Necesario? Ejemplo Tipo de datos
IDENTIFICADOR DE SIS 456789 Unique ID
Nombre Contoso High School Cadena
ID_NCES de la escuela No 456789 Cadena
Número de escuela datos no admitidos
Grado bajo datos no admitidos
Grado alto datos no admitidos
Id. de estado datos no admitidos
Id. de SIS de director datos no admitidos
Nombre del director datos no admitidos
Correo electrónico secundario del director datos no admitidos
Dirección datos no admitidos
Ciudad datos no admitidos
Estado datos no admitidos
Zip datos no admitidos
País datos no admitidos
Phone datos no admitidos
Zona datos no admitidos
  • Todas las organizaciones enumeradas se establecerán en el tipo de organización "school".

student.csv

Campo ¿Necesario? Ejemplo Tipo de datos
IDENTIFICADOR DE SIS 123456 Unique ID
Id. de SCHOOL SIS 456789 Unique ID
Nombre de usuario jsmith@contoso.edu Cadena
Nombre Sí (solo si se crean usuarios) Pelayo Cadena
Apellido Sí (solo si se crean usuarios) Díaz Cadena
Segundo nombre No Guillermo Cadena
Correo electrónico secundario No jsmith@contoso.edu Correo electrónico
Número de alumno No 123456 Cadena
Grado No 8 Enum
Fecha de nacimiento No 2009-12-19 Fecha
Estado datos no admitidos
Password datos no admitidos
Año de graduación datos no admitidos
Id. de estado datos no admitidos
  • Requiere una referencia a la escuela asociada mediante el campo "School SIS ID". Esto 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.

teacher.csv

Campo ¿Necesario? Ejemplo Tipo de datos
IDENTIFICADOR DE SIS 654321 Unique ID
Id. de SCHOOL SIS 456789 Unique ID
Nombre de usuario jcook@contoso.edu Cadena
Nombre Sí (solo si se crean usuarios) Jane Cadena
Apellido Sí (solo si se crean usuarios) Cocinar Cadena
Segundo nombre No Meredith Cadena
Número de profesor No 654321 Cadena
Grado No 8 Enum
Correo electrónico secundario No jcook@contoso.edu Correo electrónico
Estado datos no admitidos
Password datos no admitidos
Título datos no admitidos
Id. de estado datos no admitidos
Cualificación datos no admitidos
  • Requiere una referencia a la escuela asociada mediante el campo "School SIS ID". Esto genera una dependencia en el archivo school.csv.
  • Todos los usuarios enumerados se establecerán en el tipo de rol "teacher".

section.csv

Campo ¿Necesario? Ejemplo Tipo de datos
IDENTIFICADOR DE SIS 334455 Unique ID
Id. de SCHOOL SIS 456789 Unique ID
Nombre de sección Período 1- Historia mundial Cadena
Número de sección No 334466 Cadena
ID de SIS del curso No 123456789 Unique ID
Nombre del curso No Historia mundial 10 Cadena
Número de curso No 123456789 Cadena
Descripción del curso No Historia del mundo Cadena
Tema del curso No 54999 Enum
Id. de SIS del trimestre datos no admitidos
Nombre de trimestre datos no admitidos
FechadeInicio de trimestre datos no admitidos
FechadeFin del trimestre datos no admitidos
Estado datos no admitidos
Periods datos no admitidos
  • Requiere una referencia a la escuela asociada mediante el campo "School SIS ID". Esto 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

Campo ¿Necesario? Ejemplo Tipo de datos
Identificador de SIS de sección 334455 Unique ID
IDENTIFICADOR DE SIS 123456 Unique ID
  • Esto requiere una referencia a la sección asociada mediante el campo "Section SIS ID" (Id. de SIS de sección). Esto genera una dependencia en el archivo section.csv.
  • Esto requiere una referencia al usuario asociado mediante el campo "SIS ID". Esto genera una dependencia en el archivo student.csv.

teacherroster.csv

Campo ¿Necesario? Ejemplo Tipo de datos
Identificador de SIS de sección 334455 Unique ID
IDENTIFICADOR DE SIS 654321 Unique ID
  • Esto requiere una referencia a la sección asociada mediante el campo "Section SIS ID" (Id. de SIS de sección). Esto genera una dependencia en el archivo section.csv.
  • Esto requiere una referencia al usuario asociado mediante el campo "SIS ID". Esto genera una dependencia en el archivo teacher.csv.

user.csv

Campo ¿Necesario? Ejemplo Tipo de datos
Correo electrónico jsmith@outlook.com Correo electrónico
Nombre Pelayo Cadena
Apellido Díaz Cadena
Phone No +1234567890 Phone
IDENTIFICADOR DE SIS No P_123456 Unique ID
  • 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 tenga el formato 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 más bien 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

Campo ¿Necesario? Ejemplo Tipo de datos
IDENTIFICADOR DE SIS 123456 Unique ID
Correo electrónico jsmith@outlook.com Correo electrónico
Role No Parent Enum
  • 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". Esto genera una dependencia en el archivo user.csv.
  • Esto requiere una referencia al usuario asociado mediante el campo "SIS ID". Esto genera una dependencia en el archivo student.csv.
  • Si no se proporciona el valor de rol, el valor de relación predeterminado es "userContact".