Sincronizzare l'integrità e il monitoraggio
Dashboard home
Durante l'elaborazione dei dati, School Data Sync (SDS) convalida i dati inserendo dati validi nella cache 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 nella cache. I dati che non superano la convalida vengono identificati come errori o avvisi e non vengono inviati alla cache.
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 alla cache.
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 alla cache.
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
Panoramica dell'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 |
| 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 Caricamento csv manuale con Sincronizzazione dati dell'istituto di istruzione.
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
Panoramica dei dettagli 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 .
Fasi dei dettagli di sincronizzazione
Le fasi sono uno strumento che fornisce informazioni dettagliate sull'esecuzione selezionata mentre procede in ognuna delle fasi dell'esecuzione della sincronizzazione attiva. Le informazioni presentate come aggiornamento automatico come fase vengono completate e ne viene avviata un'altra.
A seconda delle dimensioni dei dati, una fase può essere nello stato "in esecuzione" per un periodo di tempo prolungato.
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
L'associazione di un utente a un'organizzazione 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.
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.
- 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.
- 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).
- 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).
- SDS mantiene i valori di data (ora) e data dell'ultima modifica (ora).
Nota
Per altre informazioni sulla gestione dei dati, vedere Validate and Data Health on SDS Overview (Convalida e integrità dei dati in SDS).