Formato de archivo CSV SDS (clásico) V2.1
Funcionalidades básicas de SDS y características de Microsoft 365 por método de ingesta
Puede usar archivos CSV (valores separados por comas) en el formato SDS V2.1 para sincronizar el sistema de información escolar (SIS) con Office 365. El uso del formato de archivo CSV SDS V2.1 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 enumerados.
Nota:
Los clientes actuales del formato CSV V2 pueden seguir usando hasta mayo de 2022. Se recomienda usar el formato CSV V2.1 con sus funcionalidades adicionales.
Los archivos SDS V2.1 deben tener el formato adecuado. Cargue los cinco archivos, denominados exactamente como detallados. Los archivos y los encabezados de columna distinguen mayúsculas de minúsculas. Los archivos CSV deben estar en formato UTF-8. Para revisar y descargar el conjunto de ejemplo de archivos CSV SDS V2.1, consulte el repositorio de GitHub de SDS.
Cada archivo CSV debe contener todos los campos obligatorios resaltados en verde. Los campos no resaltados son opcionales. Aunque el contenido de determinados atributos puede ser opcional, se requieren los encabezados de columna. Los atributos con valores enumerados definidos como marcados en la columna Tipos tienen un conjunto específico de valores que admiten. El conjunto admitido de valores enumerados para cada atributo se encuentra en la sección siguiente.
*Para filtrar solo por "escuela"
Si crea usuarios:
El campo de nombre de usuario requiere que sds acepte el dominio. Por ejemplo, cbean@domain.com.
FamilyName, givenName y email son necesarios para los usuarios que tienen roles de tutor en relationships.csv. Los usuarios que son personal, pero también contactos, se recomienda que tengan dos registros de usuarios en la lista, con el registro de usuario de contactos asociado a su dirección de correo electrónico privada.
Espere que el teléfono y los sms estén en E.164. El aprovisionamiento de SDS no generará errores en el teléfono o sms si no está alineado con E.164. La validación elimina () -, espacios, puntos (.) y conserva + si está presente en la parte delantera del valor proporcionado.
*Sincroniza solo un valor con el aprovisionamiento de SDS si se encuentran varios valores en el registro.
Valores enumerados admitidos
En el formato SDS V2.1, hay atributos definidos como valores enumerados, lo que significa que solo puede proporcionar un conjunto seleccionado de valores dentro de los archivos CSV. Cualquier cosa que no sea los valores especificados producirá un error durante el procesamiento de sincronización. En la sección se definen los valores enumerados admitidos en el formato SDS V2.1.
El users.csv contiene el atributo "role" y admite los valores de enumeración.
| Roles de organización de usuario | ||
|---|---|---|
| Estudiante | TeacherAssistant | Director |
| Proctor | Plantilla | SpecialServices |
| Profesor | Profesor | Asesor |
| ItAdmin | Investigador | asistente |
| OfficeStaff | Profesor | Silla |
| Enfermera | Afiliado | Adjunto |
| OccupationalTherapist | Egresados | Sustituir |
| Instructor | Tutor | Paraprofesional |
| PhysicalTherapist | Facultad | Administrador |
| SpeechTherapist | VisionTherapist | Otros |
El orgs.csv contiene el atributo "type" y admite los valores de enumeración.
| Tipos de organización | ||
|---|---|---|
| Escuela | MinistryOfEducation | LocalAuthority |
| Departamento | Universidad | Región |
| Distrito | Universidad | División |
| Local | Campus | Provincia |
| Estado | AdultEducation | ResearchCenter |
| Nacional | Municipio | Programa |
| DepartmentOfEducation | AcademicTrust |
El demographics.csv contiene el atributo "estado de nacimiento" y admite los valores de enumeración.
| Estado | ||
|---|---|---|
| AK | LA | OR |
| AL | MA | PA |
| AR | MD | PR |
| AS | YO | PW |
| AZ | MH | RI |
| CA | MI | SC |
| CO | MN | SD |
| CT | MO | TN |
| DC | MP | TX |
| DE | SRA | UT |
| FL | MT | VA |
| FM | NC | VI |
| GA | ND | VT |
| GU | NE | WA |
| HOLA | NH | WI |
| IA | NJ | WV |
| Id. | NM | WY |
| IL | NV | AA |
| EN | NY | AE |
| KS | OH | AP |
| KY | Aceptar |
El academicSessions.csv contiene el atributo "type" de la sesión académica y admite los valores de enumeración.
| Tipos de sesión académica | ||
|---|---|---|
| SchoolYear | Semestre | Término |
El demographics.csv contiene el atributo "sex" y admite los valores de enumeración.
| Sexo | ||
|---|---|---|
| Masculino | Femenino | No seleccionado |
El academicSessions.csv contiene el atributo "año escolar" y admite los valores de enumeración.
| Año escolar | ||
|---|---|---|
| 2021 | 2025 | 2029 |
| 2022 | 2026 | 2030 |
| 2023 | 2027 | 2031 |
| 2024 | 2028 |
El relationships.csv contiene el atributo "rol de relación" y admite los valores de enumeración.
| Roles de relación | ||
|---|---|---|
| Parent | Guardián | Ayudante |
| Relative | Child | Administrador |
| Médico | Otros |
El enrollments.csv contiene el atributo "role" y admite los valores de enumeración.
| Roles de inscripción | ||
|---|---|---|
| Estudiante | VisionTherapist | Sustituir |
| Ayudante | Paraprofesional | Director |
| Proctor | TeacherAssistant | SpecialServices |
| Profesor | Profesor | Tutor |
| Administrador | Profesor | Asesor |
| OccupationalTherapist | Afiliado | Asistente |
| PhysicalTherapist | Adjunto | Plantilla |
| SpeechTherapist | Instructor |
El Courses.csv contiene el atributo "subject" de la sesión académica y admite los valores de enumeración.
| Tema del curso | Descripción |
|---|---|
| 01 | Inglés y literatura |
| 02 | Matemáticas |
| 03 | Ciencias físicas y de vida |
| 04 | Ciencias Sociales e Historia |
| 05 | Artes visuales y escénicas |
| 07 | Educación religiosa y teología |
| 08 | Educación física, de salud y seguridad |
| 09 | Ciencia militar |
| 10 | Tecnología de la información |
| 11 | Tecnología de comunicación y audio/visual |
| 12 | Negocio y marketing |
| 13 | Industria |
| 14 | Ciencias del cuidado de la salud |
| 15 | Servicio público, de protección y de gobierno |
| 16 | Hostelería y turismo |
| 17 | Arquitectura y construcción |
| 18 | Agricultura, alimentación y recursos naturales |
| 19 | Servicios humanos |
| 20 | Transporte, distribución y logística |
| 21 | Ingeniería y tecnología |
| 22 | Varios |
| 23 | No específico del sujeto |
| 24 | Idiomas del mundo |
El userFlags.csv contiene el atributo "flag" y admite los valores de enumeración.
| Marcas de usuario | Descripción |
|---|---|
| FreeLunch | Almuerzo gratis |
| ReducedLunch | Almuerzo reducido |
| Sin hogar | Sin hogar |
| GiftedOrTalented | Talentosos o talentosos |
| 504 | Sección 504 Colocación |
| ELL | Aprendiz de idioma inglés |
| LEP | Dominio limitado del inglés |
| IEP | Servicios de educación especial /Plan de educación independiente elegible |
El demographics.csv contiene el atributo "ethnicity" y admite los valores de enumeración.
| Origen étnico | Descripción |
|---|---|
| HispanicOrLatinoEthnicity | Origen hispano o latino |
El demographics.csv contiene el atributo "race" y admite los valores de enumeración.
| Carrera | Descripción |
|---|---|
| AmericanIndianOrAlaskaNative | Indio americano o nativo de Alaska |
| NativeHawaiianOrOtherPacificIslander | Nativo hawaiano u otro isleño del Pacífico |
| BlackOrAfricanAmerican | Negro o afroamericano |
| DemographicRaceTwoOrMoreRaces | Designa varias carreras |
| Asiático | Asiático |
| Blanco | Blanco |
El roles.csv contiene el atributo "grade" y admite los valores de enumeración.
El Courses.csv contiene el atributo "grade" de la sesión académica y admite los valores de enumeración.
| Grado | Descripción |
|---|---|
| TI | Bebé/niño pequeño |
| PR | Preescolar |
| PK | Pre-kindergarten |
| TK | Jardín de infantes de transición |
| KG | Jardín de infantes |
| 01 | Primer grado |
| 02 | Segundo grado |
| 03 | Tercer grado |
| 04 | Cuarto grado |
| 05 | Quinto grado |
| 06 | Sexto grado |
| 07 | Séptimo grado |
| 08 | Octavo grado |
| 09 | Noveno grado |
| 10 | Décimo grado |
| 11 | Undécimo grado |
| 12 | Duodécimo grado |
| 13 | Grado 13 |
| 14 | Grado 14 |
| PS | Postsecundaria |
| UG | Sin degradar |
| Otros | Otros |
| PS1 | Primer año de postsecundaria |
| PS2 | Segundo segundo año de postsecundaria |
| PS3 | Postsecondary junior |
| PS4 | Postsecondary senior |
| Pregrado | Pregrado |
| Graduado | Graduado |
| Postgrado | Graduado con énfasis en investigación |
| Egresados | egresados |
| AdultEducation | Educación para adultos |