Sincronización del estado y la supervisión

Panel principal

Durante el procesamiento de datos, School Data Sync (SDS) valida los datos mediante la incorporación de datos correctos al lago de datos y la marcación de datos incorrectos. Al final de cada ejecución de sincronización, se generan estadísticas para ayudar con el estado y la supervisión.

Para determinar el estado de los datos, se pasa a través de reglas de validación y coincidencia de datos para ayudar a proteger los datos necesarios y opcionales que solo entran en el lago de datos. Los datos que no pasan la validación se identifican como errores o advertencias y no se envían al lago de datos.

Si no se encontraron errores ni advertencias, el resultado de la ejecución es Completado. El panel principal mostrará el estado "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!"

Captura de pantalla del banner sin errores ni advertencias.

Si se detectan errores y advertencias, el resultado de la ejecución es Completado con errores.

  • Se produce un error cuando un valor de un registro para los datos necesarios no superó una regla de validación o coincidencia de datos; el registro se quitó y no se envió al lago de datos.

Si solo se encuentran advertencias, el resultado de la ejecución es Completado con advertencias.

  • Se genera una advertencia cuando un valor de un registro de datos opcionales no superó una regla de validación o coincidencia de datos; se quitó el valor, pero el registro se envió al lago de datos.

El panel principal informa de que "Hemos encontrado algunos problemas con los datos" y le anima a investigar el estado de sincronización. Para obtener más información sobre los resultados de la ejecución de sincronización, seleccione Investigar estado de sincronización.

Captura de pantalla del banner de problemas encontrados.

Estado de sincronización

El estado de sincronización es una herramienta que le ayuda a comprender mejor el estado de los datos que se sincronizan y a ayudar con las investigaciones de datos.

Los cambios en los datos se producen en función de los cambios de datos de la ejecución de sincronización más reciente.

Una ejecución de sincronización es la secuenciación de las configuraciones de datos de conexión y administración.

Captura de pantalla de la pantalla de estado de ejecución.

El estado de sincronización también proporciona una representación histórica de las últimas 14 ejecuciones.

  • Inicio de la ejecución: marca de tiempo cuando se inició la ejecución general
  • Final de la ejecución: marca de tiempo cuando finalizó la ejecución general
  • Estado de ejecución: estado general en todos los flujos de datos
    • Ejecución: ejecución activa
    • Completado: completado sin errores ni advertencias
    • Completado con errores: completado, pero se encontraron errores
    • Completado con advertencias: completado, pero solo se encontraron advertencias
    • Error: ejecución cancelada por el sistema o el cliente

Para investigar los datos marcados, puede seleccionar Descargar informe para recuperar una copia del informe.

El informe tiene el formato siguiente:

Nombre de columna Descripción Ejemplo
Rule Representación de la regla de validación RequiredDataViolated
ExternalIdentifier Identificador externo o origen de la entidad relacionada desde el sistema de origen 7B2C8A0B33-F7E5-460B-993A-7257165430F7
Severity Representación de gravedad de los datos marcados Error de validación, advertencia de validación
EntityCode Representación del área relacionada con el error Persona, organización, inscripción
FriendlyMessage En función de los mensajes de error y advertencia Falta un valor necesario para {record} en el nombre del campo: {field} del origen [{fileName}/{apiEndPoint}] para crear el registro.
FlowName Nombre del flujo entrante o saliente OneRoster API Inbound
SourceSystemName Nombre del origen del que procede el registro Contoso SIS
Año Año académico 2023
Hora Datos o hora en que se identificó el registro durante el procesamiento, UTC.  2023-08-21T02:53:00Z
  • Para obtener más información sobre las reglas de validación y coincidencia de datos, vea Reglas y descripciones de validación.
  • Para obtener más información sobre la lista predeterminada de valores admitida, vea Lista predeterminada de valores.
  • familyName, givenName y correo electrónico son necesarios para los usuarios que tienen roles de contacto o tutor.
  • Espere que el teléfono y los sms estén en E.164 y + deben estar incluidos. (Ejemplo: +1234567890)

Sugerencia

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

Advertencia

El número máximo de cargas con una ejecución correspondiente es seis veces por día natural. Después de eso, si 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.

Priorización de errores para la corrección

Al solucionar errores, se recomienda priorizar los errores de validación con la mayoría de las instancias para el mismo código de entidad antes de solucionar cualquier otro error.

Los errores de validación pueden dar lugar a numerosos errores posteriores para cada instancia dentro de la misma ejecución de datos. A menudo, la corrección de estos errores de validación corrige primero muchos errores relacionados con la lista que se encuentran durante la validación.

Detalles de la vista de estado de sincronización

Para ver las estadísticas de la ejecución, puede seleccionar Ver detalles para abrir un control flotante para ver Detalles de la ejecución. Las estadísticas de la ejecución se muestran en la pestaña Información general .

Captura de pantalla del panel flotante de detalles de ejecución.

Para comprender mejor la fase desde la que se pueden haber generado errores y advertencias, seleccione la pestaña Fases . La información se divide en las siguientes fases, en función de qué configuraciones de administración de datos se hayan habilitado.

  • Datos de la institución

  • Usuarios de Microsoft 365

  • Grupos de Microsoft 365

  • Grupos de TI de Microsoft

  • Estado más reciente

    • Completado: completado sin errores ni advertencias
    • Completado con errores: Completado, pero se encontraron errores
    • Completado con advertencias: Completado, pero solo se encontraron advertencias
    • Error: ejecución cancelada por el sistema o el cliente

Nota:

Para obtener más información, consulte Estadísticas institucionales y de ejecución sobre las estadísticas que se encuentran en Detalles de ejecución.

Cómo SDS determina los datos que están presentes y establece el estado activo

Nota:

Para obtener más información sobre la configuración del año académico, consulte Control del año académico.

La asociación de un usuario a una sesión (por ejemplo, año académico) se basa en su rol, vinculado a una organización.

La asociación de un usuario a una clase se basa en su rol asociado a una inscripción, que también incluye un vínculo a una sesión.

En función de los datos conectados, estas reglas se usan para determinar el reconocimiento del registro y su estado de sesión en el almacén de datos.

  • Los datos reflejan cuándo se presenta un nuevo registro por primera vez.
    • SDS establece la fecha (hora) vista por primera vez y la fecha de última modificación (hora) como actuales y, si procede, marca el registro como "está activo en sesión" como true.
  • Los datos reflejan cuándo está presente el mismo registro en la ejecución posterior.
    • SDS conserva el valor de la primera fecha (hora) vista, establece la fecha (hora) de la última modificación en actual y deja "está activo en la sesión" para que sea true.
  • Los datos reflejan cuándo el mismo registro no está presente en una ejecución posterior.
    • SDS conserva los valores de fecha (hora) y fecha de la última modificación y, si procede, marca el registro como "está activo en sesión" como false.
      • Las excepciones se producen cuando las organizaciones, las personas (usuarios) y los registros de sesión persisten con el tiempo y no se desactivan.
      • Hay actualizaciones graduales para "inactivated". Por ejemplo, si un registro de usuario no está presente, el sistema conserva los valores existentes de fecha (hora) y fecha de última modificación (hora). El sistema establece "está activo en sesión" en false para los registros de organización/rol e inscripción de los usuarios.

Nota:

Para obtener más información sobre el control de datos, vea Validate, Store and Data Health on SDS Overview (Validación, almacenamiento y estado de datos en SDS).