Classroom koppelen aan je leerlinginformatiesysteem (LIS)

Criteria

Je kunt Classroom koppelen aan Infinite Campus als je aan de volgende vereisten voldoet:

• Je gebruikt Infinite Campus met een Campus Learning-licentie.
• Je gebruikt een SaaS-oplossing die volledig door Infinite Campus wordt gehost en beheerd.

Je kunt geen support krijgen van Google als je school Infinite Campus op de volgende manier uitvoert:

• Via een implementatie op locatie.
• Via een implementatie in de cloud die niet rechtstreeks wordt beheerd door Infinite Campus, zoals virtuele machines in AWS/GCP.

Beheerders die vragen hebben over de eerste installatie in de Infinite Campus-portal, kunnen contact opnemen via een van de volgende:

• Algemene support voor Campus
• Support voor Campus (met Campus-ID)

Stap 1: Je OAuth-inloggegevens ophalen

1. Log in op de beheerpagina van Infinite Campus.
2. Zoek en selecteer Digital Learning Applications (Digitale leer-apps).
3. Klik op Add application (App toevoegen).
4. Klik onder Browse Applications (Browsen in apps) op Google Classroom.
5. Optioneel: Als Browse Applications (Browsen in apps) niet wordt getoond, check dan je Campus Learning-licentie:
   • Zoek en selecteer Campus Learning Licensing (Campus Learning-licentie) controleer rechtsboven de licentiestatus.
   • Als je geen licentie hebt, kun je een eenmalige proeflicentie van 45 dagen aanvragen.
   • Als je wel een licentie hebt, maar nog steeds geen inloggegevens kunt maken, neem je contact op met Campus-support.

6. Klik op Generate New OneRoster Connection (Nieuwe OneRoster-koppeling genereren).

7. Selecteer OneRoster 1.2.

8. Noteer deze OAuth-inloggegevens om te gebruiken in de volgende stap:

   • Consumer key (OAuth key) (Gebruikerssleutel, OAuth-sleutel)
   • Consumer secret (OAuth secret) (Consumentengeheim, OAuth-geheim)
   • OneRoster Base URL (Host URL) (Basis-URL OneRoster, Host-URL)

Als je problemen hebt met de installatie van Infinite Campus, neem je contact op met:

• Algemene support voor Campus
• Support voor Campus (met Campus-ID)

Stap 1: Google instellen als OneRoster-partnerleverancier en je OAuth-inloggegevens noteren

1. Klik op de pagina Skyward Product Setup (Skyward-productinstallatie) onder System (Systeem) op Product Setup (PS) (Productinstallatie) Contact Access (CA) (Contacttoegang).
2. Selecteer onder Security (SE) (Beveiliging) en Subgroup Users (US) (Subgroep gebruikers) de optie Secured User (SU) (Beveiligde gebruiker) klik op Add (Toevoegen).
3. Selecteer onder Add Secured User (Beveiligde gebruiker toevoegen) het naamtype dat wordt gevolgd voor leveranciers voer een naam in voor Google. Voer bijvoorbeeld Google in bij de organisatienaam.

Tip: Noteer de naam, je hebt deze in een latere stap weer nodig.

4. Klik op Add Entered Name to Secured Users (Naam toevoegen aan beveiligde gebruikers) om door te gaan.
5. Klik onder Security Information (Beveiligingsgegevens) op Account Information (Accountgegevens). De inlognaam GOOGLE is de API-sleutel.
6. Klik op Save (Opslaan).
7. Zoek in Secured Users List (Lijst met beveiligde gebruikers) de naam die je in stap 3 hierboven hebt ingevoerd:
   • Controleer of de naam wordt vermeld als Active Secured User (Y) (Actieve beveiligde gebruiker).
   • Klik rechtsonder op API.
8. Klik in het venster API Access (API-toegang) op Generate a New Secret (Nieuw geheim genereren). Noteer de sleutel en het geheim. Met deze informatie en de API-URL wordt er verbinding gemaakt met Classroom.
9. Ga na het genereren van het nieuwe geheim terug naar de pagina Skyward Product Setup (Skyward-productinstallatie). Ga naar Product Setup (PS) (Productinstallatie) Contact Access (CA) (Contacttoegang) District Setup (DS) (Districtinstellingen) Configuration (CF) (Configuratie) selecteer API Configuration (AP) (API-configuratie).
10. Noteer de Application URL (App-URL) en Authentication URL (Verificatie-URL). Deze gegevens zijn uniek voor jouw school. Als het veld Application URL (App-URL) leeg is, neem je contact op met Skyward-support.

Tip: De OneRoster API-URL bestaat uit de Application URL (App-URL) die uniek is voor jouw school, gevolgd door het OneRoster-eindpunt /ims/oneroster/v1p1/. Voorbeeld:

