Come distribuire School Data Sync tramite l'API SIS di PowerSchoolHow to deploy School Data Sync by using PowerSchool SIS API

PowerSchool è un sistema di informazioni per studenti (SIS) che si integra con School Data Sync (SDS).PowerSchool is a Student Information System (SIS) that integrates with School Data Sync (SDS). Se si utilizza il metodo di sincronizzazione PowerSchool, è possibile connettersi direttamente al SIS utilizzando le API basate su REST fornite da PowerSchool e sincronizzare i dati direttamente anziché utilizzare i file CSV.Using the PowerSchool sync method, you can connect directly to your SIS using the REST-based APIs provided by PowerSchool, and synchronize data directly instead of using CSV files. Per configurare SDS utilizzando il metodo di sincronizzazione PowerSchool, seguire le istruzioni riportate in questo articolo.To set up SDS using the PowerSchool Sync method, follow the instructions detailed in this article.

PrerequisitiPrerequisites

Prima di avviare la sincronizzazione con SDS utilizzando il metodo di sincronizzazione PowerSchool, leggere la Panoramica di School Data Sync e verificare di aver soddisfatto i prerequisiti seguenti:Before you start synchronizing with SDS using the PowerSchool 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.

Installare il plug-in API REST per PowerSchoolInstall the REST API plug-in for PowerSchool

Prima che SDS possa accedere ai dati dal SIS PowerSchool, è necessario installare il plug-in di applicazione all'interno di PowerSchool e ottenere le credenziali OAuth seguendo questi passaggi.Before SDS can access data from your PowerSchool SIS, you must install the application plug-in below within PowerSchool and obtain OAuth credentials following these steps.

  1. Nel computer locale, creare un file di installazione del plug-in XML con il contenuto seguente e salvare il file come "plugin.xml".On your local computer, create an XML plug-in installation file with following content, and save the file as "plugin.xml".

    <?xml version="1.0" encoding="UTF-8"?>
    <plugin xmlns="http://plugin.powerschool.pearson.com"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://plugin.powerschool.pearson.com plugin.xsd"
    name="Microsoft School Data Sync"
    version="1.0.0"
    description="Plugin for Powerschool REST API for Microsoft SDS">
    <oauth></oauth>
    <publisher name="Microsoft Corp.">
    <contact email="sdshelp@microsoft.com" />
    </publisher>  
    </plugin>
    
  2. Accedere al sito Web del portale di amministrazione di PowerSchool utilizzando le credenziali di amministratore di sistema.Sign in to the PowerSchool admin portal website using your System Administrator credentials.

  3. Nella pagina iniziale, scegliere sistema dal menu principale, quindi passare a configurazione di sistemaplug-in > Configuration Management > InstallOn the start page, choose System from the main menu, then go to System Settings > Plugin Management Configuration > Install

  4. Immettere o selezionare il file di installazione del plug-in appena creato (con estensione XML), quindi scegliere Installa.Enter or select the plug-in installation file you just created (.xml), and then choose Install. Il plug-in verrà visualizzato nella sezione plug-in installati nella pagina del dashboard di gestione dei plug -in.The plug-in will appear in the Installed Plugins section on the Plugin Management Dashboard page. Verificare che il plug-in sia abilitato.Make sure the plug-in is enabled. In caso contrario, scegliere l'opzione Abilita nella pagina del dashboard di gestione dei plug -in.If it is not, choose the Enable option on the Plugin Management Dashboard page.

  5. Nella pagina del dashboard di gestione dei plug-in, assicurarsi che il plug-in sia abilitato.On the Plugin Management Dashboard page, make sure that the plugin is enabled.

  6. Scegliere configurazione dati per visualizzare le credenziali OAuth che sono state generate per il plug-in.Choose Data Configuration to view the OAuth credentials that were generated for the plug-in.

  7. Registrare i valori dell' ID client e del segreto client in modo che sia possibile immettere queste credenziali quando si crea il profilo di sincronizzazione delle informazioni della scuola.Record the values for the Client ID and Client Secret so you can enter these credentials when you create your School Information Sync profile.

