Condividi tramite


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.

    Screenshot che mostra il messaggio di benvenuto.

  • Selezionare Continua.

    Screenshot che mostra la panoramica di SDS.

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

    Screenshot che mostra in sospeso durante l'attesa del completamento del provisioning del servizio.

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

    Screenshot che mostra la richiesta di formato CSV o API.

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

    Screenshot che mostra la richiesta di nome e formato csv v2.1.

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

    Screenshot della selezione del prompt per cercare i file CSV v2.1.

  • 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

    Screenshot dell'esplorazione del percorso del file e della selezione dei file CSV v2.1.

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

    Screenshot che mostra la convalida dei nomi di file CSV v2.1.

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

    Screenshot dei file v2.1 che caricano e convalidano le intestazioni dei file.

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

    Screenshot dell'elaborazione dei file v2.1 tramite la convalida dei dati.

    Screenshot dei file v2.1 elaborati tramite la convalida dei dati.

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

    Screenshot del file CSV v2.1 selezionato per visualizzare i dettagli.

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

    Screenshot del file v2.1 selezionato per visualizzare i dettagli della regola selezionati.

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

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

    Screenshot che mostra le richieste delle regole di identità utente.

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

    Screenshot che mostra la richiesta di data di fine della sincronizzazione.

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

    Screenshot della revisione.

    Screenshot dell'elaborazione.

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

    Screenshot che indica che viene creata la configurazione dei dati di connessione per l'origine.

    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.

    Screenshot che mostra il dashboard principale e l'azione di gestione dei dati.

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

Importante

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

Screenshot che mostra la configurazione della sincronizzazione csv.

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

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

    Screenshot che mostra la modifica per le richieste delle regole di identità utente.

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

    Screenshot che mostra la modifica per il prompt della data di fine della sincronizzazione.

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

    Screenshot della revisione delle modifiche.

    Screenshot dell'elaborazione delle modifiche.

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

    Screenshot che indica che la configurazione dei dati di connessione per l'origine viene aggiornata.