Documentatie over integraties

OneRoster REST voor GG4L School Passport

Het IPSIS-platform (Integratiepakket voor studentintegratiesystemen)

Het IPSIS-platform is een integratieplatform in Brightspace® dat bestaat uit gemeenschappelijke componenten en een verzameling producten waarmee u informatie uit het informatiesysteem van uw organisatie kunt importeren naar Brightspace®, bijvoorbeeld uw organisatiestructuur, gebruikers en inschrijvingsgegevens. Zodra die informatie is geïmporteerd in Brightspace®, kunt u uw informatiesysteem blijven bijwerken en die informatie importeren naar Brightspace® met behulp van het IPSIS-platform.

Dit nieuwe bronsysteem Integration Pack for Student Information Systems (IPSIS) is beschikbaar voor PowerSchool met behulp van School Passport by Global Grid 4 Learning (GG4L). Dit bronsysteem biedt klanten die PowerSchool gebruiken een kant-en-klare integratieoptie voor het roosteren, en omvat een service van GG4L voor het opzetten van School Passport-verbindingen tussen Brightspace® en het studentinformatiesysteem van PowerSchool.

Dit is het notitieblad- en potloodpictogram die voor notities worden gebruikt.

Opmerking: roosteren omvat gebruikersbeheer, inschrijving en organisatiestructuur, inclusief School [Afdeling], Cursus [Sjabloon] en Groep [sectie Cursuseditie+]. Roosteren is een vereiste voor de functionaliteit voor het terugsturen van scores (Grade Passback).

Ondersteunde informatiesystemen

Het IPSIS-platform kan worden geïntegreerd met de volgende gangbare typen informatiesystemen:

SIS (studentinformatiesysteem) - Een softwaretool die door onderwijsinstellingen wordt gebruikt om studenten, cursussen en inschrijvingen te beheren.
HRIS (HR-informatiesysteem) - Een softwaretool die door bedrijfsorganisaties wordt gebruikt om werknemers en hun gegevens te beheren.
LIS (cursistinformatiesysteem) - Een softwaretool die door onderwijsinstellingen wordt gebruikt om de registratie van studenteninschrijvingen te beheren.

Componenten en producten in het IPSIS-platform

Onder het IPSIS-platform bevinden zich gemeenschappelijke componenten en diverse producten met unieke functies om uw specifieke informatiesysteem te integreren met Brightspace. De verzameling van componenten en producten bestaat uit:

D2L® Standaard CSV - Gebruikt voor integratie met SIS/HRIS-systemen door gebruik te maken van door D2L® gedefinieerde CSV-bestanden (Comma Separated Value).
Ellucian ILP - Gebruikt voor integratie met banner- of collegesystemen, gebaseerd op LIS-specificaties.
OneRoster CSV en OneRoster REST - Gebruikt voor integratie met K-12-informatiesystemen die de OneRoster-specificatie van het IMS Global Learning Consortium ondersteunen.
LIS v2.0 adapter - Gebruikt voor integratie met informatiesystemen die de LIS-specificatie van het IMS Global Learning Consortium ondersteunen.
SIS Course Merge - Een interface in Brightspace® waarmee instructeurs meerdere door IPSIS verwerkte cursussen kunnen samenvoegen met en kunnen loskoppelen van één bovenliggende cursuseditie.
Interface (UI) voor Sectiekoppeling - Een interface in Brightspace® die wordt gebruikt om handmatig relaties te bewerken tussen aanmeldingen van cursussen of secties in een SIS en cursusedities in Brightspace®.
IPSIS-beheerinterface (Beheer-UI) - Een beheerinterface in Brightspace® die wordt gebruikt voor het configureren en controleren van de status van SIS-integraties met Brightspace®.

Info over OneRoster 1.1 REST

OneRoster is een IMS-norm die is ontworpen om het veilig delen van groepsroosters en gerelateerde gegevens tussen een studentinformatiesysteem (SIS) en elk ander systeem mogelijk te maken. De OneRoster-norm ondersteunt export-importbewerkingen in spreadsheetstijl (CSV) en directe systeemuitwisselingen met behulp van REST API's. Deze beheerdershandleiding richt zich op de REST-specificatie.

Voordat u OneRoster REST 1.1 gaat gebruiken

D2L® ondersteunt de IMS OneRoster v1.1-specificatie en hercertificeert jaarlijks aan de hand op de IMS Global-productencertificatiesuite. D2L® ondersteunt de volgende conformiteitscertificaten:

REST Data Provider Gradebook Push Core
REST Data Consumer Rostering Core

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 (scholen, klassen, gebruikers, inschrijvingen, enz.) in het Brightspace®-platform in te vullen. De nieuwe IPSIS OneRoster REST-gebruikersinterface bevat een schema waarmee beheerders het tijdstip van de dag kunnen configureren waarop de gegevens worden opgehaald. Bovendien kunnen beheerders voor een SIS-partner die de Gradebook-service ondersteunt de scores instellen die moeten worden geretourneerd met de dagelijkse gegevenssynchronisatie en/of een faculteitslid toestaan een handmatige synchronisatie te initiëren.

Gebruikte eindpunten

Type	URL
GET	ims/oneroster/v1p1/academicSessions
GET	ims/oneroster/v1p1/classes
GET	ims/oneroster/v1p1/enrollments
GET	ims/oneroster/v1p1/orgs
GET	ims/oneroster/v1p1/orgs/{id}
GET	ims/oneroster/v1p1/users

De toewijzing van OneRoster REST aan Brightspace

Hieronder staan de toewijzingswaarden tussen een OneRoster-objecttype en een Brightspace®-objecttype

OneRoster	D2L® Brightspace
Academische sessies	Organisatie-eenheden*
Organisaties	Organisatie-eenheden*
Scholen	Organisatie-eenheden*
Cursussen	Cursussjabloon
Groepen	Cursuseditie en Cursussectie
Gebruikers	Gebruiker
Inschrijvingen	Inschrijving

*Org-eenheidstypen zijn doorgaans aangepaste typen organisatie-eenheden die tijdens het configuratieproces kunnen worden toegewezen.

Academische sessies

OneRoster	Ondersteunde waarden	Gebruikt door Brightspace® voor	Verplicht
sourcedId		N.v.t.	J
status	active of tobedeleted	Maken/vervangen of verwijderen	J
dateLastModified	YYYY-MM-DDTHH:mm:SS.sssZ	N.v.t.	J
metadata	N.v.t.	N.v.t.
title		Naam organisatie-eenheid en code organisatie-eenheid	J
startDate	DD-MM-JJJJ	Geopend voor academische sessie in scorerapport en cursuseditie	J
endDate	DD-MM-JJJJ	Geopend voor academische sessie in scorerapport en cursuseditie	J
type	Semester, Termijn, Scoreperiode, Schooljaar	Type organisatie-eenheid	J
bovenliggend item	N.v.t.	N.v.t.	N.v.t.
Onderliggende onderdelen	N.v.t.	N.v.t.	N.v.t.
SchoolYear	N.v.t.	N.v.t.	N.v.t.

Organisaties

OneRoster	Ondersteunde waarden	Gebruikt door Brightspace® voor	Verplicht
SourcedId		N.v.t.	J
Status	active of tobedeleted	Vervangen of verwijderen	J
DateLastModified	YYYY-MM-DDTHH:mm:SS.sssZ	N.v.t.	J
MetaData	N.v.t.	N.v.t.
Naam		Naam organisatie-eenheid en code organisatie-eenheid	J
Id		Code organisatie-eenheid (indien opgegeven)	N
StartDate	DD-MM-JJJJ	N.v.t.	J
EndDate	DD-MM-JJJJ	N.v.t.	J
Type	District, Afdeling, Lokaal, Nationaal, School, Staat	Type organisatie-eenheid	J
Bovenliggend item		Bovenliggende organisatie-eenheden	Vereist om organisatiestructuur aan te maken
Onderliggende onderdelen	N.v.t.	N.v.t.	N.v.t.

Cursussen

OneRoster	Ondersteunde waarden	Gebruikt door Brightspace® voor	Verplicht
SourcedId		N.v.t.	J
Status	active of tobedeleted	Actief	J
DateLastModified	YYYY-MM-DDTHH:mm:SS.sssZ	N.v.t.	J
MetaData	N.v.t.	N.v.t.
Titel		Naam organisatie-eenheid en code organisatie-eenheid	J
SchoolYear		Bovenliggende organisatie-eenheden	N
CourseCode		Code organisatie-eenheid (indien opgegeven)	N
Scores	N.v.t.	N.v.t.
Onderwerpen	N.v.t.	N.v.t.
Organisatie		Bovenliggende organisatie-eenheden	Vereist om organisatiestructuur aan te maken
StartDate	DD-MM-JJJJ	N.v.t.
EndDate	DD-MM-JJJJ	N.v.t.
SubjectCodes	N.v.t.	N.v.t.
Bronnen	N.v.t.	N.v.t.

Groepen

OneRoster	Ondersteunde waarden	Gebruikt door Brightspace® voor	Verplicht
SourcedId		N.v.t.	J
Status	active of tobedeleted	Actief of inactief	J
DateLastModified	YYYY-MM-DDTHH:mm:SS.sssZ	N.v.t.	J
MetaData	Niet toegewezen
Titel		Naam organisatie-eenheid en code organisatie-eenheid	J
ClassCode		Code organisatie-eenheid (indien aanwezig)	N
ClassType	N.v.t.
Locatie	N.v.t.
Scores	N.v.t.
Onderwerpen	N.v.t.
Cursus		Bovenliggende organisatie-eenheden	J
School		Bovenliggende organisatie-eenheden	J
Termen		Bovenliggende organisatie-eenheden	J
SubjectCodes	N.v.t.
Perioden	N.v.t.
Bronnen	N.v.t.

