Compartir a través de


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 10001 Unique ID
name Facultad de Ingeniería Cadena
type Universidad Enum
parentSourcedId No 10000 Unique ID

users.csv

Campo ¿Necesario? Ejemplo Tipo de datos
sourcedId 14001 Unique ID
usuario 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 14001 Unique ID
orgSourcedId 10001 Unique ID
role 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 12001 Unique ID
orgSourcedId 10001 Unique ID
title 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 12001 Unique ID
userSourcedId 14001 Unique ID
role 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 FS2021 Unique ID
title Semestre de otoño Cadena
type Semestre Enum
schoolYear 2021 Enum
startDate 2020-08-24 Fecha
endDate 2020-12-11 Fecha
  • Espere que los valores de fecha se proporcionen en formato ISO8601.

courses.csv

Campo ¿Necesario? Ejemplo Tipo de datos
sourcedId C12001 Unique ID
orgSourcedId 10001 Unique ID
title 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 14001 Unique ID
relationshipUserSourcedId P14001 Unique ID
relationshipRole 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 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 14001 Unique ID
flag Lep Enum
  • Esto requiere una referencia al usuario asociado mediante el campo "userSourcedId". Esto genera una dependencia en el archivo users.csv.