Come implementare School Data Sync tramite file CSVHow to deploy School Data Sync by using CSV files

È possibile utilizzare file con valori delimitati da virgole (CSV) con School Data Sync (SDS) per importare e sincronizzare i dati SIS (Student Information System) in Office 365.You can use Comma Separated Value (CSV) files with School Data Sync (SDS) to import and synchronize your Student Information System (SIS) data to Office 365. SDS può sincronizzare studenti, docenti, scuole, sezioni e informazioni di roster da SIS ad Azure Active Directory e Office 365.SDS can sync students, teachers, schools, sections, and roster information from your SIS to Azure Active Directory and Office 365. Usando questo metodo, è possibile esportare o creare file CSV per School Data Sync dai dati SIS, impostare un profilo di sincronizzazione e caricare il CSVs in SDS per l'elaborazione.Using this method, you will export or create CSV files for School Data Sync from your SIS data, set up a synchronization profile, and upload the CSVs into SDS for processing.

In questo argomento:In this topic:

Prima di iniziareBefore you get started

Prima di iniziare la sincronizzazione con SDS usando il metodo di importazione CSV, leggere la Panoramica di School Data Sync.Before you start synchronizing with SDS using the CSV Import method, read the Overview of School Data Sync.

Verificare che siano soddisfatti i prerequisiti seguenti:Make sure you meet the following prerequisites:

  • Un Office 365 per l'istruzione tenantAn Office 365 for Education tenant

  • Account Admininstrator globaleGlobal Admininstrator Account

  • School Data Sync (piano 1) abilitatoSchool Data Sync (Plan 1) enabled

Nota

I dati forniti tramite School Data Sync possono essere accessibili ai provider di applicazioni di terze parti tramite le proprie app, pertanto è necessario sincronizzare solo i dati che si desidera rendere disponibili per queste terze parti.The data that you provide through School Data Sync may be accessible to third-party application providers through their apps, so you should sync only the data that you want to make available to these third parties.

Creare un profilo di sincronizzazione e importare i file CSVCreate a Sync Profile and Import your CSV files

Guarda il video: Deploy School Data SyncWatch the video: Deploy School Data Sync

Assicurarsi di aver creato i sei file CSV e che siano pronti per l'uso.Make sure you've created your six CSV files and they're ready to use. Eseguire quindi la procedura seguente per importare i file e creare il profilo di sincronizzazione.Then follow these steps to import the files and create your sync profile. Un profilo di sincronizzazione è solo un gruppo di opzioni e impostazioni utilizzate da SDS per sincronizzare i dati CSV che si intende caricare.A sync profile is just a group of options and settings used by SDS to sync the CSV data which you plan to upload. È possibile creare più profili di sincronizzazione all'interno di un singolo tenant di Office 365.You can create multiple sync profiles within a single Office 365 tenant.

Accesso SDS e login per la prima voltaSDS Access and First Time Login

  1. Per accedere al portale di amministrazione di School Data Sync, aprire un Web browser privato, accedere a sds.microsoft.com, fare clic su Accedi e quindi immettere le credenziali dell'account di amministratore globale di O365.To access the School Data Sync Admin Portal launch a private web browser, navigate to sds.microsoft.com, click Sign-In, then enter your O365 Global Admin account credentials.

Creare un profilo di sincronizzazione e caricare i file CSVCreate a Sync Profile and Upload your CSV Files

  1. Dopo aver eseguito l'accesso, fare clic su + Aggiungi profilo nel riquadro di spostamento sinistro per creare un profilo di sincronizzazione.After logging in, click + Add Profile in the left hand navigation pane to create a Sync Profile.

how-to-deploy-SDS-using-CSV-files.PNG

  1. Nella pagina scegliere il tipo di connessione completare il modulo in base alle esigenze.On the Choose Connection Type page, complete the form as appropriate. Una volta completata, fare clic su Avvia.Once complete, click Start.

