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 | Sí | 456789 | Unique ID |
| Nombre | Sí | 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 | Sí | 123456 | Unique ID |
| Id. de SCHOOL SIS | Sí | 456789 | Unique ID |
| Nombre de usuario | Sí | 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 | Sí | 654321 | Unique ID |
| Id. de SCHOOL SIS | Sí | 456789 | Unique ID |
| Nombre de usuario | Sí | 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 | Sí | 334455 | Unique ID |
| Id. de SCHOOL SIS | Sí | 456789 | Unique ID |
| Nombre de sección | Sí | 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 | Sí | 334455 | Unique ID |
| IDENTIFICADOR DE SIS | Sí | 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 | Sí | 334455 | Unique ID |
| IDENTIFICADOR DE SIS | Sí | 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 | Sí | jsmith@outlook.com | Correo electrónico |
| Nombre | Sí | Pelayo | Cadena |
| Apellido | Sí | 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 | Sí | 123456 | Unique ID |
| Correo electrónico | Sí | 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".