Connettere i dati alla sincronizzazione dati dell'istituto di istruzione

Importante

Connettendo e rendendo disponibili i dati dell'istituto con School Data Sync (SDS), si riconosce di essere autorizzati a condividere questi dati con Microsoft e si impegna a rispettare gli standard di governance dei dati dell'organizzazione.

Configurare SDS per il tenant di Microsoft 365 Education

• Tenant di Microsoft 365 Education
• Sono necessarie autorizzazioni di amministratore globale
• L'amministratore globale che accede a SDS richiede la licenza SDS Piano 1 (A1) o SDS Piano 2 (A3/A5)

Accesso SDS e accesso alla prima volta

• Per accedere al portale di amministrazione di SDS avviare il Web browser, passare a sds.microsoft.com e quindi accedere usando l'account amministratore globale di Microsoft 365.

• Seleziona Inizia.

  

• Selezionare Continua.

  

  Attendere alcuni istanti per il provisioning dei servizi nel tenant prima del passaggio successivo.

  

• Selezionare il formato Origine. Per i dati forniti tramite CSV SDS v2.1 o CSV SDS v1, selezionare CSV. Per i dati forniti tramite l'API OneRoster, selezionare API. Dopo aver scelto, selezionare Avanti.

  

SDS v2.1 CSV

• Specificare il nome dei dati connessi Student Information System (SIS) o Student Management System (SMS). Includere informazioni che consentono di distinguere i dati connessi tra origini diverse a scopo di gestione e risoluzione dei problemi. Per la versione del formato, selezionare CSV SDS v2.1. Selezionare Avanti per continuare.

  

• Selezionare Sfoglia dispositivo per presentare la finestra di dialogo sfoglia e selezione.

  Nota

  Dopo il caricamento iniziale durante la creazione della configurazione dei dati di connessione, sarà necessario fornire sempre lo stesso set di file per i caricamenti successivi, indipendentemente dalle modifiche apportate ai dati nei file facoltativi o meno. In caso contrario, il sistema determinerà che i record non sono più attivi e li contrassegnerà come tali.

  