how-to-deploy-SDS-using-CSV-files-1.PNG

  • Denominare il profilo : immettere un nome per il profilo di sincronizzazione.Name this profile - Enter a name for your sync profile. Questo nome verrà utilizzato per identificare il profilo di sincronizzazione nel dashboard SDS e non può essere modificato dopo il completamento della configurazione del profilo.This name will be used to identify the sync profile in the SDS Dashboard, and cannot be changed once the profile setup is complete.

  • Scegliere il metodo di sincronizzazione : scegliere tra i 2 metodi di sincronizzazione disponibili, ovvero CSV o API.Choose your sync method - Choose between the 2 available sync methods shown, CSV or API. Se si sta eseguendo la sincronizzazione con i file CSV, selezionare CSV, quindi selezionare l'opzione per il formato SDS.If you're syncing using CSV files, select CSV, then select the option for the SDS format.

  1. Nella pagina Opzioni di sincronizzazione selezionare l'opzione appropriata per creare nuovi utenti o sincronizzare gli utenti esistenti.On the Sync Options page, select the appropriate option to create new users or sync existing users. Quindi fare clic su Carica file per caricare i 6 file CSV.Then click upload files to upload your 6 CSV files. Dopo aver caricato, completare le selezioni nella pagina in base alle esigenze.Once uploaded, complete your selections on the page as appropriate.

how-to-deploy-SDS-using-CSV-files-2.PNG

  • Utenti esistenti -selezionare questa opzione se si dispone già di account utente creati all'interno del tenant di O365 per ognuno degli studenti e insegnanti contenuti all'interno dei file CSV.Existing Users - Select this option if you already have user accounts created within your O365 tenant for each of the students and teachers contained within your CSV files.

  • Nuovi utenti -selezionare questa opzione se si desidera che SDS crei account utente per ogni studente e insegnante contenuto all'interno dei file CSV.New Users - Select this option if you want SDS to create user accounts for each of your students and teachers contained within your CSV files.

  • Pulsante Carica file -fare clic su questo pulsante per caricare i 6 file CSV.Upload Files button - Click this button to upload your 6 CSV files. Al momento del caricamento SDS eseguirà alcuni brevi test di convalida per assicurarsi che i file siano formattati correttamente.Upon upload SDS will perform some brief validation tests to ensure the files are formatted correctly. Se la convalida viene passata, i file verranno caricati nel profilo di sincronizzazione.If the validation passes, your files will be uploaded into the sync profile.

  • Proprietà School -dopo aver caricato i file CSV, gli attributi contenuti all'interno del School.csv verranno selezionati automaticamente.School properties - After uploading your CSV files, the attributes contained within your School.csv will be auto- selected. È consigliabile convalidare gli attributi selezionati qui sono gli stessi attributi contenuti nel School.csvYou should validate the attributes selected here are the same attributes contained in your School.csv

  • Proprietà della sezione -dopo aver caricato i file CSV, gli attributi contenuti all'interno del Student.csv verranno selezionati automaticamente.Section Properties - After uploading your CSV files, the attributes contained within your Student.csv will be auto-selected. È consigliabile convalidare gli attributi selezionati qui sono gli stessi attributi contenuti nel School.csvYou should validate the attributes selected here are the same attributes contained in your School.csv

  • Opzione per la creazione del team: se si verifica questa casella, verrà creato sia il gruppo di M365 che il team di classe per ogni classe sincronizzata.Team Creation Option – Checking this box will ensure SDS creates both the M365 Group and Class Team for each class synced. Se si lascia la casella deselezionata, SDS creerà solo i gruppi di M365.If you leave the box unchecked, SDS will only create the M365 Groups.

  • Sostituisci caratteri speciali non supportati: la verifica di questa casella consentirà a SDS di sostituire automaticamente i caratteri speciali non supportati durante l'esecuzione della sincronizzazione.Replace unsupported special characters- Checking this box will allow SDS to automatically replace unsupported special characters while the sync is running. I caratteri speciali verranno sostituiti da un "" e non si otterrà più un errore durante il processo di sincronizzazione per tale oggetto.Special characters will be replaced with an "", and no longer result in an error during the sync process for that object.

  • Opzione di sincronizzazione per il nome visualizzato di un gruppo di sezioni : la casella di controllo consente agli insegnanti di controllare il nome visualizzato della sezione dopo la prima sincronizzazione e impedire a SDS di sovrascrivere le modifiche apportate alla sezione DisplayName eseguite dagli insegnanti.Sync option for Section Group Display Name - Checking this box will allow teachers to control the section display name after the first sync, and prevent SDS from overwriting Section DisplayName changes made by teachers.

  • Delay Student Access -l'abilitazione di questa opzione consente di impostare una data futura che consenta agli studenti di visualizzare le proprie classi.Delay Student Access - Enabling this option will allow you to set a future date for students to view their classes. Disabilitare questa opzione per consentire agli studenti di visualizzare immediatamente le proprie classi.Disable this option to allow students view their classes immediately.

  • Quando interrompere la sincronizzazione?When should we stop syncing? -In genere si desidera eseguire questa operazione alla fine dell'anno scolastico.- You will typically want to do this at the end of the school year. Dopo aver interrotto la sincronizzazione di questo profilo, si avrà la possibilità di ritirare le classi associate al profilo.Once we stop syncing this profile, you will have the option to retire the classes associated with this profile.

  1. Nella pagina Opzioni insegnante , selezionare le opzioni di corrispondenza identità appropriate, confermare che le proprietà del docente siano selezionate, quindi fare clic su Avanti.On the Teacher options page, select the appropriate identity matching options, confirm the teacher properties are selected, then click Next.

