OneRoster is de standaard IMS Global-specificatie die is ontworpen om het veilig delen van klassenroosters en gerelateerde gegevens tussen een studentinformatiesysteem (SIS) en elk ander systeem mogelijk te maken.
De Brightspace® OneRoster-implementatie ondersteunt de import van spreadsheets (CSV) en directe systeemuitwisselingen met behulp van REST-API's.
Met de Brightspace®-implementatie van de OneRoster v1.1-specificatie kunnen beheerders gegevens plannen die uit hun SIS worden gehaald om de vereiste roostergerelateerde gegevens, zoals scholen, groepen, gebruikers en inschrijvingen, in Brightspace® in te vullen.
De IPSIS OneRoster REST-gebruikersinterface bevat een schema waarmee beheerders het tijdstip van de dag kunnen configureren waarop de gegevens worden opgehaald. Voor een SIS dat het terugsturen van scores ondersteunt kunnen beheerders de scores instellen die moeten worden geretourneerd met de dagelijkse gegevenssynchronisatie en/of een faculteitslid toestaan een handmatige synchronisatie te initiëren.
Voordat u uw OneRoster-integratie configureert in het gebied IPSIS-beheer, moet u het volgende doen:
Rollen instellen voor OneRoster
U moet eerst de rollen bekijken die in uw SIS zijn geconfigureerd en ervoor zorgen dat er geschikte overeenkomstige rollen zijn in Brightspace®.
Rollen voor OneRoster beoordelen
- Bekijk de rollen die in uw SIS zijn geconfigureerd. De volgende rollen zijn beschikbaar in OneRoster:
- Beheerder
- Assistent
- Voogd
- Bovenliggend item
- Surveillant
- Familielid
- Cursist
- Docent
-
Voor een van de bovenstaande rollen die u naar Brightspace® wilt verzenden, maakt u deze vanuit Rollen en machtigingen voordat u uw SIS-integratie configureert als er nog geen geschikte rollen in Brightspace® zijn. Raadpleeg Rollen en machtigingen beheren voor meer informatie.
Typen organisatie-eenheden instellen
U moet ook de typen organisatie-eenheden controleren die zijn ingesteld in uw SIS en ervoor zorgen dat de bijbehorende typen zijn ingesteld in Brightspace®.
Typen organisatie-eenheid controleren
-
Controleer de typen organisatie-eenheden die in uw SIS zijn geconfigureerd. De volgende organisatietypen zijn beschikbaar in OneRoster:
-
Nationaal
-
Staat
-
Lokaal
-
District
-
School (verplicht)
-
Afdeling
- Voor elk van de bovenstaande typen organisatie-eenheden die u naar Brightspace® wilt verzenden, maakt u deze vanuit de Editor organisatie-eenheid voordat u uw SIS-integratie configureert als er nog geen geschikte typen organisatie-eenheden in Brightspace® zijn. U moet toewijzingen instellen tussen typen organisatie-eenheden in de SIS en in Brightspace® wanneer u de SIS-integratie maakt. Raadpleeg Typen organisatie-eenheid maken en verwijderen voor meer informatie.
Inzicht krijgen in de toewijzing van gegevenstypen tussen OneRoster en Brightspace®
OneRoster-objecttypen worden niet exact gekoppeld aan die in Brightspace®. De volgende tabel toont de toewijzingsrelatie tussen OneRoster- en Brightspace®-objecttypen.

|
Opmerking: Typen organisatie-eenheden zijn doorgaans aangepaste typen organisatie-eenheden die tijdens het configuratieproces kunnen worden toegewezen.
|
OneRoster-gegevenstype |
D2L® Brightspace®-gegevenstype |
---|
Academische sessies |
Organisatie-eenheden |
Organisatie |
Organisatie-eenheden |
School |
Organisatie-eenheden |
Cursus |
Cursussjabloon |
Groep |
Cursuseditie en cursussectie |
Gebruiker |
Gebruiker |
Inschrijving |
Inschrijving |
Regelitemcategorieën |
Scorecategorieën |
Regelitems |
Score-onderdelen |
Resultaten |
Scores |
Verantwoordelijkheden voor relaties met ouders/voogden