Verificare che gli endpoint REST siano accessibili tramite InternetMake sure the REST endpoints are Internet accessible

Microsoft School Data Sync deve essere in grado di raggiungere il server PowerSchool della propria scuola.Microsoft School Data Sync must be able to reach your school's PowerSchool server. Per assicurarsi che il server sia accessibile, aprire le porte 80 e 443 da Internet al server PowerSchool.To make sure the server is accessible, open ports 80 and 443 from the Internet to your Powerschool server.

Per convalidare che gli endpoint siano impostati correttamente, verificare di poter aprire le pagine del sito Web di PowerSchool server da Internet.To validate that the endpoints are set correctly, check that you can open the PowerSchool server website pages from the Internet. Ad esempio, nel browser, passare a ( https://Powerschool.com/public/) e ( http://Powerschool.com/public/) .For example, in your browser, go to (https://Powerschool.com/public/) and (http://Powerschool.com/public/).

Informazioni sugli avvisi sulla distribuzione di AADConnectAbout AADConnect deployment warnings

Se si sta configurando School Data Sync per un tenant sincronizzato da Active Directory locale tramite AADConnect, è possibile che si verifichi un aumento del numero di disconnessioni visualizzati nel MIISClient.If you are configuring School Data Sync for a tenant which is synchronized from onpremises Active Directory through AADConnect, you may notice an increase in the number of Disconnectors shown in your miisclient. Questo è il risultato di un gruppo di Office 365 che non è in grado di eseguire la sincronizzazione di nuovo nel metaverse di AADConnect e in Active Directory locale.This is a result of Office 365 Group being unable to synchronize back to the AADConnect Metaverse and on-premises Active Directory. Questi avvisi non hanno alcun impatto negativo sulla distribuzione di AADConnect corrente e forniscono solo una nota informativa sull'esito negativo della sincronizzazione risultante.These warnings do not have any negative impact on your current AADConnect deployment, and only provide an informational note on the resultant sync failure. Gli avvisi devono essere previsti in AADConnect dopo aver abilitato la sincronizzazione in SDS, quando viene creato un gruppo di Office 365 per ogni classe sincronizzata tramite SDS.You should expect these warnings in AADConnect after enabling sync in SDS, as one Office 365 Group is created for each class synchronized through SDS.

Sincronizzare i dati SIS utilizzando il metodo di sincronizzazione PowerSchoolSynchronize your SIS data using the PowerSchool sync method

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

Dopo aver installato il plug-in e configurato l'accesso, creare un profilo in Microsoft School Data Sync per sincronizzare le informazioni degli utenti.After you've installed the plug-in and set up access, create a profile in Microsoft School Data Sync to synchronize your users' information.

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, passare 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 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.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-using-Powerschool-API-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 visualizzati.Choose your sync method - Choose between the sync methods shown. Se si sta eseguendo la sincronizzazione con l'API PowerSchool, selezionare la casella Connetti tramite una API e quindi selezionare l'opzione API di PowerSchool.If you’re syncing using PowerSchool API, select the Connect via an API box and then select the PowerSchool API option.
  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-Powerschool-API-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 PowerSchool.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 PowerSchool.
  • Nuovi utenti -selezionare questa opzione se si desidera che SDS crei account utente per ogni studente e insegnante contenuto all'interno di PowerSchool.New Users - Select this option if you want SDS to create user accounts for each of your students and teachers contained within PowerSchool.

Nota

Se uno studente/insegnante ha un nome utente all'interno di PowerSchool, SDS tenterà di usarlo per generare il proprio account.If a student/teacher has a user name within PowerSchool, SDS will attempt to use that to generate their account. Se il nome utente non è disponibile, ne verrà creato uno nel formato seguente:s-<firstName>.<lastName>.<SIS ID>@<selectedDomain>If that username is not available then it will create one in the following format: s-<firstName>.<lastName>.<SIS ID>@<selectedDomain>

  • URL di accesso Web -questo è l'URL di base per il SIS di Powerschool che è accessibile a Internet.Web Access URL - This is the base URL for your PowerSchool SIS which is Internet accessible.
  • ID client -questo è l'ID client registrato nella sezione installare il plug-in API REST per PowerSchool di questo articolo.client Id - This is the client Id recorded in the Install the REST API plug-in for PowerSchool section of this article.
  • segreto client -questo è il segreto client registrato nella sezione installare il plug-in API REST per PowerSchool di questo articolo.client secret - This is the client secret recorded in the Install the REST API plug-in for PowerSchool section of this article.
  • Selezionare scuole per la sincronizzazione : questa opzione consente di selezionare la scuola che si desidera sincronizzare da PowerSchool.Select schools to sync - This option allows you to select the school you want to sync from PowerSchool.
  • Quando inizia l'anno scolastico?When does your school year start? -Questo è l'anno scolastico di PowerSchool che si desidera sincronizzare con questo profilo.- This is the school year from PowerSchool you wish to sync under this profile. Solo 1 anno scolastico può essere sincronizzato per profilo.Only 1 school year can be synced per profile.
  • Gli insegnanti hanno lezioni a più scuole : se si ha un insegnante o uno studente associato a più di una scuola all'interno di PowerSchool, selezionare questa casella.Teachers have classes at multiple schools - If you have a teacher or student associated to more than one school within PowerSchool, check this box.
  • Proprietà scolastiche : sono gli attributi scolastici contenuti all'interno di POWERSCHOOL che SDS può sincronizzare. Gli attributi ingrigiti sono gli attributi necessari e devono essere presenti in PowerSchool 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 PowerSchool that SDS can sync. The greyed out attributes are the required attributes, and must be present in PowerSchool 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 POWERSCHOOL che SDS può sincronizzare. Gli attributi ingrigiti sono gli attributi necessari e devono essere presenti in PowerSchool 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 PowerSchool that SDS can sync. The greyed out attributes are the required attributes, and must be present in PowerSchool 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.
  • Filtro proprietà inattive -la verifica di questa casella consente di sincronizzare solo i record attivi.Filter inactive properties - Checking this box will only sync active records.
  • Sostituisci caratteri non supportati: se si seleziona questa casella, verranno sostituiti automaticamente i caratteri non supportati con quelli supportati.Replace unsupported characters - Checking this box will automatically replace unsupported characters with supported ones.
  • 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 si deve interrompere la sincronizzazione di questo profilo?When should we stop syncing this profile? -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.

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

  • Chiave primaria (directory di origine) -questo è l'attributo Student in PowerSchool utilizzato per la corrispondenza dell'identità di SDS.Primary Key (Source Directory) - This is the Student attribute in PowerSchool 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 SIS di PowerSchoolFiltered State of PowerSchool SIS 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
      • PreregistrazionePre-enrolled
      • AttivazioneActive
    • Non sincronizzatoNot Synced
      • LaureatoGraduated
      • EliminatoDropped Out
      • TrasferitiTransferred Out
  • Docenti – SDS Sincronizza alcuni docenti in base all'associazione scolastica e al tipo di personale.Teachers – SDS syncs some teachers based on school association, and staff type.

    • SincronizzatoSynced
      • DocenteTeacher
      • SostitutoSubstitute
    • Non sincronizzatoNot Synced
      • Personale del pranzoLunch Staff
      • PersonaleStaff
      • Non assegnatoNot Assigned
  • Classi e scuole-SDS Sincronizza tutto all'interno dell'anno scolastico selezionato.Classes and Schools- SDS syncs all within the selected school year.

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