Collegare Classroom al tuo sistema informatico per gli studenti (SIS)

Idoneità

Puoi collegare Classroom a Infinite Campus se:

• Usi Infinite Campus con una licenza Campus Learning.
• Usi una soluzione SaaS interamente ospitata e gestita da Infinite Campus.

Google non è in grado di fornire assistenza se il tuo distretto scolastico usa:

• Il software Infinite Campus tramite implementazione on-premise.
• Implementazioni cloud non gestite direttamente da Infinite Campus, ad esempio nel caso di macchine virtuali in AWS/Google Cloud.

In caso di domande sulla configurazione iniziale nel portale di Infinite Campus, gli amministratori possono contattare:

• Assistenza Campus non autorizzata
• Assistenza Campus autorizzata

Passaggio 1: recupera le tue credenziali OAuth

1. Accedi alla pagina dell'amministratore di sistema di Infinite Campus.
2. Cerca e seleziona Digital Learning Applications (Applicazioni per apprendimento digitale).
3. Fai clic su Add application (Aggiungi applicazione).
4. In Browse Applications (Sfoglia applicazioni), fai clic su Google Classroom.
5. (Facoltativo) Se non vedi Browse Applications (Sfoglia applicazioni), controlla la tua licenza Campus Learning:
   • Cerca e seleziona Campus Learning Licensing (Licenze Campus Learning) nell'angolo in alto a destra, controlla lo stato della tua licenza.
   • Se non hai una licenza, puoi richiederne una provvisoria, una tantum, della durata di 45 giorni.
   • Se hai una licenza ma non riesci a generare le credenziali, contatta l'assistenza Campus.

6. Fai clic su Generate New OneRoster Connection (Genera nuova connessione OneRoster).

7. Seleziona OneRoster 1.2.

8. Documenta le seguenti credenziali OAuth da utilizzare nel passaggio successivo:

   • Chiave utente (chiave OAuth)
   • Secret utente (secret OAuth)
   • URL di base OneRoster (URL host)

Se hai problemi con la configurazione di Infinite Campus, contatta:

• Assistenza Campus non autorizzata
• Assistenza Campus autorizzata

Passaggio 1: configura Google come fornitore partner di OneRoster e recupera le credenziali OAuth

1. Nella pagina di configurazione di Skyward, in "System" (Sistema) fai clic su Product Setup (PS) (Configurazione prodotto) Contact Access (CA) (Accesso contatto).
2. In "Security" (SE) (Sicurezza) e "Subgroup Users" (US) (Utenti sottogruppo), seleziona Secured User (SU) (Utente protetto) fai clic su Add (Aggiungi).
3. Nella sezione "Add Secured User" (Aggiungi utente protetto), seleziona il tipo di nome monitorato per i fornitori inserisci un nome per Google. Ad esempio, inserisci Google come nome dell'organizzazione.

Suggerimento: annota il nome per utilizzarlo più avanti.