SDS verificherà se si selezionano gli attributi e le opzioni all'interno del formato corretto.SDS will check to ensure you're selecting attributes and options within the correct format. Se ad esempio si corrisponde a un UserPrincipalName, è necessario selezionare un attributo di directory di origine nel formato di un UserPrincipalName (prefix@domain.com) oppure scegliere di aggiungere un dominio all'attributo della directory di origine per garantire la corretta formattazione.If matching a UserPrincipalName for example, you must select a source directory attribute which is in the format of a UserPrincipalName (prefix@domain.com) or you must choose to append a domain to the source directory attribute to ensure proper formatting. Se le selezioni non sono nel formato appropriato per completare una corrispondenza, nella pagina verrà visualizzato un errore rosso.If your selections are not in the proper format to complete a match, you'll see a red error displayed on the page.

how-to-deploy-SDS-using-CSV-files-3.PNG

  • Chiave primaria (directory di origine) : l'attributo del docente nel file CSV utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Source Directory) - This is the Teacher attribute in the CSV file used for SDS Identity Matching. Guardare il video relativo all'identità corrispondente per ulteriori informazioni su come selezionare l'attributo di directory di origine appropriato e configurare correttamente le impostazioni di corrispondenza delle identità per il docente.Watch the Identity Matching video for additional information on how to select the appropriate source directory attribute, and properly configure the identity matching settings for teacher.

  • Chiave primaria (directory di destinazione) -questo è l'attributo utente in Azure ad utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Target Directory) - This is the User attribute in Azure AD used for SDS Identity Matching. Guardare il video relativo all'identità corrispondente per ulteriori informazioni su come selezionare l'attributo di directory di destinazione appropriato e configurare correttamente le impostazioni di corrispondenza dell'identità per il docente.Watch the Identity Matching video for additional information on how to select the appropriate target directory attribute, and properly configure the identity matching settings for the teacher.

  • Domain (facoltativo) -questo è un valore di dominio facoltativo che è possibile aggiungere all'attributo di directory di origine selezionato per completare la corrispondenza dell'identità del docente.Domain (optional) - This is an optional domain value that you can add to the selected Source Directory attribute to complete your Teacher Identity Matching. Se è necessario corrispondere a un attributo UserPrincipalName o di posta, è necessario disporre di un dominio incluso nella stringa.If you need to match to a UserPrincipalName or Mail attribute, you must have a domain included in the string. L'attributo di origine deve includere già il dominio oppure è possibile aggiungere il dominio appropriato all'attributo di origine utilizzando il menu a discesa.Your source attribute must either include the domain already or you can append the appropriate domain to the source attribute using this dropdown menu.

  1. Nella pagina Opzioni studenti selezionare le opzioni di corrispondenza identità appropriate, confermare che le proprietà degli studenti siano selezionate e quindi fare clic su Avanti.On the Student options page, select the appropriate identity matching options, confirm the student properties are selected, and then click Next. SDS verificherà se si selezionano gli attributi e le opzioni all'interno del formato corretto.SDS will check to ensure you're selecting attributes and options within the correct format. Se ad esempio si corrisponde a un UserPrincipalName, è necessario Selecta attributo di directory di origine che si trova nel formato di un UserPrincipalName (prefix@domain.com) oppure è necessario scegliere di aggiungere un dominio all'attributo della directory di origine per garantire la corretta formattazione.If matching a UserPrincipalName for example, you must selecta source directory attribute which is in the format of a UserPrincipalName (prefix@domain.com) or you must choose to append a domain to the source directory attribute to ensure proper formatting. Se le selezioni non sono nel formato appropriato per completare una corrispondenza, nella pagina verrà visualizzato un errore rosso.If your selections are not in the proper format to complete a match, you'll see a red error displayed on the page.

