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
• 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)	Verplicht	999998
token	UID / token van schoolpas of badge	Verplicht	AB123456789
email	E-mailadres of UPN (kolomnamen e-mail, upn e.d. zijn ook toegestaan)	Optioneel	[email protected]
type	leerling of docent (ook student, teacher)	Optioneel	leerling
geboortedatum	Alleen nodig voor geboortedatum-verificatie bij Wachtwoord & MFA, bijv. dd-mm-jjjj. Anders leeg laten.	Optioneel	01-09-2008

CSV sjabloon

Voorbeeld bestand:

leerlingnummer,email,token,type
999998,[email protected],AB123456789,leerling
999999,[email protected],AB123456771,leerling
abc,[email protected],AH987432A,docent
j.jansen,[email protected],AH987433D,docent
999997,,CD98765432B,

De kolommen email en type mag u weglaten of leeg laten. Als type leeg is, wordt automatisch leerling gebruikt. Optioneel kunt u een kolom geboortedatum toevoegen als u geboortedatum-verificatie gebruikt bij Wachtwoord & MFA. 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
• De 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
• 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 uw 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
Verplicht veld leeg	Fout	Leerlingnummer en token moeten zijn ingevuld
Dubbele token	Fout	Dezelfde token staat meerdere keren in het bestand; die rij wordt overgeslagen
Ongeldig type	Fout	Alleen leerling of docent (ook student of teacher)
Leeg type	Info	Wordt automatisch `leerling`
Ongeldige geboortedatum	Fout	Gebruik dd-mm-jjjj, of laat de cel leeg
Geen e-mailkolom	Waarschuwing	Gebruikers 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 staan
• Download eerst een backup van de huidige tokens
• Bekijk eerdere imports in de importgeschiedenis

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 bij via een nieuwe CSV-upload (of individueel onder Handmatig). Start vanaf een backup-CSV en vul die aan met de extra nieuwe leerlingen. Leerlingen die van school zijn mogen verwijderd worden.

🔍 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.
Pas of badge werkt niet op de kiosk	Controleer of de import is gelukt. Controleer daarna leerlingnummer, token en type onder Handmatig, en test met een bekende pas of badge.