4. Per continuare, fai clic su Add Entered Name to Secured Users (Aggiungi nome inserito a utenti protetti).
5. Nella sezione "Security Information" (Informazioni sulla sicurezza), fai clic su Account Information (Dati dell'account). Il nome di accesso "GOOGLE" è la chiave API.
6. Fai clic su Save (Salva).
7. In Secured Users List (Elenco utenti protetti), individua il nome che hai inserito al precedente passaggio 3:
   • Verifica che il nome sia indicato come Active Secured User (Y) (Utente protetto attivo).
   • Nell'angolo in basso a destra, fai clic su API.
8. In API Access (Accesso API), fai clic su Generate a New Secret (Genera un nuovo secret). Prendi nota della chiave e del secret. Queste informazioni, insieme all'URL dell'API, vengono utilizzate per la connessione a Classroom.
9. Dopo aver generato il nuovo secret, torna alla pagina della configurazione del prodotto Skyward. Vai in "Product Setup" (PS) (Configurazione prodotto) "Contact Access" (CA) (Accesso contatto) "District Setup" (DS) (Configurazione distretto) "Configuration" (CF) (Configurazione) seleziona API Configuration (AP) (Configurazione API).
10. Documenta Application URL (URL dell'applicazione) e Authentication URL (URL di autenticazione). Queste informazioni sono specifiche per il tuo distretto. Se il campo Application URL (URL dell'applicazione) è vuoto, contatta l'assistenza Skyward.

Suggerimento: l'URL dell'API OneRoster è uguale all'URL dell'applicazione univoco per il tuo distretto più l'endpoint OneRoster (sempre /ims/oneroster/v1p1/). Ecco alcuni esempi:

11. In "OneRoster API Line Item Configuration" (Configurazione voce API OneRoster), imposta "Default Category" (Categoria predefinita) su Assignments (Compiti) o seleziona un'altra opzione.
    Suggerimento: la categoria predefinita viene compilata nel registro di Skyward per i compiti esportati da Classroom. Se nell'elenco non è presente Default Category (Categoria predefinita), contatta l'assistenza Skyward.
12. Documenta le seguenti credenziali OAuth per Classroom da utilizzare al passaggio successivo:
    • Chiave (chiave di accesso)
    • Secret (codice segreto)
    • URL API OneRoster (URL Host)
13. Fai clic su Save (Salva).

Idoneità

Puoi collegare Classroom a Skyward Qmlativ se:

• Il tuo distretto scolastico utilizza Skyward Qmlativ con licenza API OneRoster®.
• Usi una soluzione SaaS interamente ospitata e gestita da Skyward.
• Il tuo distretto scolastico ospita autonomamente Skyward Qmlativ.

I clienti che utilizzano soluzioni on-premise o ospitate autonomamente possono utilizzare l'integrazione nel SIS, ma non possono rivolgersi all'Assistenza Google.

In caso di domande sulla configurazione iniziale nel portale di Skyward, contatta il team dell'assistenza clienti di Skyward.

Passaggio 1: configura Google per l'Integration Access (Accesso all'integrazione) e recupera le credenziali OAuth

1. Configura il fornitore di OneRoster:
   1. Nel menu Skyward Qmlativ, seleziona Administrative Access (Accesso amministrativo) API.
   2. Fai clic su Vendor (Fornitore).
   3. Individua "Google" nell'elenco.
      • Se "Google" non è nell'elenco:
        1. Fai clic su Add OneRoster Vendor (Aggiungi fornitore OneRoster).
        2. Nel flusso di lavoro "Add OneRoster Vendor" (Aggiungi fornitore OneRoster), inserisci Google.
   4. Fai clic su Save (Salva).
2. Imposta la configurazione di OneRoster:
   1. Nel menu Skyward Qmlativ, seleziona Administrative Access (Accesso amministrativo) API.
   2. Fai clic su OneRoster Configuration (Configurazione di OneRoster).
   3. Trova la riga con il codice "GGLCL" e il fornitore "Google".
      • Se non trovi "GGLCL":
        1. Fai clic su Add OneRoster Configuration (Aggiungi configurazione di OneRoster).
        2. In "Add OneRoster Configuration" (Aggiungi configurazione di OneRoster), imposta "OneRoster Vendor" (Fornitore OneRoster) su Google.
        3. Nel campo "Code" (Codice), inserisci GGLCL.
        4. Nel campo "Description" (Descrizione), inserisci Google Classroom.
        5. Nel selettore "District" (Distretto), seleziona il tuo distretto.
        6. Seleziona la casella accanto a "Allow Grade Pass Back" (Consenti invio del voto).
           • Se hai configurato una "Default Category" (Categoria predefinita) per "Grade Pass Back" (Invio del voto), puoi selezionarla dal selettore "Default Category" (Categoria predefinita).
   4. Fai clic su Save (Salva).
