Ingesta de datos con formato CSV sds v1

Precaución

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.

Configuración de SDS para Microsoft 365 Educación inquilino

• Microsoft 365 Educación inquilino

• Necesita permisos de administrador global

  Advertencia

  Puede usar archivos CSV (valores separados por comas) para sincronizar el sistema de información escolar (SIS) o el sistema de administración de estudiantes (SMS). SDS solo admite la carga de archivos CSV en formato UTF-8 y compatible con RFC. 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. Para obtener más información, consulte Formato de archivo CSV SDS v1.

  Importante

  Al conectar y hacer que los datos de la institución estén disponibles con School Data Sync, reconoce que está autorizado para compartir estos datos con Microsoft y se compromete a cumplir los estándares de gobernanza de datos de su organización.

Acceso a SDS e inicio de sesión por primera vez

Para acceder al portal de Administración SDS, inicie el explorador web, vaya a sds.microsoft.com e inicie sesión con su cuenta de Administración global de Microsoft 365.

1. Seleccione Introducción.

   

2. Seleccione Continuar.

   

   Espere unos instantes para que los servicios se aprovisionen en el inquilino antes del paso siguiente.

   

3. Seleccione Crear nuevo flujo de entrada y Siguiente para continuar.

   

4. Elija el origen de datos. En CSV, seleccione la opción Conectarse a mis datos.

5. Seleccione el formato. En CSV, seleccione la opción CSV. Siguiente para continuar.

   

6. Debe proporcionar el nombre del SIS/SMS. Además, seleccione SDS v1 CSV. Seleccione Siguiente para continuar.

   

7. Seleccione Examinar archivos para presentar el cuadro de diálogo examinar y seleccionar.

   

   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.

8. Vaya a la ubicación del archivo y seleccione los archivos.

   

   Consulte formato de archivo CSV SDS v1.

   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. Si uno está seleccionado y los demás no, al seleccionar Siguiente, aparece un mensaje que indica que falta uno de estos archivos. Debe corregir antes de continuar.

   • 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).

9. Cuando haya completado la selección de los archivos, seleccione Siguiente para continuar. El sistema validará los nombres de los archivos seleccionados antes de continuar con la siguiente pantalla. Si no se encuentra un archivo necesario, aparece un mensaje y debe dirigir y volver a seleccionar el archivo o los archivos.

   

10. Una vez validados los nombres de los archivos, los archivos se cargarán para validar la estructura de los archivos seleccionados y tendrán el formato correcto con los nombres de encabezado según la especificación SDS CSV v1.

    • Si recibe el mensaje: Uno o varios de los archivos que se encuentran a continuación no coinciden con el formato esperado, revise la pantalla para ver si los archivos no tienen el formato correcto. Tendrá que volver a la pantalla anterior para volver a seleccionar los archivos después de corregir los problemas.

    • Si recibe el mensaje: No podemos encontrar uno o varios de los archivos opcionales, revise la pantalla para ver qué archivo o archivos no se encuentran. Si no espera este mensaje, debe volver a la pantalla anterior para volver a seleccionar los archivos. De lo contrario, seleccione Siguiente para continuar.

    

11. Una vez validado el esquema de archivo, SDS realizará una validación rápida de datos de los archivos cargados. Los datos cargados pasan por algunas de las reglas de validación y coincidencia de datos de SDS para ayudar a identificar los datos opcionales necesarios y proporcionados. No son todas las reglas de validación, sino las más encontradas.

    

    

    Sugerencia

    Los resultados de validación de datos no se bloquean durante las experiencias de incorporación o carga csv; tiene dos opciones: salir y devolver más adelante después de corregir los datos o continuar con el paso siguiente para continuar configurando la conexión de datos y, posteriormente, proporcionar los datos corregidos con cargas posteriores.

12. Para obtener más información sobre los datos marcados para la investigación, seleccione Ver detalles del nombre de archivo de la lista para profundizar en elementos específicos.

    También podrá descargar un informe por archivo para empezar con la investigación y las correcciones en el sistema de origen.

    Las columnas de archivo marcadas se muestran con la capacidad de expandir e investigar qué regla o reglas las marcaron.

    

    Al hacer clic en la regla, podrá ver otro resumen de los 10 primeros registros, por ejemplo.

    

    Una vez completada la investigación, cierre los diálogos y seleccione Siguiente.

13. Elija su año académico actual y proporcione un nombre descriptivo, como 2023 o 2022 – 2023. (Los caracteres deben ser utf8 o se quitarán automáticamente).

    Importante

    El año académico se usa para asociar datos entrantes para ayudar a crear datos históricos año a año. El enfoque se alinea con un año académico frente a un año natural. Si el año académico abarca un año natural, por ejemplo, comienza el 15/08/2022 y finaliza el 15/6/2023, el valor del año académico que se va a seleccionar es el año final, 2023. Para obtener más información, consulte Control del año académico.

    Escriba las fechas de inicio y finalización de su año académico.

    Escriba la fecha en la que SDS debe dejar de sincronizar los datos en función del año académico definido. Es más común dejar de sincronizar datos en la fecha de finalización del año académico que acaba de escribir.

    Seleccione Siguiente para continuar.

    

