leerlinggegevens
|
Leerlinggegevens |
school
|
School
In ieder bericht is altijd een bericht-identificatie opgenomen, die definieert de algemene gegevens en de schoolgegevens waar de resultaten betrekking op hebben. De verzoekberichten hebben de
bericht-identificatie in zich in een licht aangepaste vorm.
|
schooljaar
|
Schooljaar
Aanduiding van het schooljaar waarop de gegevens betrekking hebben. Een schooljaar wordt gedefinieerd door het kalenderjaar waarin het schooljaar start en het kalenderjaar waarin het schooljaar
eindigt, volgens het patroon jjjj-jjjj (bijvoorbeeld “2018-2019”). Waarde uit vaste codelijst (zie EDEXML).
|
peildatum
|
Peildatum
De datum waarop de schoolgegevens actueel waren.
Meestal zal de peildatum gelijk zijn aan de aanmaakdatum en kan deze weggelaten worden.
|
brincode
|
BRIN-code*
*business rule:
Een school wordt binnen deze afspraak als volgt gedefinieerd:
-
Middels een BRIN-code, optioneel aangevuld met een (vrij in te vullen) dependancecode. Een BRIN-code bestaat uit twee cijfers en twee letters, een dependancecode uit twee cijfers. De
dependancecode 00 (nul, nul) betekent hetzelfde als geen dependancecode.
- of -
-
Voor scholen die geen BRIN-code hebben: Middels een (zelf te bepalen) schoolsleutel. Deze moet, in ieder geval binnen de betreffende LAS-EA-context, uniek zijn. Hoe deze tot stand komt, is
voor deze afspraak buiten scope.
|
dependancecode
|
Dependancecode*
*business rule:
Een school wordt binnen deze afspraak als volgt gedefinieerd:
-
Middels een BRIN-code, optioneel aangevuld met een (vrij in te vullen) dependancecode. Een BRIN-code bestaat uit twee cijfers en twee letters, een dependancecode uit twee cijfers. De
dependancecode 00 (nul, nul) betekent hetzelfde als geen dependancecode.
- of -
-
Voor scholen die geen BRIN-code hebben: Middels een (zelf te bepalen) schoolsleutel. Deze moet, in ieder geval binnen de betreffende LAS-EA-context, uniek zijn. Hoe deze tot stand komt, is
voor deze afspraak buiten scope.
|
schoolkey
|
Schoolkey*
Identificatie sleutel van de school of dependance van de school in het geval de school niet beschikt over een Brincode met optioneel dependancenummer.
*business rule:
Een school wordt binnen deze afspraak als volgt gedefinieerd:
-
Middels een BRIN-code, optioneel aangevuld met een (vrij in te vullen) dependancecode. Een BRIN-code bestaat uit twee cijfers en twee letters, een dependancecode uit twee cijfers. De
dependancecode 00 (nul, nul) betekent hetzelfde als geen dependancecode.
- of -
-
Voor scholen die geen BRIN-code hebben: Middels een (zelf te bepalen) schoolsleutel. Deze moet, in ieder geval binnen de betreffende LAS-EA-context, uniek zijn. Hoe deze tot stand komt, is
voor deze afspraak buiten scope.
|
aanmaakdatum
|
Aanmaakdatum
Aanduiding van de (systeem)datum waarop de EDEXML aangemaakt is.
Wordt gebruikt om de verwerking te sturen.
|
auteur
|
Auteur / Verzender
Let op, dit veld was in voorgaande versie van EDEXML achter het volgende veld xsdversie geplaatst.
|
xsdversie
|
XSD-versie
Moet overeenkomen met de versie van het bijbehorende berichtschema (technisch: Met de waarde van het version-attribuut van het root
XML-element schema).
|
commentaar
|
Commentaar
Een voor mensen bedoeld veld. Aangezien de uitwisseling tussen systemen plaatsvindt, zal dit meestal weinig toepassing hebben. Er zijn echter uitzonderingsgevallen (testberichten bijvoorbeeld)
waarin dit een rol kan spelen.
|
groepen
|
Groepen
De lijst van groepen bevat stamgroepen en samengestelde groepen door elkaar.
|
groep
|
Stamgroep
De gegevens van een stampgroep, dat is de (fysieke) groep leerlingen waarin de leerling zich meestal bevindt. De stamgroep is in principe gekoppeld aan één jaargroep (bijv. groep
‘4 A’ is gekoppeld aan jaargroep ‘4’ ), maar het kan eventueel ook een combinatiegroep c.q. heterogene groep zijn . Bij een homogene stamgroep wordt de jaargroep onder
andere gebruikt bij referentie-normering van toetsresultaten.
|
@key
|
Stamgroep id
De definitie van de identificatie sleutel van de stamgroep.
|
naam
|
Naam van groep
Naam van een stamgroep of samengestelde groep.
|
jaargroep
|
Jaargroep
Aanduiding van het leerjaar of de niveaugroep waarin een individuele leerling of stamgroep zich in het huidige schooljaar bevindt. Waarde uit vaste codelijst (zie EDEXML).
|
omschrijving
|
Omschrijving |
toevoeging
|
Toevoeging
Het uitbreidingsblok.
|
mutatiedatum
|
Mutatiedatum
Datum van aanmaak of laatste gegevensmutatie van dit elementenblok.
|
samengestelde_groep
|
Samengestelde groep
De gegevens van een samengestelde groep, dat is een groep die is samengesteld uit leerlingen van een of meer jaargroepen en de groep is niet gekoppeld aan een jaargroep (bijvoorbeeld
‘Plusgroep rekenen’). De samengestelde groep is een groep andersoortig samengesteld dan een stamgroep.
|
@key
|
Samengestelde groep id
De definitie van de identificatie sleutel van de samengestelde groep.
|
naam
|
Naam van groep
Naam van een stamgroep of samengestelde groep.
|
omschrijving
|
Omschrijving |
toevoeging
|
Toevoeging
Het uitbreidingsblok.
|
mutatiedatum
|
Mutatiedatum
Datum van aanmaak of laatste gegevensmutatie van dit elementenblok.
|
leerlingen
|
Leerlingen
De lijst van gegevens van leerlingen.
|
leerling
|
Leerling
De gegevens van een leerling, dat is een persoon die onderwijs volgt bij een school of onderwijsinstelling (kan bij jonge kinderen ook bijv. dagopvang of peuterspeelzaal zijn) . Voor een juiste
identificatie van de leerling is het aan te bevelen altijd achternaam, roepnaam, geslacht, geboortedatum en BSN-4 in te vullen. Elke leerling dient aan een jaargroep (bijv. Groep 4) gekoppeld te
worden. Een leerling kan aan één (stam)groep gekoppeld worden. Daarnaast kan een leerling aan een of meerdere samengestelde groepen gekoppeld worden.
|
@key
|
Leerling id
Dit is een door het LAS toegekende identifier (identificatie sleutel). De identifier moet om privacy-redenen buiten de context van de uitwisseling leerresultaten geen betekenis hebben. Een BSN is
bijvoorbeeld niet toegestaan.
|
@eckid
|
ECK-iD attribuut
Dit is de unieke identifier van de leerling of leerkracht in de leermiddelenketen.
|
achternaam
|
Achternaam*
Significant deel van de achternaam, namelijk achternaam zonder voorvoegsel en zonder de scheidingsspatie volgend op het voorvoegsel [NEN 1888].
*Business rule:
In EDEXML is roepnaam óf achternaam verplicht.
|
voorvoegsel
|
Voorvoegsel*
Verzameling van een of meer voorzetsels en/of lidwoorden die aan het significante deel van de achternaam vooraf gaat en daarmee gezamenlijk de achternaam vormt [NEN 1888].
*Business rule:
Als er geen achternaam is dan mag voorvoegsel niet ingevuld zijn.
|
voornamen
|
Voornamen
De verzameling van een of meer naamgegevens ter onderscheiding van personen met dezelfde achternaam [NEN 1888].
|
voorletters-1
|
Voorletters*
Verzameling letters die wordt gevormd door de eerste letter van alle in volgorde voorkomende voornamen [NEN 1888].
*Business rule:
Als er geen achternaam is dan mogen voorletters niet ingevuld zijn.
|
roepnaam
|
Roepnaam*
Onofficiële naam, doorgaans afgeleid van een voornaam en gebruikt als een naam, waarmee een persoon in de vertrouwelijke sfeer gewoonlijk mee wordt aangesproken.
*Business rule:
In EDEXML is roepnaam óf achternaam verplicht.
|
geboortedatum
|
Geboortedatum
Datum van geboorte van de leerling.
In EDEXML is dit veld niet verplicht.
|
geslacht
|
Geslacht
Sekse van een persoon, zoals bij geboorte formeel vastgesteld of nadien formeel gewijzigd [NEN 1888] / [NEN- ISO 5218]. Waarde uit vaste codelijst (zie EDEXML): 1 (= Mannelijk), 2 (= Vrouwelijk)
of 9 (= Niet gespecificeerd).
|
start_ondw_jgr3
|
Startdatum onderwijs jaargroep 3
Startdatum waarop de leerling (lees) onderwijs heeft gekregen (op niveau van) jaargroep 3. Meestal is dit medio augustus van het schooljaar waarin de leerling voor het eerst in jaargroep 3
zat. Dit gegeven kan o.a. gebruikt worden bij bepaling didactische leeftijd.
Dit veld is alleen van toepassing in po en dus niet verplicht.
|
jaargroep
|
Jaargroep
Aanduiding van het leerjaar of de niveaugroep waarin een individuele leerling of stamgroep zich in het huidige schooljaar bevindt. Waarde uit vaste codelijst (zie EDEXML).
|
groep
|
Stamgroep ref
De verwijzing naar een stamgroep.
|
@key
|
Stamgroep idref
De verwijzing naar de identificatie sleutel van een stamgroep.
|
samengestelde_groepen
|
Samengestelde groep refs
De lijst van verwijzingen naar een samengestelde groep.
|
samengestelde_groep
|
Samengestelde groep ref
De verwijzing naar een samengestelde groep.
|
@key
|
Samengestelde groep idref
De verwijzing naar de identificatie sleutel van een samengestelde groep.
|
vestiging
|
Vestigingscode
Code van vestiging van de leerling; verwijzing naar identificatie sleutel van een (fysieke) vestiging van de school waar zich een deel van de leerlingen bevindt. Dit kan een brincode +
dependancecode zijn, maar ook de unieke vestigingscode uit het administratiesysteem van de school.
|
@key
|
Vestiging idref
De verwijzing naar de sleutel (identifier) van de vestiging.
|
string
|
Gebruikersnaam
Door de school toegekende gebruikersnaam van de leerling of leerkracht. Deze gebruikersnaam kan gebruikt worden om in te loggen in digitale systemen.
|
emailadres
|
E-mailadres
Het e-mailadres van de leerling of leerkracht. Dit e-mailadres kan gebruikt worden om in te loggen in digitale systemen.
|
fotourl
|
Foto-URL
URL naar een foto van de leerling (in het LAS).
|
bsn_ondwnr-4
|
BSN-4
Laatste 4 posities van het BSN of, indien BSN onbekend, laatste 4 posities van het onderwijsnummer. BSN-4 is een extra identificatie van de leerling als gebruik van volledige BSN of
onderwijsnummer vanwege privacy redenen niet toegestaan is. Bijvoorbeeld ten behoeve van het onderscheiden van tweelingen.
|
toevoeging
|
Toevoeging
Het uitbreidingsblok.
|
mutatiedatum
|
Mutatiedatum
Datum van aanmaak of laatste gegevensmutatie van dit elementenblok.
|
leerkrachten
|
Leerkrachten |
leerkracht
|
Leerkracht
Persoon die in dienst is van de school en/of betrokken is bij het onderwijs aan die school. Een leerkracht kan gekoppeld worden aan een of meerdere (samengestelde) groepen. Van elke leerkracht
moet minimaal de achternaam of de roepnaam gevuld zijn. Bij de leerkracht en/of per gekoppelde groep kan een of meer rollen vastgelegd worden (bijv. IB’er, stagiair of een vrij in te
vullen rolomschrijving). Rollen kunnen o.a. gebruikt worden bij selectie van leerkrachten/medewerkers ten behoeve van bepaalde functies in het ontvangende systeem.
Het wordt ten strengste afgeraden de rollen te gebruiken voor het automatisch toekennen van autorisaties.
|
@key
|
Leerkracht id
Dit is een door het LAS toegekende identifier (identificatie sleutel). De identifier moet om privacy-redenen buiten de context van de uitwisseling leerresultaten geen betekenis hebben. Een BSN is
bijvoorbeeld niet toegestaan.
|
@eckid
|
ECK-iD attribuut
Dit is de unieke identifier van de leerling of leerkracht in de leermiddelenketen.
|
achternaam
|
Achternaam*
Significant deel van de achternaam, namelijk achternaam zonder voorvoegsel en zonder de scheidingsspatie volgend op het voorvoegsel [NEN 1888].
*Business rule:
In EDEXML is roepnaam óf achternaam verplicht.
|
voorvoegsel
|
Voorvoegsel*
Verzameling van een of meer voorzetsels en/of lidwoorden die aan het significante deel van de achternaam vooraf gaat en daarmee gezamenlijk de achternaam vormt [NEN 1888].
*Business rule:
Als er geen achternaam is dan mag voorvoegsel niet ingevuld zijn.
|
voornamen
|
Voornamen
De verzameling van een of meer naamgegevens ter onderscheiding van personen met dezelfde achternaam [NEN 1888].
|
voorletters-1
|
Voorletters*
Verzameling letters die wordt gevormd door de eerste letter van alle in volgorde voorkomende voornamen [NEN 1888].
*Business rule:
Als er geen achternaam is dan mogen voorletters niet ingevuld zijn.
|
roepnaam
|
Roepnaam*
Onofficiële naam, doorgaans afgeleid van een voornaam en gebruikt als een naam, waarmee een persoon in de vertrouwelijke sfeer gewoonlijk mee wordt aangesproken.
*Business rule:
In EDEXML is roepnaam óf achternaam verplicht.
|
string
|
Gebruikersnaam
Door de school toegekende gebruikersnaam van de leerling of leerkracht. Deze gebruikersnaam kan gebruikt worden om in te loggen in digitale systemen.
|
emailadres
|
E-mailadres
Het e-mailadres van de leerling of leerkracht. Dit e-mailadres kan gebruikt worden om in te loggen in digitale systemen.
|
rol
|
Rol
Aanduiding van de algemene rol(len) die een leerkracht heeft. Deze rol geldt onafhankelijk van de aan de leerkracht gekoppelde groep (stamgroep of samengestelde groep). Bij een leerkracht kan
bijvoorbeeld aangegeven worden dat deze een algemene rol heeft als ICT-coördinator. Let op: de rol in het LAS vertaalt zich niet automatisch 1-op-1 door naar toegang tot specifieke data
in een andere applicatie.
|
rolomschrijving
|
Rolomschrijving
Rol verwijst bij voorkeur naar een lijst met vooraf gedefinieerde rollen, maar er kan ook gekozen worden voor een ‘vrij in te vullen’ rolomschrijving.
|
groepen
|
Groep refs (+rol)
De lijst van groep-verwijzingen bevat verwijzingen naar stamgroepen en samengestelde groepen, eventueel inclusief rol(beschrijving).
|
groep
|
Stamgroep ref (+rol)
De verwijzing naar een stamgroep, eventueel inclusief rol(beschrijving).
|
@key
|
Stamgroep idref
De verwijzing naar de identificatie sleutel van een stamgroep.
|
rol
|
Rol
Aanduiding van de algemene rol(len) die een leerkracht heeft. Deze rol geldt onafhankelijk van de aan de leerkracht gekoppelde groep (stamgroep of samengestelde groep). Bij een leerkracht kan
bijvoorbeeld aangegeven worden dat deze een algemene rol heeft als ICT-coördinator. Let op: de rol in het LAS vertaalt zich niet automatisch 1-op-1 door naar toegang tot specifieke data
in een andere applicatie.
|
rolomschrijving
|
Rolomschrijving
Rol verwijst bij voorkeur naar een lijst met vooraf gedefinieerde rollen, maar er kan ook gekozen worden voor een ‘vrij in te vullen’ rolomschrijving.
|
samengestelde_groep
|
Samengestelde groep ref (+rol)
De verwijzing naar een samengestelde groep, eventueel inclusief rol(beschrijving).
|
@key
|
Samengestelde groep idref
De verwijzing naar de identificatie sleutel van een samengestelde groep.
|
rol
|
Rol
Aanduiding van de algemene rol(len) die een leerkracht heeft. Deze rol geldt onafhankelijk van de aan de leerkracht gekoppelde groep (stamgroep of samengestelde groep). Bij een leerkracht kan
bijvoorbeeld aangegeven worden dat deze een algemene rol heeft als ICT-coördinator. Let op: de rol in het LAS vertaalt zich niet automatisch 1-op-1 door naar toegang tot specifieke data
in een andere applicatie.
|
rolomschrijving
|
Rolomschrijving
Rol verwijst bij voorkeur naar een lijst met vooraf gedefinieerde rollen, maar er kan ook gekozen worden voor een ‘vrij in te vullen’ rolomschrijving.
|
toevoeging
|
Toevoeging
Het uitbreidingsblok.
|
mutatiedatum
|
Mutatiedatum
Datum van aanmaak of laatste gegevensmutatie van dit elementenblok.
|