Grade Import Widget (Instructor Tools+)

🚀 Algemeen Gebruik

De Grade Import Widget maakt het mogelijk om cijfers vanuit verschillende bronnen te importeren in Brightspace gradebook items. De widget ondersteunt Osiris, Remindo, TestVision, Brightspace export, en eenvoudige CSV bestanden. Met ingebouwde veiligheidscontroles en enrollment verificatie zorgt de widget voor betrouwbare en veilige cijfer imports.

Ga naar je Course Homepage. Onderaan staat de Instructor Tools+ widget. Selecteer hierin de Grade import optie en volg de rest van de handleiding.

⚠️ Let Op: Cijfer Import Risico’s

Backup maken: Maak altijd een backup van je gradebook voordat je importeert.
Test eerst: Test met een klein bestand (5-10 studenten) voordat je alle cijfers importeert.
Controleer data: Controleer de preview tabel zorgvuldig – dit voorkomt foutieve cijfers en een correctie actie.
Grade Scheme keuze: Importeer bij numerieke cijfers alleen in Grade 0-10. Bij Grade 1-10 herrekent Brightspace de import cijfers en worden de cijfers iets hoger.

📋 Import Mode

Mode 1: Simple/Single Grade Item

Voor: Alle bestandsformaten – importeer één cijferkolom naar één grade item

Selecteer Simple Mode
Upload je bestand (Osiris, Remindo, Brightspace export, of CSV)
Als je bestand meerdere cijferkolommen heeft: Kies welke kolom je wilt importeren uit de dropdown
Kies één Brightspace grade item (bestaand) of maak een nieuwe aan met de “➕” knop naast de dropdown
Controleer preview met enrollment status
Vink goedkeuring aan
Klik Import

💡 Tip: Bestanden met meerdere kolommen

Als je een bestand uploadt met meerdere cijferkolommen (bijvoorbeeld een Brightspace export), verschijnt er automatisch een dropdown menu waar je kunt kiezen welke kolom je wilt importeren. De eerste kolom is standaard geselecteerd.

Mode 2: Multiple Grade Items

Voor: Elk bestand met meerdere cijferkolommen (Brightspace, TestVision, handmatig Excel/CSV)

Selecteer Multiple Mode
Upload je bestand – de widget toont automatisch het gedetecteerde format in een badge
Widget detecteert automatisch alle cijferkolommen
Map elke kolom naar een bestaand grade item of maak nieuwe items aan met de “+” knop
Controleer de mapping en de preview
Vink de goedkeuring checkbox aan
Klik Import All Mapped Columns

📁 Ondersteunde Bestandsformaten

🎯 Automatische Format Detectie

De widget herkent automatisch het formaat van je bestand en toont dit in een badge onder de file upload. Je hoeft niet handmatig te selecteren welk format je gebruikt – de widget detecteert of het een Brightspace, Remindo, Osiris, TestVision export is, of een generiek CSV/Excel bestand.

Brightspace Export

✓ BOTH MODES

Excel (.xlsx), CSV (.csv), of Tab-delimited (.txt)
“Username” kolom verplicht
Automatische format detectie
Simple: Selecteer één cijferkolom
Multiple: Map alle cijferkolommen

Remindo Export

✓ SIMPLE MODE

Excel (.xlsx) of Tab-delimited (.txt, .csv)
“Studentnummers” kolom
“Behaalde score” kolom
Automatische format detectie
Extra kolommen worden genegeerd

Osiris Export

✓ SIMPLE MODE

Excel (.xlsx) of Text (.txt)
Student ID in specifieke cel
Cijfer in specifieke kolommen
Automatische format detectie

TestVision Export

✓ SIMPLE MODE

Excel (.xlsx) of CSV (.csv)
“Studentnummer” kolom
“Cijfer” kolom
Automatische format detectie

Generic CSV/Excel

✓ BOTH MODES

Excel (.xlsx), CSV (.csv), of Tab-delimited (.txt)
Student ID kolom + één of meerdere cijferkolommen
Automatische format detectie
Simple: Selecteer één cijferkolom
Multiple: Map alle cijferkolommen
Voorbeelden: F123456,7.5 of F123456;7,5

📌 Welke Mode Gebruiken?

Simple Mode: Importeer één cijferkolom naar één grade item
- Werkt met alle bestandsformaten
- Bij multi-kolom bestanden: selecteer welke kolom je wilt importeren
- Makkelijkste keuze voor één toets/opdracht
Multiple Mode: Importeer meerdere cijferkolommen tegelijk naar meerdere grade items
- Voor elk bestand met meerdere cijferkolommen (Brightspace, TestVision, handmatig Excel/CSV)
- Map elke kolom naar een ander grade item
- Bespaart tijd bij bulk import van meerdere opdrachten tegelijk