• Passare al percorso del file e selezionare i file.

  Fare riferimento al formato di file CSV SDS V2.1.

  Obbligatorio: i tre file elencati devono essere selezionati prima di poter procedere. Se si gestiscono solo utenti e non classi, è sufficiente fornire questi file.

  • orgs.csv
  • users.csv
  • roles.csv

  Facoltativo/Obbligatorio: non obbligatorio se si gestiscono solo utenti. Se si gestiscono anche classi e registrazioni di classi, è necessario fornire i due file elencati, insieme ai tre file precedenti. In caso contrario, non selezionare alcun file con questi nomi. Se uno è selezionato e l'altro no, quando si seleziona Avanti viene visualizzato un messaggio che indica che uno di questi file è mancante. È necessario correggere prima di continuare.

  • classes.csv
  • enrollments.csv

  Facoltativo: i seguenti sono file facoltativi e vengono usati per migliorare le esperienze. Non obbligatorio, a meno che i file precedenti non abbiano riferimenti ai dati in base alle note fornite.

  • academicSessions.csv (se il roles.csv, classes.csv o courses.csv contiene dati di sessione accademica, forniti per evitare messaggi di errore durante l'elaborazione dei dati.
  • courses.csv (se i dati classes.csv contengono collegamenti ai corsi, forniti per evitare messaggi di errore durante l'elaborazione dei dati).
  • demographics.csv
  • userFlags.csv
  • relationships.csv

  

• Al termine della selezione dei file, selezionare Avanti per continuare. Il sistema convalida i nomi dei file selezionati prima di continuare con la schermata successiva. Se non viene trovato un file obbligatorio, viene visualizzato un messaggio ed è necessario indirizzare e deselezionare nuovamente il file o i file.

  

• Dopo la convalida dei nomi dei file, i file verranno caricati per convalidare la struttura dei file selezionati e formattati correttamente con i nomi di intestazione in base alla specifica CSV SDS v2.1.

  • Se si riceve il messaggio: uno o più file trovati non corrispondono al formato previsto. Esaminare la schermata per verificare se i file non sono formattati correttamente. Sarà necessario tornare alla schermata precedente per deselezionare nuovamente i file dopo aver corretto i problemi.

  • Se si riceve il messaggio: non è possibile trovare uno o più file facoltativi. Esaminare la schermata per vedere quali file o file non sono stati trovati. Se questo messaggio non è previsto, è necessario tornare alla schermata precedente per deselezionare nuovamente i file. In caso contrario, selezionare Avanti per continuare.

  

• Dopo la convalida dello schema del file, SDS eseguirà una convalida rapida dei dati dai file caricati. I dati caricati passano attraverso alcune delle regole di corrispondenza e convalida dei dati SDS per identificare i dati facoltativi validi richiesti e forniti. Non si tratta di tutte le regole di convalida, ma di quelle più rilevate.

  Consiglio

  I risultati della convalida dei dati non vengono bloccati durante l'onboarding o il caricamento csv, sono disponibili due opzioni: uscire e tornare in un secondo momento dopo aver corretto i dati o procedere al passaggio successivo per continuare a configurare la connessione dati e successivamente fornire i dati corretti con i caricamenti successivi.

  

  

• Per altre informazioni sui dati contrassegnati per l'analisi, selezionare Visualizza i dettagli per il nome del file nell'elenco per eseguire il drill-in di elementi specifici.

  È possibile scaricare un report in base al file per ottenere un'introduzione all'analisi e alle correzioni nel sistema di origine.

  Le colonne di file contrassegnate vengono visualizzate con la possibilità di espandere e analizzare la regola o le regole contrassegnate.

  

  Facendo clic sulla regola, è possibile visualizzare un altro riepilogo dei primi 10 record, ad esempio.

  

  Al termine dell'indagine, chiudere le finestre di dialogo e quindi selezionare Avanti.

SDS v1 CSV

• Specificare il nome del SIS/SMS dei dati connessi. Includere informazioni che consentono di distinguere i dati connessi tra origini diverse a scopo di gestione e risoluzione dei problemi. Per la versione del formato, selezionare SDS v1 CSV. Selezionare Avanti per continuare.

  

• Selezionare Sfoglia dispositivo per presentare la finestra di dialogo sfoglia e selezione.

  Importante

  Non tutti i campi sono supportati per inserire i dati nella nuova esperienza SDS in base al formato CSV SDS v1 legacy. I dati sono indicati in Formato file CSV SDS v1 nella colonna Obbligatorio. I dati non sono supportati. Inoltre, i valori Grade e Course Subject passati devono essere allineati ai codici List of Values (ENUM) corrispondenti.

  Nota

  Dopo il caricamento iniziale durante la creazione della configurazione dei dati di connessione, sarà necessario fornire sempre lo stesso set di file per i caricamenti successivi, indipendentemente dalle modifiche apportate ai dati nei file facoltativi o meno. In caso contrario, il sistema determinerà che i record non sono più attivi e li contrassegnerà come tali.

  

• Passare al percorso del file e selezionare i file.

  Fare riferimento al formato di file CSV SDS v1.

  Obbligatorio: i tre file elencati devono essere selezionati prima di poter procedere. Se si gestiscono solo utenti e non classi, è sufficiente fornire questi file.

  • school.csv
  • student.csv
  • teacher.csv

  Facoltativo/Obbligatorio: non obbligatorio se si gestiscono solo utenti. Se si gestiscono anche classi e registrazioni di classi, è necessario fornire i tre file elencati, insieme ai tre file precedenti. In caso contrario, non selezionare alcun file con questi nomi. Se uno è selezionato e gli altri non lo sono, quando si seleziona Avanti viene visualizzato un messaggio che indica che uno di questi file è mancante. È necessario correggere prima di continuare.

  • section.csv
  • studentenrollment.csv
  • teacherroster.csv

  Facoltativo: i seguenti sono file facoltativi e vengono usati per migliorare le esperienze. Se uno dei file elencati è selezionato, è necessario selezionare anche l'altro per continuare.

  • user.csv
  • guardianrelationship.csv (richiede record utente e studente per compilare l'associazione di contatti).

  

• Al termine della selezione dei file, selezionare Avanti per continuare. Il sistema convalida i nomi dei file selezionati prima di continuare con la schermata successiva. Se non viene trovato un file obbligatorio, viene visualizzato un messaggio ed è necessario indirizzare e deselezionare nuovamente il file o i file.

  

• Dopo la convalida dei nomi dei file, i file verranno caricati per convalidare la struttura dei file selezionati e formattati correttamente con i nomi di intestazione in base alla specifica CSV SDS v2.1.

  • Se si riceve il messaggio: uno o più file trovati non corrispondono al formato previsto. Esaminare la schermata per verificare se i file non sono formattati correttamente. Sarà necessario tornare alla schermata precedente per deselezionare nuovamente i file dopo aver corretto i problemi.

  • Se si riceve il messaggio: non è possibile trovare uno o più file facoltativi. Esaminare la schermata per vedere quali file o file non sono stati trovati. Se questo messaggio non è previsto, è necessario tornare alla schermata precedente per deselezionare nuovamente i file. In caso contrario, selezionare Avanti per continuare.

  

• Dopo la convalida dello schema del file, SDS eseguirà una convalida rapida dei dati dai file caricati. I dati caricati passano attraverso alcune delle regole di corrispondenza e convalida dei dati SDS per identificare i dati facoltativi validi richiesti e forniti. Non si tratta di tutte le regole di convalida, ma di quelle più rilevate.

  Consiglio

  I risultati della convalida dei dati non vengono bloccati durante l'onboarding o il caricamento csv, sono disponibili due opzioni: uscire e tornare in un secondo momento dopo aver corretto i dati o procedere al passaggio successivo per continuare a configurare la connessione dati e successivamente fornire i dati corretti con i caricamenti successivi.

  

  

• Per altre informazioni sui dati contrassegnati per l'analisi, selezionare Visualizza i dettagli per il nome del file nell'elenco per eseguire il drill-in di elementi specifici.

  È possibile scaricare un report in base al file per ottenere un'introduzione all'analisi e alle correzioni nel sistema di origine.

  Le colonne di file contrassegnate vengono visualizzate con la possibilità di espandere e analizzare la regola o le regole contrassegnate.

  

  Facendo clic sulla regola, è possibile visualizzare un altro riepilogo dei primi 10 record, ad esempio.

  

  Al termine dell'indagine, chiudere le finestre di dialogo e quindi selezionare Avanti.

API OneRoster

• È necessario selezionare il provider SIS/SMS dall'elenco dei provider. Specificare un nome per il SIS/SMS dei dati connessi. Includere informazioni che consentono di distinguere i dati connessi tra origini diverse a scopo di gestione e risoluzione dei problemi. Selezionare Avanti per continuare.

  Fare riferimento ai dati dell'API OneRoster accessibili da SDS.

  Nota

  Se il provider non è incluso nell'elenco, vedere Panoramica del provider OneRoster per istruzioni su come partecipare a test pilota o informazioni da inviare al provider affinché partecipino per l'aggiunta come provider OneRoster.

  

• Per abilitare la connessione al SIS/SMS, è necessario specificare le credenziali di connessione. Selezionare Avanti per continuare.

  • URL di accesso Web: URL in cui l'API OneRoster è accessibile per SIS/SMS

  • ID client usato per connettersi all'API OneRoster SIS/SMS

  • Segreto client usato per connettersi all'API OneRoster SIS/SMS

  • URL del token di accesso, se l'API OneRoster SIS/SMS è configurata per l'autenticazione tramite OAuth2, è necessario fornire l'endpoint URL del token di accesso che deve connettersi. L'endpoint è diverso dall'URL di accesso Web.

  

• SDS testa la connessione al SIS/SMS in base alle informazioni immesse nell'ultima schermata.

  

  • Se non si verificano problemi, si riceve una notifica e si può selezionare Avanti per continuare.

  • Se non è possibile stabilire una connessione, si riceve una notifica e si può selezionare Indietro per esaminare e aggiornare le informazioni fornite.

    

• In base alle funzionalità di dati facoltative supportate dal provider, viene visualizzato l'interruttore attivato (impostazione predefinita) per includere altri dati. Se lo si desidera, è possibile selezionare l'interruttore da disattivare. Se l'interruttore è disattivato e non è disponibile per l'attivazione, il profilo del provider non supporta attualmente la fornitura dei dati facoltativi. Per altre informazioni se il provider supporta l'invio di dati facoltativi, vedere Panoramica del provider di API OneRoster.

  

  Selezionare Avanti per continuare.

• Per evitare che determinate scuole vengano incluse nei dati forniti dal SIS a SDS, è necessario collaborare con il provider per configurare le scuole incluse per la connessione o le credenziali usate per collegare SDS al SIS.

• Selezionare le opzioni della regola di identità utente. Effettuare le selezioni sia per i ruoli del personale che per quello degli studenti. Se le regole sono diverse per il personale e gli studenti, selezionare l'opzione di suddivisione per definire regole univoche. Dopo aver soddisfatto le selezioni, selezionare Avanti per continuare.

  Nota

  La corrispondenza utente viene eseguita durante l'inserimento dei dati e non scrive o aggiorna gli oggetti utente in Microsoft Entra ID. La corrispondenza viene eseguita e archiviata nel data lake SDS. Per altre informazioni, vedere Gestire i dati al tipo di provisioning utenti di Microsoft 365 durante la scrittura del collegamento di corrispondenza in avanti durante la gestione dei dati a Microsoft 365.

  • Attributo dall'origine: attributo utente basato sui dati provenienti dal SIS/SMS.
    • Le opzioni di origine disponibili sono Username, Email e ActiveDirectory MatchId.
  • Attributo da associare a: proprietà utente in Microsoft Entra ID a cui corrispondere.
    • Le opzioni di corrispondenza di Microsoft Entra ID disponibili sono UserPrincipalName e Mail.
  • (FACOLTATIVO) Se i dati utente non includono il valore @domain , selezionare un dominio dall'elenco.

  Avviso

  La selezione di un dominio è facoltativa e deve essere usata solo se i dati in ingresso in base all'attributo selezionato dall'origine non includono il valore @domain . SDS non controlla e accoda se il valore è mancante in un record. SDS accoderà la selezione di dominio a tutti i record che potrebbero causare @domain@domain e non trovare corrispondenze in tali istanze per il mapping utente esistente con gli utenti in Microsoft Entra ID.

  Attenzione

  Se gli utenti SIS/SMS, ad esempio gli utenti del gruppo di ruoli del personale, possono essere associati a @domain1 o @domain2 o @domain3 è necessario includere un @domain nei dati di origine, in base all'attributo selezionato dalla selezione dell'origine (ad esempio: prefix@domain). Questa operazione è necessaria affinché l'attributo corrisponda a: UserPrincipalName o Mail per trovare l'utente Microsoft Entra corretto con cui trovare la corrispondenza.

  Nell'istanza in cui un utente ha più ruoli, vengono usate le regole seguenti per determinare quali regole di corrispondenza tra il personale o gli studenti devono essere usate tra il record utente e l'oggetto utente di Microsoft Entra.

  • Se isPrimary è impostato per tutti i ruoli degli studenti, anche se esiste l'associazione a un ruolo del personale, la corrispondenza viene eseguita in base al ruolo dello studente.

  • Se isPrimary è impostato per qualsiasi ruolo del personale, anche se esiste l'associazione a un ruolo di studente, la corrispondenza viene effettuata in base al ruolo del personale.

  • Se isPrimary è impostato sia per il ruolo del personale che per quello degli studenti, la corrispondenza viene eseguita in base al ruolo del personale.

  • Se isPrimary non è impostato per alcun ruolo, in particolare con una combinazione per i ruoli sia del personale che degli studenti, la corrispondenza si basa sul ruolo del personale.

  Importante

  Quando si configura Gestisci dati nel tipo di provisioning utenti di Microsoft 365, queste regole vengono usate se l'opzione è attivata in Crea utenti non corrispondenti, per definire il costrutto per la proprietà UserPrincipalName di Microsoft Entra.

  

• Immettere la data in cui SDS deve impedire la sincronizzazione degli aggiornamenti ai dati dall'origine dati connessa. La maggior parte dei casi interrompe la sincronizzazione dei dati al termine dell'anno accademico. Il massimo è 18 mesi dalla data di inizio della sincronizzazione.

  

• Esaminare le informazioni presentate. Se tutto è corretto, selezionare il pulsante Connetti dati . In caso contrario, è possibile tornare alla correzione.

  

  

• La configurazione dei dati di connessione viene creata e la prima esecuzione è in sospeso, selezionare il pulsante Completato .

  

  Consiglio

  È possibile configurare la configurazione gestisci dati immediatamente dopo aver definito la configurazione dei dati connect, durante la prima esecuzione attiva o dopo il completamento della prima esecuzione.

  

• Per controllare lo stato dell'esecuzione della sincronizzazione, tornare alla pagina Home del dashboard.

  Se non si verificano problemi con i dati, il dashboard Home verrà visualizzato senza errori o avvisi di dati. Durante l'ultima esecuzione non sono stati rilevati errori o avvisi relativi ai dati. Continuate il grande lavoro!

  Se si verificano problemi con i dati, il dashboard Home informa che sono stati rilevati alcuni problemi con i dati. È consigliabile analizzare l'integrità della sincronizzazione.

  Consiglio

  Per fornire aggiornamenti ai dati dopo il caricamento csv iniziale, vedere Caricamento csv SDS manuale.

  Consiglio

  È possibile automatizzare il caricamento csv usando Power Automate. Per altre informazioni, vedere Automatizzare i caricamenti csv SDS.

Modificare la configurazione dei dati connect

• Dal dashboard home usare lo spostamento a sinistra per passare alla sincronizzazione | Configurazione.

Modifica csv

Importante

I passaggi seguenti sono gli stessi indipendentemente dal formato CSV SDS v1 o v2.1.

• Nella scheda Dati connessi selezionare Modifica dettagli origine per l'origine configurata.

  Consiglio

  Per fornire aggiornamenti ai dati dopo il caricamento csv iniziale, vedere Caricamento csv manuale.

Modificare l'API OneRoster

Importante

I passaggi seguenti illustrano anche come modificare le credenziali di connessione per l'origine.

• Nella scheda Dati connessi selezionare Modifica dettagli origine per l'origine configurata.

• Viene visualizzata un'opzione per modificare le credenziali dell'API. L'interruttore predefinito è selezionato su Disattivato. Dopo aver determinato l'opzione, selezionare Avanti per continuare.

  • Selezionando No (impostazione predefinita) è possibile modificare i dati facoltativi, le regole di identità e la configurazione della data di fine della sincronizzazione.
  • Se si seleziona Sì , è possibile aggiornare le credenziali di connessione del provider corrente, insieme ai dati facoltativi, alle regole di identità e alla configurazione dei dati finali di sincronizzazione.

  

• Per aggiornare la connessione al SIS/SMS, è necessario esaminare e aggiornare le credenziali di connessione di conseguenza. Vengono visualizzate le informazioni di connessione immesse in precedenza, meno il segreto client. È necessario specificare il segreto client esistente o nuovo.

  • Esaminare/aggiornare l'URL di accesso Web in cui è accessibile l'API SIS/SMS.

  • Esaminare/aggiornare l'ID client usato per connettersi all'API SIS/SMS.

  • Specificare il segreto client usato per connettersi all'API SIS/SMS.

  • Se il SIS/SMS è configurato per l'autenticazione tramite OAuth2, è necessario esaminare/aggiornare l'endpoint URL del token di accesso usato per connettersi all'API SIS/SMS. L'URL del token di accesso è diverso dall'URL di accesso Web.

  • Selezionare Avanti per continuare.

  

• Successivamente, la connessione al SIS/SMS viene testata in base alle informazioni immesse.

  

  • Se non si verificano problemi, si riceve una notifica e si può selezionare Avanti per continuare.
  • Se non è possibile stabilire una connessione, si riceve una notifica e si è in grado di selezionare Indietro per esaminare e aggiornare le informazioni fornite.

  

• In base alle funzionalità di dati facoltative supportate dal provider, vengono visualizzati gli interruttori per includere altri dati. Se lo si desidera, è possibile selezionare l'interruttore da attivare o disattivare. Se l'interruttore non è disponibile, il profilo del provider non supporta attualmente la fornitura di tali dati. Per altre informazioni se il provider supporta l'invio di dati facoltativi, vedere Panoramica del provider di API OneRoster.

  Nota

  Se si disattiva un interruttore, questa azione impedirà solo nuovi o aggiornamenti ai dati corrispondenti in un'esecuzione futura. I dati esistenti inseriti non verranno rimossi.

  

  Selezionare Avanti per continuare.

• Esaminare le opzioni delle regole di identità utente.

  Nota

  La corrispondenza utente viene eseguita durante l'inserimento dei dati e non scrive o aggiorna gli oggetti utente in Microsoft Entra ID. La corrispondenza viene eseguita e archiviata nel data lake SDS. Per altre informazioni, vedere Gestire i dati al tipo di provisioning utenti di Microsoft 365 durante la scrittura del collegamento di corrispondenza in avanti durante la gestione dei dati a Microsoft 365.

  • Attributo dall'origine: attributo utente basato sui dati provenienti dal SIS/SMS.
    • Le opzioni di origine disponibili sono Username, Email e ActiveDirectory MatchId.
  • Attributo da associare a: proprietà utente in Microsoft Entra ID a cui corrispondere.
    • Le opzioni di corrispondenza di Microsoft Entra ID disponibili sono UserPrincipalName e Mail.

  Affinché l'attributo corrisponda a: UserPrincipalName o Mail, ad esempio, prefix@domain, è necessario includere un @domain nei dati di origine.

  Nell'istanza in cui un utente ha più ruoli, vengono usate le regole seguenti per determinare quali regole di corrispondenza tra il personale o gli studenti devono essere usate tra il record utente e l'oggetto utente di Microsoft Entra.

  • Se isPrimary è impostato per tutti i ruoli degli studenti, anche se esiste l'associazione a un ruolo del personale, la corrispondenza viene eseguita in base al ruolo dello studente.

  • Se isPrimary è impostato per qualsiasi ruolo del personale, anche se esiste l'associazione a un ruolo di studente, la corrispondenza viene effettuata in base al ruolo del personale.

  • Se isPrimary è impostato sia per il ruolo del personale che per quello degli studenti, la corrispondenza viene eseguita in base al ruolo del personale.

  • Se isPrimary non è impostato per alcun ruolo, in particolare con una combinazione per i ruoli sia del personale che degli studenti, la corrispondenza si basa sul ruolo del personale.

  Importante

  Quando si configura Manage data to Microsoft 365 user provisingin type ,queste regole vengono usate se l'opzione è attivata in Crea utenti non corrispondenti, per definire il costrutto per la proprietà Microsoft Entra UserPrincipalName.

  Selezionare Avanti per continuare.

  

• Esaminare la data in cui SDS deve impedire la sincronizzazione degli aggiornamenti ai dati dall'origine dati connessa. La maggior parte dei casi interrompe la sincronizzazione dei dati al termine dell'anno accademico. Il massimo è 18 mesi dalla data di inizio della sincronizzazione.

  

• Esaminare le informazioni presentate. Se tutto è corretto, selezionare il pulsante Invia . In caso contrario, è possibile tornare indietro per correggere.

  

  

• La configurazione dei dati di connessione viene aggiornata e selezionare Il pulsante Chiudi .