Formato de archivo CSV DE SDS V2.1
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. El formato de archivo CSV SDS V2.1 seguirá expandiendo las categorías de datos que admite.
Si usa el formato SDS V2.1, los archivos deben tener el formato adecuado. Cargue los archivos, denominados exactamente como detallados. 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 V2.1, 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: se deben proporcionar los tres archivos siguientes. Si solo administra usuarios y no clases, solo debe proporcionar estos archivos.
orgs.csv
users.csv
roles.csv
Opcional o obligatorio: los dos archivos siguientes no son necesarios si solo se administran usuarios. Si también está administrando las clases y las inscripciones de clases, debe proporcionar los dos archivos que se enumeran a continuación, junto con los tres archivos anteriores.
classes.csv
enrollments.csv
Opcional: los siguientes son archivos opcionales y se usan para mejorar las experiencias. Estos archivos no son necesarios, a menos que los archivos anteriores tengan referencias de datos basadas en las notas siguientes.
academicSessions.csv (si el roles.csv, classes.csv o courses.csv contiene datos de sesión académica, se deben proporcionar los datos correspondientes para evitar mensajes de error al procesar datos).
courses.csv (si los datos de classes.csv contienen vínculos a cursos, se deben proporcionar los datos correspondientes para evitar mensajes de error al procesar datos).
demographics.csv
userFlags.csv
relationships.csv
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.
orgs.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| sourcedId | Sí | 10001 | Unique ID |
| name | Sí | Facultad de Ingeniería | Cadena |
| type | Sí | Universidad | Enum |
| parentSourcedId | No | 10000 | Unique ID |
users.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| sourcedId | Sí | 14001 | Unique ID |
| usuario | Sí | cbeane@domain.com | Cadena |
| familyName | Sí (solo si se crean usuarios) | Craig | Cadena |
| givenName | Sí (solo si se crean usuarios) | Beane | Cadena |
| activeDirectoryMatchId | No | craig.beane@domain.com | Cadena |
| correo electrónico | No | cbeane@domain.com | Correo electrónico |
| phone | No | +1234567890 | Phone |
| Sms | No | +1234567890 | Phone |
| userNumber | No | 14001 | Cadena |
- familyName y givenName son necesarios para los usuarios si usan la opción "Crear usuarios no coincidentes".
- familyName, givenName y correo electrónico son necesarios para los usuarios si usan la opción "Asociaciones de contactos de estudiantes" para los usuarios que tienen un rol de relación de contacto en relationships.csv. Los usuarios que son personal, pero también contactos, se recomienda que tengan dos registros de usuario en la lista, con el registro de usuario de contactos asociado a su dirección de correo electrónico privada.
- Espere que los campos de teléfono y sms tengan 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.
- la contraseña ya no se usa para proporcionar la contraseña predeterminada para crear nuevos usuarios.
roles.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| userSourcedId | Sí | 14001 | Unique ID |
| orgSourcedId | Sí | 10001 | Unique ID |
| role | Sí | student | Enum |
| sessionSourcedId | No | FS2021 | Unique ID |
| grade | No | PS1 | Enum |
| isPrimary | No | true | Booleano |
| roleStartDate | No | 2020-08-24 | Fecha |
| roleEndDate | No | 2020-12-11 | Fecha |
- Requiere una referencia al usuario asociado mediante el campo "userSourcedId". Esto genera una dependencia en el archivo users.csv.
- Requiere una referencia a la organización asociada mediante el campo "orgSourcedId". Esto genera una dependencia en el archivo orgs.csv.
- Si se pasa: esto requiere una referencia a los términos asociados (sesiones académicas) mediante el campo "sessionSourcedId". Esto genera una dependencia en el archivo academicSessions.csv.
- isPrimary indica si este rol es el principal (true) o secundario (false) de esa organización. Si se pasan varios roles, para el mismo usuario y la misma organización, debería haber uno y solo un rol principal establecido en (true) para cada organización.
- Valores de fecha que se proporcionarán en formato ISO8601.
classes.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| sourcedId | Sí | 12001 | Unique ID |
| orgSourcedId | Sí | 10001 | Unique ID |
| title | Sí | Informática 101 | Cadena |
| sessionSourcedIds | No | FS2021 | Identificador único[] |
| courseSourcedId | No | C12001 | Unique ID |
| código | No | 12001 | Cadena |
- Esto requiere una referencia a la escuela asociada (org) mediante el campo "orgSourcedId". Esto genera una dependencia en el archivo orgs.csv.
- Si se pasa: esto requiere una referencia a los términos asociados (sesiones académicas) mediante el campo "sessionSourcedIds". Esto genera una dependencia en el archivo academicSessions.csv.
- Si se pasa: si una clase está asociada a varias sesiones en el mismo año académico, por ejemplo, semestre de otoño y semestre de primavera, puede proporcionar ambos de sourcedId para las sesiones del registro. Los valores deben combinarse en una sola cadena con los valores entre comillas y separados por comas.
- La asociación a varios sessionSourcedIds solo se almacena en Data Lake.
- El atributo de extensión grupo de Microsoft 365 para identificadores de sesión no admite varias asociaciones.
- Si se pasa: esto requiere una referencia al curso asociado mediante el campo "courseSourcedId". Esto genera una dependencia en el archivo courses.csv.
enrollments.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| classSourcedId | Sí | 12001 | Unique ID |
| userSourcedId | Sí | 14001 | Unique ID |
| role | Sí | student | Enum |
- Esto requiere una referencia a la clase asociada mediante el campo "classSourcedId". Esto genera una dependencia en el archivo classes.csv.
- Esto requiere una referencia al usuario asociado mediante el campo "userSourcedId". Esto genera una dependencia en el archivo users.csv.
academicSessions.csv
| Presentado | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| sourcedId | Sí | FS2021 | Unique ID |
| title | Sí | Semestre de otoño | Cadena |
| type | Sí | Semestre | Enum |
| schoolYear | Sí | 2021 | Enum |
| startDate | Sí | 2020-08-24 | Fecha |
| endDate | Sí | 2020-12-11 | Fecha |
- Espere que los valores de fecha se proporcionen en formato ISO8601.
courses.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| sourcedId | Sí | C12001 | Unique ID |
| orgSourcedId | Sí | 10001 | Unique ID |
| title | Sí | Informática 101 | Cadena |
| código | No | CS101 | Cadena |
| schoolYearSourcedId | No | Y2021 | Unique ID |
| subject | No | 10 | Enum |
| grade | No | Pregrado | Enum |
- Esto requiere una referencia a la organización asociada (org) mediante el campo orgSourcedId. Esto genera una dependencia en el archivo orgs.csv.
- Si se pasa: esto requiere una referencia al registro de año de sesión académico asociado mediante el campo "schoolYearSourcedId" donde el tipo = schoolYear. Esto genera una dependencia en el archivo academicSessions.csv.
relationships.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| userSourcedId | Sí | 14001 | Unique ID |
| relationshipUserSourcedId | Sí | P14001 | Unique ID |
| relationshipRole | Sí | Guardián | Enum |
- Si también está sincronizando relaciones de contacto (tutores), debe incluir un registro para ellos en el users.csv.
- Esto requiere una referencia al usuario asociado mediante el campo "userSourcedId". Esto genera una dependencia en el archivo users.csv.
- Esto requiere una referencia al usuario asociado mediante el campo "relationshipUserSourcedId". Esto genera una dependencia en el archivo users.csv.
- Además, se requieren familyName, givenName y correo electrónico para los usuarios que tienen roles de relación de contacto.
demographics.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| userSourcedId | Sí | 14001 | Unique ID |
| Sexo | No | masculino | Enum |
| birthDate | No | 2001-07-20 | Fecha |
| birthCity | No | Woodenville | Cadena |
| birthState | No | WA | Enum |
| birthCountry | No | E.E.U.U | Cadena |
| ethnicityCodes | No | hispanicOrLatinoEthnicity | Enumeración[] |
| raceCodes | No | demographicRaceTwoOrMoreRaces | Enumeración[] |
- Esto requiere una referencia al usuario asociado mediante el campo "userSourcedId". Esto genera una dependencia en el archivo users.csv.
- Se deben combinar varios valores que se asignan a "raceCodes" en una sola cadena con los valores entre comillas y separados por comas.
userFlags.csv
| Campo | ¿Necesario? | Ejemplo | Tipo de datos |
|---|---|---|---|
| userSourcedId | Sí | 14001 | Unique ID |
| flag | Sí | Lep | Enum |
- Esto requiere una referencia al usuario asociado mediante el campo "userSourcedId". Esto genera una dependencia en el archivo users.csv.