Voorbeeld van de Application URL (App-URL):	https://esdemo1.skyward.com
Officieel OneRoster-eindpunt	/ims/oneroster/v1p1/
Voorbeeld van de OneRoster API-URL:	https://esdemo1.skyward.com/api/ims/oneroster/v1p1/

11. Stel onder OneRoster API Line Item Configuration (Regelitemconfiguratie voor OneRoster API) de Default Category (Standaardcategorie) in op Assignments (Opdrachten) of selecteer een andere optie.
    Tip: De Default Category (Standaardcategorie) wordt ingevuld in de beoordelingslijst van Skyward voor opdrachten die worden geëxporteerd vanuit Classroom. Als Default Category (Standaardcategorie) niet in de lijst staat, neem je contact op met Skyward-support.
12. Noteer de volgende OAuth-inloggegevens voor Classroom om te gebruiken in de volgende stap:
    • Key (Access key) (Sleutel, toegangssleutel)
    • Secret (Secret code) (Geheim, geheime code)
    • OneRoster API URL (Host URL) (OneRoster API-URL, Host-URL)
13. Klik op Save (Opslaan).

Criteria

Je kunt Classroom koppelen aan Skyward Qmlativ als je aan de volgende vereisten voldoet:

• Je organisatie is een school die Skyward Qmlativ gebruikt met de OneRoster® API-licentie.
• Je gebruikt een SaaS-oplossing die volledig door Skyward wordt gehost en beheerd.
• Je organisatie is een school die Skyward Qmlativ zelf host.

Klanten die een oplossing op locatie of een zelfgehoste oplossing gebruiken, kunnen LIS-integratie gebruiken maar kunnen geen hulp krijgen van Google Support.

Neem bij vragen over de eerste installatie via de Skyward-portal contact op met het klantenserviceteam van Skyward.

Stap 1: Google instellen met integratietoegang en je OAuth-inloggegevens noteren

1. Stel de OneRoster Vendor (OneRoster-leverancier) in:
   1. Selecteer in het Skyward Qmlativ-menu de optie Administrative Access (Beheerderstoegang) API.
   2. Klik op Vendor (Leverancier).
   3. Zoek Google in de lijst.
      • Als Google niet in de lijst staat:
        1. Klik op Add OneRoster Vendor (OneRoster-leverancier toevoegen).
        2. Voer in de workflow Add OneRoster Vendor (OneRoster-leverancier toevoegen) de waarde Google in.
   4. Klik op Save (Opslaan).
2. Stel de OneRoster Configuration (OneRoster-configuratie) in:
   1. Selecteer in het Skyward Qmlativ-menu de optie Administrative Access (Beheerderstoegang) API.
   2. Klik op OneRoster Configuration (OneRoster-configuratie).
   3. Zoek de rij met de code GGLCL en de leverancier Google.
      • Als je GGLCL niet kunt vinden:
        1. Klik op Add OneRoster Configuration (OneRoster-configuratie toevoegen).
        2. Stel onder Add OneRoster Configuration (OneRoster-configuratie toevoegen) de optie OneRoster Vendor (OneRoster-leverancier) in op Google.
        3. Voer in het veld Code de waarde GGLCL in.
        4. Voer in het veld Description (Beschrijving) de waarde Google Classroom in.
        5. Selecteer je school in de kiezer District.
        6. Vink het vakje aan naast Allow Grade Pass Back (Beoordelingen terugsturen toestaan).
           • Als je een standaardcategorie hebt ingesteld voor Grade Pass Back (Beoordelingen terugsturen), kun je deze selecteren in de kiezer Default Category (Standaardcategorie).
   4. Klik op Save (Opslaan).