how-to-deploy-SDS-using-CSV-files-4.PNG

  • Chiave primaria (directory di origine) -questo è l'attributo Student nel file CSV utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Source Directory) - This is the Student attribute in the CSV file used for SDS Identity Matching. Guardare il video relativo all'identità corrispondente per ulteriori informazioni su come selezionare l'attributo di directory di origine appropriato e configurare correttamente le impostazioni di corrispondenza delle identità per il docente.Watch the Identity Matching video for additional information on how to select the appropriate source directory attribute, and properly configure the identity matching settings for teacher.

  • Chiave primaria (directory di destinazione) -questo è l'attributo utente in Azure ad utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Target Directory) - This is the User attribute in Azure AD used for SDS Identity Matching. Guardare il video relativo all'identità corrispondente per ulteriori informazioni su come selezionare l'attributo di directory di destinazione appropriato e configurare correttamente le impostazioni di corrispondenza delle identità per lo studente.Watch the Identity Matching video for additional information on how to select the appropriate target directory attribute, and properly configure the identity matching settings for the student.

  • Domain (facoltativo) -questo è un valore di dominio facoltativo che è possibile aggiungere all'attributo di directory di origine selezionato per completare la corrispondenza dell'identità degli studenti.Domain (optional) - This is an optional domain value that you can add to the selected Source Directory attribute to complete your Student Identity Matching. Se è necessario corrispondere a un attributo UserPrincipalName o di posta, è necessario disporre di un dominio incluso nella stringa.If you need to match to a UserPrincipalName or Mail attribute, you must have a domain included in the string. L'attributo di origine deve includere già il dominio oppure è possibile aggiungere il dominio appropriato all'attributo di origine utilizzando il menu a discesa.Your source attribute must either include the domain already or you can append the appropriate domain to the source attribute using this dropdown menu.

  1. Nella pagina Revisione verificare che siano state apportate le selezioni appropriate.On the Review page, ensure you've made the appropriate selections. Se non sono necessarie ulteriori modifiche, fare clic su Crea profilo.If no additional changes are needed, click Create Profile. Dopo aver creato un profilo di sincronizzazione, SDS inizierà una procedura di convalida pre-sincronizzazione.Once you create a sync profile, SDS will begin a pre-sync validation process. Durante questo processo, SDS assicurerà che non vi siano errori evidenti con i file CSV.During this process, SDS will ensure there are no obvious errors with your CSV files. Se si verificano errori durante il processo di convalida preliminare alla sincronizzazione, è possibile correggerli e caricarli di nuovo prima di fare clic sul pulsante Riprendi sincronizzazione e avviare il processo di sincronizzazione reale.If any errors are found during the pre-sync validation process, you will have the option to fix them and re-upload the files before clicking the resume sync button and begin the real synchronization process. Se si ricevono errori e si sceglie di non aggiornarli, è comunque possibile scegliere di riprendere la sincronizzazione senza correggere gli errori.If you receive errors and choose not to update them, you can still choose to resume sync without fixing the errors. Basta tenere presente che SDS può sostenere fino a 15.000 errori prima che il profilo entri nello stato di quarantena.Just be aware that SDS can only sustain up to 15,000 errors before the profile will enter a quarantine status. how-to-deploy-SDS-using-CSV-files-5.PNGhow-to-deploy-SDS-using-CSV-files-5.PNG

Per semplificare il processo di sincronizzazione dopo aver configurato il profilo di sincronizzazione, è possibile utilizzare Microsoft Flow per caricare i file CSV in SDS.To help automate the sync process after setting up your sync profile, you can Use Microsoft Flow to upload CSV files to SDS. In questo modo è possibile gestire l'intero processo di caricamento tramite l'interfaccia utente nel cloud, che è molto più semplice da utilizzare rispetto agli script di PowerShell.This enables you manage the entire upload process via UI in the cloud, which is much simpler to use than PowerShell scripts.

Video: come associare gli attributi di origine e di destinazione per la sincronizzazioneVideo: How to match source and target attributes for sync

Per diversi esempi di risultati della logica di corrispondenza e di errore per la sincronizzazione, guardare il video corrispondente all'identità:For various examples of matching logic success and failure for sync, watch the Identity Matching video:


##Argomenti correlati

Panoramica di School Data SyncOverview of School Data Sync

File CSV per School Data SyncCSV files for School Data Sync

Come distribuire School Data Sync tramite PowerSchool SyncHow to deploy School Data Sync by using PowerSchool Sync

Come distribuire School Data Sync tramite file CSV in formato cleverHow to deploy School Data Sync by using CSV files in the Clever format

Come distribuire School Data Sync tramite file CSV OneRosterHow to deploy School Data Sync by using OneRoster CSV files

Errori di SDSSDS Errors

Risoluzione dei problemi di SDSSDS Troubleshooting

Processo di convalida del file CSV SDSSDS CSV File Validation Process