Gebruikers

OneRoster	Ondersteunde waarden	Gebruikt door Brightspace® voor	Verplicht
SourcedId		OrgDefinedId	J
Status	active of tobedeleted	IsActive	J
DateLastModified	YYYY-MM-DDTHH:mm:SS.sssZ	N.v.t.	J
MetaData	Niet toegewezen
UserName		UserName	J
UserIds	Niet toegewezen
EnabledUser		IsActive	J
GivenName		FirstName	J
FamilyName		LastName	J
MiddleName		MiddleName	N
Rol		Rol in organisatie	J
Id		OrgDefinedId (indien aanwezig)	N
E-mail		ExternalEmail	N
Sms		N.v.t.	N
Telefoon		N.v.t.	N
Agenten		Brightspace® Ouder & voogd	N
Organisaties	Inschrijvingen bovenste organisatie-eenheid (met rol in organisatie)
Scores	N.v.t.
Wachtwoord		Gebruikerswachtwoord	N

Inschrijvingen

OneRoster	Ondersteunde waarden	Gebruikt door Brightspace® voor	Verplicht
SourcedId		N.v.t.	J
Status	active of tobedeleted	Actief	J
DateLastModified	YYYY-MM-DDTHH:mm:SS.sssZ		J
MetaData	N.v.t.
Gebruiker		Gebruiker om in te schrijven	J
Groep		Cursuseditie en sectie om in te schrijven	J
School	N.v.t.
Rol		Rol	J
Primair	N.v.t.
BeginDate	N.v.t.
EndDate	N.v.t.

Aannames en beperkingen

Aannames

D2L® kan werken met elk SIS dat OneRoster 1.1 REST ondersteunt en is gecertificeerd door IMS Global of werkt aan de certificering hiervan.

REST-proces

Geplande uitvoeringen worden uitgevoerd vanaf de vorige uitvoerdatum van het gegevensextract tot de startdatum van het huidige gegevensextract. Als dit de eerste uitvoering is, fungeert deze als synchronisatiebewerking en wordt deze uitgevoerd zonder startdatum voor het datumbereik.
U kunt een uitvoering handmatig activeren vanaf de vorige uitvoerdatum, vanaf een specifieke datum of voor alle records in het systeem.
Aanroepvolgorde: De volgorde waarin de verschillende eindpunten worden aangeroepen:
- Academische sessies
- Organisaties
- Scholen
- Cursussen
- Groepen
- Gebruikers
- Inschrijvingen
- Scores

Beperkingen

Records met een status tobedeleted worden alleen verwijderd als het onderliggende onderdeel is verwijderd.
Inschrijvingen in bovenste organisatorische eenheden die zijn gemaakt vóór de release van juni 2024/20.24.6, kunnen niet worden uitgeschreven via de OneRoster-integratie.
Inschrijvingen die handmatig in Brightspace® zijn gemaakt, kunnen niet worden uitgeschreven via de OneRoster-integratie.
Niet-ondersteunde tekens: Er zijn verschillende tekens die niet worden ondersteund in de Brightspace®-code voor de organisatie-eenheid. Deze tekens worden vervangen door een onderstrepingsteken (_). Niet-ondersteunde karakters: \ : ? " " < > | ' # , % &
Afkappingen: De maximumlengte voor de code van de organisatie-eenheid in Brightspace® is 50 tekens. Als deze lengte wordt overschreden, wordt de code afgekapt in de gebruikersinterface.

Configuratieopties voor OneRoster REST

U gaat samen met de Brightspace®-implementatieconsultant het OneRoster REST-bronsysteem configureren. Brightspace® gaat automatisch terug naar de meest gebruikelijke instellingen. Deze instellingen kunnen echter op elk gewenst moment worden bewerkt met de juiste machtigingen.

Voordat het bronsysteem kan worden geconfigureerd, moet u ervoor zorgen dat u de volgende items hebt voltooid:

Algemene vereisten

Neem contact op met uw OneRoster-vertegenwoordiger voor uw API-informatie. U hebt het volgende nodig:

Eindpunt-URL
Consumentensleutel
Consumentengeheim
OAuth-ondertekeningsmethode = SHA-256

Configuratie

Na de eerste installatie kunt u de configuratie van uw OneRoster REST-bronsysteem bijwerken:

Selecteer in het menu Beheertools de optie IPSIS-beheer en selecteer het tabblad Configuratie
De aanmeldingsgegevens die tijdens de eerste installatie zijn opgegeven, worden als eerste weergegeven. Deze gegevens kunnen indien nodig worden bewerkt.
Velden Bronsysteem:

SIS-naam: Het veld SIS-naam is bewerkbaar en het wordt aanbevolen om dit veld up-to-date te houden.
Geplande updates: De tijd dat Brightspace® automatisch wordt gesynchroniseerd met het SIS. Het wordt aanbevolen dit proces 's nachts te voltooien.
Brightspace overschrijven: Gedetailleerde keuzemogelijkheden om aan te geven welke velden in Brightspace® door het SIS overschreven kunnen worden.

Personen

Toewijzingen van SIS-rollen: Dit gedeelte bevat de specifieke OneRoster-rol om SIS-rolnamen toe te wijzen aan Brightspace®-rolnamen. De rollen van docent en student zijn standaard opgenomen, maar kunnen worden verwijderd. Hieronder volgen de rollen die beschikbaar zijn in OneRoster:
- Beheerder
- Assistent
- Voogd
- Bovenliggend item
- Surveillant
- Familielid
- Cursist
- Docent

Als u extra voor SIS specifieke rolnamen wilt toevoegen om toe te wijzen aan Brightspace®-rollen, klikt u op + Rol toevoegen.Opmerking:: Als het SIS een rol verzendt die niet is geconfigureerd, leidt dit tot een fout en kan de gebruiker niet worden gemaakt.

SIS-vermeldingen toewijzen aan bestaande gebruikers:Biedt de mogelijkheid SIS-vermeldingen op basis van gebruikersnaam of OrgDefinedId toe te wijzen aan bestaande gebruikers die buiten het SIS zijn gemaakt (handmatig, bulkbewerkingen, API, enz.). Als toewijzingen zijn uitgeschakeld, kunnen er duplicaten worden gemaakt.

Cursussen en secties

Cursussen en secties - Toewijzingen: Dit gedeelte bevat de specifieke organisatie-eenheden van OneRoster om SIS-organisaties toe te wijzen aan Brightspace®-organisatienamen.
Klik op + Type organisatie-eenheid toevoegen om extra namen van SIS-specifieke organisatie-eenheden toe te voegen. De volgende typen organisatie-eenheden zijn vereist voor ClassLink:
- SIS-organisaties
  - District
  - School
  - Lokaal, Nationaal, Staat en Afdeling zijn optioneel
- Type academische sessie
  - Semester
  - Term
  - SchoolYear
  - Scoreperiode
- SIS-groep
  - Cursuseditie
  - Cursussectie
  - Cursussjabloon
  - Sectiekoppeling
Verwijdering: Biedt twee opties voor de manier waarop een status tobedeleted (te verwijderen) van invloed is op een organisatie-eenheid in Brightspace®.
- Niets doen: de toewijzing van de organisatie-eenheid wordt verwijderd uit IPSIS-toewijzingen, maar de organisatie-eenheid blijft ongewijzigd in Brightspace
- Cursuseditie inactiveren: de toewijzing van organisatie-eenheid wordt verwijderd uit IPSIS-toewijzingen, de cursuseditie wordt als inactief gemarkeerd in Brightspace®, sectie en inschrijvingen blijven bestaan
SIS-vermeldingen toewijzen aan cursussen en secties: Biedt de mogelijkheid SIS-vermeldingen op basis van de code organisatie-eenheid toe te wijzen aan bestaande organisatie-eenheden die buiten het SIS zijn gemaakt (handmatig, bulkbewerkingen, API, enz.). Het wordt niet aanbevolen deze in te schakelen voor organisatie-eenheden die door uw SIS zijn gemaakt, tenzij u hebt bevestigd dat de codes uniek zijn voor scholen en schooljaren. Als ze niet uniek zijn, kan het SIS bestaande organisatie-eenheden overschrijven met gegevens van andere organisatie-eenheden.
Cursusinhoud: Biedt de mogelijkheid om cursusinhoud van een hoofdcursus of een cursussjabloon naar de nieuwe cursus te kopiëren. Selecteer Ja en kies een van de volgende opties:
- Als Een organisatie-eenheid zoeken om op basis van opgegeven criteria automatisch van te kopiëren? niet is geselecteerd, wordt de inhoud van een Hoofdcursuseditie naar de cursuseditie op hetzelfde niveau gekopieerd als de hoofdcursuseditie en de cursussjabloon dezelfde code voor de organisatie-eenheid hebben
- Als Een organisatie-eenheid zoeken om op basis van opgegeven criteria automatisch van te kopiëren? wel is geselecteerd, kunt u kiezen uit twee opties:
  - Sjabloon voor bovenliggende cursus van de nieuwe cursus
    - De inhoud wordt gekopieerd van de sjabloon voor de bovenliggende cursus naar de nieuwe cursuseditie op het onderliggende niveau
    - Cursus op hetzelfde niveau waarbij de code van de organisatie-eenheid overeenkomt met de bovenliggende sjabloon. Inhoud wordt van de broncursuseditie naar de nieuwe onderliggende cursuseditie gekopieerd op basis van de broncursus die handmatig aan Brightspace® wordt toegevoegd met dezelfde code van de organisatie-eenheid als de bovenliggende sjabloon.