|
Opmerking: Deze informatie is voor K-12-klanten die Brightspace® ouder & voogd willen gebruiken. |
Uw instelling is verantwoordelijk voor het handhaven van de nauwkeurigheid van gebruikersrelaties in uw studentinformatiesysteem (SIS). Raadpleeg uw adviseurs om ervoor te zorgen dat u zich houdt aan het privacy- en beveiligingsbeleid van uw instelling en de toepasselijke wetgeving. Uw instelling of rechtsgebied kan bijvoorbeeld beleidsregels of wetten hebben die bepalen dat wanneer een kind 18 jaar wordt, de ouder/wettelijke voogd geen toegang meer mag krijgen tot de inhoud van het kind, tenzij het kind toestemming geeft. Hier moet rekening mee worden gehouden bij het genereren en verzenden van ouder/voogd-kindrelaties naar Brightspace®.
Basisconfiguratie van een OneRoster REST-integratie
In de volgende stappen wordt de volgorde op hoofdlijnen beschreven om het inzicht te vergroten. Basisconfiguratie van OneRoster REST vereist de volgende algemene stappen:
- Genereer in het studentinformatiesysteem van uw organisatie een OneRoster Consumer voor Brightspace® waarmee u uw studentinformatiesysteem kunt aanroepen. Het proces hiervoor varieert afhankelijk van uw studentinformatiesysteem. Raadpleeg uw SIS-vertegenwoordiger voor meer informatie.
- Noteer de OAuth-aanmeldingsgegevens uit uw studentinformatiesysteem.
- Noteer de URL van het OneRoster-eindpunt van uw studentinformatiesysteem. Bijvoorbeeld https://www.sis.com/school/api.
Belangrijk: Voeg niet ims/oneroster/v1p1 toe aan het einde van de URL. D2L® doet dit binnen de IPSIS-service.
- Voltooi de configuratie in het nieuwe gebied IPSIS-beheer. Als u bestaande records hebt die u wilt afstemmen op de OneRoster-gegevens, zorg er dan voor dat u de juiste opties selecteert voor de vragen over het koppelen van Brightspace®-gegevens met hun SIS-equivalenten.
- Selecteer in het veld Geplande updates het tijdstip waarop de REST-integratie elke dag automatisch moet worden gesynchronieerd met uw studentinformatiesysteem.
- Wanneer u uw integratie opslaat, wordt deze verwerkt wanneer de volgende geplande update plaatsvindt. Als u uw integratie onmiddellijk wilt uitvoeren, klikt u op de pagina Batches op Nu update uitvoeren en selecteert u Alle SIS-records opnieuw synchroniseren.
Basisconfiguratie van OneRoster CSV-integratie
In de volgende stappen wordt de volgorde op hoofdlijnen beschreven om het inzicht te vergroten. Voor de basisconfiguratie van OneRoster CSV zijn de volgende algemene stappen vereist:
- Maak een CSV-bestand met uw roostergerelateerde gegevens.
- Voltooi de configuratie in het nieuwe gebied IPSIS-beheer. Als u bestaande records hebt die u wilt afstemmen met de OneRoster-gegevens, moet u ervoor zorgen dat u de juiste opties selecteert voor de vragen met betrekking tot het koppelen van Brightspace®-gegevens aan hun SIS-equivalenten.
- Sleep het zipbestand met het CSV-bestand met de roostergegevens naar de pagina Batches en zet het daar neer of blader naar het relevante zipbestand.
De verwerking van de integratie start automatisch.
Een OneRoster-integratie verifiëren
Beheerders kunnen een OneRoster-integratie verifiëren met behulp van de volgende methoden.
Een OneRoster-integratie verifiëren
- Ga naar IPSIS-beheer > Auditlogboek om te bepalen of een REST-integratie is voltooid. Vernieuw de pagina om te controleren of alle verwachte recordtypen (zoals gebruiker, organisatie-eenheid enzovoort) zijn uitgevoerd.
- Voer een van de volgende handelingen uit om te zien of een CSV-integratie is voltooid:
Pagina Batches: Na het uploaden van een CSV ZIP-bestand verschijnt de verwerkingsindicator op de pagina Batches in het bronsysteem. Vernieuw de pagina om te bevestigen dat de indicator Voltooid weergeeft.
Auditlogboek: Vernieuw het auditlogboek om te controleren of alle verwachte recordtypen zijn verwerkt.
- Ga als volgt te werk om te bepalen of een van beide typen is voltooid:
- Organisatie-eenheden: Gebruik de Editor organisatie-eenheid om alle gemaakte organisatie-eenheden te controleren en zo nodig bij te werken.
- Gebruikers: Gebruik de tool Gebruikers om alle gebruikers te controleren die zijn gemaakt en zo nodig updates uit te voeren.