3. Stel integratietoegang in en genereer je geheim:
   1. Selecteer in het Skyward Qmlativ-menu de optie Administrative Access (Beheerderstoegang) API Integration (Integratie).
   2. Ga naar de rij met de leveranciersnaam Google Dev Team en de productnaam Google Classroom.
   3. Klik om de integratie te zoeken op Open (Openen) Integration Access (Integratietoegang).
   4. Klik op Add Integration Access (Integratietoegang toevoegen).
   5. Voer de informatie in de workflow Add Integration Access (Integratietoegang toevoegen) in:
      1. Voer in het veld Name (Naam) een naam in voor de integratietoegang, zoals Google Classroom.
      2. Voer in het veld Key (Sleutel) de waarde GOOGLE in.
      3. Selecteer in het veld Authentication Type (Verificatietype) de optie OA2 – OAuth 2.0.
      4. Vink het vakje aan naast Is active (Is actief).
      5. Stel de Effective Date (Ingangsdatum) in op de datum waarop je de toegang wilt starten.
         • Als je meteen toegang wilt geven, laat je de standaardwaarde staan.
      6. Stel de Expiration Date (Vervaldatum) in op de datum waarop je de toegang wilt laten verlopen. Deze datum is standaard ingesteld op één jaar vanaf de ingangsdatum, maar je kunt deze ook verwijderen als je dat wilt.
         • Skyward raadt je aan minimaal elk jaar om beveiligingsredenen een nieuwe integratietoegang te maken. Voor deze transitie kun je meerdere integratietoegangsrecords maken met overlappende ingangs- en vervaldatums. Ze krijgen dan verschillende sleutels of geheimen.
      7. Zoek onder Configuration (Configuratie) de kiezer OneRoster Configuration (OneRoster-configuratie).
      8. Selecteer de code GGLCL en de leverancier Google.
      9. Klik op Save (Opslaan).
      10. Zorg dat in het veld Successful Record (Geslaagde Record), bij Review Results (Resultaten beoordelen), de waarde 1 staat.
      11. Klik op Generate Secret (Geheim genereren).
      12. Klik op Copy (Kopiëren) om de gegevens van de sleutel en het geheim voor integratietoegang naar het klembord te kopiëren.
          • Bewaar deze informatie goed, je kunt deze later niet meer terugkrijgen. Maar als je een nieuw geheim genereert met de workflow Generate Secret (Geheim genereren), wordt het vorige geheim vervangen door het nieuwe geheim dat je instelt.
      13. Klik op Run Process (Proces uitvoeren) Close (Sluiten).
4. Genereer het geheim:
   1. Selecteer in het Skyward Qmlativ-menu de optie Administrative Access (Beheerderstoegang) API.
   2. Klik op Integration (Integratie).
   3. Ga naar de rij met de leveranciersnaam Google Dev Team en de productnaam Google Classroom.
   4. Klik om de integratie te zoeken op Open (Openen) Integration Access (Integratietoegang).
   5. Selecteer de integratietoegang waarvoor je een geheim wilt genereren.
   6. Klik op de pijl voor het menu Generate Secret (Geheim genereren).
   7. Als je de gegevens van de sleutel en het geheim voor integratietoegang naar het klembord wilt kopiëren, klik je in de workflow Generate Secret (Geheim genereren) op Copy (Kopiëren).
      • Bewaar deze informatie goed, je kunt deze later niet meer terugkrijgen. Maar als je een nieuw geheim genereert met de workflow Generate Secret (Geheim genereren), wordt het vorige geheim vervangen door het nieuwe geheim.
   8. Klik op Run Process (Proces uitvoeren) Close (Sluiten).

Tip: De OneRoster® API-URL bestaat uit de Application URL (App-URL) die uniek is voor jouw school en eindigt op API, gevolgd door het OneRoster®-eindpunt /ims/oneroster/v1p1/. Voorbeeld:

Voorbeeld van de Application URL (App-URL):	https://demo.skyward.com/demo
Voorbeeld van de API-URL:	https://demo.skyward.com/demoAPI
Officieel OneRoster®-eindpunt	/ims/oneroster/v1p1/
Voorbeeld van de OneRoster® API-URL:	https://demo.skyward.com/demoapi/ims/oneroster/v1p1/

Stap 2: Classroom koppelen

1. Ga naar classroom.google.com/admin.
2. Klik naast Je LIS selecteren op de pijl-omlaag .
3. Selecteer je LIS.
4. Klik op Koppelen met Google.

   

5. Klik onder 'LIS instellen' op Koppelen.
6. Voer de OAuth-inloggegevens in die je in stap 1 hierboven hebt genoteerd:
   • Host-URL
   • Toegangssleutel
   • Geheime code

   

7. Als je wilt dat Google je domeinnaam kan delen met je LIS-provider, vink je het vakje aan naast Ondersteuning voor het LIS aanzetten.
   • Als deze functie aanstaat, wordt je domeinnaam gedeeld met je LIS-provider om systeemfouten vast te stellen en op te lossen.
8. Klik op Autoriseren.
   • Als je een foutmelding krijgt, vernieuw je de pagina.

Als je ondersteuning aanzet, kan Google je domeinnaam delen met je LIS om systeemfouten vast te stellen en op te lossen.

1. Ga naar classroom.google.com/admin.
2. Vink het vakje aan naast Ondersteuning aanzetten.
   • Je keuze wordt automatisch opgeslagen. Je kunt deze altijd wijzigen.

Als je Classroom loskoppelt van je LIS, kunnen docenten geen integratiefuncties meer gebruiken. Eerder geëxporteerde gegevens blijven bewaard, maar worden niet meer geüpdatet. Als je Classroom later weer koppelt aan je LIS, kunnen toekomstige exports van beoordelingen worden gedupliceerd in je LIS.