Leerlinggegevensantwoordbericht
- Protocol
- Alles-in-één-overdracht
- EDEXML (geen profiel)
- LVS-set
- Smalle set
- Gekoppeld met
- Leerlinggegevensverzoekbericht
- Structuur
- Leerlinggegevensstructuur
- Standaard
- EDEXML 2.1
Dit is het bericht met de volledige set van leerlinggegevens als antwoord op het LeerlinggegevensVerzoek en wordt uitgewisseld binnen het protocol Alles-in-één-overdracht.
Componenten
- XML-binding
- UWLR_Leerlinggegevens_v2p2.xsd
- Voorbeeldbestand
- Voorbeeld Leerlinggegevens SOAP Response.xml
Structuur
- Namespace
- http://www.edustandaard.nl/leerresultaten/2/leerlinggegevens
| Smalle set | ||
|---|---|---|
| XML-tag | Omschrijving | Kardinaliteit |
leerlinggegevens_antwoord | LeerlinggegevensAntwoord | verplicht, enkelvoudig |
leerlinggegevens | Leerlinggegevens | verplicht, enkelvoudig |
school | SchoolIn 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. | verplicht, enkelvoudig |
schooljaar | SchooljaarAanduiding 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). | verplicht, enkelvoudig |
peildatum | PeildatumDe datum waarop de schoolgegevens actueel waren. Meestal zal de peildatum gelijk zijn aan de aanmaakdatum en kan deze weggelaten worden. | optioneel, enkelvoudig |
brincode | BRIN-code*
*business rule: Een school wordt binnen deze afspraak als volgt gedefinieerd:
- of -
| optioneel, enkelvoudig |
dependancecode | Dependancecode*
*business rule: Een school wordt binnen deze afspraak als volgt gedefinieerd:
- of -
| optioneel, enkelvoudig |
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:
- of -
| optioneel, enkelvoudig |
aanmaakdatum | AanmaakdatumAanduiding van de (systeem)datum waarop de EDEXML aangemaakt is. Wordt gebruikt om de verwerking te sturen. | optioneel, enkelvoudig |
auteur | Auteur / VerzenderLet op, dit veld was in voorgaande versie van EDEXML achter het volgende veld xsdversie geplaatst. | optioneel, enkelvoudig |
xsdversie | XSD-versieMoet overeenkomen met de versie van het bijbehorende berichtschema (technisch: Met de waarde van het version-attribuut van het root XML-element schema). | optioneel, enkelvoudig |
commentaar | CommentaarEen 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. | optioneel, enkelvoudig |
groepen | GroepenDe lijst van groepen bevat stamgroepen en samengestelde groepen door elkaar. | verplicht, enkelvoudig |
groep | StamgroepDe 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. | optioneel, meervoudig |
@key | Stamgroep idDe definitie van de identificatie sleutel van de stamgroep. | verplicht, enkelvoudig |
naam | Naam van groepNaam van een stamgroep of samengestelde groep. | verplicht, enkelvoudig |
jaargroep | JaargroepAanduiding van het leerjaar of de niveaugroep waarin een individuele leerling of stamgroep zich in het huidige schooljaar bevindt. Waarde uit vaste codelijst (zie EDEXML). | verplicht, enkelvoudig |
omschrijving | Omschrijving | niet toegestaan |
toevoeging | ToevoegingHet uitbreidingsblok. | niet toegestaan |
mutatiedatum | MutatiedatumDatum van aanmaak of laatste gegevensmutatie van dit elementenblok. | niet toegestaan |
samengestelde_groep | Samengestelde groepDe 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. | optioneel, meervoudig |
@key | Samengestelde groep idDe definitie van de identificatie sleutel van de samengestelde groep. | verplicht, enkelvoudig |
naam | Naam van groepNaam van een stamgroep of samengestelde groep. | verplicht, enkelvoudig |
omschrijving | Omschrijving | niet toegestaan |
toevoeging | ToevoegingHet uitbreidingsblok. | niet toegestaan |
mutatiedatum | MutatiedatumDatum van aanmaak of laatste gegevensmutatie van dit elementenblok. | niet toegestaan |
leerlingen | LeerlingenDe lijst van gegevens van leerlingen. | verplicht, enkelvoudig |
leerling | LeerlingDe 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. | verplicht, meervoudig |
@key | Leerling idDit 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. | verplicht, enkelvoudig |
@eckid | ECK-iD attribuutDit is de unieke identifier van de leerling of leerkracht in de leermiddelenketen. | optioneel, enkelvoudig |
achternaam | Achternaam*
Significant deel van de achternaam, namelijk achternaam zonder voorvoegsel en zonder de scheidingsspatie volgend op het voorvoegsel [NEN 1888]. *Business rule: | optioneel, enkelvoudig |
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: | optioneel, enkelvoudig |
voornamen | VoornamenDe verzameling van een of meer naamgegevens ter onderscheiding van personen met dezelfde achternaam [NEN 1888]. | niet toegestaan |
voorletters-1 | Voorletters*
Verzameling letters die wordt gevormd door de eerste letter van alle in volgorde voorkomende voornamen [NEN 1888]. *Business rule: | niet toegestaan |
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: | optioneel, enkelvoudig |
geboortedatum | GeboortedatumDatum van geboorte van de leerling. In EDEXML is dit veld niet verplicht. | verplicht, enkelvoudig |
geslacht | GeslachtSekse 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). | niet toegestaan |
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. | niet toegestaan |
jaargroep | JaargroepAanduiding van het leerjaar of de niveaugroep waarin een individuele leerling of stamgroep zich in het huidige schooljaar bevindt. Waarde uit vaste codelijst (zie EDEXML). | verplicht, enkelvoudig |
groep | Stamgroep refDe verwijzing naar een stamgroep. | verplicht, enkelvoudig |
@key | Stamgroep idrefDe verwijzing naar de identificatie sleutel van een stamgroep. | verplicht, enkelvoudig |
samengestelde_groepen | Samengestelde groep refsDe lijst van verwijzingen naar een samengestelde groep. | optioneel, enkelvoudig |
samengestelde_groep | Samengestelde groep refDe verwijzing naar een samengestelde groep. | verplicht, meervoudig |
@key | Samengestelde groep idrefDe verwijzing naar de identificatie sleutel van een samengestelde groep. | verplicht, enkelvoudig |
vestiging | VestigingscodeCode 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. | niet toegestaan |
@key | Vestiging idrefDe verwijzing naar de sleutel (identifier) van de vestiging. | niet toegestaan |
string | GebruikersnaamDoor de school toegekende gebruikersnaam van de leerling of leerkracht. Deze gebruikersnaam kan gebruikt worden om in te loggen in digitale systemen. | niet toegestaan |
emailadres | E-mailadresHet e-mailadres van de leerling of leerkracht. Dit e-mailadres kan gebruikt worden om in te loggen in digitale systemen. | niet toegestaan |
fotourl | Foto-URLURL naar een foto van de leerling (in het LAS). | niet toegestaan |
bsn_ondwnr-4 | BSN-4Laatste 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. | niet toegestaan |
toevoeging | ToevoegingHet uitbreidingsblok. | niet toegestaan |
mutatiedatum | MutatiedatumDatum van aanmaak of laatste gegevensmutatie van dit elementenblok. | niet toegestaan |
leerkrachten | Leerkrachten | optioneel, enkelvoudig |
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. | verplicht, meervoudig |
@key | Leerkracht idDit 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. | verplicht, enkelvoudig |
@eckid | ECK-iD attribuutDit is de unieke identifier van de leerling of leerkracht in de leermiddelenketen. | optioneel, enkelvoudig |
achternaam | Achternaam*
Significant deel van de achternaam, namelijk achternaam zonder voorvoegsel en zonder de scheidingsspatie volgend op het voorvoegsel [NEN 1888]. *Business rule: | verplicht, enkelvoudig |
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: | optioneel, enkelvoudig |
voornamen | VoornamenDe verzameling van een of meer naamgegevens ter onderscheiding van personen met dezelfde achternaam [NEN 1888]. | niet toegestaan |
voorletters-1 | Voorletters*
Verzameling letters die wordt gevormd door de eerste letter van alle in volgorde voorkomende voornamen [NEN 1888]. *Business rule: | niet toegestaan |
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: | optioneel, enkelvoudig |
string | GebruikersnaamDoor de school toegekende gebruikersnaam van de leerling of leerkracht. Deze gebruikersnaam kan gebruikt worden om in te loggen in digitale systemen. | niet toegestaan |
emailadres | E-mailadresHet e-mailadres van de leerling of leerkracht. Dit e-mailadres kan gebruikt worden om in te loggen in digitale systemen. | verplicht, enkelvoudig |
rol | RolAanduiding 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. | niet toegestaan |
rolomschrijving | RolomschrijvingRol verwijst bij voorkeur naar een lijst met vooraf gedefinieerde rollen, maar er kan ook gekozen worden voor een ‘vrij in te vullen’ rolomschrijving. | niet toegestaan |
groepen | Groep refs (+rol)De lijst van groep-verwijzingen bevat verwijzingen naar stamgroepen en samengestelde groepen, eventueel inclusief rol(beschrijving). | optioneel, enkelvoudig |
groep | Stamgroep ref (+rol)De verwijzing naar een stamgroep, eventueel inclusief rol(beschrijving). | optioneel, meervoudig |
@key | Stamgroep idrefDe verwijzing naar de identificatie sleutel van een stamgroep. | verplicht, enkelvoudig |
rol | RolAanduiding 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. | niet toegestaan |
rolomschrijving | RolomschrijvingRol verwijst bij voorkeur naar een lijst met vooraf gedefinieerde rollen, maar er kan ook gekozen worden voor een ‘vrij in te vullen’ rolomschrijving. | niet toegestaan |
samengestelde_groep | Samengestelde groep ref (+rol)De verwijzing naar een samengestelde groep, eventueel inclusief rol(beschrijving). | optioneel, meervoudig |
@key | Samengestelde groep idrefDe verwijzing naar de identificatie sleutel van een samengestelde groep. | verplicht, enkelvoudig |
rol | RolAanduiding 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. | niet toegestaan |
rolomschrijving | RolomschrijvingRol verwijst bij voorkeur naar een lijst met vooraf gedefinieerde rollen, maar er kan ook gekozen worden voor een ‘vrij in te vullen’ rolomschrijving. | niet toegestaan |
toevoeging | ToevoegingHet uitbreidingsblok. | niet toegestaan |
mutatiedatum | MutatiedatumDatum van aanmaak of laatste gegevensmutatie van dit elementenblok. | niet toegestaan |