Formato de archivo CSV de SDS V2
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 para sincronizar el sistema de información escolar (SIS) con Office 365. El uso del formato de archivo CSV SDS V2 para ingerir las categorías de datos siguientes le permite iluminar las funcionalidades básicas de SDS para el aprovisionamiento. También le permite mejorar las experiencias de los productos y características de Microsoft 365 (Microsoft 365) que se enumeran a continuación. El formato de archivo CSV SDS V2 seguirá expandiendo las categorías de datos que admite.
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.
Cuando se usa el formato SDS V2, los archivos deben tener el formato adecuado. En este artículo se describen los requisitos de formato y los atributos admitidos para su uso con SDS. Debe cargar los cuatro archivos, denominados exactamente como se detalla a continuación. Los archivos y los encabezados de columna distinguen mayúsculas de minúsculas. Para revisar y descargar el conjunto de ejemplo de archivos CSV de SDS V2, consulte el repositorio de GitHub de SDS.
Cada archivo CSV debe contener todos los campos obligatorios resaltados en verde a continuación. Los campos no resaltados son opcionales. Aunque el contenido de determinados atributos puede ser opcional, se requieren los encabezados de columna. Además, los atributos con valores de enumeración definidos como marcados en la columna Tipos tienen un conjunto específico de valores que admiten. Consulte el conjunto de compatibilidad de valores enumerados para cada atributo de enumeración en la sección siguiente.
Valores enumerados (enumeración) admitidos
En el nuevo formato SDS V2, hay varios 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 siguiente se definen los valores de enumeración admitidos en el formato SDS V2.
El users.csv contiene el atributo "role" admite los valores de enumeración siguientes.
El users.csv contiene el atributo "grade" y admite los valores de enumeración siguientes.
El orgs.csv contiene el atributo "type" y admite los valores de enumeración siguientes.
El enrollments.csv contiene el atributo "role" y admite los valores de enumeración siguientes.
