Come distribuire School Data Sync tramite OneRoster® API 1,1How to deploy School Data Sync by using OneRoster® 1.1 API

OneRoster® è un formato standard del settore per Exchange di dati del sistema informativo degli studenti (SIS) e le API REST di OneRoster® sono il mezzo tramite il quale è possibile sincronizzare gli oggetti dai sistemi informativi degli studenti che forniscono API di® di OneRoster a O365 tramite il servizio SDS (School Data Sync).OneRoster® is an Industry Standard format for exchange of Student Information System (SIS) data, and the OneRoster® REST APIs are the means by which we can sync objects from Student Information Systems that provide OneRoster® APIs to O365 through the School Data Sync (SDS) service. Se si utilizza questo metodo di sincronizzazione, è possibile connettersi direttamente al SIS utilizzando le API di OneRoster 1,1 basate su REST fornite dal SIS e sincronizzare i dati direttamente anziché utilizzare i file CSV.Using this sync method, you can connect directly to your SIS using the REST-based OneRoster 1.1 APIs provided by the SIS, and synchronize data directly instead of using CSV files. Per configurare SDS tramite il metodo di sincronizzazione® OneRoster, seguire le istruzioni riportate in questo articolo.To set up SDS using the OneRoster® Sync method, follow the instructions detailed in this article.

In questo argomento:In this topic:

PrerequisitiPrerequisites

Prima di avviare la sincronizzazione con SDS tramite il metodo di sincronizzazione® OneRoster, leggere la Panoramica di School Data Sync e verificare di aver soddisfatto i prerequisiti seguenti:Before you start synchronizing with SDS using the OneRoster® Sync method, read the Overview of School Data Sync and make sure you meet the following prerequisites:

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

  • Autorizzazioni di amministratore globaleGlobal Admin Permissions

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

Guarda il videoWatch the Video

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 e quindi accedere utilizzando l'account di amministratore globale di O365.To access the School Data Sync Admin Portal launch a private web browser, navigate to sds.microsoft.com, and then sign in using your O365 Global Admin account.