💡 Tip: Begin altijd met Simple Mode – deze werkt met alle bestanden. Gebruik Multiple Mode alleen als je meerdere cijferkolommen tegelijk wilt importeren.

🛠️ Bestand Voorbereiden

Brightspace Export Bestand

Ga naar Grades in Brightspace
Klik Export
Selecteer Points Grade onder Grade Value
Kies Username of Org Defined ID – beide werken
Kies Export to Excel of Export to CSV
Download het bestand

Username Grade1 Grade2 Grade3 beta_test1 7.5 8.8 9.0 beta_test2 6.5 7.2 8.5

Osiris Bestand

Export je cijferlijst direct vanuit Osiris naar Excel. De Grade Import Widget herkent het specifieke Osiris-formaat automatisch en vindt de juiste gegevens, ongeacht waar ze in het Excel-bestand staan:

Studentnummers – worden automatisch gevonden in vaste celposities
Cijfers – herkent de juiste kolom met resultaten
Extra informatie – zoals student-namen en cursuscodes worden genegeerd

💡 Handige tip: Het Osiris-bestand heeft een uniek format met cijfers in specifieke celposities. Je hoeft niets aan te passen – upload het bestand direct zoals het uit Osiris komt!

Generic CSV/Excel Bestand

Maak een bestand met Student ID kolom + één of meerdere cijferkolommen. Headers zijn optioneel maar aanbevolen voor duidelijkheid. De widget werkt met zowel 2-kolom bestanden als multi-kolom bestanden.

⚠️ BELANGRIJK: Scheidingsteken en Decimaal

Je KUNT NIET hetzelfde teken gebruiken voor zowel scheidingsteken als decimaal!

Toegestane combinaties:

✅ Komma-scheidingsteken + Punt-decimaal: F123456,7.5
✅ Puntkomma-scheidingsteken + Komma-decimaal: F123456;7,5
✅ Tab-scheidingsteken + Punt-decimaal: F123456 7.5
✅ Tab-scheidingsteken + Komma-decimaal: F123456 7,5

FOUT – Deze werken NIET:

❌ Gemengde decimaaltekens in één bestand:
F123456;7.5
F234567;8,5
→ Bestand gebruikt zowel punt (7.5) als komma (8,5)!
❌ Verkeerde delimiter voor cijfer met komma: F123456,7,5 → wordt gelezen als 3 kolommen!

💡 Tip voor Nederlands Excel: Gebruik ; als scheidingsteken en , als decimaal. Dit is de standaard Nederlandse Excel export: F123456;7,5

Optie 1: Komma-scheidingsteken met punt-decimaal (aanbevolen)

F123456,7.5 F123457,8.0 F123458,6.5

Optie 2: Puntkomma-scheidingsteken met komma-decimaal (Nederlands Excel)

F123456;7,5 F123457;8,0 F123458;6,5

Optie 3: Tab-scheidingsteken met punt-decimaal

F123456 7.5 F123457 8.0 F123458 6.5

Remindo Export

Export je toetsresultaten direct vanuit Remindo naar een Excel-bestand. De Grade Import Widget herkent automatisch het Remindo formaat en zoekt zelf naar de juiste kolommen:

Studentnummers kolom – wordt automatisch gedetecteerd
Behaalde score kolom – alle cijfers worden correct ingelezen
Extra kolommen – zoals namen en e-mailadressen worden genegeerd

💡 Handige tip: Je hoeft het Remindo bestand niet te bewerken of kolommen te verwijderen. Upload het direct zoals het uit Remindo komt, en de widget doet de rest!

TestVision Export

Export je toetsresultaten vanuit TestVision naar CSV of Excel. De Grade Import Widget herkent automatisch het TestVision formaat:

Studentnummer kolom – wordt automatisch gedetecteerd
Cijfer kolom – alle cijfers worden correct ingelezen
Extra kolommen – zoals namen worden genegeerd

💡 Handige tip: Upload het TestVision export bestand direct zoals het uit het systeem komt. De widget herkent het format automatisch en vindt de juiste kolommen!

⚙️ Verwerkingsstappen

1. Upload & Validatie

Widget detecteert automatisch het bestandsformaat
Format indicator badge toont het gedetecteerde bestandstype (Brightspace, Remindo, Osiris, TestVision, etc.)
Verwerkt student IDs en cijfers
Valideert cijfers op basis van het geselecteerde grade item (max points, letter grades, etc.)
Controleert enrollment status per student
Haalt alle bestaande cijfers op voor vergelijking (geoptimaliseerd voor grote klassen)

2. Preview & Mapping

In Simple Mode selecteer je één grade item, in Multiple Mode map je kolommen naar grade items. Bekijk de preview tabel met:

Student ID: De student identifier uit je bestand
Current: Huidige cijfer in Brightspace (alleen zichtbaar wanneer vergelijking is ingeschakeld)
New Grade: Nieuw cijfer uit je bestand
Status: Change indicator (alleen zichtbaar wanneer vergelijking is ingeschakeld)
- ✨ New – Student heeft nog geen cijfer
- 🔄 Update – Cijfer wordt gewijzigd
- ⚪ Unchanged – Cijfer blijft hetzelfde

3. Goedkeuring & Import

Lees de waarschuwingen over niet-ingeschreven studenten
Vink goedkeuring checkbox aan
Klik Import (alleen enrolled students worden geïmporteerd)
Ontvang bevestiging met aantal geïmporteerde cijfers

🚨 Problemen Oplossen

Geen cijfers geïmporteerd? Controleer of studenten ingeschreven zijn in de cursus.

Verkeerde cijfers? Controleer het bestandsformaat en de kolomkoppelingen.

Foutmeldingen? Controleer of het bestand niet corrupt is en de juiste kolommen bevat.

💡 Handige Tips

Backup: Exporteer je gradebook voordat je importeert
Test: Begin met een klein bestand (5-10 studenten)
Controleer: Bekijk de preview tabel zorgvuldig
Format: Gebruik de juiste bestandsformaten voor betere resultaten

➕ Nieuwe Grade Items Aanmaken

De widget kan automatisch nieuwe grade items aanmaken in Brightspace, zowel in Simple als Multiple Mode. Dit is handig wanneer je cijfers wilt importeren naar een opdracht die nog niet bestaat in Brightspace.

🎯 Wanneer Gebruiken?

Nieuwe opdracht: Cijfers importeren voor een nieuwe toets/opdracht
Snelle workflow: Cijfers importeren zonder eerst handmatig grade item aan te maken

Simple Mode

Klik op de “➕” knop naast de grade item dropdown
Vul de Grade Item Name in (bijv. “Assignment 1”, “Midterm Exam”)
Kies Maximum Points (standaard: 10.0 voor Nederlands systeem)
Optioneel: Klik “Advanced Options” voor meer instellingen
Klik “Create & Select”
Het nieuwe grade item wordt aangemaakt en automatisch geselecteerd

Multiple Mode

Bij elke kolom zie je een “+” knop
Klik de knop voor de kolom waar je een nieuw grade item voor wilt maken
Vul de grade item gegevens in en klik “Create & Select”
Het nieuwe item wordt direct aangemaakt en automatisch gekoppeld aan die kolom
Het item verschijnt meteen als geselecteerd in de dropdown
Herhaal voor andere kolommen indien nodig

⚙️ Advanced Options

Klik op “Advanced Options” om extra instellingen te configureren:

Short Name: Afgekorte naam (auto-filled from Name)
Exclude from final grade: Aangeraden – voorkomt onbedoelde impact op eindcijfer
Description: Optionele beschrijving voor het grade item

🛡️ Veilige Standaardinstellingen

Nieuw aangemaakte grade items worden standaard uitgesloten van final grade calculation. Dit voorkomt dat cijfers direct impact hebben op het eindcijfer. Docenten kunnen dit later handmatig aanpassen in Brightspace na controle.

🔧 Veelvoorkomende Problemen

❌ “All rows are invalid”

Mogelijke oorzaken:

Bestand heeft verkeerd format (controleer scheidingstekens en decimalen)
Student IDs zijn niet valide
Cijfers passen niet bij het grade item (bijv. 11.0 bij max 10.0 zonder exceed)
Lettercijfers in numeriek grade item (of omgekeerd)

Oplossing: Controleer of het geselecteerde grade item het juiste type is (numeriek/letter) en of “Can exceed maximum” correct is ingesteld in Brightspace.

Is het juiste grade item geselecteerd?
Zijn de studenten enrolled in de cursus?
Is de goedkeuring checkbox aangevinkt?
Passen de cijfers bij het grade item? (max points, letter grades, etc.)
Let op: Calculated grades (Final Grade, etc.) zijn niet beschikbaar voor import

💡 Tips & Best Practices

🎯 Pro Tips

Test eerst met een klein bestand (5-10 studenten)
Controleer altijd de preview tabel voor je importeert
Let op de change indicators: New, Update, Unchanged
Gebruik Simple Mode voor Osiris/Remindo bestanden
Gebruik Multiple Mode voor Brightspace exports
Bewaar originele bestanden als backup en verwijder deze nadat de import is gecontroleerd
Controleer dat het grade item correct is geconfigureerd (max points, letter grades, exceed, geen grade scheme 1-10)

Grade Import Widget v0.9.31 | Utrecht University