Sincronizzare l'integrità e il monitoraggio
Dashboard home
Durante l'elaborazione dei dati, School Data Sync (SDS) convalida i dati inserendo dati validi nel data lake e contrassegnando i dati non validi. Al termine di ogni esecuzione della sincronizzazione, vengono generate statistiche per facilitare l'integrità e il monitoraggio.
Per determinare l'integrità dei dati, viene passato attraverso le regole di corrispondenza e convalida dei dati per proteggere i dati validi necessari e facoltativi solo nel data lake. I dati che non superano la convalida vengono identificati come errori o avvisi e non vengono inviati al data lake.
Se non sono stati rilevati errori o avvisi, il risultato dell'esecuzione è Completato. Il dashboard principale indica "Nessun errore o avviso dei dati trovati" e "Non sono stati rilevati errori o avvisi relativi ai dati durante l'ultima esecuzione. Continuate il grande lavoro!
Se sono stati rilevati errori e avvisi, il risultato dell'esecuzione è Completato con errori.
- Viene generato un errore quando un valore in un record per i dati necessari non ha superato una regola di corrispondenza e convalida dei dati; il record è stato rimosso e non inviato al data lake.
Se sono stati trovati solo avvisi, il risultato dell'esecuzione è Completato con avvisi.
- Viene generato un avviso quando un valore in un record per i dati facoltativi non ha superato una regola di convalida o corrispondenza dei dati; il valore è stato rimosso, ma il record è stato inviato al data lake.
Il dashboard home informa che "Sono stati rilevati alcuni problemi con i dati" e consiglia di analizzare l'integrità della sincronizzazione. Per altre informazioni sui risultati dell'esecuzione della sincronizzazione, selezionare Analizza integrità sincronizzazione.
Integrità della sincronizzazione
L'integrità della sincronizzazione è uno strumento che consente di comprendere meglio l'integrità dei dati sincronizzati e di facilitare le indagini sui dati.
Le modifiche ai dati si verificano in base alle modifiche dei dati dell'esecuzione di sincronizzazione più recente.
Un'esecuzione di sincronizzazione è la sequenziazione delle configurazioni dei dati di connessione e gestione.
L'integrità della sincronizzazione fornisce anche una rappresentazione cronologica delle ultime 14 esecuzioni.
- Inizio esecuzione: timestamp all'avvio dell'esecuzione complessiva
- Fine esecuzione: timestamp al termine dell'esecuzione complessiva
- Stato di esecuzione: stato complessivo per tutti i flussi di dati
- Esecuzione: esecuzione attiva
- Completato: completato senza errori o avvisi
- Completato con errori: completato ma sono stati rilevati errori
- Completato con avvisi: completato ma sono stati trovati solo avvisi
- Non riuscito: esecuzione annullata dal sistema o dal cliente
Per analizzare i dati contrassegnati, è possibile selezionare Scarica report per recuperare una copia del report.
Il report viene formattato nel modo seguente:
| Column Name | Descrizione | Esempio |
|---|---|---|
| Regola | Rappresentazione della regola di convalida | RequiredDataViolated |
| ExternalIdentifier | ID esterno/di origine dell'entità correlata dal sistema di origine | 7B2C8A0B33-F7E5-460B-993A-7257165430F7 |
| Gravità | Rappresentazione della gravità dei dati contrassegnati | Errore di convalida, avviso di convalida |
| EntityCode | Rappresentazione dell'area correlata all'errore | Persona, organizzazione, registrazione |
| FriendlyMessage | In base ai messaggi di errore e avviso | Manca un valore obbligatorio per {record} nel nome del campo: {field} dall'origine [{fileName}/{apiEndPoint}] per creare il record. |
| FlowName | Nome del flusso in ingresso o in uscita | OneRoster API Inbound |
| SourceSystemName | Nome dell'origine da cui proviene il record | Contoso SIS |
| Anno | Anno accademico | 2023 |
| Ora | Data/ora in cui il record è stato identificato durante l'elaborazione, UTC. | 2023-08-21T02:53:00Z |
- Per altre informazioni sulla corrispondenza dei dati e sulle regole di convalida, vedere Regole e descrizioni di convalida.
- Per altre informazioni sull'elenco predefinito di valori supportato, vedere Elenco predefinito di valori.
- FamilyName, givenName e posta elettronica sono necessari per gli utenti con ruoli di contatto/tutore.
- Aspettatevi che telefono e sms siano in E.164 e + devono essere inclusi. (Esempio: +1234567890)
Consiglio
Per caricare manualmente le modifiche dopo la prima esecuzione per aggiornare i dati di origine, vedere Aggiornare i dati di origine con SDS v2.1 CSV.
Avviso
Il numero massimo di caricamenti con un'esecuzione corrispondente è sei volte al giorno di calendario. Dopo di che, se si carica, verrà eseguito solo fino a due volte in base alla cadenza di esecuzione automatizzata SDS di ogni 12 ore.
Priorità degli errori per la correzione
Quando si risoluzione degli errori, è consigliabile assegnare priorità agli errori di convalida con la maggior parte delle istanze per lo stesso codice di entità prima di risolvere eventuali altri errori.
Gli errori di convalida possono causare numerosi errori successivi per ogni istanza all'interno della stessa esecuzione dei dati. Spesso, la correzione di questi errori di convalida consente prima di tutto di correggere molti errori correlati al roster rilevati durante la convalida.
Dettagli della visualizzazione integrità di sincronizzazione
Per visualizzare le statistiche dall'esecuzione, è possibile selezionare Visualizza dettagli per aprire un riquadro a comparsa per visualizzare Dettagli esecuzione. Le statistiche dell'esecuzione vengono visualizzate nella scheda Panoramica .
Per comprendere meglio la fase in cui potrebbero essere stati generati errori e avvisi, selezionare la scheda Fasi . Le informazioni vengono suddivise nelle fasi seguenti, a seconda di quali configurazioni dei dati sono state abilitate.
Dati dell'istituto
Utenti di Microsoft 365
Gruppi di Microsoft 365
Gruppi IT Microsoft
Stato più recente
- Completato: completato senza errori o avvisi
- Completato con errori: completato ma sono stati rilevati errori
- Completato con avvisi: completato, ma sono stati trovati solo avvisi
- Non riuscito: esecuzione annullata dal sistema o dal cliente
Nota
Per altre informazioni, vedere Statistiche istituzionali ed esegui sulle statistiche disponibili in Dettagli esecuzione.
Come SDS determina la presenza dei dati e imposta lo stato attivo
Nota
Per altre informazioni sulla configurazione dell'anno accademico, vedere Gestione dell'anno accademico
L'associazione di un utente a una sessione (ad esempio, Anno accademico) si basa sul proprio ruolo, legato a un'organizzazione.
L'associazione di un utente a una classe si basa sul ruolo associato a una registrazione, che include anche un collegamento a una sessione.
In base ai dati connessi, queste regole vengono usate per determinare la consapevolezza del record e del relativo stato della sessione nell'archivio dati.
- I dati riflettono quando viene presentato un nuovo record per la prima volta.
- SDS imposta la prima data vista (ora) e la data dell'ultima modifica (ora) come corrente e, se necessario, contrassegna il record come "attivo nella sessione" come true.
- I dati riflettono quando lo stesso record è presente nell'esecuzione successiva.
- SDS mantiene il primo valore di data (ora) visualizzato, imposta la data dell'ultima modifica (ora) su corrente e lascia "attivo nella sessione" su true.
- I dati si riflettono quando lo stesso record non è presente in un'esecuzione successiva.
- SDS mantiene i valori di data (ora) e data dell'ultima modifica (ora) e, se necessario, contrassegna il record come "attivo nella sessione" su false.
- Le eccezioni si verificano quando organizzazioni, persone (utenti) e record di sessione persistono nel tempo e non vengono disattivati.
- Sono disponibili aggiornamenti in sequenza per "inattivato". Ad esempio, se non è presente un record utente, il sistema mantiene i valori esistenti di data (ora) e data dell'ultima modifica (ora). Il sistema imposta "è attivo nella sessione" su false per i record di organizzazione/ruolo e registrazione degli utenti.
- SDS mantiene i valori di data (ora) e data dell'ultima modifica (ora) e, se necessario, contrassegna il record come "attivo nella sessione" su false.
Nota
Per altre informazioni sulla gestione dei dati, vedere Validate, Store and Data Health on SDS Overview (Convalida, archiviazione e integrità dei dati in SDS).