Creare un profilo di sincronizzazione e sincronizzare i dati SISCreate a Sync Profile and Sync your SIS Data

  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.PNGhow-to-deploy-SDS-using-CSV-files.PNG

  2. Nella pagina Scegli il tipo di connessione scegliere API OneRoster e quindi scegliere il provider di integrazione SIS dal menu a discesa "Scegli il tuo provider" .On the Choose Connection Type page, choice OneRoster API and then choose your SIS integration provider from the “Choose your provider” drop-down menu. Una volta completata, fare clic su Avvia.Once complete, click Start.

    how-to-deploy-SDS-using-oneroster-sync-1.PNGhow-to-deploy-SDS-using-oneroster-sync-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 metodi di sincronizzazione disponibili visualizzati.Choose your sync method - Choose between the available sync methods shown. Se si sta eseguendo la sincronizzazione con OneRoster, selezionare Connetti tramite un metodo di sincronizzazione API, quindi selezionare OneRoster 1,1 API per la selezione del servizio.If you're syncing using OneRoster, select Connect via an API sync method, and then select OneRoster 1.1 API for the service selection.
  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. Completare quindi le selezioni nella pagina in base alle esigenze.Then complete your selections on the page as appropriate.
    how-to-deploy-SDS-using-oneroster-sync-2.PNGhow-to-deploy-SDS-using-oneroster-sync-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 docenti contenuti in OneRoster.Existing Users - Select this option if you already have user accounts create within your O365 tenant for each of the students and teachers contained within OneRoster.

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

  • URL di accesso Web : questo è l'URL accessibile a Internet per l'endpoint ONEROSTER del SIS.Web Access URL - This is the internet accessible URL for the OneRoster Endpoint of your SIS.

  • ID client -questa è la chiave del consumer OAuth per l'autenticazione con l'endpoint ONEROSTER del SIS.client Id - This is the OAuth consumer key for authenticating with the OneRoster endpoint of your SIS.

  • segreto client -questo è il segreto del consumer OAuth per l'autenticazione con l'endpoint ONEROSTER del SIS.client secret - This is the OAuth consumer secret for authenticating with the OneRoster endpoint of your SIS.

  • Quando finisce l'anno scolastico?When does your school year end? -Selezionare l'anno di fine dell'anno scolastico che si desidera sincronizzare. Ad esempio, se si desidera sincronizzare 2017-2018 anni scolastici, selezionare "2018".- Select the end year of the school year that you want to sync. For example, if you would like to sync 2017-2018 school year, select “2018”. Per impostazione predefinita, questo Sincronizza tutti i termini nell'anno scolastico selezionato.By default, this syncs all the terms in the selected school year. Dopo la creazione del profilo, è possibile modificare il profilo di sincronizzazione per selezionare un sottoinsieme di termini da sincronizzare.After the profile is created, you can edit the sync profile to select a subset of terms to sync.

  • Proprietà scolastiche : sono gli attributi scolastici contenuti all'interno di ONEROSTER che SDS può sincronizzare. Gli attributi ingrigiti sono gli attributi necessari e devono essere presenti in OneRoster per la sincronizzazione di ogni scuola. Gli attributi aggiuntivi visualizzati sono facoltativi e possono essere sincronizzati se si sceglie.School properties - These are the school attributes contained within OneRoster that SDS can sync. The greyed out attributes are the required attributes, and must be present in OneRoster for each school to sync. The additional attributes shown are optional, and can be synced if you choose.

  • Proprietà della sezione -questi sono gli attributi di sezione contenuti all'interno di ONEROSTER che SDS può sincronizzare. Gli attributi ingrigiti sono gli attributi necessari e devono essere presenti in OneRoster per la sincronizzazione di ogni sezione. Gli attributi aggiuntivi visualizzati sono facoltativi e possono essere sincronizzati se si sceglie.Section Properties - These are the section attributes contained within OneRoster that SDS can sync. The greyed out attributes are the required attributes, and must be present in OneRoster for each section to sync. The additional attributes shown are optional, and can be synced if you choose.

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

  • Filtrare le voci inattive -sincronizzare solo i record attivi dalla directory di origine.Filter inactive entries - Sync only active records from source directory.

  • Sostituisci caratteri speciali non supportati : se si seleziona questa casella, SDS sostituirà 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.

  • Quando si deve interrompere la sincronizzazione di questo profilo?When should we stop syncing this profile? Questa operazione verrà in genere eseguita 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.

    how-to-deploy-SDS-using-CSV-files-3.PNGhow-to-deploy-SDS-using-CSV-files-3.PNG
  • 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.
  • Chiave primaria (directory di origine) : l'attributo dell'insegnante in OneRoster utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Source Directory) - This is the Teacher attribute in OneRoster 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.
  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.


    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 in OneRoster utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Source Directory) - This is the Student attribute in OneRoster 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.

Stato filtrato dell'API OneRosterFiltered State of OneRoster API

  • Studenti e iscritti – SDS Sincronizza alcuni studenti in base all'associazione scolastica e allo stato.Students and enrollments – SDS syncs some students based on school association and status.

    • SincronizzatoSynced
      • AttivazioneActive
    • Non sincronizzatoNot Synced
      • Da eliminareTo be deleted
  • Insegnanti – SDS Sincronizza alcuni studenti in base all'associazione scolastica e allo stato.Teachers – SDS syncs some students based on school association and status.

    • SincronizzatoSynced
      • AttivazioneActive
    • Non sincronizzatoNot Synced
      • Da eliminareTo be deleted
  • Classi-SDS sincronizza alcune classi in base all'associazione scolastica e al tipo di personale.Classes - SDS syncs some classes based on school association, and staff type.

    • SincronizzatoSynced
      • AttivazioneActive
    • Non sincronizzatoNot Synced
      • Da eliminareTo be deleted
  • Schools – SDS sincronizza alcune scuole basate sull'associazione scolastica e sul tipo di personale.Schools– SDS syncs some schools based on school association, and staff type.

    • SincronizzatoSynced
      • AttivazioneActive
    • Non sincronizzatoNot Synced
      • Da eliminareTo be deleted

changes-to-filtering-powerschool.PNG

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