14. Seleccione las opciones de regla de identidad de usuario. Haga sus selecciones para los roles de personal y estudiante.

    Nota:

    La coincidencia de usuarios se realiza con el flujo de entrada y no escribe ni actualiza los objetos de usuario en Microsoft Entra ID. La coincidencia se realiza y se almacena en el lago de datos de Education. Para obtener más información, consulte Administración de usuarios de Microsoft 365 en la escritura del vínculo de coincidencia hacia delante con el flujo de salida.

    • Atributo del origen: atributo de usuario basado en los datos que proceden del SIS/SMS.
      • Las opciones de origen disponibles son Username, Email y ActiveDirectory MatchId.
    • Atributo con el que se va a hacer coincidir: propiedad de usuario en Microsoft Entra ID con la que se va a hacer coincidir.
      • Las opciones de coincidencia de Microsoft Entra ID disponibles son UserPrincipalName y Mail.
    • (OPCIONAL) Si los datos de usuario no incluyen el valor @domain , seleccione un dominio de la lista.

    Advertencia

    La selección de un dominio es opcional y solo se debe usar si los datos entrantes basados en el atributo seleccionado del origen no incluyen el valor @domain . SDS no comprueba y anexa si falta el valor en un registro. SDS anexará la selección de dominio a todos los registros que podrían dar lugar a @domain@domain y no encontrar coincidencias en esas instancias para la asignación de usuarios existente con usuarios en Microsoft Entra ID.

    Precaución

    Si los usuarios de SIS o SMS, por ejemplo, los usuarios del grupo de roles de personal, podrían estar asociados a @domain1 , @domain2 o @domain3 debe tener un @domain incluido en los datos de origen, en función del atributo seleccionado de la selección de origen (por ejemplo, prefix@domain). Esto es necesario para que el atributo coincida con: UserPrincipalName o Mail para encontrar el Microsoft Entra usuario correcto con el que debe coincidir.

    En la instancia de que un usuario tiene varios roles, se usan las reglas siguientes para determinar qué reglas de coincidencia de personal o alumno se deben usar entre el registro de usuario y el Microsoft Entra objeto de usuario.

    • Si isPrimary está establecido para todos los roles de alumno, incluso si existe asociación a un rol de personal, la coincidencia se realiza en función del rol de alumno.

    • Si isPrimary se establece para cualquier rol de personal, incluso si existe asociación a un rol de estudiante, la coincidencia se realiza en función del rol de personal.

    • Si isPrimary está establecido para el rol de personal y estudiante, la coincidencia se realiza en función del rol de personal.

    • Si isPrimary no está establecido para ningún rol, especialmente con una combinación para los roles de personal y alumno, la coincidencia se basa en el rol de personal.

    Importante

    Al configurar el flujo Administrar usuarios de Microsoft 365, estas reglas se usan si la opción está activada para Crear usuarios no coincidentes, para definir la construcción de la Microsoft Entra propiedad UserPrincipalName.

    Una vez que esté satisfecho con las selecciones, seleccione Siguiente para continuar.

    

15. Revise la información presentada en Revisión y creación. Si todo parece correcto, seleccione el botón Crear . Si no es así, puede volver a la corrección.

    

    

16. Se ha creado el flujo de datos de entrada y la primera ejecución está pendiente, seleccione el botón Listo . Vuelva a comprobar para ver el estado de la primera ejecución.

    

    

    Sugerencia

    Puede configurar la configuración administrar datos inmediatamente después de definir la configuración de datos de Connect, durante la primera ejecución activa o posterior después de que la primera ejecución haya finalizado.

17. Para comprobar el estado de la ejecución, vuelva a la página Panel principal.

    Si no hay ningún problema con los datos, el panel inicio indicará, "No se encontraron errores de datos o advertencias" y "No se encontraron errores de datos ni advertencias durante la última ejecución. ¡Sigue con el gran trabajo!"

    Si se encuentran problemas con los datos, el panel inicio informa de que "Hemos encontrado algunos problemas con los datos" y le anima a investigar el estado de sincronización.

    Nota:

    Para cargar manualmente los cambios después de la primera ejecución para actualizar los cambios de los datos de origen , consulte Actualización de datos de origen con SDS CSV

    Las cargas máximas, con una ejecución correspondiente, son seis veces por día natural. Después de seis veces al día si se carga, solo se ejecutará hasta dos veces más en función de la cadencia de ejecución automatizada de SDS de cada 12 horas.