CSV Import

📋 Overzicht

Via een CSV-import kunt u tokens (schoolpassen/badges) met bijbehorende gegevens uploaden naar EduDisplay. Deze methode is ideaal voor kleinere scholen of wanneer u volledige controle wilt over welke tokens worden toegevoegd.

✅ Voordelen

• Eenvoudig te implementeren
• Volledige controle over data
• Geen externe koppelingen vereist
• Geschikt voor kleine datasets
• Ondersteuning voor batch updates

📋 Wanneer CSV import gebruiken

• Scholen < 500 gebruikers
• Geen frequente aanpassingen van gebruikergegevens
• Geen Microsoft 365 omgeving met
gevulde UID velden van de pasjes/badges bij de gebruikers
• Handmatige controle over de data gewenst

🟦 Microsoft Gebruikers Sync

Voor scholen met meer dan 500 gebruikers en een Microsoft-omgeving met gevulde UID-velden van de pasjes/badges bij de gebruikers
raden we de Microsoft Gebruikers Sync aan voor automatische synchronisatie.

📄 CSV formaat

Kolommen

Kolom	Beschrijving	Verplicht	Voorbeeld
leerlingnummer	Leerlingnummer of gebruikerscode (bijv. Zermelo-code)	Ja	999998
token	UID / token van schoolpas of badge	Ja	AB123456789
email	E-mailadres of UPN (kolomnamen e-mail, upn e.d. zijn ook toegestaan)	Nee	[email protected]
type	leerling, docent of lokaal (ook student, teacher, location)	Nee	leerling
geboortedatum	Geboortedatum, bijv. dd-mm-jjjj	Nee	01-09-2008

CSV sjabloon

Voorbeeld bestand:

leerlingnummer,email,token,type,geboortedatum
999998,[email protected],AB123456789,leerling,01-09-2008
999999,[email protected],AB123456771,leerling,
abc,[email protected],AH987432A,docent,15-04-1980
j.jansen,[email protected],AH987433D,docent,
LOC001,[email protected],LOC123456789,lokaal,
999997,,CD98765432B,,

Als type leeg is, wordt automatisch leerling gebruikt. Scheidingsteken mag een komma (,) of puntkomma (;) zijn.

📥 Download sjabloon

Download een CSV sjabloon om mee te beginnen (inloggen vereist)

CSV Sjabloon

⚠️ Belangrijk

• Sla het bestand op als CSV met UTF-8 codering
• Gebruik komma (,) of puntkomma (;) als scheidingsteken
• Tokens moeten uniek zijn
• Een nieuwe upload vervangt bestaande handmatige/CSV-tokens (Microsoft Sync-tokens blijven behouden)

⬆️ Import proces

Stap-voor-stap import

1

Bestand voorbereiden

• Download het CSV-sjabloon
• Vul de gebruikersgegevens in
• Controleer op duplicaten
• Sla het bestand op als .csv met UTF-8 codering

2

Upload naar EduDisplay

• Ga naar Gebruikersbeheer → CSV
• Sleep het CSV-bestand in het uploadvak of kies Bladeren op je computer

3

Gegevens controleren

• Bekijk het voorbeeld onder Controleer gegevens
• Los fouten in het CSV-bestand op en upload opnieuw als dat nodig is
• Let op waarschuwingen (import kan dan nog wel doorgaan)
• Klik op Importeren en bevestig de waarschuwing

4

Import voltooien

• Controleer of de import is gelukt
• Test met enkele gebruikers

Validatie regels

Validatie	Type	Beschrijving
Lege verplichte velden	Fout	Leerlingnummer en token mogen niet leeg zijn
Dubbele token	Fout	Token komt vaker voor in het bestand en wordt overgeslagen
Ongeldig type	Fout	Alleen leerling, docent, lokaal (of student, teacher, location)
Leeg type	Info	Type wordt ingesteld op `leerling`
Geen e-mailkolom	Waarschuwing	Records worden zonder e-mailadres opgeslagen

👥 Gebruikersbeheer

Na een succesvolle import beheert u tokens via Gebruikersbeheer:

CSV

• Nieuwe CSV uploaden (vervangt handmatige/CSV-tokens; Microsoft Sync blijft behouden)
• Eerst een backup downloaden van de huidige tokens
• Importgeschiedenis bekijken

Handmatig

• Tokens bekijken, zoeken, toevoegen, bewerken of verwijderen
• Velden: leerlingnummer, e-mail, token, type, geboortedatum

📅 Start schooljaar

Elk schooljaar krijgen vooral brugklassers nieuwe pasjes die uitgedeeld moeten worden. De UID's daarvan werkt u handmatig bij via een nieuwe CSV-upload (of individueel onder Handmatig). Start vanaf een backup-CSV en vul die aan met de extra nieuwe leerlingen.

Voorbeeld nieuwe brugklassers:

leerlingnummer,email,token,type,geboortedatum
250001,[email protected],A1B2C3D4E5,leerling,12-03-2013
250002,[email protected],F6G7H8I9J0,leerling,05-11-2012

🔍 Problemen oplossen

Probleem	Oplossing
Bestand kan niet worden gelezen	Sla het bestand op als CSV met UTF-8-codering. Gebruik een komma of puntkomma als scheidingsteken en houd de kolomkoppen gelijk aan het sjabloon.
Verplichte kolom ontbreekt	Zet `leerlingnummer` en `token` in de header, of download de CSV-sjabloon opnieuw.
Token komt eerder voor in dit bestand	Verwijder dubbele tokens; elke token moet uniek zijn.
Ongeldig leerlingnummer of token	Gebruik alleen letters, cijfers en tekens zoals `.` `_` `@` `-`. Een token moet minimaal 3 tekens zijn, zonder spaties of Excel-formules in de cel.
CSV is niet geïmporteerd	Lees de foutmeldingen op de CSV-pagina, los de genoemde rijen op en probeer opnieuw.
Tokens verschijnen niet op de roosterzuil	Controleer of de import is gelukt. Controleer daarna leerlingnummer, token en type onder Handmatig, en test met een bekende token.