Datums cursuseditie: Hiermee kunt u gegevens van academische sessies gebruiken voor de begin- en einddatums van de cursuseditie. Dit selectievakje is standaard ingesteld op uit. Met deze optie kunt u kiezen of datums van een academische sessie (semester, onderwijsperiode, schooljaar of beoordelingsperiode) worden gekoppeld aan de cursuseditie (deze optie wordt standaard ingesteld op onderwijsperiode). De start- en einddatum van een cursus kunnen ook worden verschoven met een opgegeven aantal dagen. Als er meerdere academische sessies zijn ingesteld voor één cursuseditie, wordt de eerste academische sessie die van het SIS is ontvangen, gebruikt voor de start- en einddatum.

Uitschrijving: Biedt de mogelijkheid om gebruikers uit te schrijven voor secties en cursussen op basis van de Einddatum van de inschrijving die door het SIS wordt verstrekt, en de mogelijkheid om gebruikers uit te schrijven voor SIS Orgs als zij niet meer aan deze zijn gekoppeld in het SIS.

Afdelingen, semesters en overig:
SIS-vermeldingen toewijzen aan bestaande organisatie-eenheden: Biedt de mogelijkheid SIS-vermeldingen op basis van de code organisatie-eenheid toe te wijzen aan bestaande organisatie-eenheden die buiten het SIS zijn gemaakt (handmatig, bulkbewerkingen, API enz.). Het wordt niet aanbevolen deze in te schakelen voor organisatie-eenheden die door uw SIS zijn gemaakt, tenzij u hebt bevestigd dat de codes uniek zijn voor scholen en schooljaren.

Scores exporteren: Scores exporteren naar PowerSchool.

Gebruikers met de machtiging "Scores exporteren" kunnen scores exporteren naar de SIS om docenten met de machtiging Scores exporteren op aanvraag scores naar GG4L te laten verzenden.
Selecteer Exporteer alle scores naar het studentinformatiesysteem tijdens de geplande dagelijkse update om de export van scores bij de dagelijkse synchronisatie op te nemen.

Afbeelding: Selecteer de gewenste opties van Scores exporteren.

Als u gereed bent om gegevens te synchroniseren, selecteert u Configuratie opslaan. Navigeer naar IPSIS-beheer - Dashboard en kies Meer acties naast Update nu uitvoeren - Alle SIS-records opnieuw synchroniseren om de gekozen gegevens uit School Passport te synchroniseren.

Details bij exporteren van scores

Voor scores die moeten worden geëxporteerd:

De cursus moet zijn gemaakt via IPSIS (brontype OneRoster 1.1 REST en GG4L als provider).
Het bronsysteem moet worden geconfigureerd met Score-export ingeschakeld. Schakel deze optie in onder het gedeelte Configuratie van het bronsysteem in IPSIS-beheer.
De cursus mag slechts worden toegewezen aan één actief bronsysteem met Scores exporteren ingeschakeld. Een cursus kan worden toegewezen aan meerdere bronsystemen, maar op slechts één ervan kan Scores exporteren zijn ingeschakeld.
Score-onderdelen moeten behoren tot scorecategorieën waarvoor Exporteren naar SIS is ingeschakeld. Schakel deze optie in op de pagina Scorecategorie bewerken.
Score-onderdelen moeten een bijbehorende academische sessie hebben. Schakel deze optie in op de pagina Score-onderdeel bewerken.

Eigendom van scoreobjecten

Brightspace® bezit score-onderdelen en -scores, terwijl PowerSchool de scorecategorieën bezit. Daarom worden de gekoppelde objecten in PowerSchool overschreven door wijzigingen die in Brightspace® worden aangebracht om items en scores te beoordelen. Wijzigingen in scorecategorieën in PowerSchool worden echter niet overschreven door wijzigingen in Brightspace®.

Als u bijvoorbeeld de maximale score voor een score-onderdeel in PowerSchool wijzigt, wordt de maximale score bijgewerkt in Brightspace® wanneer scores de volgende keer vanuit Brightspace® via GG4L School Passport worden verzonden. Houd rekening met het eigenaarschap van het object tijdens het doornemen van de volgende secties.

Timing van roosteren en terugsturen van scores

Brightspace® synchroniseert eenmaal per dag met GG4L School Passport en GG4L School Passport synchroniseert eenmaal per dag met PowerSchool. Tijdens de synchronisatie tussen systemen gebeurt het volgende:

Wanneer GG4L School Passport wordt gesynchroniseerd met PowerSchool, worden er wijzigingen in het rooster doorgevoerd en worden er wijzigingen naar scores verzonden die sinds de laatste synchronisatie met PowerSchool zijn ontvangen van Brightspace®.
Wanneer Brightspace® synchroniseert met GG4L School Passport, worden wijzigingen in roosters opgehaald en worden wijzigingen in scores verzonden sinds de laatste synchronisatie met School Passport.

Let op het volgende:

Het tijdstip waarop Brightspace® synchroniseert met School Passport kan worden geconfigureerd in IPSIS-beheer > Configuratie. Klanten moeten tijdens de installatie van de integratie samenwerken met hun implementatiespecialist om te bepalen op welk moment van de dag de synchronisatie tussen PowerSchool en GG4L School Passport het beste kan worden geconfigureerd
D2L® raadt aan dat GG4L School Passport wordt gesynchroniseerd met PowerSchool voordat Brightspace® synchroniseert met School Passport. Dit zorgt ervoor dat belangrijke roosterupdates zo snel mogelijk worden doorgegeven aan Brightspace®.
Het kan tot twee dagen duren voordat scores worden weergegeven in PowerSchool. Clients kunnen deze tijd echter verkorten tot de volgende dag door handmatig een synchronisatie te starten met GG4L School Passport in IPSIS-beheer > Dashboard.

Het volgende voorbeeld illustreert een synchronisatie die op vrijdagochtend plaatsvindt, waarbij wordt aangegeven wanneer en welke gegevens worden overgedragen:

Vrijdag 01:00 uur synchronisatie tussen PowerSchool en GG4L School Passport
1. GG4L School Passport haalt alle wijzigingen op uit PowerSchool (bijvoorbeeld voor gebruikers, lessen en secties) die donderdag hebben plaatsgevonden.
2. GG4L School Passport stuurt score-onderdelen en scores naar PowerSchool die de vorige dag van Brightspace® zijn ontvangen. Dit zijn onder andere:
  1. De wijzigingen die woensdag in Brightspace® hebben plaatsvonden en die donderdag om 05:00 uur naar School Passport zijn verzonden
  2. De wijzigingen die donderdag plaatsvonden toen docenten de functie Exporteren naar SIS uitvoerden vanuit de tool Scores of wanneer een beheerder handmatig een synchronisatie met GG4L School Passport heeft gestart in IPSIS-beheer > Dashboard.
Vrijdag 05:00 uur synchronisatie tussen GG4L School Passport en Brightspace®
1. Brightspace® haalt updates (delta’s) op uit GG4L School Passport. Dit zijn de wijzigingen die donderdag in PowerSchool hebben plaatsgevonden.
2. Brightspace® stuurt alle updates van scores naar School Passport die in de loop van donderdag hebben plaatsgevonden.

Omgaan met scorecategorieën

Brightspace® haalt geen categorieën op uit PowerSchool. U moet ze maken in Brightspace®, zelfs als er al categorieën zijn ingesteld in PowerSchool (dit geldt voor categorieën voor leerkrachten en districten).
Als u een categorie wilt synchroniseren met PowerSchool, moet u Exporteren naar SIS selecteren in Categorie bewerken.
GG4L School Passport verbindt categorieën tussen beide systemen op basis van overeenkomende namen. Een categorie die niet bestaat in PowerSchool wordt gemaakt door GG4L School Passport.
Zodra categorieën in Brightspace® en PowerSchool zijn verbonden, heeft het wijzigen van de naam in het ene systeem geen invloed op het andere systeem of op het verzenden van scores naar PowerSchool. Als u de naam van een categorie moet wijzigen, wijzigt u deze in Brightspace® en PowerSchool.
PowerSchool ondersteunt geen categorienamen die langer zijn dan 30 tekens. Categorieën in Brightspace® die meer dan 30 tekens bevatten, kunnen niet worden gemaakt in PowerSchool en bijbehorende score-onderdelen en scores worden niet overgedragen.
PowerSchool ondersteunt geen dubbele categorienamen. Een duplicaat in Brightspace® kan niet worden gemaakt in PowerSchool en de bijbehorende score-onderdelen en scores kunnen niet worden overgedragen.
Categorieën verwijderen:
- Als u een categorie verwijdert uit PowerSchool die is gesynchroniseerd met Brightspace®, wordt de koppeling tussen systemen verbroken. Het opnieuw maken van de categorie in PowerSchool met dezelfde naam is niet voldoende om de koppeling opnieuw tot stand te brengen. Hiervoor moet u een nieuwe categorie maken in Brightspace® (met dezelfde naam als in PowerSchool) en de score-onderdelen naar de nieuwe categorie verplaatsen.
- Als u een categorie wilt verwijderen die al aan PowerSchool is gekoppeld, schakelt u eerst Exporteren naar SIS uit op de pagina Categorie bewerken en verwijdert u vervolgens de categorie uit Brightspace®. De categorie en toewijzingen blijven in PowerSchool losgekoppeld van Brightspace®.

Dit is het megafoonpictogram dat wordt gebruikt voor waarschuwingen.

Waarschuwing: de optie Exporteren naar SIS voor een scorecategorie verschijnt niet als de cursus niet is gemaakt in Brightspace® via de IPSIS-integratie of als de functie Scores exporteren niet is ingeschakeld onder Organisatietools.

Afhandeling van score-onderdelen

Brightspace® haalt geen score-onderdelen (opdrachten) van PowerSchool op om het Brightspace®-scorerapport te vullen. Ook worden wijzigingen in de score-eigenschappen van PowerSchool-opdrachten niet doorgevoerd in Brightspace®.
Een score-onderdeel kan alleen worden gesynchroniseerd met PowerSchool als het onderdeel tot een categorie behoort waarvoor Exporteren naar SIS is ingeschakeld en een semester is geselecteerd in de vervolgkeuzelijst Academische sessie op de pagina Score-onderdeel bewerken. Als u een aantal maar niet alle score-onderdelen in een categorie wilt verzenden naar PowerSchool, worden alleen de score-onderdelen met een academische sessie verzonden.
Score-onderdelen van de volgende typen kunnen naar PowerSchool worden verzonden: Numeriek, Selectievakje, Formule en Voldoende/Onvoldoende.
Scoreschema's in Brightspace® hebben geen invloed op de overdracht van scores. U kunt elk scoreschema gebruiken, onafhankelijk van de PowerSchool-configuratie. Brightspace® stuurt altijd de onderliggende numerieke scores van score-onderdelen naar PowerSchool, ongeacht hoe studenten en docenten scores bekijken. Als studenten of ouders scores bekijken in Brightspace® en PowerSchool, stemt u de scores tussen de systemen af. Dat wil zeggen dat u hetzelfde display gebruikt, zoals letters, punten of percentages met behulp van scoreschema's in Brightspace® en PowerSchool.

In de volgende tabel ziet u hoe eigenschappen van score-onderdelen in Brightspace® worden toegewezen aan PowerSchool-opdrachten.

Brightspace®-score-onderdeel	PowerSchool Assignment
Naam	Opdrachtnaam
Categorie	Categorie
Beschrijving	Beschrijving
Maximumaantal punten	Invoerpunten voor score
Type score-onderdeel (Numeriek, Selectievakje, Formule, Voldoende/Onvoldoende)	Scoretype - Alleen punten
	Vervaldatum (zie hieronder)
	Telling in traditionele eindscore - Altijd ingesteld op Ja
	Extra punten - Niet ondersteund
	Gewicht - Niet ondersteund
	Publicatieopdracht - Onmiddellijk (er wordt geen publicatiedatum verzonden vanuit Brightspace®)

De vervaldatum voor een PowerSchool Assignment wordt als volgt bepaald:
- Als het Brightspace®-score-onderdeel is gekoppeld aan een activiteit (bijvoorbeeld met een test of opdracht), is een van de volgende opties mogelijk:
  - Verzend de vervaldatum van de activiteit, indien ingesteld
  - Verzend de einddatum van de activiteit, indien ingesteld
  - Verzend de einddatum van de academische sessie (semester)
- Als het score-onderdeel niet aan een activiteit is gekoppeld, doet u het volgende:
  - Verzend de einddatum van de academische sessie (semester)
    Opmerking: De startdatum en einddatum van een score-onderdeel worden genegeerd.
Alle PowerSchool-opdrachten worden automatisch gemarkeerd in PowerSchool om te worden opgenomen in de eindscore. Als u wilt dat deze wordt uitgesloten, wijzigt u de optie in PowerSchool of sluit u deze uit van Brightspace® door de academische sessie te verwijderen uit het score-onderdeel.
Als u een student in staat wilt stellen dezelfde eindscore in Brightspace® te halen als via PowerSchool, moet u ervoor zorgen dat dezelfde categorieën en score-onderdelen die zijn geconfigureerd voor de eindscore in Brightspace® overeenkomen met de categorieën die naar PowerSchool worden verzonden. Dat wil zeggen dat als een score-onderdeel niet naar PowerSchool wordt verzonden maar wel is opgenomen in de berekening van de eindscore in Brightspace®, de student en de ouders mogelijk verschillende eindscores zien tussen Brightspace® en PowerSchool.
- Voor scorecategorieën die niet in de eindscore van PowerSchool moeten worden opgenomen, mag Exporteren naar SIS niet voor elke categorie zijn ingeschakeld. Het wordt ook aanbevolen om de scorecategorie een gewicht van 0 te geven.
- Bij score-onderdelen die zijn uitgesloten van de PowerSchool-eindscore, verwijdert u de academische sessie, schakelt u UItgesloten van eindscoreberekening in en wijst u een gewicht van 0 toe aan elk score-onderdeel (in een gewogen scorerapport).
U kunt de naam, beschrijving en het maximale aantal punten in Brightspace® wijzigen en de wijzigingen worden overschreven in PowerSchool. Als u de eigenschappen van een score-onderdeel wijzigt, synchroniseert Brightspace® de wijzigingen van het score-onderdeel en worden alle scores van de student voor dat score-onderdeel opnieuw verzonden.
PowerSchool ondersteunt geen opdrachtnamen die langer zijn dan 50 tekens. Score-onderdelen in Brightspace® met namen van meer dan 50 tekens worden niet gemaakt in PowerSchool en bijbehorende scores van studenten worden niet overgedragen.
Een score-onderdeel kan van de ene categorie naar de andere worden verplaatst in Brightspace® en de categorie wordt gewijzigd in PowerSchool.
Scores binnen samengevoegde cursussen worden op de hieronder beschreven wijze verwerkt door Brightspace® en GG4L School Passport. Neem het volgende scenario:
Twee delen van PowerSchool zijn samengevoegd tot één in Brightspace®-gedeelte. We beginnen bijvoorbeeld met cursus1 (sectie1) en cursus2 (sectie2). Cursus2 wordt vervolgens samengevoegd met Cursus1. Daardoor bevat cursus1 zowel sectie 1 (met de groep cursisten) als sectie 2 (met de groep cursisten uit cursus 2).
Cursus1 heeft een score-onderdeel met de naam Labrapport Week1 en de cursisten zijn beoordeeld.
Brightspace® verzendt het score-onderdeel Labrapport Week1 en scores voor studenten in Sectie 1. Brightspace® verzendt vervolgens het score-onderdeel Labrapport Week1 en scores voor studenten in Sectie 2.
In PowerSchool wordt een nieuwe opdracht gemaakt met de naam Labrapport Week1 in Sectie 1 en krijgen studenten in die sectie hun scores. In Sectie 2 van PowerSchool is er ook een opdracht met de naam Labrapport Week1 en krijgen studenten in die sectie hun scores.

Opmerking: de optie Academische sessie voor een score-onderdeel verschijnt niet als de cursus niet is gemaakt in Brightspace® via de IPSIS-integratie of als de functie Scores exporteren niet is ingeschakeld in Organisatiehulpmiddelen.

Afhandeling van score-onderdelen

Het toevoegen, wijzigen of verwijderen van scores voor studenten wordt weergegeven in PowerSchool.
Wijzigingen in de score van een student in PowerSchool worden overschreven door Brightspace® als er een activeringswijziging wordt aangebracht waardoor Brightspace® de score van een student opnieuw verzendt. Triggers kunnen bestaan uit het wijzigen van een score, een eigenschap van een score-onderdeel en een eigenschap van een scorecategorie.
De vrijstellingsstatus voor een student wordt momenteel niet overgedragen naar PowerSchool. Dit wordt opgelost in een toekomstige release.
Score-onderdelen in Brightspace® kunnen zodanig worden geconfigureerd dat het maximale aantal punten wordt overschreden. Hoewel scores die groter zijn dan de maximale overdracht naar PowerSchool zonder fouten worden weergegeven, geeft PowerSchool wel een fout weer bij het bekijken van de score van de student. Dit kan gevolgen hebben voor de berekeningen van de eindscore. U kunt de fout in PowerSchool oplossen door de opdracht te wijzigen en het aantal punten op te geven waarmee de student het maximum mag overschrijden.
Opmerkingen van docenten aan studenten in Brightspace®, samen met scores, worden naar PowerSchool verzonden.
Eindscores worden niet overgebracht naar PowerSchool.

Problemen oplossen

Het dashboard geeft de verwerkingsstatus van de laatste batch weer. Op de pagina Dashboard en de pagina Batches wordt een eindindicator weergegeven als de batch met succes is voltooid of als er fouten zijn opgetreden. Elke batch heeft een snelkoppeling naar het controlelogboek en indien voltooid met fouten naar foutmeldingen.

Bekijk alle logboeken om te controleren of alle records zijn verwerkt zoals verwacht. Als er foutberichten zijn opgeslagen, vouwt u de fout uit om de vastgelegde metadata te bekijken om de fout te identificeren. Hierna corrigeert u de gegevens in uw SIS en wacht u tot de volgende dag op de geplande update of vraagt u een update aan via het dashboard. Het doel is om de uitvoeringen zonder fouten te laten voltooien.