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

È possibile utilizzare file con valori delimitati da virgole (CSV) nel formato intelligente con School Data Sync (SDS) per importare e sincronizzare i dati del sistema di informazioni di Student (SIS) in Office 365.You can use Comma Separated Value (CSV) files in the Clever format 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. Se si utilizza questo metodo, verranno esportati o creati i file CSV nel formato intelligente contenente i dati SIS, si configura un profilo di sincronizzazione e si caricano i file CSV in SDS per l'elaborazione.Using this method,you will export or create your CSV Files in the Clever format containing your SIS data, set up a synchronization profile, and upload the CSV files into SDS for processing.

Prima di iniziareBefore you get started

Prima di iniziare la sincronizzazione con SDS usando il metodo di sincronizzazione intelligente, leggere la Panoramica di School Data Sync.Before you start synchronizing with SDS using the Clever Sync 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 amministratore globaleGlobal Administrator 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 esportato o creato i [file CSV in formato intelligente](clever-format-csv-files-for-SDS.md).Make sure you've exported or created your [Clever format CSV files](clever-format-csv-files-for-SDS.md). 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

Per accedere al portale di amministrazione di School Data Sync, aprire un Web browser privato, passare a SDS.Microsoft.com e quindi accedere con le credenziali di amministratore globale per il tenant di Office 365 Education.To access the School Data Sync Admin Portal launch a private web browser, navigate to sds.microsoft.com and then sign-in using the Global Admin credentials for your Office 365 Education tenant.

Creare un profilo di sincronizzazione e sincronizzare i file CSV in formato intelligenteCreate a Sync Profile and Sync your Clever format CSV files

  1. Dopo aver eseguito l'accesso, fare clic su + Aggiungi profilo per creare un profilo di sincronizzazione SDS e iniziare a sincronizzare i dati da clever.After signing in, click + Add Profile to create an SDS Sync Profile and begin syncing data from Clever.

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

  2. 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-by-using-Clever-format-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.This name will be used to identify the sync profile in the SDS Dashboard.
  • Scegliere il metodo di sincronizzazione : scegliere tra le opzioni disponibili, caricare i file CSV e la connessione tramite i metodi API.Choose your sync method - Choose between the available options, Upload CSV files and Connection via an API methods. Se si sta eseguendo la sincronizzazione con i file CSV nel formato intelligente, selezionare l'opzione per i file CSV.If you're syncing using CSV files in the Clever format, select the option for CSV files.
  • Scegliere il tipo di CSV : scegliere tra i formati di file CSV disponibili.Choose the type of CSV - Choose between the available CSV file formats. Se si sta eseguendo la sincronizzazione con i file CSV nel formato intelligente, selezionare file CSV: formato intelligente.If you're syncing using CSV files in the Clever format, select CSV files: Clever 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. Fare quindi clic su Carica file per caricare i file CSV in formato intelligente.Then click upload files to upload your Clever format CSV files. Dopo aver caricato, completare le selezioni nella pagina in base alle esigenze, quindi fare clic su Avanti.Once uploaded, complete your selections on the page as appropriate, then click Next.

    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 dell'istanza intelligente.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 Clever instance.

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

  • Pulsante Carica file -fare clic su questo pulsante per caricare i file CSV in formato intelligente.Upload Files button - Click this button to upload your Clever format 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 insegnanti selezionare le opzioni di corrispondenza identità appropriate, verificare che le proprietà dell'insegnante che si desidera sincronizzare siano selezionate, quindi fare clic su Avanti.On the Teachers options page, select the appropriate identity matching options, confirm the teacher properties you want to sync are selected, then click Next. SDS verificherà la possibilità di selezionare gli attributi e le opzioni all'interno del formato corretto.SDS will check to ensure your selecting attribute and options within the correct format. Se ad esempio è corrispondente a un UserPrincipalName, è necessario selezionare un attributo di directory di origine nel formato di un UserPrincipalName (prefix@domain.com) oppure è necessario scegliere di aggiungere un dominio all'attributo della directory di origine per garantire la formattazione appropriata.If matching to 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 the appropriate 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 appropriate format to complete a match, you’ll see a red error displayed on the page. how-to-deploy-SDS-using-CSV-files-3.PNGhow-to-deploy-SDS-using-CSV-files-3.PNG
  • Chiave primaria (directory di origine) -attributo del docente nel formato CSVs utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Source Directory) - This is the Teacher attribute in your Clever format CSVs 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 gli insegnanti.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 teachers.
  • 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 il dominio all'interno della directory di origine oppure è possibile aggiungere il dominio appropriato all'attributo di origine utilizzando il menu a discesa.Your source attribute must either include the domain within the source directory 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à la possibilità di selezionare gli attributi e le opzioni all'interno del formato corretto.SDS will check to ensure your selecting attribute and options within the correct format. Se ad esempio è corrispondente a un UserPrincipalName, è necessario selezionare un attributo di directory di origine nel formato di un UserPrincipalName (prefix@domain.com) oppure è necessario scegliere di aggiungere un dominio all'attributo della directory di origine per garantire la formattazione appropriata.If matching to 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 the appropriate 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 appropriate format to complete a match, you’ll see a red error displayed on the page. how-to-deploy-SDS-using-CSV-files-4.PNGhow-to-deploy-SDS-using-CSV-files-4.PNG
  • Chiave primaria (directory di origine) -questo è l'attributo Student nel formato CSVs utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Source Directory) - This is the Student attribute in your Clever format CSVs 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 Revisioneverificare 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. how-to-deploy-SDS-using-CSV-files-5.PNG dopo aver creato un profilo di sincronizzazione, SDS inizierà una procedura di convalida pre-sincronizzazione.how-to-deploy-SDS-using-CSV-files-5.PNG 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, sarà possibile correggerli e ricaricare i file 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 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.

Per facilitare l'automazione del processo di sincronizzazione dopo aver configurato il profilo di sincronizzazione, è possibile installare Microsoft School Data Sync Toolkit.To help automate the sync process after setting up your sync profile, you can install the Microsoft School Data Sync Toolkit. Questo strumento consente di creare una pianificazione di sincronizzazione automatizzata tra file CSV e Office 365 e può essere utilizzata anche per verificare i dati del file CSV.This tool helps you to create an automated sync schedule between CSV files and Office 365 and can also be used to verify the CSV file data. Per ulteriori informazioni, vedere Install the Microsoft School Data Sync Toolkit.For details, see Install the Microsoft School Data Sync Toolkit.

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:


Panoramica di School Data SyncOverview of School Data Sync

File CSV per School Data SyncCSV files for School Data Sync

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

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