3. Configura Integration Access (Accesso all'integrazione) e genera il secret:
   1. Nel menu Skyward Qmlativ, seleziona Administrative Access (Accesso amministrativo) API Integration (Integrazione).
   2. Trova la riga con il nome del fornitore "Google Dev Team" e il nome del prodotto "Google Classroom".
   3. Per trovare Integration (Integrazione), fai clic su Open (Apri) Integration Accesses (Accessi all'integrazione).
   4. Fai clic su Add Integration Access (Aggiungi accesso all'integrazione).
   5. Compila le informazioni nel flusso di lavoro "Add Integration Access" (Aggiungi accesso all'integrazione):
      1. Nel campo "Nome", inserisci un nome per l'Integration Access (Accesso all'integrazione), ad esempio "Google Classroom".
      2. Nel campo "Key" (Chiave), inserisci GOOGLE.
      3. Nel campo "Authentication Type" (Tipo di autenticazione), seleziona OA2 - OAuth 2.0.
      4. Seleziona la casella accanto a "Is Active" (È attivo).
      5. Imposta “Effective Date” (Data di validità) sulla data in cui vuoi che inizi l'accesso.
         • Se vuoi che la data di validità inizi immediatamente, lascia il valore predefinito.
      6. Imposta "Expiration Date" (Data di scadenza) sulla data in cui vuoi che termini l'accesso. Per impostazione predefinita questa data è fissata a un anno dalla data di validità, ma se vuoi puoi rimuoverla.
         • Skyward consiglia di creare un nuovo Integration Access (Accesso all'integrazione) come minimo all'inizio di ogni anno scolastico, per motivi di sicurezza. Per consentire questa transizione, puoi creare più record di Integration Access (Accesso all'integrazione) le cui date di validità e scadenza si sovrappongono. Ogni record avrà chiavi o secret diversi.
      7. In "Configuration" (Configurazione), individua il selettore "OneRoster Configuration" (Configurazione OneRoster).
      8. Seleziona il codice GGLCL e il fornitore Google.
      9. Fai clic su Save (Salva).
      10. In "Review Results" (Rivedi i risultati), assicurati che il valore relativo a “Successful Record” (Record riuscito) sia "1".
      11. Fai clic su Generate Secret (Genera secret).
      12. Per copiare negli appunti le informazioni sulla chiave e il secret di Integration Access (Accesso all'integrazione), fai clic su Copy (Copia).
          • Conserva le informazioni dove puoi accedervi, perché non potrai recuperarle in un secondo momento. Tuttavia, quando crei un nuovo secret con il flusso di lavoro "Generate Secret" (Genera secret), sostituisci il precedente secret con quello appena impostato.
      13. Fai clic su Run Process (Esegui processo) Close (Chiudi).
4. Genera il tuo secret:
   1. Nel menu Skyward Qmlativ, seleziona Administrative Access (Accesso amministrativo) API.
   2. Fai clic su Integration (Integrazione).
   3. Individua la riga con il nome del fornitore "Google Dev Team" e il nome del prodotto "Google Classroom".
   4. Per trovare Integration (Integrazione), fai clic su Open (Apri) Integration Accesses (Accessi all'integrazione).
   5. Seleziona l'Integration Access (Accesso all'integrazione) per il quale vuoi generare un secret.
   6. Fai clic sul pulsante Freccia del menu Generate Secret (Genera secret).
   7. Per copiare negli appunti le informazioni sulla chiave e il secret di Integration Access (Accesso all'integrazione), nel flusso di lavoro "Generate Secret" (Genera secret), fai clic su Copy (Copia).
      • Dato che non potrai accedere a queste informazioni in un secondo momento, mantienile accessibili. Tuttavia, quando crei un nuovo secret con il flusso di lavoro "Generate Secret" (Genera secret), sostituisci il precedente secret con quello appena impostato.
   8. Fai clic su Run Process (Esegui processo) Close (Chiudi).

Suggerimento: l'URL dell'API OneRoster® è uguale all'URL dell'applicazione univoco per il tuo distretto con l'aggiunta di "API" alla fine, più l'endpoint OneRoster® (sempre /ims/oneroster/v1p1/). Ecco alcuni esempi: